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

Objetivos de aprendizaje

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

Antes de empezar

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.

La extensión 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 informático con acceso SSH al servidor donde está alojado 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 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 te permite instalar fácilmente la última versión de la extensión.
   composer require Klaviyo/magento2-extension
3. Ejecuta el siguiente comando para habilitar la extensión Klaviyo que acabas de descargar:
   php bin/Magento module:enable Klaviyo_Reclaim --clear-static-content
4. Como se muestra en la salida de ejemplo, ahora debes activar cualquier módulo adicional. Ejecuta el siguiente comando para habilitarlos:
   php bin/Magento setup:upgrade
5. Examina la salida del módulo "Klaviyo_Reclaim" 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 Magento 2 tienda, comercio sigue 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 Klaviyo, navega hasta la pestaña clave 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, activará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 tus integraciones un nombre memorable, ya que necesitarás localizarlas por este nombre más adelante.
3. Haz clic en Guardar configuración para continuar.
   
4. Localiza Sistema en el panel de navegación izquierdo y selecciona integraciones en la bandeja Sistema.
5. Localiza el nombre de tus integraciones y haz clic en Activar. Al activar las integraciones se abrirá una ventana solicitándote que apruebes el acceso.
   
6. Haz clic en Permitir para ser redirigido a Klaviyo, donde completarás la configuración de las integraciones.
   
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á las Magento 2 integraciones a la Klaviyo cuenta asociada a la clave de API que utilizaste para la configuración. Si has iniciado sesión en varias Klaviyo cuenta y no se muestra la cuenta correcta, cierra la sesión de las demás sesiones.
   

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

Si en lugar de ello recibes el siguiente error, asegúrate de que la clave de API utilizada en el primer paso corresponde a la cuenta a la que estás iniciando sesión.

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

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 el webhook (más abajo) para que el consentimiento en la página de pago funcione correctamente. 

1. En la página Configuración, en KlaviyoNavega hasta Consentimiento en la página de pago.
   
2. Verás una sección para recoger el consentimiento de correo electrónico y consentimiento para enviar SMS. Ambos se tratan por separado, de modo que puedes recopilar sólo correo electrónico, sólo SMS, o ambos. Si reúnes tanto SMS como correo electrónico suscriptor, elige una lista diferente para 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 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 suscribirse a 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. Introduce el texto de la casilla de verificación de inclusión por correo electrónico que deseas utilizar.
   
6. En SMSselecciona Sí para suscribirte a marketing por SMS en la página de pago.
7. Elige la lista con la que quieres sincronizar tu SMS contacto. Para más detalles sobre estos ajustes, paga nuestra guía para recabar 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

1. Desde el panel de administración, navega hasta tienda, comercio > Configuración.
2. Pulsa en Klaviyo y selecciona la pestañawebhook. 
3. Crea un secreto webhook e introdúcelo en el campo Secreto del webhookcorrespondiente. El secreto 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 webhook con asteriscos por motivos de seguridad, así que ten cuidado de introducirlo correctamente.
   
   Si utilizas integraciones multitienda, comercio, el secreto webhook de este campo debe introducirse en tu configuración por defecto, y se utilizará el mismo secreto como validación para cada configuración de tienda, comercio. El secreto webhook sólo debe añadirse a la configuración por defecto y no debe añadirse por tienda, comercio.
4. Junto al webhook que desees activar, selecciona Sí en el desplegable. Para leer más sobre el webhook soportado por Klaviyo, paga nuestra guía sobre webhook para Magento 2.
5. Haz clic en Guardar Config.

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 Añadir nuevo cliente de Magento 2 a una lista de Klaviyo y selecciona una lista en el desplegable. Ten 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.
   
   Esta configuración sólo sincronizará los nuevos clientes; los clientes existentes deben migrarse manualmente de tu Magento lista de Klaviyo a.
3. En Avanzado, activa los siguientes ajustes según sea necesario :
   • tienda, comercio
     Todos los Magento 2 tienda, comercio están sincronizados con Klaviyo por defecto. Esta configuración te permite ser selectivo sobre con qué tienda, comercio te integras. Si utilizas el Inventario multifuente (MSI) en Magento 2, marca Sincronizar sólo tienda, comercio específicos de Magento 2 y selecciona la tienda, comercio que deseas sincronizar para ver tu inventario correctamente representado en Klaviyo.
   • 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. Te recomendamos encarecidamente que habilites estas funciones/características si piensas utilizarlas, ya que es más difícil habilitarlas más adelante. Cuando activas Utilizar precio especial para los precios de los productos cuando proceda, el bloque de producto mostrará el precio especial cuando proceda. Si utilizas una fuente dinámica de productos, el precio especial aparecerá en la hora de envío. Cuando selecciones manualmente artículos de tu catálogo, el precio especial aparecerá una vez que hayas 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) Es el precio de venta especial del artículo. Cuando este precio esté en vigor, verás este precio_especial junto a un precio tachado.
     • 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 precio_especial.
   • Contenido multimedia personalizado URL raíz
     Este ajuste te permite cambiar la ruta por defecto para las imágenes de tu sitio. Activa esta opción si alojas las imágenes de tus productos en una URL diferente a la de tu sitio web. 
4. Haz clic en Guardar.

¡Ya has activado correctamente las integraciones 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, 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 saber más, dirígete a nuestra referencia de datos de Magento 2. 

Convertir Magento valor del pedido en una sola moneda

Klaviyo equipo de asistencia la conversión de todas las monedas extranjeras en Magento a una moneda primaria en Klaviyo. Ponte en contacto con el equipo de asistencia para activar estas funciones/características. Esto es especialmente útil si tienes varias tiendas, comercios con transacciones en distintas monedas.

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

• La conversión se produce cuando Magento sincroniza los datos del pedido con Klaviyo. 
• Klaviyo comprobará si el código_divisa_pedido es el mismo que el código_divisa_globalestablecido. Si no es así, Klaviyo convertirá el total del pedido de la moneda del pedido a la moneda global especificada para garantizar la exactitud de tus análisis financieros. Ten en cuenta que las partidas del pedido permanecerán en el código de moneda del pedido y no se convertirán. 

Actualiza tu extensión

¿Quieres actualizar tu extensión Klaviyo Magento 2? Sigue las instrucciones detalladas en la sección Instalar más arriba y ejecuta el comando para instalar la última versión. Esto sobrescribirá tu versión actual y tu actualización estará completa - no hay necesidad de reconfigurar la extensión o volver a habilitar las integraciones 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 Klaviyo actualizar al inventario y las funciones/características 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.
   
   

Recursos adicionales

• Referencia de datos de Magento 2
• Klaviyo Community: Magento 2 "Pregúntame lo que quieras" Vídeo de preguntas y respuestas