PS PrestaShop Intermedio

GSC Connect — Documentación

Instalar y usar Search Console Connect 2.0.0: asistente de conexión con Google, rendimiento por producto y categoría, inspección masiva de URLs, sitemaps, alertas, cron y seguridad.

Actualizado Versión del módulo 2.0.0

Search Console Connect muestra sus datos de Google Search Console en el back office de PrestaShop: clics, impresiones, CTR y posición por producto, categoría, página CMS y consulta, inspección de URLs en bloque con cola de espera, sitemaps y alertas por correo electrónico. Esta guía cubre la instalación, el asistente de conexión con Google, la lectura de los informes, la inspección, las alertas, el cron, la seguridad y la resolución de problemas. Versión documentada: 2.0.0, compatible con PrestaShop 1.7.8 a 9.

Independencia respecto a Google. Este módulo no está afiliado a Google, ni cuenta con su aprobación ni su patrocinio. Muestra los datos devueltos por la API oficial de Search Console con su propio cliente OAuth: sus datos no pasan por DataFirefly. No garantiza ninguna mejora de posicionamiento, de tráfico ni de indexación.

Resumen de Search Console en PrestaShop: clics, impresiones, CTR, posición media y gráfico de tendencia
Resumen de Search Console en PrestaShop: clics, impresiones, CTR, posición media y gráfico de tendencia

Instalación

  1. Back office → Módulos → Gestor de módulos → Subir un módulo, y a continuación arrastre dfgscconnect-2.0.0.zip.
  2. Aparece un menú Search Console con seis páginas: Resumen, Rendimiento, Indexación, Sitemaps, Alertas, Conexión y ajustes.
  3. Abra Conexión y ajustes: un asistente de 4 pasos le guía (unos 10 minutos la primera vez).

Requisitos previos

  • PrestaShop 1.7.8, 8.x o 9.x; PHP 7.1 a 8.5 (probado en 7.4, 8.1 y 8.5); extensiones curl y openssl.
  • Una cuenta de Google que sea propietaria o usuaria de la propiedad de Search Console de la tienda.
  • Una tarea programada (cron) en su alojamiento para la automatización.

Actualización desde 1.0.x

Instale el nuevo zip sobre el anterior. El script de actualización conserva la conexión con Google (los tokens se cifran durante el proceso), la propiedad, las métricas (duplicados fusionados), las inspecciones, la cola y las alertas. Las alertas antiguas no se vuelven a enviar por correo electrónico.

Asistente de conexión con Google

Asistente de conexión paso a paso: cliente OAuth de Google Cloud y URI de redireccionamiento para copiar
Asistente de conexión paso a paso: cliente OAuth de Google Cloud y URI de redireccionamiento para copiar

Paso 1: crear su cliente OAuth de Google Cloud

  1. En console.cloud.google.com, cree un proyecto y, en APIs y servicios > Biblioteca, active Google Search Console API.
  2. Configure la pantalla de consentimiento (tipo Externo) con el nombre de la tienda y su correo electrónico. En el acceso a los datos, añada el ámbito https://www.googleapis.com/auth/webmasters.readonly (o webmasters si desea gestionar los sitemaps desde la tienda).
  3. Cree un ID de cliente OAuth de tipo Aplicación web y pegue en «URIs de redireccionamiento autorizados» la dirección que muestra el módulo (botón Copiar). En multitienda, cada tienda tiene su propia dirección: añádalas todas al mismo cliente.
  4. Publique la aplicación (estado «En producción»). Con el estado «En fase de pruebas», Google invalida la autorización al cabo de 7 días y habría que volver a conectarse cada semana. Para su uso personal, Google puede mostrar «Google no ha verificado esta aplicación»: haga clic en Configuración avanzada y continúe.
  5. Copie el ID de cliente y el secreto de cliente en el módulo, elija el acceso solicitado y guarde. El secreto se cifra (AES-256) y no se vuelve a mostrar nunca.

