Qué aprenderás
Aprenda a integrar Klaviyo con su tienda Magento 2 CE o EE. Tendrá que instalar la extensión Klaviyo en Magento, configurar la extensión y establecer OAuth, y después activar la integración en Klaviyo. Esta guía cubre todos los pasos necesarios para la integración, así como la forma de confirmar que la sincronización de sus datos históricos se ha realizado correctamente.
Antes de empezarAntes de empezar
Tenga en cuenta que las versiones de Magento 2 inferiores a la 2.2.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.
Encuentre la versión de su extensión KlaviyoEncuentre la versión de su extensión Klaviyo
Todos los rangos de versiones de la tabla son inclusivos. Todas las extensiones están disponibles para su instalación a través de Composer.
Versión Magento 2 | Versión de la extensión Klaviyo |
2.4.0+ |
4.1.0+ |
2.3.4+ | |
2.3.0 - 2.3.3 | |
2.2.0 - 2.2.11 | |
Por debajo de 2.2.0 |
No se admite |
El proceso de instalación difiere en función de la versión de Magento 2 que esté utilizando.
Si utiliza Magento 2 versión 2.4.0 o superior, siga las instrucciones detalladas en Instalar con Composer más abajo.
Para aquellos en Magento 2 versiones por debajo de 2.4.0: Hemos lanzado parches para que las versiones anteriores de nuestras extensiones sean compatibles con nuestras nuevas API. Los enlaces Github se proporcionan en la tabla anterior, y también están disponibles para su instalación a través de Packagist/Composer. Tendrá que realizar la instalación a través del método que utilice actualmente para instalar extensiones (si es Composer, puede seguir la sección Instalar con Composer más abajo). Si está utilizando Magento 2 versión 2.2.0, también tendrá que habilitar manualmente OAuth después de la instalación.
Instale la extensión Klaviyo en Magento 2Instale la extensión Klaviyo en Magento 2
Vídeo de instruccionesVídeo de instrucciones
Instalar con Composer
- 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.
- Ejecute el siguiente comando para acceder a la última versión de la extensión Klaviyo de Packagist. Packagist es un repositorio de bibliotecas de código PHP que le permite instalar fácilmente la última versión de la extensión.
composer require klaviyo/magento2-extension
- Si necesita instalar una versión anterior de la extensión Magento 2 con Composer, especifique la versión que desea instalar. Por ejemplo
composer require klaviyo/magento2-extension:3.0.4-patch
- Ejecute el siguiente comando para habilitar la extensión Klaviyo que acaba de descargar:
php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
- Como se muestra en la salida de ejemplo, ahora debe habilitar cualquier módulo adicional. Ejecute el siguiente comando para habilitarlos:
php bin/magento setup:upgrade
- Analice la salida del
módulo 'Klaviyo_Reclaim
' para confirmar que el módulo Klaviyo está activado y en funcionamiento. - Para asegurarse de que el CSS y el JS de su tienda Magento 2 siguen funcionando correctamente, tendrá que ejecutar un comando de despliegue de contenido estático.
php bin/magento setup:static-content:deploy -f
- 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 KlaviyoConfigurar la extensión Klaviyo
Vídeo de instruccionesVídeo de instrucciones
- En su cuenta de Klaviyo, navegue hasta la pestaña de claves API.
- En una nueva pestaña, navegue hasta el admin de su tienda Magento.
- En Configuración, haga clic en Almacenes > Configuración.
- En el menú desplegable de Klaviyo, haga clic en General.
- Establezca Habilitar extensión Klaviyo en Sí.
- 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.
- 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 OAuthConfigurar OAuth
A continuación, habilitará la autenticación OAuth para conectar de forma segura su cuenta de Klaviyo con la extensión de Magento 2. Tenemos una guía separada para aquellos con una integración existente que necesiten añadir OAuth. Si está utilizando Magento 2 versión 2.2.0, visite nuestra guía sobre cómo habilitar manualmente OAuth para su integración.
- Vaya a la pestaña Configurar OAuth en Magento.
- Dé a su integración un nombre memorable, ya que necesitará localizarla por este nombre más adelante.
- Haga clic en Guardar configuración para continuar.
- Localice Sistema en el panel de navegación izquierdo y seleccione Integraciones en la bandeja Sistema.
- Localice el nombre de su integración y haga clic en Activar. Al activar la integración se abrirá una ventana solicitándole que apruebe el acceso.
- Haga clic en Permitir para ser redirigido a Klaviyo, donde completará la configuración de la integración.
- Inicie sesión en Klaviyo si se le solicita, o confirme que el nombre de su cuenta es correcto y haga clic en Integrar. Esto añadirá la integración de Magento 2 a la cuenta de Klaviyo asociada a la clave API que utilizó para la configuración. Si ha iniciado sesión en varias cuentas de Klaviyo y no se muestra la cuenta correcta, cierre la sesión de las demás.
Si la ventana se cierra automáticamente, la conexión se ha realizado correctamente. También puede confirmar el éxito abriendo su cuenta de Klaviyo en una nueva pestaña o ventana del navegador, haciendo clic en el nombre de su cuenta en la esquina inferior izquierda, luego seleccionando Integraciones y buscando Magento 2 en la lista.
Si en su lugar recibe el siguiente error, asegúrese de que las claves API utilizadas en el primer paso corresponden a la cuenta con la que está conectado en ese momento.
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 boletinesEstablecer 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.
- En Magento, haga clic en Boletín.
- Seleccione en el desplegable la lista de Klaviyo con la que desea sincronizar su formulario de registro de Magento.
- Hagaclic en Guardar Config.
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.
Tenga en cuenta que si habilita el consentimiento en el pago, también tendrá que habilitar los webhooks (más abajo) para que el consentimiento en el pago funcione correctamente.
- En la página de Configuración, en Klaviyo, navegue hasta Consentimiento en el pago.
- Verá una sección para recabar el consentimiento por correo electrónico y por SMS. Ambos se tratan por separado, de modo que puede recopilar sólo correo electrónico, sólo SMS o ambos. Si reúne tanto suscriptores de SMS como de correo electrónico, elija una lista diferente para los SMS que para el correo electrónico. Esto garantiza que el consentimiento se atribuya siempre 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.
- En Correo electrónico, seleccione Sí para Suscribir contactos al marketing por correo electrónico en el momento dela compra.
- Seleccione una lista de correo electrónico para sincronizar los suscriptores, como un boletín de noticias.
- Introduzca el texto de la casilla de verificación de inclusión por correo electrónico que desee utilizar.
- En SMS, seleccione Sí para Suscribir contactos al marketing por SMS al finalizar la compra.
- Elija la lista con la que desea sincronizar sus contactos SMS. Para obtener más detalles sobre estos ajustes, consulte nuestra guía para recabar el consentimiento por SMS en el momento del pago.
- 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.
- Cuando haya terminado, haga clic en Guardar configuración en la parte superior derecha.
Habilitar webhooks
A continuación, habilite los webhooks de Klaviyo en su cuenta de Magento 2. Tenga en cuenta que es necesario activar los webhooks para que el consentimiento en el pago funcione correctamente.
- Desde el panel de control del administrador, vaya a Tiendas > Configuración.
- Haga clic en Klaviyo y seleccione la pestañaWebhooks.
- Cree un secreto de webhook e introdúzcalo en el campo Webhook Secretcorrespondiente. El secreto del webhook es una clave que Klaviyo utilizará para la validación. Este secreto puede ser cualquier cosa que elija, pero le recomendamos crear una cadena segura de letras y números. Magento ocultará su secreto webhook con asteriscos por motivos de seguridad, así que tenga cuidado de introducirlo correctamente.
Si está utilizando una integración multitienda, el secreto del webhook en este campo debe introducirse en su configuración por defecto, y el mismo secreto se utilizará como validación para la configuración de cada tienda. El secreto del webhook sólo debe añadirse a la configuración por defecto y no debe añadirse por tienda. - Junto a los webhooks que desee habilitar, seleccione Sí en el desplegable. Para leer más sobre los webhooks soportados por Klaviyo, consulte nuestra guía de webhooks para Magento 2.
- Hagaclic en Guardar Config.
Habilitar la integración de Magento 2 en Klaviyo
Vídeo de instruccionesVídeo de instrucciones
- Abra Klaviyo, haga clic en el nombre de su cuenta en la esquina inferior izquierda y seleccione Integraciones. Busque Magento 2 en la lista y selecciónelo.
- En la página siguiente, tendrá la opción de añadir nuevos clientes de Magento 2 a una lista de Klaviyo. Haga clic en la casilla de verificación Añadir nuevos clientes de Magento 2 a una lista de Klaviyo y seleccione una lista en el desplegable. Tenga en cuenta que al marcar esta opción sólo se añadirán clientes a la lista seleccionada, pero no se suscribirán a los mensajes de marketing.
Este ajuste sólo sincronizará los nuevos clientes; los clientes existentes deben ser migrados manualmente de su lista de Magento a Klaviyo. - En Avanzado, active los siguientes ajustes según sea necesario :
-
Tiendas
Todas las tiendas Magento 2 se sincronizan con Klaviyo por defecto. Este ajuste le permite ser selectivo sobre las tiendas con las que se integra. Diríjase a Apoyo a varias tiendas Magento para obtener más información. -
Ajustes de precios especiales
Este ajuste se refiere a un precio de venta especial para artículos que puede entrar en vigor opcionalmente en un determinado intervalo de fechas. Le recomendamos encarecidamente que habilite esta función si piensa utilizarla, ya que es más difícil habilitarla posteriormente. Si activa la opción Utilizar precio especial para los precios de los productos cuando corresponda, el bloque de productos mostrará el precio especial cuando corresponda. Si utiliza un feed de productos dinámico, el precio especial se rellenará en el momento del envío. Cuando seleccione manualmente artículos de su catálogo, el precio especial aparecerá una vez que haya seleccionado el/los producto(s). Para cada producto, hay 4 campos de metadatos que se sincronizarán:
-
precio
(Obligatorio, flotante) El precio estándar del artículo. -
precio_especial
(Opcional, flotante) Se trata de un precio de venta especial para el artículo. Cuando este precio esté en vigor, verá este special_price junto a un tachado del precio. -
fecha_de_especial
(Opcional, fecha) Especifica una fecha de inicio para que el precio_especial entre en vigor. -
especial_hasta_fecha
(Opcional, fecha) Especifica una fecha de finalización de la vigencia de special_price.
-
precio
-
URL raíz multimedia personalizada
Este ajuste le permite cambiar la ruta predeterminada para las imágenes de su sitio. Habilite esta configuración si aloja las imágenes de sus productos en una URL diferente a la de su sitio web.
-
Tiendas
- Pulse Guardar.
¡Ya ha habilitado correctamente la integración con Magento 2! Sus 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 2Datos 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 saber más, diríjase a nuestra referencia de datos de Magento 2.
Convertir los valores de los pedidos de Magento en una única divisaConvertir los valores de los pedidos de Magento en una única divisa
Klaviyo soporta la conversión de todas las monedas extranjeras en Magento a una moneda primaria en Klaviyo - por favor contacte con soporte para habilitar esta característica. Esto es especialmente útil si tiene varias tiendas con transacciones en distintas divisas.
Cuando esta función está activada:
- La conversión se produce cuando Magento sincroniza los datos del pedido en Klaviyo.
- Klaviyo comprobará si el order_currency_code es el mismo que el global_currency_codeestablecido. Si no es así, Klaviyo convertirá el total del pedido de la moneda del pedido a la moneda global especificada para garantizar que sus análisis financieros sean precisos. Tenga en cuenta que las partidas del pedido permanecerán en el código de moneda del pedido y no se convertirán.
Actualice su extensión
Consulte la tabla siguiente: ¿está utilizando una versión de extensión inferior a la especificada para su versión de Magento 2? Si es así, le recomendamos que actualice su extensión inmediatamente. Algunas versiones antiguas de la extensión utilizan las API v1 y v2 de Klaviyo, que se han retirado y ya no funcionan como se esperaba. Proporcionamos versiones parcheadas específicas para ayudar a los clientes de versiones anteriores de Magento 2, que están enlazadas en la tabla.
En primer lugar, determine a qué versión de extensión necesita actualizarse utilizando la tabla siguiente.
Todos los rangos de versiones de la tabla son inclusivos. Todas las extensiones están disponibles para su instalación a través de Composer.
Versión Magento 2 |
Versión actual de la extensión Klaviyo |
Actualizar la versión de la extensión Klaviyo |
2.4.0+ |
4.1.0+ |
No necesita actualización |
2.4.0+ |
4.0.0 - 4.0.12 |
4.1.0+ |
2.3.4+ |
3.0.5 - 3.0.11 | |
2.3.0 - 2.3.3 |
3.0.4 | |
2.2.0 - 2.2.11 |
2.2.0 | |
Por debajo de 2.2.0 | N/A | No se admite |
Ahora que ha determinado a qué versión debe actualizarse, es el momento de hacerlo. El proceso de actualización difiere en función de la versión de Magento 2 que esté utilizando.
Si está utilizando Magento 2 versión 2.4.0 o superior, siga las instrucciones detalladas en Instalar con Composer más arriba y ejecute el comando para instalar la última versión. Esto sobrescribirá su versión actual y su actualización estará completa - no hay necesidad de volver a configurar la extensión o volver a activar la integración en Klaviyo.
Para aquellos en Magento 2 versiones por debajo de 2.4.0: Hemos lanzado parches para que las versiones anteriores de nuestras extensiones sean compatibles con nuestras nuevas API. Los enlaces Github se pueden encontrar en la tabla anterior, y también están disponibles para su instalación a través de Packagist/Composer. Tendrá que instalar a través del método que utilice actualmente para instalar extensiones (si es Composer, puede seguir la sección Instalar con Composer de más arriba).
Recursos adicionales