Tienes la opción de automatizar la transmisión de prueba de compra y servicios a través del CMS Prestashop.
Esta documentación es válida solo para clientes que tienen la última versión de la plataforma de Opiniones Verificadas.
Si no tienes esta página, usa esta documentación.
Si estás actualizando tu conector Prestashop a la versión 9, consulta este artículo que detalla las especificidades de esta actualización.
Cómo funciona
Una vez que el módulo está instalado y configurado, todo es automático: Opiniones Verificadas se comunica directamente con tu solución de e-commerce.
- Recuperación automática de pedidos y solicitudes de opinión: El módulo comunica tus últimos pedidos directamente a nosotros. Nuestra plataforma recupera los pedidos para los cuales necesitamos enviar solicitudes de opinión, según la configuración establecida durante la instalación descrita más adelante en este documento.
- Mostrar opiniones de productos en tu sitio: El módulo te permite mostrar las opiniones de productos recogidas en nuestra plataforma directamente en tus páginas de productos, tranquilizando a tus clientes sobre la calidad de tus productos.
Instalación del módulo
- Inicia sesión en tu panel de administración de Prestashop
- Haz clic en el Catálogo de Módulos y busca "netreviews", aparecerá el módulo "Opiniones Verificadas", o haz clic aquí
- Haz clic en Instalar
- Aparecerá un mensaje de éxito tras la instalación
Acceder a la Configuración
Configuración Inicial:
Para configurar el módulo en el entorno de Prestashop, dirígete al menú “Módulos > Gestor de Módulos”, localiza el módulo Opiniones Verificadas en la pestaña “Módulos” y haz clic en “Configurar”.
Antes de configurar, si tienes una instalación multitienda en Prestashop, asegúrate de que el módulo esté activado en el gestor de módulos. Una vez en la página de configuración del módulo, selecciona la tienda relevante utilizando el selector de Prestashop en la parte superior de la página.
Para que nuestra plataforma se comunique con tu tienda, necesitas proporcionar los dos campos “Clave Secreta del Conector” y “Identificador del Sitio Web” que puedes obtener en tu área de cliente de Opiniones Verificadas. Desde el menú “Gestión de Cuentas > Mi Conector de Prestashop”, copia los códigos de integración (ver imagen abajo).
Introdúcelos en tu tienda Prestashop en la sección “CONFIGURACIÓN”.
Haz clic en “Guardar” para activar el módulo en Prestashop. Luego deberás completar la activación del módulo en tu cuenta de Opiniones Verificadas.
Configuración Multilingüe
Si tu Prestashop está en modo multitienda, solo puedes conectar una cuenta de Opiniones Verificadas a una tienda (un id_shop). Si deseas integrar el módulo de Opiniones Verificadas en varias tiendas, necesitas tantas tiendas como cuentas de Opiniones Verificadas (diferentes idWebsite y claves secretas).
Si tu sitio está disponible en diferentes idiomas, puedes optar por activar la configuración multilingüe del módulo. Para ello, necesitas cuentas de Opiniones Verificadas en diferentes plataformas y rellenar la Clave Secreta y el ID del Sitio Web para cada cuenta.
Por ejemplo: si tu sitio está disponible en francés, español, italiano e inglés. Para beneficiarte de la configuración multilingüe, necesitas una cuenta en cada una de nuestras plataformas:
- Opiniones Verificadas FR para Francia
- Opiniones Verificadas para España
- Recensioni Verificate para Italia
- Verified Reviews UK para países de habla inglesa
La configuración multilingüe por defecto sigue el comportamiento siguiente:
- si tu cliente realiza un pedido desde una versión en inglés, los correos electrónicos se enviarán en inglés.
- si tu cliente realiza un pedido desde una versión en español, los correos electrónicos se enviarán en español, etc.
- El módulo también permite, con la personalización del código, mostrar todas las reseñas en todos los idiomas.
Si tu sitio no está disponible en varios idiomas, no actives la configuración multilingüe.
Configuración del Módulo en Opiniones Verificadas
Ahora que tu módulo está instalado y tus códigos están integrados en tu entorno de Prestashop, puedes asegurarte de que el módulo está comunicándose correctamente con nuestra plataforma.
Ve a tu área de cliente de Opiniones Verificadas en el menú
« Gestión de Cuenta > Mi Conector Prestashop».
Códigos de Integración
Como se mencionó en la sección "Configuración de Acceso", necesitas ir a la página « Gestión de Cuenta > Mi Conector Prestashop», copiar los códigos y pegarlos en los campos correspondientes de tu conector.
Configuración de Recolección de Opiniones
Para configurar la recogida a través del módulo, desde el menú lateral izquierdo, ve aRecogida de Opiniones, luego Configuración.
Desde esta interfaz, podrás configurar todos los aspectos de tu recogida.
- Retraso antes de enviar la solicitud de opinión de la marca
Esta opción te permite gestionar el tiempo de espera antes de enviar tus solicitudes de opinión. Este retraso se aplica tan pronto como nuestros servicios reciben un pedido.
- Estados deseados para la recuperación de pedidos
Esta opción te permite elegir el estado o estados que nuestros servicios usarán para recuperar tus pedidos.
- Retraso después de enviar la solicitud de opinión de la marca
Esta opción te permite seleccionar el número de días entre el envío de la solicitud de opinión de la marca y la solicitud de opinión del producto.
- Seguimiento de solicitud de opinión
Esta opción te permite reenviar una notificación a tus clientes pidiéndoles que dejen una opinión. También puedes establecer el tiempo antes de enviar este correo electrónico.
- Extensiones de correo electrónico a excluir
Puedes ingresar en este campo los nombres de dominio a los que no se enviará ninguna solicitud de opinión.
Configuración de la visualización de reseñas de productos
1. Configura el widget del producto
2. Integra el widget del producto
Tienes 2 opciones de integración disponibles:
Para la integración manual del widget, reemplaza cada elemento de datos en el código con los valores apropiados de tu sitio web y atributos del producto.
3. Integra estrellas en las páginas de categorías
Puedes habilitar la visualización de estrellas en las páginas de categorías y/o en la página de inicio desde la página de configuración del módulo de tu cuenta de Prestashop: sección Diseño:
Configuración de la visualización de reseñas de marca
Tienes dos opciones para integrar nuestro widget:
¿Cómo integrar manualmente el widget de marca?
Integración automática de widgets de marca y producto
La integración automática es válida solo para clientes que tienen la última versión de la plataforma de Reseñas Verificadas y solo funciona para integrar un widget flotante.
En cualquier momento, puedes desactivar la integración automática.
Eliminar un widget de marca del back office anula automáticamente cualquier integración automática si estaba en su lugar.
Exportar mis pedidos (versión 9.0.0)
En caso de pérdida temporal de automatización, puedes generar un archivo CSV con tus pedidos pasados para ponerte al día.
Cada exportación contiene un máximo de 5000 pedidos. Una vez realizada la primera exportación, los pedidos incluidos en el archivo se consideran recuperados por nuestros servicios. Por favor, asegúrate de cargar correctamente el CSV en nuestra plataforma.
Para evitar cualquier sobre-solicitud, también asegúrate de que los pedidos en el archivo no estén ya presentes en nuestro sistema.
Detalles de las opciones:
- Desde: puedes recuperar pedidos hasta 12 meses (como se define en nuestros Términos de Servicio).
- Recuperar reseñas de productos: selecciona "sí" si deseas recuperar reseñas de productos para estos pedidos (esencial si deseas encuestar tus productos).
- Exportar pedidos con el estado: puedes seleccionar uno o más estados de recuperación.
Una vez que hayas recuperado el CSV generado, contacta nuestro equipo de Atención al Cliente.
- Panel y agregar hooks
La opción "agregar todos los hooks" te permite volver a adjuntar hooks en caso de que se hayan registrado incorrectamente, por ejemplo. Esta función está disponible desde la versión 1.6.
Recuperación automática de pedidos
Proceso general:
Recuperamos tus pedidos de acuerdo con la configuración que defines en tu cuenta de Opiniones Verificadas "Configuración de Colección de Reseñas".
Puedes rastrear los pedidos recuperados en tu cuenta bajo "Seguimiento de Solicitud de Reseña de Colección de Reseñas".
Cuando también recuperamos los detalles de los productos, la referencia del producto es el ID de Prestashop. Si se deja una reseña sobre el producto, esa reseña se asociará con el ID de Prestashop en tu cuenta de Opiniones Verificadas. Luego aparecerá en el widget del producto que se muestra en la página del producto correspondiente a ese ID de Prestashop.
Hooks de recuperación:
Nuestro sistema de recuperación de pedidos se basa en el sistema predeterminado de Prestashop: con cada validación de pedido, lo registramos ejecutando el hook actionValidateOrder en nuestra tabla av_orders.
Solo los pedidos debidamente registrados en esta tabla son considerados "elegibles" para la transmisión automática a nuestros servicios. La transmisión ocurre cuando un pedido cambia de estado y pasa a uno de los estado(s) de recuperación seleccionados en la configuración.
Para que los pedidos sean transmitidos, el método de cambio de estado en el back-office de Prestashop debe activar el hook actionOrderStatusPostUpdate.
Google Shopping:
Para poder compartir tus reseñas de productos en Google Shopping, necesitamos el GTIN_EAN (Europa) o GTIN_UPC (EE. UU., Canadá) que son los datos más precisos para Google, o si es necesario, el dúo marca + MPN. También es importante proporcionar la marca y el MPN incluso si tienes GTIN: cuanta más información podamos proporcionar sobre tus productos a Google, más fácil será para Google asociar las reseñas con los productos.
Al recuperar pedidos, automáticamente recuperamos información de Google Shopping siempre que estén correctamente llenos en las hojas de producto del catálogo en el Back Office de Prestashop.
Registros y Alertas (a partir de la versión 9.1.0)
Registros
Los registros se guardan durante 7 días en el conector, con una rotación diaria. Por defecto, el módulo registra varios eventos, incluyendo:
- las respuestas de error en las llamadas realizadas a nuestros servicios
- las referencias de los pedidos enviados a nuestros servicios
- la ejecución de los hooks en los que opera el conector
A partir de la versión 9.1.0 del conector, se han introducido dos niveles adicionales de registros. Estos pueden activarse o desactivarse en la sección «Acciones avanzadas».
- Registros avanzados: Están activados por defecto. Te recomendamos mantenerlos activados, ya que facilitan la investigación de posibles problemas. Permiten saber qué otros módulos se han instalado/desinstalado desde la instalación de nuestro módulo y cuáles están conectados a los mismos hooks utilizados por el conector.
- Registros completos para debug: Están desactivados por defecto. Te recomendamos activarlos solo si nuestro equipo de soporte lo solicita. Esta opción permite registrar todos los cambios de estado de cada pedido para investigar posibles problemas con la transmisión de los pedidos.
El botón Exportar registros te permite exportar en un clic un archivo en formato .zip que puedes adjuntar a un ticket de soporte. Nuestro equipo de soporte podrá acceder directamente a los registros del conector para realizar las investigaciones necesarias.
Alertas
En caso de problemas importantes con el conector, este mostrará una alerta en tu cuenta de Prestashop. Desde el panel de control y el gestor de módulos, un mensaje de advertencia te avisará de un posible problema. Un enlace te llevará directamente a la página de configuración del módulo donde podrás consultar los detalles de la alerta. Para cada alerta, se ofrece un enlace a la documentación con acciones iniciales.
4 tipos de errores pueden generar una alerta:
- Error durante la instalación del conector
- Errores en las respuestas de las llamadas realizadas a nuestros servicios
- Imposibilidad de escribir registros
- Inconsistencia entre los estados de recuperación de pedidos seleccionados en la configuración y los cambios de estado en la cuenta de Prestashop: esta alerta puede aparecer si pasan 15 días sin ningún pedido en el/los estado(s) configurado(s).
Recomendaciones técnicas
Esta documentación presenta las opciones disponibles en la última versión del módulo. Siempre se recomienda actualizar tu módulo para beneficiarte de nuevas funciones/correcciones de errores y comprobar regularmente que el conector está transmitiendo correctamente los pedidos realizados en tu sitio.
Actualización del módulo
Si tu módulo ha sido personalizado (sobrescrituras, archivos del módulo modificados, etc.), asegúrate de hacer una copia de los archivos antes de actualizar y prueba la actualización en un sitio de preproducción antes de actualizar tu sitio principal.
Cambios en la estructura de tu sitio (solo si tu versión de conector es inferior a 9.0.0)
Nos comunicamos con tu sitio a través de una URL de API. Esta URL de API corresponde a la ruta al archivo netreviewsApi.php ubicado en la raíz del módulo.
Si mueves el módulo dentro de tus archivos, o si agregas un subdirectorio, asegúrate de comprobar siempre la conexión y contactar al soporte para modificar la URL de API si es necesario.
Por ejemplo: si el dominio de tu sitio es https://monsupersitedetest.com y instalas el módulo en la raíz del sitio, la URL de la API será https://monsupersitedetest.com/modules/netreviews/netreviewsApi.php. Si luego mueves tu tienda a un subdirectorio https://monsupersitedetest.com/shop/, deberás modificar la URL de la API como esta: https://monsupersitedetest.com/shop/modules/netreviews/netreviewsApi.php.
Sincronización de la Configuración de Colección y Visualización de Widgets con tu Sitio Prestashop
Cuando guardas una configuración de colección o habilitas la integración automática de un widget, los cambios pueden tardar hasta una hora en aplicarse.
Si deseas aplicar estos cambios inmediatamente, puedes forzar la sincronización haciendo clic en el botón "Recuperar" en la sección de Acciones Avanzadas de la página de configuración del módulo en el Back Office de Prestashop.
FAQ
Verificación de la referencia del producto:
Como se explicó anteriormente, el módulo de Prestashop usa el ID del producto de Prestashop como referencia del producto. Puedes verificar en tu cuenta de Opiniones Verificadas que tus reseñas estén vinculadas correctamente con los ID de Prestashop.
En otros casos, aquí están los pasos a seguir si las reseñas no se muestran:
1. Verifica la conexión entre nuestra plataforma y tu sitio accediendo a tu cuenta de Opiniones Verificadas, luego a “Gestión de la Cuenta > Mi Conector Prestashop”, donde puedes hacer clic en el botón “Probar conexión”. Si recibes un mensaje de error, contacta al soporte (solo si tu versión del conector es inferior a 9.0.0).
2. Verifica en tu cuenta de Opiniones Verificadas que la integración automática esté activada en “Integrar mis widgets > Activar integración automática”.
3. Haz clic en el botón “Agregar todos los hooks” para volver a registrar los hooks (página de configuración del módulo en el Back-Office de Prestashop > sección DEBUG).
4. Borra todas tus cachés: caché de Smarty y caché de complementos (por ejemplo, Page Cache Ultimate). Al borrar la caché de Smarty, asegúrate de que la opción “No recompilar plantillas” no esté seleccionada.
Si después de todo esto, las reseñas aún no se muestran: es probable que tu tema no incluya los hooks a los que nos conectamos. Puedes insertar manualmente nuestros hooks personalizados en tu plantilla product.tpl:
{hook h='ExtraNetreviews'} para mostrar las estrellas
{hook h='TabcontentNetreviews' product=$product} para mostrar el bloque de reseñas
Con respecto a las estrellas en las páginas de categoría, nuestro módulo se conecta a los hooks:
displayProductListReviews si la versión de Prestashop es < 1.7
displayProductPriceBlock (type="before_price") si la versión de Prestashop es > 1.7
Después de activar esta opción, si las estrellas (en la lista de productos) aún no aparecen: significa que estos hooks no están presentes en tu tema. En este caso, puedes agregar directamente nuestro hook personalizado {hook h='CategorystarsNetreviews' product=$product} en el archivo product-list.tpl (Prestashop < 1.7) o en el archivo de miniaturas de productos (en el tema predeterminado de Prestashop 1.7, la ruta del archivo es themes/classic/templates/catalog/_partials/miniatures/product.tpl).
Esto suele ser un problema de caché.
En la página de configuración del módulo en el Back-Office de Prestashop > sección DEBUG, haz clic en el botón “Agregar todos los hooks” para volver a registrar los hooks y luego borra todas tus cachés: caché de Smarty y caché de complementos (por ejemplo, Page Cache Ultimate). Al borrar las cachés de Smarty, asegúrate de que la opción “No recompilar plantillas” no esté seleccionada.
Nuestras estrellas en las páginas de productos y categorías, así como el bloque de reseñas, generalmente aparecen automáticamente.
Si su posición no es satisfactoria y deseas moverlas, puedes hacerlo siguiendo estos pasos:
1. Desenganchar los hooks relevantes
Para hacerlo, desde la página de configuración del módulo, haz clic en Hooks.
Selecciona la opción “Mostrar hooks invisibles” para ver todos los hooks asociados con el módulo.
Para deshabilitar la visualización automática de estrellas en las páginas de productos, desengancha “displayProductButtons,” “displayLeftColumnProduct” y “displayRightColumnProduct”.
Para deshabilitar la visualización automática del bloque de reseñas en una pestaña en las páginas de productos, desengancha “displayProductExtraContent”.
Para deshabilitar la visualización automática de reseñas en miniaturas de productos en páginas de categoría, desengancha “displayProductPriceBlock” y “displayProductListReviews”.
2. Insertar manualmente nuestros hooks personalizados
Páginas de productos: en tu archivo product.tpl, agrega:
{hook h='ExtraNetreviews'} para mostrar las estrellas
{hook h='TabcontentNetreviews' product=$product} para mostrar el bloque de reseñas
Páginas de categorías: en el archivo product-list.tpl (Prestashop < 1.7) o en el archivo de miniaturas de productos (en el tema predeterminado de Prestashop 1.7, la ruta del archivo es themes/classic/templates/catalog/_partials/miniatures/product.tpl), agrega:
{hook h='CategorystarsNetreviews' product=$product}
1. Verifica la conexión entre nuestra plataforma y tu sitio: desde el menú lateral izquierdo, ve a Opiniones Verificadas, luego Recogida de Opiniones y Configuración. Haz clic en el botón Probar Conexión o en Enviar Configuración. Si recibes un mensaje de error, por favor contacta a nuestro equipo de Care a través del icono de contacto disponible en la parte inferior derecha de la página (solo si tu versión del conector es inferior a la 9.0.0).
2. Verifica que la automatización esté activada correctamente: desde el menú lateral izquierdo, ve a Opiniones Verificadas, luego Recogida de Opiniones y Configuración.
3. Asegúrate de que los pedidos a transmitir tengan los mismos estados que los seleccionados en tu cuenta de Opiniones Verificadas: menú lateral izquierdo, Recogida de Opiniones, y Configuración.
4. Confirma que el método que utilizas para cambiar los estados de los pedidos active correctamente el hook actionOrderStatusPostUpdate.
Una vez realizadas estas comprobaciones, si el problema persiste, por favor contacta a nuestro equipo de Care a través del icono de contacto.