¿Qué acceso elegir? Solo lectura (recomendado) basta para el rendimiento, la inspección de URLs y el estado de los sitemaps. Lectura + gestión de sitemaps permite además enviar y eliminar sitemaps desde PrestaShop. El módulo solicita también openid email para mostrar qué cuenta de Google está conectada.

Paso 2: iniciar sesión con Google

Haga clic en Iniciar sesión con Google y acepte la pantalla de consentimiento: volverá al back office, ya conectado. Se muestran la cuenta, el acceso concedido y el estado de la conexión; están disponibles Reconectar y Desconectar y revocar.

Conexión con Google activa y elección de la propiedad de Search Console (dominio o prefijo de URL)
Conexión con Google activa y elección de la propiedad de Search Console (dominio o prefijo de URL)

Paso 3: elegir la propiedad

El módulo lista las propiedades accesibles y destaca la que cubre la dirección de la tienda (una propiedad de dominio sc-domain: cubre todos los subdominios; una propiedad con prefijo de URL cubre una dirección concreta). Opción avanzada: dirección pública, si la tienda se sirve desde una dirección distinta de la definida en PrestaShop (proxy, CDN).

Paso 4: automatizar

Copie la URL del cron (manténgala privada) y prográmela cada 15 minutos, por ejemplo: */15 * * * * curl -fsS "URL" >/dev/null. El botón Ejecutar ahora lanza una pasada inmediata. El historial de actividad muestra las últimas tareas y sus posibles errores, explicados en lenguaje claro.

Prueba de conexión con un clic: cliente OAuth, autorización, propiedad, datos de rendimiento
Prueba de conexión con un clic: cliente OAuth, autorización, propiedad, datos de rendimiento

El botón Probar la conexión comprueba paso a paso: cliente OAuth, autorización de Google, acceso a la propiedad, lectura del rendimiento y permiso de gestión de sitemaps.

Resumen

Clics, impresiones, CTR y posición media de la propiedad de 7 días a 16 meses, comparados con el periodo anterior o con el año anterior. Los totales proceden de la dimensión «fecha» de la API: son las mismas cifras que las de los gráficos de Search Console. La curva muestra clics, impresiones, CTR, posición y el periodo de comparación.

Productos, categorías y consultas principales, páginas que pierden clics y oportunidades
Productos, categorías y consultas principales, páginas que pierden clics y oportunidades

Más abajo: principales productos, principales categorías, principales consultas, páginas que pierden clics, oportunidades (consultas en posición 4 a 20 con muchas impresiones), estado de la indexación, sitemaps y alertas abiertas. Google publica sus datos con un retraso de unos 2 días; el último día puede estar incompleto.

Rendimiento por producto, categoría y consulta

Informe de rendimiento por producto: clics, variación, impresiones, CTR y posición
Informe de rendimiento por producto: clics, variación, impresiones, CTR y posición

Pestañas Productos, Categorías, Consultas, Todas las páginas y Páginas CMS: clics, evolución, impresiones, CTR y posición (media ponderada por las impresiones, como en Search Console), búsqueda, ordenación, paginación y exportación a CSV (UTF-8 con BOM, separador punto y coma).

Cada URL de Google se asocia a su página de PrestaShop gracias a las rutas de la tienda, incluidas las reglas personalizadas de «SEO y URL», el prefijo de idioma y las URL sin reescribir. Los parámetros (?utm_…, paginación, filtros) se ignoran: todas las variantes de una página se agrupan bajo ella.

Consultas de Google que llevan a la ficha de un producto, con clics, impresiones y posición
Consultas de Google que llevan a la ficha de un producto, con clics, impresiones y posición

El botón de detalle muestra las consultas que llevan a un producto, una categoría o una página (instantánea de los últimos 28 días), o las páginas que se posicionan para una consulta.

Rendimiento por categoría, con los clics de los productos de cada categoría
Rendimiento por categoría, con los clics de los productos de cada categoría

