primeros pasos con Magento 2.x (CE y EE)

Objetivos de aprendizaje

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

Antes de empezar

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

Para garantizar que Klaviyo pueda realizar las llamadas a la interfaz de programación de aplicaciones (API) necesarias para las integraciones, tu servidor Magento 2 debe tener un nombre de host accesible públicamente. Los servidores Magento 2 alojados localmente no podrán integrarse plenamente con Klaviyo.

Te recomendamos encarecidamente añadir las IP de Klaviyo a la lista de permisos de tu proveedor de firewall para minimizar los problemas de autenticación y configuración. Para obtener más detalles, consulta Cómo mostrar las direcciones IP del tráfico de 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.

Instala la extensión Klaviyo en Magento 2

1. inicia sesión en tu servidor Magento 2 y navega hasta el directorio raíz de tu aplicación Magento desde tu 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 tu elección.
2. Ejecuta el comando siguiente para acceder a la última versión de la extensión de Klaviyo de Packagist. Packagist es un repositorio de bibliotecas de códigos PHP que te permite instalar fácilmente la última versión de la extensión. El compositor requiere una extensión de Klaviyo/Magento2
3. Ejecuta el comando siguiente 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 comando siguiente para habilitarlos: php bin/magento setup:upgrade
5. Escanea el resultado del módulo 'Klaviyo_Reclaim' para confirmar que el módulo de Klaviyo está habilitado y en ejecución.
6. Para asegurarte de que la CSS y 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 puedes volver al panel de administración de Magento desde tu navegador.

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

Configura la extensión Klaviyo

Video de instrucciones

1. En tu cuenta de Klaviyo, navega hasta la pestaña Claves de API.
2. En una nueva pestaña, navega hasta tu Magento tienda, comercio admin.
3. En Configuración, haz clic en tienda, comercio > Configuración.
4. En el desplegable Klaviyo, haz clic en General.
5. Establece Activar Extensión Klaviyo en Sí.
6. Copia tu clave pública de seis dígitos Klaviyo de la pestaña clave de API y pégala en la casilla correspondiente de Magento.
7. En la pestaña Klaviyo clave de API, genera una nueva clave privada y pégala en la casilla correspondiente de Magento. Autenticándote con tu clave privada de API podrás sincronizar las suscripciones al boletín de Magento a Klaviyo.

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

Configurar OAuth

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

1. Ve 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. Ubica Sistema en el panel de navegación izquierdo y selecciona Integraciones en la bandeja Sistema.
5. Busca el nombre de tus integraciones y haz clic en Activar. Si activas la integración, se abrirá un periodo en el que se te pedirá que apruebes el acceso.
   
6. Haz clic en Permitir que se 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 es correcto y haz clic en Integrar. Esto añadirá la integración de Magento 2 a la cuenta de Klaviyo asociada con la clave de API que utilizaste para la configuración. Si iniciaste sesión en varias cuentas de Klaviyo y no se muestra la cuenta correcta, cierra la sesión de cualquier otra sesión.

Si la ventana se cierra automáticamente, la conexión se realizó 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 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 tienes sesión iniciada actualmente.

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

Establecer una lista de boletines

A continuación, seleccionarás una Klaviyo lista con la que sincronizar tu boletín suscriptor. También tienes 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 elijas.

1. En Magento, haz clic en boletín.
2. Selecciona en el desplegable la lista de Klaviyo con la que quieres sincronizar tu formulario de registro de Magento.
3. Haz clic en Guardar configuración.

Activar el consentimiento en la página de pago

A continuación, puedes optar por activar el consentimiento en la página de pago por correo electrónico y SMS.

Ten en cuenta que si habilitas el consentimiento en la página de pago, también tendrás que habilitar los webhooks (a continuación) para que el consentimiento en la página de pago funcione correctamente.

1. En la página Configuración, en Klaviyo, navega hasta Consentimiento en la página de pago.
   
2. ™Verás una sección para recopilar el consentimiento para enviar correos electrónicos y SMS. Los dos se tratan por separado, de modo que puedes recopilar solo correo electrónico, solo 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 correo electrónico como para SMS) hasta que el cliente finalice el pedido y, en su caso, confirme su suscripción por doble confirmación de suscripción.
   • Ten en cuenta que para los usuarios que ya hayan iniciado sesión en tu Magento 2 tienda, comercio, la casilla de consentimiento de correo electrónico no aparecerá por defecto en la página 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. Selecciona una lista de correos electrónicos con la que sincronizar el suscriptor, como un boletín.
