Riferimento ai requisiti di sistema per l'integrazione con Magento

Cosa imparerai

Scopri i requisiti di sistema per una sincronizzazione ottimale con Magento 1 o 2. L’amministratore del tuo store Magento è responsabile delle specifiche e della configurazione del sistema. Assicurarti che il tuo sistema sia configurato per funzionare con Klaviyo ti consentirà un’esperienza di integrazioni fluida.

Le versioni di Magento 2 inferiori alla 2.4.0 non sono supportate.

Configura le autorizzazioni API

Per un’integrazione Magento 1 esistente, l’utente SOAP API deve avere accesso completo alle risorse. Assicurati che Resource Access sia impostato su All.

Per Magento 2, installa e configura l’estensione Klaviyo, quindi configura OAuth e approva le autorizzazioni API richieste. Segui la guida all’integrazione di Magento 2 per completare la configurazione in Magento e attivare l’integrazione in Klaviyo.

Senza le autorizzazioni API necessarie, Klaviyo non potrà interagire correttamente con le API del tuo negozio Magento, impedendo alle integrazioni di recuperare i dati dal tuo negozio.

Abilita l’accesso agli endpoint API richiesti

Klaviyo richiede i dati da endpoint specifici. Le configurazioni del tuo sistema devono consentire l’accesso a questi endpoint; valuta l’impatto dei controlli di sicurezza o della logica di reindirizzamento dell’URL sull’accessibilità di questi endpoint per Klaviyo. Se Klaviyo non ha accesso agli endpoint API previsti, alcuni o tutti i dati di Magento non potranno sincronizzarsi e vedrai la reportistica degli errori nell’applicazione.

Per Magento 2, il tuo negozio deve avere un hostname accessibile pubblicamente. Consenti a Klaviyo di raggiungere /oauth/token/request e /oauth/token/access per l’autenticazione OAuth, oltre alla REST API in /index.php/rest. Se l’autenticazione non va a buon fine, segui la guida alla risoluzione dei problemi di Magento 2.

Tutto il traffico in uscita delle integrazioni Klaviyo è instradato tramite un insieme di indirizzi IP statici e prevedibili, così puoi avere un elevato livello di certezza che questo traffico provenga da Klaviyo; ti consigliamo di inserire questi indirizzi nell’allowlist.

Capacità di sistema per le richieste API di sincronizzazione dello storico dei dati

Quando attivi l'integrazione, Klaviyo accoda automaticamente richieste API per sincronizzare lo storico dei dati, inclusi i dati dei clienti, i dati degli ordini e il catalogo prodotti. Cerchiamo di farlo rapidamente per consentire ai marketer di utilizzare questi dati nei loro account il prima possibile. Cerchiamo anche di farlo in modo responsabile limitando la concorrenza e gestendo in modo efficiente i nuovi tentativi. Se il tuo negozio ha un volume elevato di dati storici, una capacità di risorse limitata o altre applicazioni che effettuano richieste API consistenti, consigliamo di consultare l’amministratore Magento per assicurarti che l’infrastruttura sia attrezzata per supportare la sincronizzazione dello storico dei dati. Il tuo amministratore potrebbe valutare di aumentare temporaneamente le risorse o applicare l'auto-scaling.

Verifica la validità del certificato SSL

Un certificato SSL autentica digitalmente l’identità di un sito web e consente una connessione crittografata tra un browser web e un server web. Il certificato SSL del tuo sito web è ospitato dal server di origine del sito. Un certificato SSL valido è fondamentale per accettare i pagamenti in modo sicuro, proteggere gli accessi con password e mettere in sicurezza i moduli web. Test del server SSL può essere usato per verificare il certificato SSL di un sito web.

Le integrazioni Magento possono disattivarsi se il certificato SSL del tuo sito web scade. In questo caso, il dominio e i certificati intermedi devono essere aggiornati sul provider di hosting. Se non sei sicuro di dove si trovino i tuoi certificati, contatta il tuo provider di hosting per ricevere assistenza.

Allocazione di memoria del server sufficiente

Lo spazio su disco per prodotti, immagini dei prodotti, e-mail archiviate e pagine di contenuti statici è separato dalla memoria PHP. Uno spazio su disco sufficiente non significa che PHP abbia abbastanza memoria per elaborare le richieste API di Klaviyo.

Ti consigliamo di allocare oltre 1 gigabyte di memoria alla tua integrazione Klaviyo, ma 512 megabyte sono il minimo richiesto. Se il tuo server non può allocare risorse sufficienti per rispondere alle richieste di Klaviyo, si verificheranno errori di integrazione. L’integrazione Klaviyo-Magento inizia con una sincronizzazione dello storico dei dati, quindi ti consigliamo di verificare le impostazioni della memoria in Magento e sul tuo server prima di attivare l’integrazione.

Verifica l’impostazione PHP memory_limit utilizzata dal tuo server web Magento. Il valore predefinito di PHP è 128 megabyte, ma la configurazione del tuo hosting può sovrascriverlo. L’amministratore di Magento può aggiornare questa impostazione in php.ini. Per Magento 2, segui anche le linee guida sulle impostazioni PHP di Adobe.

Usa i timestamp UTC per la sincronizzazione

Klaviyo utilizza il Tempo coordinato universale (UTC) per richiedere i dati recenti di Magento e interpretare i timestamp restituiti dalle API. Timestamp non corretti possono far sì che alcuni record vengano saltati durante la sincronizzazione o che vengano visualizzati nel momento sbagliato in Klaviyo.

Chiedi al tuo amministratore Magento di verificare che i timestamp restituiti dalle API del tuo negozio siano in UTC. Se mancano record recenti o mostrano orari non corretti, controlla questi timestamp e la configurazione del server prima di modificare le impostazioni del fuso orario del tuo negozio.

Risorse aggiuntive