Primeros pasos con Magento 1.x (CE y EE)

Qué aprenderás

Aprenda a integrarse con Magento 1. Klaviyo se integra tanto con Magento 1 CE como con Magento 1 EE. Actualmente somos compatibles con las versiones 1.5 y superiores de Magento.

Hay dos pasos principales para integrar Magento 1 con Klaviyo:

1. Habilitación de la integración de Magento en Klaviyo.
2. Instalación de la extensión Klaviyo en Magento.

Esta guía cubre ambos pasos y las tareas relacionadas para tiendas Magento 1.

Configurar las credenciales API de Magento

La integración de Magento 1.x con Klaviyo requiere crear un nuevo rol con acceso total a los recursos y asignar un nuevo usuario a este rol. El nombre de usuario y la contraseña de este usuario servirán como credenciales de la API.

En su panel de administración de Magento, haga clic en la pestaña Sistema y seleccione Servicios web > SOAP/XML-RPC-Roles.

Seleccione Añadir nuevo rol. A continuación, haga clic en la pestaña Recursos de rol y establezca el Acceso a los recursos en Todos.

Seleccione la pestaña Información del rol, nombre el rol "Klaviyo," y haga clic en Guardar rol.

Haga clic en la pestaña Sistema y seleccione Servicios web > SOAP/XML-RPC-Usuarios.

Seleccione Añadir nuevo usuario.

Haga clic en la pestaña Rol de usuario y establezca el Rol en Klaviyo.

Haga clic en la pestaña Información del usuario. Establezca el nombre de usuario en "klaviyo" e introduzca una clave de API segura. Puede introducir cualquier valor alfanumérico. Guarde el Nombre de usuario y la Clave API ya que los utilizará cuando habilite la integración de Magento 1 en Klaviyo. Rellene el resto de la información y haga clic en Guardar usuario.

Rendimiento de la API

Para mejorar el rendimiento de su integración le recomendamos encarecidamente que habilite el almacenamiento en caché para los dos ajustes de configuración de los servicios web de Magento.

En su panel de administración de Magento haga clic en Sistema > Gestión de caché.

Habilite el almacenamiento en caché en los dos ajustes de configuración de los servicios web.

Habilitar la integración de Magento 1 en Klaviyo

Utilice la clave API de Magento que creó para habilitar la integración de Magento 1 en Klaviyo.

inicia sesión en tu cuenta de Klaviyo y haz clic en integraciones en el navegador de la izquierda. A continuación, haz clic en Añadir integraciones y busca Magento. Haz clic en la tarjeta Magento y, a continuación, en Instalar.

Introduzca la siguiente información:

• URL delsitio
  La URL del sitio es la dirección de su instancia de Magento.
• Nombre de usuario API
  El nombre de usuario que ha creado para su nuevo usuario con permisos API.
• Contraseña / Clave API
  La clave api que ha creado para su nuevo usuario.

Ahora, haga clic en Conectar con Magento. Se le presentarán las siguientes opciones avanzadas, y deberá activarlas según sea necesario:

• Tiendas
  Todas las tiendas Magento 1 se sincronizan con Klaviyo por defecto. Este ajuste le permite ser selectivo sobre las tiendas con las que se integra. Diríjase a Soporte de varias tiendas Magento para obtener más información. 
• Configuración de precios especiales
  Le recomendamos encarecidamente que active la configuración de precios especiales si piensa utilizar esta función. Es más difícil habilitar esta función más adelante. Puede leer más sobre este ajuste en la secciónPrecio especial más abajo.
• Configuración de cupones
  Revise esta guía sobre cómo activar los cupones en Magento 1 y luego rellene estos campos.

Cuando haya terminado, haga clic en Completar configuración.

Magento 1 ya está conectado a Klaviyo. A continuación añadirá la Extensión/Plugin Klaviyo a su cuenta Magento.

Instale la extensión Klaviyo en Magento

La extensión Klaviyo añade a su tienda Magento el seguimiento de Productos Activos en el Sitio y Productos Vistos. También es necesario instalar la extensión Klaviyo para Magento para empezar a sincronizar los eventos de Checkout Started . Es importante sincronizar los eventos de inicio de pago para que puedan activar el flujo de carritos abandonados.

Klaviyo's última extensión para Magento 1 es v.1.9.0, actualizar octubre 2024: Magento 1 v1.9.0 Extensión Descargar.

Después de descargar la extensión en su ordenador, vaya a Sistema > Magento Connect > Magento Connect Manager.

En Carga directa de archivos de paquete haga clic en Elegir archivo y seleccione la extensión que ha descargado anteriormente. Haga clic en Cargar. La extensión se cargará e instalará.

