Introducción a Magento 2.x (CE y EE)

Qué aprenderás

Aprende a integrar Klaviyo con tu tienda de Magento 2 CE o EE. Tendrás que instalar la extensión de Klaviyo en Magento, configurarla y configurar OAuth, y luego habilitar la integración en Klaviyo. Esta guía cubre todos los pasos de integración requeridos, así como cómo confirmar que la sincronización de tus datos históricos sea correcta.

Antes de empezar

Ten en cuenta que las versiones de Magento 2 inferiores a la 2.4.0 no son compatibles.

Para asegurarse de que Klaviyo puede realizar las llamadas a la API necesarias para la integración, su servidor Magento 2 debe tener un nombre de host accesible públicamente. Los servidores Magento 2 alojados localmente no podrán integrarse completamente con Klaviyo.

Te recomendamos encarecidamente que añadas direcciones IP de Klaviyo a la lista de permitidos de tu proveedor de cortafuegos para minimizar los problemas de autenticación y configuración. Para obtener más información, consulta Cómo realizar una lista de permitidos de las direcciones IP de tráfico de la integración de Klaviyo.

La extensión de Magento 2 de Klaviyo debe instalarse a través de Composer. Ten en cuenta que la instalación a través de Composer requiere un administrador de TI con acceso SSH al servidor donde se aloja Magento 2.

Instale la extensión Klaviyo en Magento 2

1. Inicie sesión en su servidor Magento 2 y navegue hasta el directorio raíz de su aplicación Magento desde su herramienta de línea de comandos. Esta guía muestra salidas de ejemplo para Terminal, pero estos pasos pueden modificarse para cualquier herramienta de línea de comandos de su elección.
2. Ejecuta el siguiente comando para acceder a la última versión de la extensión de Klaviyo desde Packagist. Packagist es un repositorio de bibliotecas de código PHP que te permite instalar fácilmente la última versión de la extensión. Los compositores necesitan la extensión Klaviyo/Magento2
3. Ejecuta el siguiente comando para habilitar la extensión de Klaviyo que acabas de descargar: php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
   
4. Como se muestra en la salida de muestra, ahora debes habilitar cualquier módulo adicional. Ejecuta el siguiente comando para habilitarlos: php bin/magento setup:upgrade
5. Busca el módulo «Klaviyo_Reclaim» en la salida para confirmar que el módulo Klaviyo esté activado y en ejecución.
6. Para asegurarte de que el CSS y el JS de tu tienda de Magento 2 sigan funcionando correctamente, tendrás que ejecutar un comando de despliegue de contenido estático. PHP BIN/Magento setup:static-content:deploy -f
   
7. Ahora puede volver al panel de administración de Magento desde su navegador.

¡La instalación a través de Composer se ha completado! Pase a la siguiente sección para ver las instrucciones de configuración.

Configurar la extensión Klaviyo

Vídeo de instrucciones

1. En tu cuenta de Klaviyo, ve a la pestaña Claves de API.
2. En una nueva pestaña, navegue hasta el admin de su tienda Magento.
3. En Configuración, haga clic en Almacenes > Configuración.
4. En el menú desplegable de Klaviyo, haga clic en General.
5. Establezca Habilitar extensión Klaviyo en Sí.
6. Copie su clave de API pública de Klaviyo de seis dígitos de la pestaña de claves de API y péguela en la casilla correspondiente en Magento.
7. En la pestaña Claves API de Klaviyo, genere una nueva clave privada y péguela en la casilla correspondiente de Magento. La autenticación con su clave API privada le permitirá sincronizar las suscripciones a boletines desde Magento a Klaviyo.

En la siguiente sección, configurará OAuth, que habilita otros aspectos de la integración.

Configurar OAuth

A continuación, habilitarás la autenticación OAuth para conectar de forma segura tu cuenta de Klaviyo con la extensión de Magento 2.

1. Vaya a la pestaña Configurar OAuth en Magento.
2. Dale a tu integración un nombre memorable, ya que tendrás que localizarla con este nombre más adelante.
3. Haz clic en Guardar configuración para continuar.
   
4. Localiza System en el panel de navegación izquierdo y selecciona Integrations from the System tray.
5. Localiza el nombre de tu integración y haz clic en Activar. Al activar la integración, se abrirá una ventana en la que se te pedirá que apruebes el acceso.
   
6. Haz clic en Permitir que se te redirija a Klaviyo, donde completarás la configuración de la integración.
   
7. Inicia sesión en Klaviyo si se te solicita, o confirma que el nombre de tu cuenta sea correcto y haz clic en Integrar. Esto añadirá la integración de Magento 2 a la cuenta de Klaviyo asociada a la Clave de API que utilizaste para la configuración. Si has iniciado sesión en varias cuentas de Klaviyo y no se muestra la cuenta correcta, cierra sesión en cualquier otra sesión.

Si la ventana se cierra automáticamente, la conexión se ha realizado correctamente. También puedes confirmar el éxito abriendo tu cuenta de Klaviyo en una nueva pestaña o ventana del navegador, seleccionando la pestaña de integraciones y buscando Magento 2 en la lista.

