Référence des exigences système pour les intégrations Magento

Objectif de cet article

Découvrez les exigences système pour une synchronisation optimale avec Magento 1 ou 2. L’administrateur de votre boutique Magento est responsable des spécifications et de la configuration du système. Veiller à ce que votre système soit configuré pour fonctionner avec Klaviyo vous garantira une expérience d’intégrations fluide.

Les versions de Magento 2 antérieures à la 2.4.0 ne sont pas prises en charge.

Configurer les autorisations API

Pour une intégration Magento 1 existante, l’utilisateur de l’API SOAP doit disposer d’un accès complet aux ressources. Assurez-vous que Accès aux ressources est défini sur Toutes.

Pour Magento 2, installez et configurez l’extension Klaviyo, puis configurez OAuth et approuvez les autorisations d’API demandées. Suivez le guide d’intégration Magento 2 pour finaliser la configuration dans Magento et activer les intégrations dans Klaviyo.

Sans les autorisations API nécessaires, Klaviyo ne pourra pas interagir correctement avec les API de votre boutique Magento, ce qui empêchera les intégrations de récupérer les données de votre boutique.

Activez l’accès aux points de terminaison d’API requis

Klaviyo demande des données à partir de points de terminaison spécifiques. Vos configurations système doivent autoriser l’accès à ces points de terminaison ; tenez compte de l’impact des contrôles de sécurité ou de la logique de redirection d’URL sur l’accessibilité de ces points de terminaison pour Klaviyo. Si Klaviyo n’a pas accès aux points de terminaison API attendus, certaines ou toutes les données Magento ne pourront pas être synchronisées, et vous verrez du reporting d’erreurs dans l’application.

Pour Magento 2, votre boutique doit disposer d’un nom d’hôte accessible publiquement. Autorisez Klaviyo à accéder à /oauth/token/request et /oauth/token/access pour l’authentification OAuth, ainsi qu’à l’API REST sous /index.php/rest. Si l’authentification échoue, suivez le guide de dépannage Magento 2.

Tout le trafic sortant des intégrations Klaviyo est acheminé via un ensemble d’adresses IP statiques et prévisibles, afin que vous puissiez avoir un haut niveau de confiance quant au fait que ce trafic provient de Klaviyo ; nous vous recommandons d’autoriser ces adresses.

Capacité du système pour les requêtes API de synchronisation de données historiques

Lorsque vous activez l’intégration, Klaviyo met automatiquement en file d’attente des requêtes d’API pour synchroniser les données historiques, notamment les dossiers clients, les dossiers de commande et le catalogue de produits. Nous essayons de le faire rapidement afin de permettre aux marketeurs d’utiliser ces données dans leurs comptes le plus tôt possible. Nous essayons également de le faire de manière responsable en limitant la simultanéité et en gérant les nouvelles tentatives de manière appropriée. Si votre boutique dispose d’un volume élevé de données historiques, d’une capacité de ressources limitée ou d’autres applications qui effectuent des requêtes d’API importantes, nous vous recommandons de consulter votre administrateur Magento afin de vous assurer que votre infrastructure est équipée pour prendre en charge la synchronisation des données historiques. Votre administrateur peut envisager d’augmenter temporairement les ressources ou d’appliquer une mise à l’échelle automatique.

Vérifiez la validité du certificat SSL

Un certificat SSL authentifie numériquement l’identité d’un site web et permet une connexion chiffrée entre un navigateur web et un serveur web. Le certificat SSL de votre site web est hébergé par le serveur d’origine du site. Un certificat SSL valide est essentiel pour accepter les paiements de manière sécurisée, protéger les identifiants de connexion, et sécuriser les formulaires web. Test de serveur SSL peut être utilisé pour vérifier le certificat SSL d’un site web.

Les intégrations Magento peuvent être désactivées si le certificat SSL de votre site web expire. Dans ce cas, le domaine et les certificats intermédiaires doivent être mis à jour chez le fournisseur d’hébergement. Si vous n’êtes pas sûr de l’emplacement de vos certificats, contactez votre fournisseur d’hébergement pour obtenir de l’aide.

Allocation de mémoire serveur suffisante

L’espace disque pour les produits, les images de produits, les e-mails stockés, et les pages de contenu statique est distinct de la mémoire PHP. Un espace disque suffisant ne signifie pas que PHP dispose de suffisamment de mémoire pour traiter les requêtes API de Klaviyo.

Nous recommandons d’allouer plus de 1 gigaoctet de mémoire à votre intégration Klaviyo, mais le minimum requis est de 512 mégaoctets. Si votre serveur ne peut pas allouer suffisamment de ressources pour répondre aux requêtes de Klaviyo, des erreurs d’intégration se produiront. L’intégration Klaviyo-Magento commence par une synchronisation de vos données historiques. Il est donc recommandé de vérifier les paramètres de mémoire dans Magento et sur votre serveur avant d’activer l’intégration.

Vérifiez le paramètre PHP memory_limit utilisé par votre serveur web Magento. La valeur par défaut de PHP est de 128 mégaoctets, mais la configuration de votre hébergement peut la remplacer. Votre administrateur Magento peut mettre à jour ce paramètre dans php.ini. Pour Magento 2, suivez également les recommandations d’Adobe concernant les paramètres PHP.

Utiliser des horodatages UTC pour la synchronisation

Klaviyo utilise le Temps universel coordonné (UTC) pour demander des données Magento récentes et interpréter les horodatages renvoyés par l’API. Des horodatages incorrects peuvent entraîner l’omission d’enregistrements lors de la synchronisation ou leur affichage au mauvais moment dans Klaviyo.

Demandez à votre administrateur Magento de vérifier que les horodatages renvoyés par les API de votre boutique sont en UTC. Si des enregistrements récents manquent ou affichent des heures incorrectes, vérifiez ces horodatages et la configuration de votre serveur avant de modifier les paramètres de fuseau horaire de votre boutique.

Ressources supplémentaires