Una vez que haya instalado la extensión, vaya a la página de la extensión para configurar los ajustes.
Haga clic en Sistema > Configuración y, a continuación, haga clic en Klaviyo en la sección Clientes. Si después de hacer clic en Klaviyo aparece un mensaje 404, salga de Magento y vuelva a entrar.

Establezca Activado en Sí y rellene los demás campos. La clave del consumidor, el secreto del consumidor, el token de autorización y el secreto de autorización pueden dejarse en blanco a menos que esté configurando cupones con Magento.

Sincronizar un formulario de inscripción de Magento con una lista de Klaviyo

Opcionalmente puede sincronizar un formulario de registro de Magento para que los usuarios se añadan a una lista de Klaviyo.

En primer lugar, cree una lista en Klaviyo que desee sincronizar con su formulario de registro de Magento.

Si aún no está en la pestaña Configuración general (como se indica en la sección anterior), vaya a Sistema > Configuración , y haga clic en Klaviyo en la sección Clientes.

En el desplegable Lista de suscripción general, seleccione la lista de Klaviyo con la que desea sincronizar.

Por defecto, Usar la configuración Opt-In de Klaviyo para esta lista está establecida en Sí, utilice la configuración de Klaviyo para esta lista. Le recomendamos que mantenga activado este ajuste. Cuando este ajuste está activado:

• Para una lista de doble opt-in: el usuario recibirá un correo electrónico de confirmación antes de ser añadido a la lista designada. Una vez que confirman por correo electrónico, se añaden a la lista y se crea una métrica Suscribirse a la lista. Si no se recibe confirmación, no se añadirán a la lista.
• Para una lista de inclusión única: el cliente se añadirá a una lista y se creará una métrica Suscribirse a la lista.

Si se activa No, no enviar correos electrónicos de suscripción desde Klaviyo, nunca se creará una métrica Suscrito a lista cuando se añada un perfil a una lista. No recomendamos esta configuración, pero está disponible para preservar una configuración heredada.

Configurar una tarea cron de Magento

La extensión Klaviyo utiliza cron jobs para mantenerse al día y ejecutar tareas de mantenimiento periódicas.

Desde el panel de administración de Magento, vaya a Sistema > Configuración.

Desplácese hasta la sección Avanzado y elija Sistema.

A continuación, seleccione Cron (Tareas programadas). Configure un Cron para que se ejecute cada 5 minutos y, a continuación, haga clic en Guardar configuración.

Para obtener más información sobre la configuración de las tareas cron de Magento, consulte la documentación de Magento para obtener información más detallada sobre la configuración de una tarea cron.

Configurar cron en un sistema operativo basado en UNIX

Si tiene acceso shell a su servidor, puede utilizar el comando crontab service. El cron de Magento debe ejecutarse cada cinco minutos, por lo que la configuración horaria es:

*/5 * * * *

La línea completa en crontab se parecerá a una de estas (sugerimos la primera versión):

*/5 * * * /bin/sh MAGENTO_PATH/cron.sh
*/5 * * * /bin/bash MAGENTO_PATH/cron.sh
*/5 * * * /usr/bin/php MAGENTO_PATH/cron.php
*/5 * * * /usr/local/bin/php -f MAGENTO_PATH/cron.php

donde MAGENTO_PATH es la ubicación de su instalación de Magento en el servidor.

Configure cron mediante cPanel (o su proveedor de alojamiento virtual)

Si no tiene acceso al shell puede consultar la documentación de su proveedor de alojamiento virtual. A continuación cubrimos el uso de cPannel como ejemplo.

Acceda al cPanel de su cuenta de alojamiento. Busque la sección Avanzado y haga clic en el icono "Cron Jobs".

Se muestra una lista de los trabajos cron actuales junto con un formulario para añadir un nuevo trabajo. Introduzca los siguientes ajustes en el formulario "Add New Cron Job". Asegúrese de sustituir MAGENTO_PATH por la ruta a su instalación de Magento. Si no está seguro de cuál es la ruta o de cómo encontrarla, puede utilizar un programa FTP para examinar los archivos de su servidor y encontrar el directorio que contiene el archivo cron.sh.

Después de añadir la nueva tarea cron debería ver los datos de pago en Klaviyo en 15 minutos.

Supervisión de la sincronización de datos históricos

Cuando se integre por primera vez con Magento 1, Klaviyo sincronizará los últimos 90 días de sus datos de Magento 1 para que pueda empezar de inmediato a captar a sus clientes más recientes. Tras la sincronización de sus 90 días de datos más recientes, Klaviyo iniciará la sincronización completa de sus datos históricos. Dependiendo del número de pedidos, clientes y productos que tenga su tienda, la sincronización de todos sus datos puede tardar desde unos minutos hasta varios días.

Una vez completada esta sincronización histórica, los nuevos datos se sincronizarán con Klaviyo cada 30 minutos. Para comprobar el progreso de la sincronización inicial, haga clic en la pestaña Análisis de la barra lateral.