Si recibes el siguiente error, asegúrate de que las Claves de API utilizadas en el primer paso correspondan a la cuenta en la que has iniciado sesión.

Al establecer la conexión entre Magento y Klaviyo, si en su lugar recibe una lista de errores, puede hacer clic en cada error para saber más sobre la causa.

Establecer una lista de boletines

A continuación, seleccionará una lista de Klaviyo para sincronizar los suscriptores de su boletín. También tiene la opción de utilizar la configuración de opt-in de Klaviyo o la configuración de opt-in de Magento 2 para la lista que elija.

1. En Magento, haga clic en Boletín.
2. Seleccione en el desplegable la lista de Klaviyo con la que desea sincronizar su formulario de registro de Magento.
3. Haz clic en Guardar configuración.

Habilitar el consentimiento en el pago

A continuación, puede optar por activar el consentimiento en la caja para el correo electrónico y los SMS.

Ten en cuenta que, si activas el consentimiento en la página de pago, también tendrás que activar los webhooks (más abajo) para que el consentimiento en la página de pago funcione correctamente.

1. En la página de configuración, en Klaviyo, ve a Consentimiento en la página de pago.
   
2. Verás una sección para recopilar el Consentimiento para enviar SMS para enviar correos electrónicos. Los dos se tratan por separado, por lo que solo se pueden recopilar correos electrónicos, SMS o ambos. Si reúnes suscriptores de SMS y de correo electrónico, elige una lista diferente para SMS que para correo electrónico. Esto garantiza que el consentimiento siempre se atribuya correctamente al canal correcto.
   
   • El consentimiento no se sincronizará (tanto para el correo electrónico como para el SMS) hasta que el cliente termine de realizar el pedido y, si procede, confirme su suscripción debido al doble opt-in.
   • Tenga en cuenta que para los usuarios que ya hayan iniciado sesión en su tienda Magento 2, la casilla de verificación de consentimiento por correo electrónico no aparecerá por defecto en el proceso de pago.
3. En Correo electrónico, selecciona Sí para Suscribir contactos al marketing por correo electrónico en la página de pago.
4. Seleccione una lista de correo electrónico para sincronizar los suscriptores, como un boletín de noticias.
5. Introduce el texto de la casilla de suscripción al correo electrónico que quieras usar.
   
6. En SMS, selecciona Sí para suscribir contactos al Marketing por SMS en la página de pago.
7. Elige la lista a la que quieras que se sincronicen tus contactos de SMS. Para obtener más detalles sobre estos ajustes, consulta nuestra guía para obtener el Consentimiento para enviar SMS en la página de pago.
   
8. El orden de clasificación le permite cambiar la colocación de las casillas de consentimiento por correo electrónico y SMS. Por defecto, estas casillas aparecen bajo el primer campo de entrada de correo electrónico y el campo de número de teléfono de envío, respectivamente. Por lo tanto, si no ha reorganizado la página de pago, no necesita cambiar el orden de clasificación. Si ha cambiado la disposición, ajuste el orden de clasificación en consecuencia.
9. Cuando hayas terminado, haz clic en Guardar configuración en la parte superior derecha.

Habilitar webhooks

A continuación, habilitarás los webhooks de Klaviyo en tu cuenta de Magento 2. Ten en cuenta que, para que el webhook en la página de pago funcione correctamente, debes habilitarlo.

1. Desde el panel de control del administrador, vaya a Tiendas > Configuración.
2. Haz clic en Klaviyo y selecciona la pestaña de Webhooks .
3. Crea un secreto de webhook e introdúcelo en el campo Secreto de Webhook correspondiente. El secreto de webhook es una clave que Klaviyo utilizará para la validación. Este secreto puede ser cualquier cosa que elijas, pero te recomendamos que crees una cadena segura de letras y números. Magento ocultará tu secreto de webhook con asteriscos por razones de seguridad, así que ten cuidado de introducirlo correctamente. Si estás usando una integración de varias tiendas, el secreto de webhook en este campo debe introducirse en tu configuración predeterminada, y el mismo secreto se utilizará como validación para cada configuración de tienda. El secreto de webhook solo debe añadirse a la configuración predeterminada y no debe añadirse por tienda.
   
4. Junto a los webhooks que quieras activar, selecciona Sí en el menú desplegable. Para obtener más información sobre los webhooks que admite Klaviyo, consulta nuestra guía de webhooks para Magento 2.
5. Haz clic en Guardar configuración.

Habilitar la integración de Magento 2 en Klaviyo

Vídeo de instrucciones

1. Abre Klaviyo y selecciona integraciones en el menú de navegación de la izquierda. Busca Magento 2 en la lista y selecciónalo.
2. En la página siguiente, tendrás la opción de añadir nuevos clientes de Magento 2 a una lista de Klaviyo. Haz clic en la casilla para añadir nuevos clientes de Magento 2 a una lista de Klaviyo y selecciona una lista en el menú desplegable. Ten en cuenta que, al marcar este ajuste, solo se añadirán clientes a la lista seleccionada, pero no se les suscribirá a mensajes de marketing. Este ajuste solo sincronizará a los clientes nuevos; los clientes existentes deben migrarse manualmente de tu lista de Magento a Klaviyo.
   
