Integración con Magento

Se necesita la ayuda de un desarrollador

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.

Descripción general de la integración

Magento es una plataforma de comercio electrónico líder que ayuda a las empresas a gestionar productos, clientes y pedidos a gran escala. Al integrar Magento con Pushwoosh, puede sincronizar automáticamente clientes, pedidos y carritos abandonados para permitir la mensajería en tiempo real, la segmentación dirigida y la automatización del marketing multicanal, ayudándole a interactuar con los usuarios y aumentar las conversiones directamente desde la actividad de su tienda.

Tipo de integración

Destino: Esta integración envía datos desde su tienda Magento a Pushwoosh.

Requisitos previos

Antes de continuar, asegúrese de lo siguiente:

• Acceso al Panel de Administración de Magento

• Una cuenta de Pushwoosh válida

• Su token de acceso a la API y el código de la aplicación de Pushwoosh

• Composer instalado en su servidor Magento

• Requisitos del sistema cumplidos:

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

Glosario

Mapeo de nombres de entidades si son diferentes:

Magento	Pushwoosh
Cliente	Usuario

Lista de entidades sincronizadas:

• Clientes
• Pedidos
• Carritos abandonados

Casos de uso

• Enviar notificaciones push basadas en eventos de creación de pedidos y abandono de carritos.

• Segmentar a los clientes en función de atributos (por ejemplo, ubicación, cumpleaños) y enviar campañas dirigidas.

• Enviar notificaciones promocionales basadas en el navegador.

Configurar la integración

Instalación

Nota

Para instalar la integración de Pushwoosh, asegúrese de tener Composer instalado.

1. Ejecute el siguiente comando de Composer en la raíz de su proyecto Magento:

composer require pushwoosh/magento2-integration

2. Una vez instalado el paquete, ejecute la configuración de Magento para instalar el módulo:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

Configuración posterior a la instalación

Después de completar la instalación:

1. Inicie sesión en el panel de Administración de Magento.

2. Vaya a Tiendas > Configuración > Pushwoosh > Configuración.

Ajustes generales

En la sección General, configure los siguientes campos:

• Estado: Establézcalo en Enable para activar la integración.
• URL de la API: Introduzca el endpoint de la API de Pushwoosh: https://api.pushwoosh.com/
• Clave de la API: Pegue su clave de la API de Pushwoosh necesaria para autenticar las solicitudes. Más información sobre la clave de acceso a la API de Pushwoosh
• Código de la aplicación: Introduzca el código de la aplicación de Pushwoosh correspondiente a su aplicación móvil o web.

A continuación se presentan las opciones de configuración disponibles para sincronizar clientes, pedidos y carritos abandonados.

Configuración de la sincronización de pedidos

Defina cómo se sincronizan los datos de los pedidos entre su tienda Magento y Pushwoosh.

Rellene los siguientes campos:

Activar sincronización de pedidos	Establézcalo en Sí para activar la sincronización automática de pedidos. Si está activado, el proceso seguirá el horario cron definido. Establézcalo en No para desactivar la sincronización automática.
Ajustes de Cron	Disponible solo si la sincronización de pedidos está activada. Defina cuándo debe ejecutarse el trabajo cron utilizando los siguientes campos: Minuto, Hora, Día, Mes, Día de la semana. Cron es un programador basado en tiempo que se utiliza para ejecutar tareas automáticamente a intervalos especificados.
Número de sincronizaciones de pedidos	Especifique cuántos pedidos procesar durante cada ejecución de sincronización.
Sincronización de pedidos en tiempo real	Establézcalo en Sí para sincronizar los pedidos inmediatamente después de su realización.

Aquí también puede ver el estado de la sincronización de pedidos:

• Pedidos totales: Muestra el número total de pedidos evaluados para la sincronización.
• Pedidos sincronizados: Número de pedidos sincronizados con éxito con Pushwoosh.
• Pedidos no sincronizados: Pedidos que aún no han sido sincronizados.
• Pedidos con sincronización fallida: Pedidos para los que los intentos de sincronización han fallado.

Configuración de la sincronización de carritos abandonados

Configure la sincronización de los datos de los carritos de compra abandonados entre su tienda Magento y Pushwoosh.

Rellene los siguientes campos:

Sincronización de carritos abandonados	Establézcalo en Sí para activar la sincronización automática de los datos de los carritos abandonados. Si está activado, la sincronización se ejecuta según el horario cron definido.
Configuración del horario de Cron	Defina cuándo debe ejecutarse la sincronización utilizando los siguientes campos: Minuto, Hora, Día, Mes, Día de la semana. Cron es un programador de trabajos basado en tiempo que ejecuta tareas automáticamente a intervalos especificados.
Número de carritos abandonados	Especifique cuántos carritos abandonados se procesarán durante cada ejecución de sincronización.
Tiempo mínimo de inactividad	Establezca el tiempo mínimo de inactividad (en minutos) para que un carrito se considere abandonado. Por ejemplo, 60 significa que los carritos inactivos durante al menos 60 minutos serán elegibles para la sincronización.

Aquí también puede ver métricas en tiempo real sobre la actividad de sincronización:

• Carritos abandonados totales: Número total de carritos identificados como abandonados.
• Carritos abandonados sincronizados: Número de carritos sincronizados con éxito con Pushwoosh.
• Carritos abandonados no sincronizados: Número de carritos que aún no han sido sincronizados.
• Carritos abandonados con sincronización fallida: Número de carritos para los que la sincronización ha fallado.

Configuración de la sincronización de clientes

Configure la sincronización de los datos de los clientes desde su tienda Magento a Pushwoosh para permitir la segmentación de la audiencia y la mensajería personalizada basada en los atributos del cliente.

Rellene los siguientes campos:

Sincronización de clientes	Establézcalo en Sí para activar la sincronización de todos los registros de clientes existentes y nuevos. La sincronización seguirá el horario cron definido y utilizará los mapeos de atributos especificados.
Configuración del horario de Cron	Defina cuándo debe ejecutarse la sincronización utilizando los siguientes campos: Minuto, Hora, Día, Mes, Día de la semana. Cron es un programador de trabajos basado en tiempo que ejecuta tareas automáticamente a intervalos especificados.
Mapeo de campos personalizados del cliente	Mapee los atributos del cliente de Magento a los campos personalizados de Pushwoosh para una transferencia de datos precisa. Ejemplos: Fecha de nacimiento → Birthday, Nombre → firstName
Número de clientes	Establezca el número máximo de clientes a sincronizar por ejecución de cron.

Aquí también puede ver las estadísticas de sincronización:

• Clientes totales: Número total de registros de clientes identificados para la sincronización.
• Clientes sincronizados: Número de clientes sincronizados con éxito con Pushwoosh.
• Clientes no sincronizados: Clientes pendientes de sincronización.
• Clientes con sincronización fallida: Clientes que no se pudieron sincronizar debido a errores.

Configuración de notificaciones web

Establézcalo en Sí para activar las notificaciones push web para los visitantes de su tienda. Establézcalo en No para desactivar esta funcionalidad.

Cuando está activado, su tienda Magento puede enviar mensajes en tiempo real a los usuarios a través de su navegador. Las notificaciones se pueden utilizar para ofertas promocionales, actualizaciones del estado del pedido, recordatorios de carritos abandonados y otras comunicaciones de marketing.

Guardar configuración

Una vez que todos los campos requeridos estén completos, haga clic en el botón Guardar configuración ubicado en la esquina superior derecha. Limpie la caché de Magento si se le solicita para aplicar los cambios.

Opciones de sincronización manual

Sincronizar clientes seleccionados con Pushwoosh

Si prefiere no sincronizar todos los clientes automáticamente, puede sincronizar manualmente clientes individuales o seleccionados.

1. En el Panel de Administración de Magento, vaya a Clientes > Todos los clientes.
2. Localice y seleccione el/los cliente(s) que desea sincronizar.
3. En el menú desplegable Acciones sobre la lista de clientes, elija Sincronizar con Pushwoosh.

Una vez que se complete la sincronización, los datos del cliente aparecerán en la sección User Explorer de su cuenta de Pushwoosh, con toda la información relevante transferida desde Magento.

Sincronizar pedidos seleccionados con Pushwoosh

Si prefiere no sincronizar todos los pedidos automáticamente, puede sincronizar manualmente pedidos específicos. Para ello:

1. En el Panel de Administración de Magento, vaya a Ventas > Pedidos.

2. Seleccione uno o más pedidos de la lista.

3. En el menú desplegable Acciones, elija Sincronizar con Pushwoosh.

Después de la sincronización, el pedido aparecerá en la sección de Eventos del perfil del usuario en el User Explorer de Pushwoosh como un evento PW_OrderCreated o PW_OrderUpdated (si el estado del pedido ha cambiado), incluyendo información detallada del pedido.

Sincronizar carritos abandonados seleccionados

Para sincronizar manualmente los carritos abandonados seleccionados:

1. En el Panel de Administración de Magento, vaya a la sección Carritos abandonados.
2. Seleccione el carrito que desea sincronizar.
3. En el menú desplegable Acciones, elija Sincronizar con Pushwoosh.

Nota: Asegúrese de haber configurado el período de inactividad requerido en los ajustes de Sincronización de carritos abandonados para determinar cuándo se considera que un carrito está abandonado.

Después de la sincronización, los datos del carrito abandonado aparecerán en la sección Eventos del perfil del usuario en el User Explorer de Pushwoosh como un evento PW_AbandonedCart con información detallada.

Además, se establecerán dos tags en el perfil del usuario:

• Fecha del carrito abandonado → PW_AbandonedCartDate
• ID del carrito abandonado → PW_AbandonedCartID

Estos tags se pueden utilizar para enviar recordatorios de carritos abandonados utilizando contenido conectado en sus plantillas de correo electrónico. Más información

Verificar que la integración funciona

Para confirmar que la integración funciona correctamente:

1. Cree un cliente de prueba en Magento.
2. Sincronice manualmente el cliente con Pushwoosh.
3. Abra el User Explorer en su panel de control de Pushwoosh y busque al cliente.

Si el cliente aparece en el User Explorer, indica que la sincronización fue exitosa.