El informe de Categorías muestra también los clics de los productos cuya categoría por defecto es esa.

Indexación: inspección de URLs en bloque

Inspección de URLs masiva: estado de indexación, cola y cuota de Google del día
Inspección de URLs masiva: estado de indexación, cola y cuota de Google del día

Añada a la cola las páginas vistas en Google (28 días) (recomendado: son las URL exactas que Google conoce), todos los productos activos, todas las categorías, las páginas CMS, las páginas modificadas desde su última inspección, o una lista de URLs pegada. Las URL ajenas a la propiedad se ignoran. El cron procesa la cola; Ejecutar la cola ahora la procesa desde la página con una barra de progreso.

Cuotas de Google. La API de inspección está limitada a 2.000 llamadas al día y 600 por minuto por propiedad (se restablece a medianoche, hora del Pacífico). El módulo cuenta cada llamada, respeta sus límites (configurables más abajo), pone la cola en pausa ante un error 429 y se reanuda por sí solo; un error de cuota no consume ningún intento.

Resultados de inspección: páginas indexadas y sin indexar, URL canónica elegida por Google
Resultados de inspección: páginas indexadas y sin indexar, URL canónica elegida por Google

Resultados filtrables: indexadas, no indexadas, errores y páginas para las que Google ha elegido una URL canónica distinta de la declarada.

Detalle de una inspección de URL: cobertura, rastreo, robots.txt y URLs canónicas
Detalle de una inspección de URL: cobertura, rastreo, robots.txt y URLs canónicas

El detalle muestra el veredicto, el estado de cobertura, si la indexación está permitida o no, la recuperación de la página, robots.txt, el último rastreo, el agente de rastreo, las URL canónicas declarada y seleccionada por Google, los sitemaps, las páginas de referencia y los resultados enriquecidos detectados. La inspección muestra la versión que Google conoce (último rastreo), no una prueba en directo. «No indexada» no siempre es un problema: las páginas con una etiqueta canónica hacia otra URL, redirigidas o con noindex se excluyen voluntariamente.

Sitemaps

Sitemaps conocidos por Search Console, errores y sitemaps detectados en la tienda
Sitemaps conocidos por Search Console, errores y sitemaps detectados en la tienda

Lista de los sitemaps conocidos por Search Console con su estado (correcto, pendiente, errores, advertencias), las URL enviadas por tipo, la fecha de envío y la última lectura por parte de Google. El módulo detecta los sitemaps de la tienda (líneas Sitemap: del robots.txt, módulo Google sitemap, DataFirefly Sitemap) y, con el acceso de «gestión de sitemaps», permite enviarlos, reenviarlos o eliminarlos. Solo se pueden enviar las URL cubiertas por la propiedad; eliminar un sitemap no borra el archivo. Desde 2023, Google ya no comunica el número de URL indexadas por sitemap.

Alertas

Alertas: caída de posición o de clics, página desindexada, errores de sitemap
Alertas: caída de posición o de clics, página desindexada, errores de sitemap
  • Caída de posición y caída de clics: últimos 7 días consolidados comparados con los 7 días anteriores, por página y para toda la propiedad, con umbrales y mínimos de impresiones o de clics configurables.
  • Página no indexada: una página indexada que sale del índice, o una página que aporta clics y no está indexada (excepto las exclusiones voluntarias).
  • Errores de sitemap, conexión con Google perdida, cuota de inspección de URLs alcanzada.

Las alertas se deduplican, se resuelven solas cuando el problema desaparece y pueden marcarse como leídas o resueltas en bloque.

Ajustes: alertas configurables, cuotas de inspección, historial y tarea cron
Ajustes: alertas configurables, cuotas de inspección, historial y tarea cron

El resumen por correo electrónico (diario, semanal o en cada pasada del cron) se envía hasta a 10 destinatarios, en el idioma elegido. Un botón envía un correo de prueba.

Correo electrónico de resumen de alertas de Search Console enviado por la tienda
Correo electrónico de resumen de alertas de Search Console enviado por la tienda