3. A continuación, selecciona qué vistas de tienda de Magento 2 quieres sincronizar con Klaviyo. De forma predeterminada, todas las vistas de la tienda se sincronizan con Klaviyo. Este ajuste te permite ser selectivo sobre con qué tiendas te integras. Si utilizas el inventario de varias fuentes (MSI) en Magento 2, comprueba las visualizaciones específicas de tiendas de Magento 2 y selecciona las tiendas que quieras sincronizar para ver tu inventario adecuadamente representado en Klaviyo.
4. En Opciones avanzadas, habilita los siguientes ajustes según sea necesario:
   
   • Ajustes de precios especiales Este ajuste se refiere a un precio de venta especial para artículos que, opcionalmente, pueden aplicarse en un intervalo de fechas determinado. Te recomendamos encarecidamente que habilites esta función si tienes previsto usarla, ya que es más difícil habilitarla más adelante. Cuando habilitas Usar precio especial para los precios de los productos cuando corresponda, el bloque de productos mostrará el precio especial cuando corresponda. Si usas un feed de productos dinámico, el precio especial se generará a la hora de envío. Al seleccionar manualmente artículos de tu catálogo, el precio especial se generará una vez que selecciones los productos. Para cada producto, hay 4 campos de metadatos que se sincronizarán:
     • precio (obligatorio, flotante) El precio estándar del artículo.
     • special_price (opcional, flotante) Es un precio de venta especial del artículo. Cuando este precio esté en efecto, verás este special_price junto a un tachado del precio.
     • special_from_date (opcional, fecha) Especifica una fecha de inicio para que se aplique special_price.
     • special_to_date (opcional, fecha) Especifica una fecha de finalización para que special_price esté en vigor.
   • URL raíz de los medios personalizados Este ajuste te permite cambiar la ruta predeterminada para las imágenes de tu sitio. Habilita este ajuste si alojas las imágenes de tus productos en una URL diferente a la de tu sitio web.
5. Pulsa Guardar.

Ahora has activado correctamente la integración de Magento 2. Tus datos comenzarán a sincronizarse con Klaviyo en cuestión de minutos.

Una vez completada la sincronización inicial de los datos históricos, la integración con Magento 2 se sincroniza cada 30 minutos.

Datos sincronizados con la integración de Magento 2

La integración Magento 2 de Klaviyo extrae información clave de los clientes de su plataforma Magento.

Estos son algunos de los datos que sincronizamos desde Magento:

• Información del cliente, incluyendo nombre, apellidos y ubicación.
• Datos de ventas y pedidos, incluidos los artículos comprados, las imágenes de los artículos, las categorías de los artículos y los descuentos aplicados.
• Datos de pedidos cumplimentados, reembolsados y cancelados.
• Cuando las personas visitan su sitio web y qué elementos ven; el seguimiento web es gestionado por la extensión.

Para obtener más información, consulta nuestra referencia de datos de Magento 2.

Convertir los valores de los pedidos de Magento en una única divisa

Klaviyo permite convertir todas las divisas extranjeras de Magento a una divisa principal de Klaviyo. Ponte en contacto con el servicio de asistencia para habilitar esta función. Esto es especialmente útil si tienes varias tiendas con transacciones en diferentes monedas.

Cuando esta función está activada:

• La conversión se produce cuando Magento sincroniza datos de pedidos con Klaviyo.
• Klaviyo comprobará si el order_currency_code es el mismo que el set global_currency_code. De lo contrario, Klaviyo convertirá el total del pedido de la moneda del pedido a la moneda internacional especificada para garantizar que tus análisis financieros sean precisos. Ten en cuenta que los artículos de la línea de pedido permanecerán en el código de moneda del pedido y no se convertirán.

Actualice su extensión

¿Quieres mejorar tu extensión de Klaviyo Magento 2? Sigue las instruccionesdetalladas en la sección Instalar anterior y ejecuta el comando para instalar la última versión. Se sobrescribirá tu versión actual y se completará la actualización. No es necesario que vuelvas a configurar la extensión ni que vuelvas a habilitar la integración en Klaviyo.

Volver a sincronizar el catálogo

Puedes solicitar una resincronización completa de tu catálogo de Magento 2 en cualquier momento. Volver a sincronizar el catálogo puede ayudarte a aprovechar las actualizaciones de Klaviyo en el inventario y las funciones relacionadas con las variantes.

Para volver a sincronizar su catálogo:

1. En Klaviyo, selecciona la pestaña Integraciones.
2. Seleccione su Magento 2 integraciones de la lista.
3. Haz clic en la pestaña Datos.
4. En Sincronizar datos del catálogo, haz clic en Volver a sincronizar.