Busque la métrica Placed Order y cambie el intervalo de fechas del gráfico para ver qué fechas se han sincronizado completamente. Cuando la sincronización se haya completado, la integración de Magento 1 en lapestaña Integraciones se marcará como completada. Si desea verificar por sí mismo que todos los datos de Magento 1 están sincronizados, puede cotejar el total de pedidos durante unos días o una semana. Antes de empezar a validar, asegúrese de que la zona horaria de su cuenta coincide con la configuración de Magento 1.

Datos sincronizados con la integración de Magento 1

La integración con Magento de Klaviyo le permite extraer cierta información de los clientes de su plataforma Magento para enviar correos electrónicos dirigidos y basados en datos en Klaviyo. Una vez configurada la integración, podrá personalizar y orientar los correos electrónicos en función de la actividad de compra y del sitio web del cliente. Estos son algunos de los datos que sincronizamos desde Magento:

• Información del cliente, incluyendo nombre, apellidos y ubicación.
• Klaviyo sincroniza todos los clientes que se suscriben a su lista de boletines de Magento en adelante. Es importante asegurarse de que cualquier cliente que entre en su lista de boletines de Magento haya dado su consentimiento para recibir correos electrónicos de marketing.
• Datos de pedidos cumplimentados, reembolsados y cancelados.
• Cuándo visitan las personas su sitio web y qué artículos y categorías consultan.
  • Estas métricas se mostrarán en su cuenta como Activo en el sitio y Producto visto.
  • No tendrá que añadir el fragmento de seguimiento de Klaviyo a su sitio con la integración de Magento ya que estas métricas ya son gestionadas por nuestra extensión.

Para saber más, diríjase a Revise y comprenda sus datos de Magento 1.

Crear una clave API con permisos limitados

Esta documentación cubre la API SOAP de Magento en la que se basa la integración de Klaviyo. Recomendamos dar acceso a todos los puntos finales dentro de la ruta /api/*. Aunque lo más probable es que éstos no se correspondan directamente con los permisos que verá al configurar el usuario y el rol SOAP (ya que los permisos han cambiado a lo largo de las distintas versiones 1.x), éstas son las llamadas a la API que hacemos para Magento 1.x:

• catalogCategoryTree
• catalogInventoryStockItemList
• catalogProductAttributeInfo
• catalogProductAttributeMediaList
• catalogProductInfo
• catalogProductList
• catalogProductTagList
• customerCustomerInfo
• clienteListaDeClientes
• customerGroupList
• salesOrderInfo
• salesOrderList
• shoppingCartInfo
• storeList

Si necesita permitir ciertos puertos (si tiene un cortafuegos, por ejemplo), la integración de Magento está actualmente en HTTP/80, pero si está disponible en 443 esto se puede cambiar.

Precio especial

Al configurar los ajustes de su integración, tendrá la opción de tirar de "Precio especial," que se refiere a un precio de venta especial para artículos que opcionalmente puede entrar en vigor en un determinado intervalo de fechas. Para cada producto, hay 4 campos de metadatos que sincronizaremos:

• Precio (flotante obligatorio): El precio estándar del artículo
• precio_especial (flotante opcional): Es el precio de venta especial del artículo. Cuando este precio esté en vigor, verá este special_price junto a un tachado del precio
• special_from_date (Fecha opcional): Especifica una fecha de inicio para que el precio_especial entre en vigor.
• especial_hasta_fecha (Fecha opcional): Especifica una fecha de finalización de la vigencia de special_price .

En la página de ajustes de integración de Magento 1, hay una casilla de verificación para Usar precio especial para los precios de los productos cuando proceda. Cuando este ajuste está activado, el bloque de producto 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).

Convertir 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. Cuando esta función está activada, la conversión se produce cuando Magento sincroniza los datos del pedido en Klaviyo. Esto es especialmente útil si tiene varias tiendas con transacciones en distintas divisas.

Klaviyo comprobará si el order_currency_code es el mismo que el global_currency_code establecido. Si no es así, Klaviyo convertirá el total del pedido de la moneda del pedido a la moneda global especificada en sus ajustes de integración. Esto garantiza que sus análisis financieros sean precisos.

Actualice su extensión

¿Está utilizando una versión de extensión de Magento inferior a la 1.8.3? Le recomendamos que actualice inmediatamente a la versión 1.8.3. Las versiones anteriores de la extensión utilizan las API v1 y v2 de Klaviyo, que están retiradas y ya no funcionan como se esperaba. 

Para actualizar su extensión, elimine la antigua y siga los pasos que se indican en esta guía para volver a instalarla. Puede descargar la versión 1.8.3 aquí: Descarga de la extensión Magento 1 v1.8.3.