Ajustes

Ajuste Valor por defecto Función
Historial a importar 16 meses Profundidad cargada en la primera pasada, un mes por ejecución del cron (Search Console conserva 16 meses).
Conservar los datos en la tienda durante 24 meses Retención local (16, 24, 36 meses o sin límite); más allá de 16 meses, permite comparaciones que Search Console ya no ofrece.
Inspecciones por día / por minuto 1.800 / 300 Límites del módulo, por debajo de los límites de Google (2.000 / 600).
Idiomas a inspeccionar Solo el idioma por defecto O todos los idiomas activos, o una selección.
Volver a inspeccionar las páginas automáticamente Activada Tras la modificación de un producto, una categoría o una página CMS. El guardado no se ralentiza: el cambio se anota y lo gestiona la siguiente ejecución del cron.
Conservar los datos al desinstalar Desactivado Desactivado: la desinstalación revoca las conexiones con Google y elimina las tablas del módulo.

Seguridad y permisos

  • OAuth 2.0 con PKCE y un parámetro state aleatorio, de un solo uso, válido durante 15 minutos y vinculado al empleado y a su navegador; el código se intercambia dentro de la sesión del empleado.
  • Secreto de cliente, token de acceso y token de actualización cifrados en la base de datos; nunca se muestran ni se escriben en los registros.
  • Desconectar revoca la autorización en Google. Si Google rechaza la autorización guardada (acceso revocado, contraseña cambiada, aplicación en estado «En fase de pruebas»), la tienda pasa a «reconexión necesaria», se crea una alerta y no se realiza ninguna llamada más.
  • Permisos por pestaña: un perfil con solo el permiso «Ver» puede consultarlo todo pero no modificar nada. Token CSRF en todas las acciones.
  • Multitienda: cada tienda tiene su conexión, su propiedad, sus datos, sus ajustes y sus alertas.
  • Cron: token comparado en tiempo constante, bloqueo contra ejecuciones simultáneas, respuesta sin detalles internos. El controlador de retorno de Google y el cron siguen siendo accesibles en modo mantenimiento.

Resolución de problemas

redirect_uri_mismatch en la pantalla de Google

La dirección de redireccionamiento registrada en Google Cloud no es estrictamente idéntica a la del módulo (http/https, www, ruta). Cópiela de nuevo con el botón Copiar.

La conexión se interrumpe al cabo de 7 días

La aplicación OAuth sigue en estado «En fase de pruebas» en Google: publíquela («En producción») y vuelva a conectar la tienda.

«Google Search Console API no está activada»

Active la API en la biblioteca del proyecto de Google Cloud, espere unos minutos y pruebe la conexión.

Ningún producto en los informes

Compruebe que la propiedad cubre la dirección de la tienda. Si la tienda se sirve detrás de un proxy o de una CDN, indique la dirección pública (paso 3).

La cola de inspección está en pausa

Se ha alcanzado la cuota del día (la suya o la de Google) o Google ha pedido que se reduzca el ritmo: la cola se reanuda sola. El botón Reanudar ahora levanta la pausa.

Los correos de alerta no llegan

Compruebe los destinatarios y la configuración de correo de PrestaShop (Parámetros avanzados > Correo electrónico) y use después Enviar un correo de prueba. Si falla el envío, el módulo reintenta como máximo cada 6 horas.

Datos y desinstalación

Tablas ps_dfgsc_* (conexión, propiedades, totales diarios, páginas, consultas, pares página-consulta, correspondencia de URL, inspecciones, cola, cuotas, sitemaps, alertas, historial de tareas) y claves DFGSC_*. La desinstalación revoca las conexiones con Google y elimina estos datos, salvo que esté activado «Conservar los datos al desinstalar». Chart.js 4.4.0 (licencia MIT) se incluye y se carga únicamente en las páginas del módulo que muestran gráficos.

¿Te ha resultado útil esta página?

¿Sigues atascado? Contacta con soporte