5. Ingresa el texto de la casilla de correo electrónico de registro que deseas utilizar.
   
6. En SMS, selecciona Sí para Suscribir contactos a marketing por SMS en la página de pago.
7. Elige la lista a la que deseas sincronizar tus contactos de SMS. Para obtener más detalles sobre estas configuraciones, consulta nuestra guía sobre cómo recopilar el consentimiento para enviar SMS en la página de pago.
   
8. El orden de clasificación te permite cambiar la ubicació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 tanto, si no has reorganizado la página de pago, no necesitas cambiar el orden de clasificación. Si has cambiado el diseño, ajusta el orden de clasificación en consecuencia.
9. Cuando hayas terminado, haz clic en Guardar configuración en la parte superior derecha.

Activar webhook

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

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

Activa las Magento 2 integraciones en Klaviyo

Video 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 de verificación 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 si marcas esta configuración, solo se añadirán clientes a la lista seleccionada, pero no se suscribirán a los mensajes de marketing. Esta configuración solo sincronizará a los clientes nuevos; los clientes existentes deben migrarse manualmente de tu lista de Magento a Klaviyo.
   
3. A continuación, selecciona las vistas de tienda de Magento 2 que deseas sincronizar con Klaviyo. Todas las vistas de la tienda se sincronizan con Klaviyo de forma predeterminada. Esta configuración te permite seleccionar con qué tiendas te integras. Si utilizas el inventario de múltiples fuentes (MSI) en Magento 2, comprueba las vistas específicas de la tienda Magento 2 y selecciona las tiendas que deseas sincronizar para que tu inventario se muestre correctamente en Klaviyo.
4. En Opciones avanzadas, habilita las siguientes configuraciones según sea necesario:
   
   • Configuración de precios especiales Esta configuración se refiere a un precio de venta especial para artículos que, opcionalmente, puede surtir efecto en un intervalo de fechas determinado. Te recomendamos encarecidamente habilitar esta función si planeas 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. Cuando utilices una fuente de productos dinámica, el precio especial aparecerá a la hora de envío. Al seleccionar manualmente artículos de tu catálogo, el precio especial aparecerá 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, float) Este es un precio de venta especial para el artículo. Cuando este precio esté en vigor, verás este special_price junto a un tachado del precio.
     • special_from_date (Opcional, date) Esto especifica una fecha de inicio para que special_price surta efecto.
     • special_to_date (Opcional, date) Esto especifica una fecha de fin para special_price que está en vigor.
   • URL raíz multimedia personalizada Esta configuración te permite cambiar la ruta predeterminada para las imágenes de tu sitio. Habilita esta configuración si alojas las imágenes de tus productos en una URL diferente a la de tu sitio web.
5. Haz clic en Guardar.

Ya habilitaste correctamente la integración con 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, Magento 2 integraciones se sincroniza cada 30 minutos.

datos sincronizados con las integraciones de Magento 2

Klaviyo's Magento 2 integraciones extrae información clave del cliente de tu 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 tu sitio web y qué elementos ven; el seguimiento web lo gestiona la extensión.

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

Convertir Magento valor del pedido en una sola moneda

Klaviyo admite la conversión de todas las monedas extranjeras en Magento a una moneda principal en Klaviyo. Ponte en contacto con el equipo de asistencia para habilitar esta función. Esto es especialmente útil si tienes varias tiendas con transacciones en diferentes monedas.

Cuando esta función/característica está activada:

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

Actualiza tu extensión

¿Deseas actualizar tu extensión de Klaviyo Magento 2? Sigue las instruccionesdetalladas en la sección Instalar anterior y ejecuta el comando para instalar la versión más reciente. ™ Esto sobrescribirá tu versión actual y tu actualización estará completa. No es necesario que vuelvas a configurar la extensión ni que vuelvas a habilitar la integración en Klaviyo.

Vuelve a sincronizar tu catálogo

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

Para volver a sincronizar tu catálogo:

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