Google Customer Reviews: configuración y ayuda

1. Sube e instala el ZIP mprgooglereviews en Módulos > "Module Manager".
2. Haz clic en "Configure" o abre "Google Reviews" > Configuración > "Configuration".
3. Selecciona el contexto de tienda deseado si usas multitienda.
4. Introduce tu ID de comerciante numérico de Google Merchant Center.
5. Configura "Días de entrega estimados", "Posición de la insignia" y "Idioma de la insignia".
6. Activa "Activar Google Customer Reviews" y guarda.
7. Prueba en una sesión nueva del navegador de cliente con consentimiento de marketing. Completa un pedido de prueba y comprueba su página nativa de confirmación.

Tu cuenta de Google debe estar configurada para usar el programa Customer Reviews. El módulo empieza desactivado con Merchant ID vacío. No crea ni administra tu cuenta de Google.

Los ajustes se heredan de todas las tiendas al grupo y después a la tienda. Guarda en el contexto correcto. Usar los ajustes heredados elimina las sobrescrituras locales cuando está disponible. Para ver los ajustes necesitas permiso de lectura en el back office; guardar requiere además el permiso de edición adecuado y una petición válida.

El módulo carga los scripts del navegador mediante displayHeader y proporciona los datos de la encuesta del pedido mediante displayOrderConfirmation. Muestra la insignia mediante displayBeforeBodyClosingTag, con displayFooter como alternativa en versiones de PrestaShop anteriores a 1.7.

El script de Google solo se carga cuando el consentimiento de marketing, las reglas de tráfico interno, la política de envío de datos y la responsabilidad del módulo lo permiten. Prueba como cliente en lugar de como empleado del back office marcado. Si otro módulo compatible es responsable de Google Customer Reviews para el mismo Merchant ID, este módulo muestra un aviso de responsabilidad y le cede la insignia y la encuesta. Su "Product Review Feed" sigue siendo independiente.

En la página estándar de confirmación del pedido de la tienda, los datos de la encuesta contienen:

• Merchant ID e ID del pedido.
• Correo del cliente y código ISO del país de entrega.
• Fecha de entrega estimada calculada a partir de "Días de entrega estimados".
• Valores GTIN numéricos distintos de 8, 12, 13 o 14 dígitos procedentes de los campos EAN-13 guardados con los artículos comprados, cuando existen. No se comprueba el dígito de control del GTIN.

La respuesta de confirmación se hace privada y no almacenable en caché. Un registro de entrega evita admisiones repetidas para la misma tienda, destino de Google y pedido. Recargar una confirmación antigua no es una forma fiable de repetir una prueba. Usa un nuevo pedido de prueba.

Google controla la interfaz de aceptación, las posteriores invitaciones a opinar, la disponibilidad de la insignia y los requisitos para las valoraciones. No hay un interruptor independiente para ocultar la insignia manteniendo la encuesta activada.

Abre "Google Reviews" > "Product Review Feed". Esta pantalla genera archivos XML públicos de Google Product Reviews con esquema 2.4 a partir de tus reseñas de productos existentes. Es independiente de la recogida de valoraciones del vendedor tras la compra.

Guarda los ajustes y haz clic en "Generar ahora". El panel de estado enumera las URL XML públicas, las reseñas escritas y las omitidas. Los archivos siguen este patrón:

https://example.com/modules/mprgooglereviews/feeds/reviews_1_en.xml

Obtienes un archivo por cada tienda activa habilitada e idioma activo. El mapeo de productos incluye los nombres, URL, GTIN, marca y SKU disponibles. El MPN está disponible donde lo admite el esquema de productos de PrestaShop. Envía a Google las URL XML públicas, no el endpoint de generación.

Mapeo de una "Tabla genérica"

Usa una tabla dedicada a reseñas públicas. Los identificadores de tablas y columnas solo deben contener letras, dígitos y guiones bajos. Puedes incluir u omitir el prefijo de la base de datos de la tienda en "Tabla genérica".

