Referentie voor systeemvereisten voor Magento-integratie

Wat je leert

Meer informatie over de systeemvereisten voor optimaal synchroniseren met Magento 1 of 2. De beheerder van je Magento-winkel is verantwoordelijk voor de systeemspecificaties en configuratie. Zorgen dat je systeem is geconfigureerd om met Klaviyo te werken, zorgt voor een soepele integratie-ervaring.

Magento 2-versies onder 2.4.0 worden niet ondersteund.

API-machtigingen configureren

Voor een bestaande Magento 1-integratie heeft de SOAP API-gebruiker volledige resourcetoegang nodig. Zorg dat Resourcetoegang is ingesteld op Alle.

Voor Magento 2 installeer en configureer je de Klaviyo-extensie. Vervolgens stel je OAuth in en keur je de aangevraagde API-machtigingen goed. Volg de integratiehandleiding voor Magento 2 om de installatie in Magento te voltooien en de integratie in Klaviyo in te schakelen.

Zonder de benodigde API-rechten kan Klaviyo niet goed communiceren met de API’s van je Magento-store, waardoor de integratie geen gegevens uit je store kan ophalen.

Toegang tot vereiste API-eindpunten inschakelen

Klaviyo vraagt data op bij specifieke eindpunten. Je systeemconfiguraties moeten toegang tot deze eindpunten toestaan; houd rekening met de impact van beveiligingscontroles of URL-omleidingslogica op de toegankelijkheid van deze eindpunten voor Klaviyo. Als Klaviyo geen toegang heeft tot de verwachte API-eindpunten, kan sommige of alle Magento-data niet synchroniseren en zie je foutrapportage in de applicatie.

Voor Magento 2 moet je winkel een openbaar toegankelijke hostnaam hebben. Sta Klaviyo toe om /oauth/token/request en /oauth/token/access te bereiken voor OAuth-authenticatie, evenals de REST API onder /index.php/rest. Als de authenticatie mislukt, volg je de probleemoplossingsgids voor Magento 2.

Al het uitgaande verkeer van Klaviyo-integraties loopt via een set voorspelbare, statische IP-adressen, zodat je met een hoge mate van zekerheid weet dat dit verkeer van Klaviyo komt; we raden aan om deze adressen toe te staan.

Systeemcapaciteit voor API-aanvragen voor synchronisatie van historische gegevens

Wanneer je de integratie activeert, zet Klaviyo automatisch API-verzoeken in de wachtrij om historische gegevens te synchroniseren, waaronder klantrecords, orderrecords en de productcatalogus. We proberen dit snel te doen, zodat marketeers deze gegevens zo snel mogelijk in hun account kunnen gebruiken. We proberen dit ook op een verantwoorde manier te doen door gelijktijdigheid te beperken en retries netjes af te handelen. Als je winkel een groot volume aan historische gegevens heeft, een beperkte resourcecapaciteit, of andere applicaties die substantiële API-verzoeken doen, raden we aan je Magento-beheerder te raadplegen om te zorgen dat je infrastructuur is uitgerust om de synchronisatie van historische gegevens te ondersteunen. Je beheerder kan overwegen om resources tijdelijk te verhogen of auto-scaling toe te passen.

Controleer of het SSL-certificaat geldig is

Een SSL-certificaat verifieert digitaal de identiteit van een website en maakt een versleutelde verbinding tussen een webbrowser en een webserver mogelijk. Het SSL-certificaat van je website wordt gehost door de originserver van de site. Een geldig SSL-certificaat is cruciaal om betalingen veilig te kunnen accepteren, wachtwoordlogins te beschermen en webformulieren te beveiligen. Je kunt SSL Server Test gebruiken om het SSL-certificaat van een website te verifiëren.

Magento-integraties kunnen worden uitgeschakeld als het SSL-certificaat van je website verloopt. In dit geval moeten het domeincertificaat en de intermediate certificates worden bijgewerkt bij de hostingprovider. Als je niet zeker weet waar je certificaten staan, neem dan contact op met je hostingprovider voor hulp.

Voldoende servergeheugentoewijzing

Schijfruimte voor producten, productafbeeldingen, opgeslagen e-mails en pagina's met statische content staat los van PHP-geheugen. Voldoende schijfruimte betekent niet dat PHP genoeg geheugen heeft om de API-verzoeken van Klaviyo te verwerken.

We raden aan om meer dan 1 gigabyte aan geheugen toe te wijzen aan je Klaviyo-integraties, maar 512 megabytes is het vereiste minimum. Als je server niet voldoende resources kan toewijzen om te reageren op verzoeken van Klaviyo, treden er integratiefouten op. De Klaviyo-Magento-integraties beginnen met een synchronisatie van historische gegevens, dus we raden aan om de geheugeninstellingen in Magento en op je server te controleren voordat je de integraties activeert.

Controleer de PHP-instelling memory_limit die wordt gebruikt door je Magento-webserver. De standaardinstelling van PHP is 128 megabyte, maar je hostingconfiguratie kan dit overschrijven. Je Magento-beheerder kan deze instelling bijwerken in php.ini. Volg voor Magento 2 ook de richtlijnen van Adobe voor PHP-instellingen.

Gebruik UTC-tijdstempels voor synchroniseren

Klaviyo gebruikt Coordinated Universal Time (UTC) om recente Magento-data op te vragen en tijdstempels te interpreteren die door de API’s worden geretourneerd. Onjuiste tijdstempels kunnen ervoor zorgen dat records worden gemist tijdens het synchroniseren of op het verkeerde moment in Klaviyo verschijnen.

Laat je Magento-beheerder verifiëren dat de tijdstempels die door de API’s van je winkel worden geretourneerd, in UTC zijn. Als recente records ontbreken of onjuiste tijden weergeven, controleer dan die tijdstempels en je serverconfiguratie voordat je de tijdzone-instellingen van je winkel wijzigt.

Extra hulpbronnen