SERP Tracker — Guía completa
Instalar, configurar y explotar el seguimiento de posiciones Google: proveedor SERP, palabras clave por país y dispositivo, panel, distancia al top, índice de visibilidad, competidores, alertas y cron para PrestaShop 8 y 9.
Presentación
El módulo SERP Tracker (dfserptracker) monitoriza las posiciones de su tienda en los resultados de búsqueda de Google, directamente desde el back-office de PrestaShop. Usted declara sus palabras clave (con su país y dispositivo), el módulo comprueba periódicamente su posición mediante un proveedor de API SERP de su elección, conserva el historial de cada comprobación, calcula sus oportunidades y le avisa por correo cuando una página cae.
SERP Tracker no hace scraping de Google: se apoya en una API SERP oficial a la que usted proporciona su propia clave. Las comprobaciones son así fiables, estables y conformes a las condiciones de uso de Google. Cuatro proveedores son compatibles de forma nativa: Serper.dev, ValueSERP, SerpApi y DataForSEO.
Compatibilidad
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- MySQL 5.6+ o MariaDB 10.3+
- Monotienda y multitienda (seguimiento aislado por tienda)
- 5 idiomas: FR, EN, ES, DE, IT
- Alojamiento compartido compatible (o2switch, OVH, etc.)
- Sin dependencia Composer (autoloader propio); gráficos renderizados con Chart.js en local, sin CDN
Instalación
- En el back-office, abra Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y seleccione el archivo
dfserptracker.zip. - Una vez instalado, haga clic en Configurar.
Al instalarse, el módulo crea sus dos tablas (df_serp_keyword y df_serp_position), registra sus pestañas de administración bajo el menú SERP Tracker (Panel, Palabras clave, Competidores) e inicializa sus ajustes por defecto, incluido un token de cron aleatorio.
Elegir y configurar un proveedor SERP
Antes de cualquier comprobación, debe elegir un proveedor e introducir su clave API en la página de configuración del módulo.
- Serper.dev: introduzca su clave en Clave API Serper. Sencillo y económico, ideal para empezar.
- ValueSERP: introduzca su clave en Clave API ValueSERP.
- SerpApi: introduzca su clave en Clave API SerpApi.
- DataForSEO: este proveedor usa autenticación por identificador y contraseña. Introduzca su Login DataForSEO y su Contraseña DataForSEO.
El módulo es una compra única; las comprobaciones consumen créditos en el proveedor que elija, según su propia cuenta y volumen de palabras clave. La mayoría de los proveedores ofrecen un plan gratuito o muy económico para empezar.
Se muestra un banner de advertencia en el panel mientras no haya un proveedor correctamente configurado. Compruebe que la clave introducida corresponde al proveedor seleccionado en el menú desplegable Proveedor.
Configuración
Contexto de búsqueda por defecto
- Dominio monitorizado: el dominio cuya posición desea detectar (por defecto el dominio de la tienda). El módulo compara este dominio con los resultados orgánicos, ignorando el prefijo
www. - País por defecto y Dispositivo por defecto (escritorio o móvil): aplicados a las nuevas palabras clave, sustituibles caso por caso en cada palabra clave.
- Profundidad de resultados: número de resultados analizados por comprobación (más allá, la posición se considera «no posicionada»).
Alertas
- Activar las alertas: activa el envío de correos ante cambios de posición significativos.
- Correo de destino: la dirección que recibe las alertas.
- Umbral de caída: número de puestos de retroceso a partir del cual se dispara una alerta.
Planificación
- Tamaño del lote: número de palabras clave procesadas en cada pasada del cron.
- Retención del historial: tiempo de conservación de las comprobaciones; las más antiguas se purgan automáticamente.
- URL de cron: dirección de solo lectura, protegida por token, que se activa desde el cron de su alojamiento (consulte la sección Comprobaciones automáticas).
Añadir y gestionar palabras clave
Abra la pestaña Palabras clave y luego Añadir una palabra clave. Cada palabra clave lleva su contexto:
- Palabra clave: la consulta a monitorizar.
- URL objetivo (opcional): la página que desea ver posicionada. Si se indica, el módulo prioriza una coincidencia exacta de esta URL; si no, retiene la primera página de su dominio.
- Etiqueta: etiqueta de agrupación (gama, temática…) para filtrar sus palabras clave.
- Idioma, País y Dispositivo: el contexto de búsqueda propio de esta palabra clave.
- Volumen de búsqueda (opcional): a título indicativo.
- Activa: solo las palabras clave activas son comprobadas por el cron.
La lista de palabras clave muestra la posición actual, con una etiqueta de color y una flecha de evolución (▲ / ▼) respecto a la comprobación anterior. La posición 0 significa «no posicionada» dentro de la profundidad analizada.
Puede lanzar una comprobación inmediata sin esperar al cron: use la acción Comprobar ahora en una fila, o seleccione varias palabras clave y aplique la acción masiva Comprobar. Las acciones masivas también permiten activar, desactivar o eliminar en lote.
El panel de control
La pestaña Panel resume su SEO a través de 7 indicadores:
- Índice de visibilidad (0 a 100): puntuación global ponderada por una curva de CTR por posición. Una palabra clave en primera posición pesa mucho más que una al final de la página. Es el indicador de tendencia a seguir en el tiempo.
- Total monitorizadas: número de palabras clave activas.
- Top 3 y Top 10: número de palabras clave posicionadas en los tres y diez primeros puestos.
- Distancia al top: palabras clave posicionadas entre el puesto 4 y el 20 — sus oportunidades más rentables.
- Posición media: media de las posiciones posicionadas.
- No posicionadas: palabras clave fuera de la profundidad analizada.
Bajo los indicadores, un gráfico de anillo muestra la distribución de sus posiciones (top 3 / top 10 / distancia al top / no posicionadas). Dos tablas listan sus ganadores y perdedores entre las dos últimas comprobaciones, y una tabla distancia al top aísla las palabras clave de alto potencial. El botón Lanzar todas las comprobaciones ejecuta una comprobación inmediata de todas las palabras clave pendientes (en AJAX, sin salir de la página).
Competidores y funciones SERP
Para cada comprobación, el módulo detecta las funciones de la SERP: featured snippet (con identificación de su propietario — usted o un competidor), People Also Ask y local pack.
La pestaña Competidores agrega los dominios que aparecen en sus consultas a partir de la última comprobación de cada palabra clave, cuenta sus apariciones y calcula su posición media. Se muestran los 30 dominios más presentes, para detectar de un vistazo quién le pisa los talones en todo su ámbito.
Comprobaciones automáticas (cron)
Para automatizar las comprobaciones, active la URL de cron desde el planificador de tareas de su alojamiento (cron o2switch, OVH, etc.). La URL, protegida por un token, se muestra en solo lectura en la configuración.
En cada pasada, el cron procesa un lote de palabras clave pendientes (según el tamaño del lote configurado), espacia las llamadas para respetar a su proveedor, y luego aplica su periodo de retención purgando las comprobaciones antiguas. Se aceptan dos parámetros opcionales en la URL: limit (número de palabras clave a procesar) e id_shop (tienda objetivo en multitienda).
El token de cron protege el endpoint contra llamadas no autorizadas. No lo difunda públicamente. Toda solicitud sin el token correcto es rechazada.
Alertas
Cuando las alertas están activadas, SERP Tracker envía un correo (plantillas HTML y texto, en francés e inglés) cuando una palabra clave sufre un cambio significativo:
- entrada o salida del top 3;
- salida del top 10;
- pérdida de posición (la palabra clave ya no aparece);
- caída superior al umbral configurado;
- obtención de un featured snippet.
El correo recuerda la palabra clave afectada, la posición anterior y la nueva, el motivo o motivos de la alerta y la URL posicionada.
FAQ y resolución de problemas
El panel muestra «ningún proveedor configurado»
Compruebe que ha seleccionado un proveedor en el menú desplegable Proveedor e introducido la clave correspondiente (o el login/contraseña para DataForSEO). El banner desaparece en cuanto se detecta un proveedor válido.
Mis palabras clave no se actualizan automáticamente
El módulo comprueba las posiciones solo cuando se llama a la URL de cron. Configure una tarea programada en su alojamiento para activar esta URL con la frecuencia deseada (por ejemplo una vez al día). Mientras tanto, el botón Lanzar todas las comprobaciones y la acción Comprobar ahora permiten comprobaciones manuales.
Una posición muestra 0
La posición 0 significa que su dominio no se encontró dentro de la profundidad de resultados analizada. Aumente eventualmente la profundidad en la configuración, o compruebe la URL objetivo y el contexto (país, dispositivo) de la palabra clave.
¿Por qué no hacer scraping de Google directamente?
El scraping directo es frágil, se bloquea pronto y es contrario a las condiciones de uso de Google. Al pasar por una API SERP oficial, las comprobaciones se mantienen fiables y conformes. Usted mantiene el control de los costes mediante su propia cuenta de proveedor.
¿Cómo se calcula el índice de visibilidad?
Cada posición se convierte en un CTR estimado mediante una curva por posición, y luego el conjunto se lleva a una puntuación de 0 a 100. Es un indicador de tendencia: sube cuando sus palabras clave avanzan globalmente hacia lo alto de los resultados.
¿Es compatible con PrestaShop 9 y multitienda?
Sí. El módulo es compatible con PrestaShop 8 y 9, y el seguimiento está aislado por tienda en multitienda. Los controladores se apoyan en ModuleAdminController para seguir siendo compatibles entre PS8 y PS9.