Referencia de requisitos del sistema de integración de Magento
Objetivos del artículo
Conoce los requisitos del sistema para una sincronización óptima con Magento 1 o 2. El administrador de tu tienda Magento es responsable de las especificaciones y la configuración del sistema. Asegurarse de que el sistema esté configurado para funcionar con Klaviyo permitirá una experiencia de integración fluida.
La integración de Klaviyo con Magento 1 ya no acepta nuevas instalaciones. Soporte de Klaviyo ya no ayuda con solicitudes de Magento 1. La guía de Magento 1 a continuación aplica a las integraciones existentes. Consulta la referencia de datos de Magento 1.
No se admiten las versiones de Magento 2 anteriores a la 2.4.0.
Configura los permisos de la interfaz de programación de aplicaciones (API)
Para una integración existente de Magento 1, el usuario de la interfaz de programación de aplicaciones (API) SOAP necesita acceso completo a los recursos. Asegúrate de que Acceso a recursos esté configurado como Todos.
Para Magento 2, instala y configura la extensión de Klaviyo; luego configura OAuth y aprueba los permisos solicitados de la interfaz de programación de aplicaciones (API). Sigue la guía de integración de Magento 2 para completar la configuración en Magento y habilitar la integración en Klaviyo.
Sin los permisos necesarios de la interfaz de programación de aplicaciones (API), Klaviyo no podrá interactuar correctamente con las interfaz de programación de aplicaciones (API) de tu tienda Magento, lo que impedirá que la integración recupere datos de tu tienda.
Habilitar el acceso a los puntos de conexión de la interfaz de programación de aplicaciones (API) obligatorios
Klaviyo solicita datos de puntos de conexión específicos. Las configuraciones del sistema deben permitir el acceso a estos puntos de conexión; considera el impacto de los controles de seguridad o de la lógica de redirección de URL en la accesibilidad de estos puntos de conexión para Klaviyo. Si Klaviyo no tiene acceso a los puntos de conexión esperados de la interfaz de programación de aplicaciones (API), algunos o todos los datos de Magento no podrán sincronizarse y verás la elaboración de informes de errores en la aplicación.
Para Magento 2, la tienda debe tener un nombre de host accesible públicamente. Permite que Klaviyo acceda a /oauth/token/request y /oauth/token/access para la autenticación OAuth, así como a la interfaz de programación de aplicaciones (API) REST en /index.php/rest. Si la autenticación falla, sigue la guía de solución de problemas de Magento 2.
Todo el tráfico de integraciones saliente de Klaviyo está detrás de un conjunto de direcciones IP estáticas y predecibles, para que puedas tener un alto nivel de confianza de que este tráfico proviene de Klaviyo; recomendamos incluir estas direcciones en la lista de permitidos.
Capacidad del sistema para solicitudes de la interfaz de programación de aplicaciones (API) de sincronización de datos históricos
Cuando activas la integración, Klaviyo pone automáticamente en cola las solicitudes a la interfaz de programación de aplicaciones (API) para sincronizar datos históricos, incluidos registros de clientes, registros de pedidos y el catálogo de productos. Intentamos hacerlo rápidamente para que los especialistas en marketing puedan usar estos datos en sus cuentas lo antes posible. También intentamos hacerlo de forma responsable limitando la concurrencia y gestionando los reintentos de forma adecuada. Si tu tienda tiene un volumen alto de datos históricos, capacidad de recursos limitada u otras aplicaciones que hacen solicitudes sustanciales a la interfaz de programación de aplicaciones (API), recomendamos consultar a tu administrador de Magento para asegurarte de que tu infraestructura esté preparada para admitir la sincronización de datos históricos. Es posible que el administrador quiera considerar aumentar temporalmente los recursos o aplicar el escalado automático.
Si te preocupa el volumen de datos históricos o la capacidad del servidor para manejar un aumento temporal de solicitudes a la interfaz de programación de aplicaciones (API) para obtener estos datos, considera escalar temporalmente los recursos del servidor o aplicar escalado automático.
Verificar la validez del certificado SSL
Un certificado SSL autentica digitalmente la identidad de un sitio web y permite una conexión cifrada entre un navegador web y un servidor web. El certificado SSL de tu sitio web está alojado en el servidor de origen del sitio. Tener un certificado SSL válido es fundamental para aceptar pagos de forma segura, proteger los inicios de sesión con contraseña y proteger el formulario web. Prueba del servidor SSL se puede usar para verificar el certificado SSL de un sitio web.
Las integraciones de Magento pueden deshabilitarse si vence el certificado SSL de tu sitio web. En este caso, el dominio y los certificados intermedios deben actualizarse con el proveedor de hosting. Si no estás seguro de la ubicación de los certificados, comunícate con el proveedor de hosting para recibir ayuda.
Asignación suficiente de memoria del servidor
El espacio en disco para productos, imágenes de productos, correos electrónicos almacenados y páginas de contenido estático es independiente de la memoria de PHP. Tener suficiente espacio en disco no significa que PHP tenga suficiente memoria para procesar las solicitudes a la interfaz de programación de aplicaciones (API) de Klaviyo.
Se recomienda asignar más de 1 gigabyte de memoria a la integración de Klaviyo, pero el mínimo requerido es de 512 megabytes. Si el servidor no puede asignar recursos suficientes para responder a las solicitudes de Klaviyo, se producirán errores de integración. La integración de Klaviyo-Magento comienza con una sincronización de datos históricos, por lo que se recomienda verificar la configuración de memoria en Magento y en el servidor antes de activar la integración.
Revisa la configuración de PHP memory_limit que usa tu servidor web de Magento. El valor predeterminado de PHP es 128 megabytes, pero la configuración de hosting puede anularlo. El administrador de Magento puede actualizar esta configuración en php.ini. Para Magento 2, también sigue la guía de configuración de PHP de Adobe.
Usa marcas de tiempo UTC para sincronizar
Klaviyo usa el Tiempo Universal Coordinado (UTC) para solicitar datos recientes de Magento e interpretar las marcas de tiempo que devuelve la interfaz de programación de aplicaciones (API). Las marcas de tiempo incorrectas pueden hacer que se omitan registros durante la sincronización o que aparezcan en el momento equivocado en Klaviyo.
Pídele al administrador de Magento que verifique que las marcas de tiempo que devuelven las interfaces de programación de aplicaciones (API) de la tienda estén en UTC. Si faltan registros recientes o muestran horas incorrectas, revisa esas marcas de tiempo y la configuración del servidor antes de cambiar la configuración de la zona horaria de la tienda.
Recursos adicionales
- Primeros pasos con Magento 2.x (CE y EE)
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.