✨ Prestashop - Documentación del nuevo conector

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, utiliza la siguiente documentación: Documentación Prestashop - Conector

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

blobid0.png

  • Aparecerá un mensaje de éxito tras la instalación

blobid1.png

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”.

blobid2.png

 

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 camposClave 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).

blobid4.jpg

Introdúcelos en tu tienda Prestashop en la sección “CONFIGURACIÓN”.

blobid5.jpg

 

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:

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 recolección a través del módulo, ve a la página de configuración en la sección de Recogida de opiniones > Configuración.

Desde esta interfaz, podrás configurar todos los aspectos de tu recolección.

  • Activar la recolección de opiniones de la marca

Esta opción te permite automatizar la recolección de pedidos. Si está marcada, nuestro sistema recuperará los pedidos realizados en tu sitio para enviar solicitudes de opinión. Haz clic en esta opción para desactivarla/activarla.

 

  • 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.

 

  • Activar la recolección de opiniones de productos

Esta opción permite la recolección de opiniones sobre tus productos.

 

  • Retraso en el envío de la solicitud de opinión de productos

Esta opción te permite separar la solicitud de opinión de la marca y la solicitud de opinión del producto en dos correos electrónicos.

blobid11.jpg

 

  • 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.

Aprende más sobre la integración del widget 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: para cada validación de pedido, lo registramos mediante la ejecución del hook actionValidateOrder en nuestra tabla av_orders. Sin embargo, para anticipar la acción de ciertos módulos específicos que modifican el sistema de Prestashop, realizamos una doble verificación y también usamos el hook actionOrderStatusPostUpdate para registrar los pedidos en nuestra tabla.

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.

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

Mis reseñas no se están mostrando

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).

La visualización de mis reseñas de productos está rota

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.

Quiero mover mis reseñas

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}

Mis pedidos no se están recuperando

Verifica la conexión entre nuestra plataforma y tu sitio (cuenta de Opiniones Verificadas > Integración > Configurar mi módulo Prestashop, puedes hacer clic en el botón “Probar conexión” o hacer clic en “Enviar configuración”). Si recibes un mensaje de error, contacta al soporte (solo si tu versión del conector es inferior a 9.0.0).

Verifica si la automatización está activada correctamente en tu cuenta de Opiniones Verificadas > Configuración de colección de reseñas. Verifica que los pedidos que se deben recuperar tengan el mismo estado que el que seleccionaste en tu cuenta de Opiniones Verificadas en la página de configuración del módulo.

Si obtienes una conexión, la automatización está activada y los estados son correctos, contacta al soporte.

 

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0