Para una tabla con id_review, id_product, rating, customer_name, title, comment, date_add y active, mapea esos campos. Mantén los valores de escala 1 y 5 para una fuente de cinco estrellas. Esta versión no retiene los mapeos genéricos a la espera de autorizar las columnas públicas ni rechaza los campos privados según su finalidad. Comprueba cada columna mapeada antes de publicar el XML.

El panel "External cron URL" muestra una URL con un token distinto para cada tienda, sin un campo "Cron token" separado. Necesitas permiso de edición y una sesión verificada del navegador en el back office para verla. Trata la URL completa como un secreto.

Envía una petición HTTPS POST. La URL mostrada incluye el token en la cadena de consulta, lo que esta versión acepta. Para no conservarlo en las URL del planificador, elimina el parámetro del token de la URL y envía el mismo valor en el cuerpo POST como token. La cabecera X-MPR-Review-Feed-Token no es compatible.

curl --request POST \
  --data-urlencode 'token=YOUR_SHOP_TOKEN' \
  'https://example.com/index.php?fc=module&module=mprgooglereviews&controller=reviewfeed&id_shop=1'

El endpoint devuelve JSON para esa tienda. GET devuelve 405. Se rechazan los tokens inválidos y las tiendas que no coincidan. Programa una petición independiente para cada tienda que uses.

El proceso PHP necesita acceso de escritura a modules/mprgooglereviews/feeds/. El módulo escribe reglas de acceso que permiten XML y deniegan archivos PHP, temporales y de bloqueo en servidores que respetan esas reglas. Confirma una protección equivalente si tu servidor ignora .htaccess.

• Falta la insignia o la encuesta: comprueba la activación, Merchant ID, consentimiento de marketing, marcadores de empleado y cualquier aviso de responsabilidad. Revisa la consola del navegador y los errores de red.
• Falta la encuesta en un proceso de compra personalizado: confirma que el hook nativo de confirmación recibe un pedido válido. No almacenes en caché ni prerrenderices la respuesta de confirmación.
• Ajustes inválidos: usa un Merchant ID numérico, días de entrega de 0 a 365, una posición de la lista y un código de idioma válido.
• Feed vacío: comprueba la disponibilidad de la fuente, la aprobación, los textos, fechas y puntuaciones de las reseñas, los productos activos y sus URL. Revisa los recuentos de omisiones.
• Falla el feed genérico: comprueba la tabla, los nombres de columnas mapeadas, los campos obligatorios y un ID de reseña estable o una clave primaria. Esta versión no tiene un proceso de autorización de columnas públicas.
• Falla la generación: comprueba la escritura en el directorio, los permisos del empleado sobre las tiendas y si ya hay otra generación en curso.
• Falla el cron: usa POST, el endpoint correcto de la tienda y su parámetro token en la cadena de consulta o el cuerpo POST. No se admite la autenticación solo mediante cabecera.
• No se puede leer la configuración: abre "Google Reviews" > Configuración > "Integrity".

Configura la insignia y la encuesta en los ajustes del módulo. Las sobrescrituras de order-confirmation.tpl y badge.tpl no controlan estos ajustes.

Desactiva "Activar Google Customer Reviews" para detener la insignia y la encuesta. Desactiva "Activar el feed XML de reseñas de productos" por separado para detener nuevas generaciones. Los archivos XML existentes siguen siendo públicos; elimínalos del directorio de feeds cuando quieras retirar un feed.

Desinstala desde "Module Manager" para eliminar el menú y la configuración del módulo. Los feeds XML generados permanecen en el directorio de feeds si conservas los archivos del módulo en disco. Comprueba y elimina los archivos XML públicos que queden. Las valoraciones que ya conserva Google quedan fuera del almacenamiento local del módulo.

Requiere PrestaShop 1.6 o posterior y PHP 7.1 o posterior.