Iniziare con Magento 2.x (CE ed EE)

Imparerai

Scopri come integrare Klaviyo con il tuo negozio Magento 2 CE o EE. Devi installare l'estensione Klaviyo in Magento, configurare l'estensione e configurare OAuth, quindi abilitare l'integrazione in Klaviyo. Questa guida illustra tutti i passaggi di integrazione richiesti e come verificare che la sincronizzazione dello storico dei dati abbia successo.

Prima di iniziare

Tieni presente che le versioni di Magento 2 inferiori alla 2.4.0 non sono supportate.

Per garantire che Klaviyo possa effettuare le chiamate API necessarie per l'integrazione, il suo server Magento 2 deve avere un hostname accessibile pubblicamente. I server Magento 2 ospitati localmente non potranno integrarsi completamente con Klaviyo.

Per ridurre al minimo i problemi di autenticazione e configurazione, ti consigliamo vivamente di aggiungere gli IP di Klaviyo all'elenco degli indirizzi consentiti del tuo provider firewall. Per maggiori dettagli, consulta la sezione Come lista consentita gli indirizzi IP del traffico di integrazione di Klaviyo.

L'estensione Magento 2 di Klaviyo deve essere installata tramite Composer. L'installazione tramite Composer richiede un amministratore IT con accesso SSH al server in cui è ospitato Magento 2.

Installi l'estensione Klaviyo in Magento 2

1. Si colleghi al suo server Magento 2 e navighi nella directory principale della sua applicazione Magento dal suo strumento a riga di comando. Questa guida mostra degli esempi di output per il Terminale, ma questi passaggi possono essere modificati per qualsiasi strumento a riga di comando di sua scelta.
2. Esegui il seguente comando per accedere all'ultima versione dell'estensione Klaviyo da Packagist. Packagist è un repository per le librerie di codici PHP che ti permette di installare facilmente l'ultima versione dell'estensione. per la composizione è necessaria l'estensione Klaviyo/Magento2
3. Esegui il seguente comando per abilitare l'estensione Klaviyo che hai appena scaricato: modulo php bin/magento:enable Klaviyo_Reclaim --clear-static-content
   
4. Come mostrato nell'output campione, ora devi abilitare tutti i moduli aggiuntivi. Esegui il seguente comando per abilitarli: php bin/magento setup:upgrade
5. Scansiona l'output del modulo "Klaviyo_Reclaim" per verificare che il modulo Klaviyo sia abilitato e in esecuzione.
6. Per assicurarti che CSS e JS sul tuo negozio Magento 2 continuino a funzionare correttamente, dovrai eseguire un comando di distribuzione di contenuti statici.€™ php bin/magento setup:static-content:deploy -f
   
7. Ora può tornare alla dashboard amministrativa di Magento dal suo browser.

L'installazione tramite Composer è completa! Proceda alla sezione successiva per le istruzioni di configurazione.

Configurare l'estensione Klaviyo

Come fare un video

1. Nel tuo account Klaviyo, vai alla scheda Chiavi API.
2. In una nuova scheda, si rechi nell'amministrazione del suo negozio Magento.
3. Sotto Impostazioni, faccia clic su Stores > Configurazione.
4. Dal menu a tendina di Klaviyo, faccia clic su Generale.
5. Imposti Abilita estensione Klaviyo su Sì.
6. Copi la sua chiave API pubblica di sei cifre di Klaviyo dalla scheda Chiavi API e la incolli nella casella corrispondente in Magento.
7. Nella scheda Chiavi API di Klaviyo, generi una nuova chiave privata e la incolli nella casella corrispondente in Magento. L'autenticazione con la sua chiave API privata le permetterà di sincronizzare le iscrizioni alla newsletter da Magento a Klaviyo.

Nella prossima sezione, imposterà OAuth, che abilita altri aspetti dell'integrazione.

Impostare OAuth

Successivamente, abiliterai l'autenticazione OAuth per connettere in modo sicuro il tuo account Klaviyo all'estensione Magento 2.

1. Si rechi nella scheda Setup OAuth di Magento.
2. Dai un nome memorabile alla tua integrazione, perché dovrai trovarla con questo nome in un secondo momento.
3. Fai clic su Salva configurazione per procedere.
   
4. Individuare System nel riquadro di navigazione a sinistra e selezionare Integrazioni dalla barra delle applicazioni.
5. Individua il nome della tua integrazione e clicca su Attiva. L'attivazione dell'integrazione aprirà una finestra che richiede la tua approvazione per l'accesso.
   
6. Fai clic su Consenti il reindirizzamento a Klaviyo, dove completerai la configurazione dell'integrazione.
   
7. Accedi a Klaviyo se richiesto o verifica che il nome del tuo account sia corretto e clicca su Integra. Questa operazione aggiungerà l'integrazione di Magento 2 all'account Klaviyo associato alla Chiave API che hai utilizzato per la configurazione. Se hai effettuato l'accesso a più account Klaviyo e l'account corretto non viene visualizzato, esci da qualsiasi altra sessione.

Se la finestra si chiude automaticamente, la connessione è riuscita. Puoi anche confermare il successo aprendo il tuo account Klaviyo in una nuova scheda o finestra del browser, selezionando la scheda Integrazioni e cercando Magento 2 nell'elenco.

Se invece ricevi il seguente errore, assicurati che le Chiavi API utilizzate nel primo passaggio corrispondano all'account a cui hai effettuato l'accesso.

Quando stabilisce la connessione tra Magento e Klaviyo, se invece riceve un elenco di errori, può cliccare su ogni errore per saperne di più sulla causa.

Impostare una lista di newsletter

Successivamente, selezionerà una lista Klaviyo con cui sincronizzare gli iscritti alla newsletter. Ha anche la possibilità di utilizzare le impostazioni opt-in di Klaviyo o le impostazioni opt-in di Magento 2 per la lista scelta.

1. In Magento, faccia clic su Newsletter.
2. Selezioni la lista Klaviyo a cui desidera sincronizzare il suo modulo di iscrizione Magento dal menu a tendina.
3. Fai clic su Salva configurazione.

Abilita il consenso alla cassa

Poi, può scegliere di abilitare il consenso al momento del checkout per le e-mail e gli SMS.

Tieni presente che se abiliti il consenso al momento del pagamento, dovrai anche abilitare i webhook (qui di seguito) per consentire il corretto funzionamento del consenso al momento del pagamento.

1. Nella pagina Configurazione, alla voce Klaviyo, vai su Consenso al momento del pagamento.
   
2. €™Vedrai una sezione per la raccolta del consenso e del Consenso all'invio di SMS all'invio di e-mail. I due vengono trattati separatamente, in modo da poter raccogliere solo e-mail, solo SMS o entrambi. Se raccogli sia iscritti all'SMS sia iscritti alle e-mail, scegli un elenco diverso per l'SMS rispetto alle e-mail. In questo modo, il consenso sarà sempre attribuito correttamente al canale corretto.
   
   • Il consenso non si sincronizzerà (sia per le e-mail che per gli SMS) fino a quando il cliente non avrà completato l'ordine e, se del caso, non avrà confermato l'iscrizione grazie al doppio opt-in.
   • Si noti che per gli utenti che hanno già effettuato l'accesso al suo negozio Magento 2, la casella di controllo del consenso via e-mail non apparirà per impostazione predefinita al momento del checkout.
3. Alla voce E-mail, seleziona Sì per iscrivere i contatti al marketing via e-mail al momento del pagamento.
4. Selezioni un elenco di e-mail su cui sincronizzare gli iscritti, ad esempio una newsletter.
5. Inserisci il testo della casella di controllo opt-in per l'e-mail che desideri utilizzare.
   
6. Alla voce SMS, seleziona Sì per Iscrivi i contatti al Marketing via SMS al momento del pagamento.
7. Scegli l'elenco con cui desideri sincronizzare i tuoi contatti SMS. Per maggiori dettagli su queste impostazioni, leggi la nostra guida alla raccolta del Consenso all'invio di SMS al momento del pagamento.
   
8. L'ordine di ordinamento le consente di modificare la posizione delle caselle di consenso per e-mail e SMS. Per impostazione predefinita, queste caselle appaiono rispettivamente sotto il primo campo di inserimento dell'e-mail e del numero di telefono di spedizione. Pertanto, se non ha riorganizzato la pagina di cassa, non è necessario modificare l'ordine di ordinamento. Se ha modificato il layout, regoli l'ordine di ordinamento di conseguenza.
9. Una volta terminato, fai clic su Salva configurazione in alto a destra.

Abilita i webhook

Successivamente, abiliterai i webhook Klaviyo nel tuo account Magento 2. Tieni presente che per il corretto funzionamento del consenso al momento del pagamento è necessario abilitare i webhook.

1. Dal cruscotto dell'amministratore, navighi su Stores > Configurazione.
2. Fai clic su Klaviyo e seleziona la scheda Webhook .
3. Crea un segreto di webhook e inseriscilo nel campo segreto di Webhook corrispondente. Il segreto di webhook è una chiave che Klaviyo utilizzerà per la convalida. Questo segreto può essere qualsiasi cosa tu scelga, ma ti consigliamo di creare una stringa sicura di lettere e numeri. Magento nasconderà il tuo segreto di webhook con degli asterischi per motivi di sicurezza, quindi fai attenzione a inserirlo correttamente. Se utilizzi un'integrazione con più negozi, il segreto di webhook in questo campo deve essere inserito nella tua configurazione predefinita e lo stesso segreto sarà utilizzato come convalida per ogni configurazione del negozio. Il segreto di webhook deve essere aggiunto solo alla configurazione predefinita e non per negozio.
   
4. Accanto ai webhook che desideri abilitare, seleziona Sì dal menu a discesa. Per saperne di più sui webhook supportati da Klaviyo, consulta la nostra guida ai webhook per Magento 2.
5. Fai clic su Salva configurazione.

Abilitare l'integrazione di Magento 2 in Klaviyo

Come fare un video

1. Apri Klaviyo, quindi seleziona integrazioni dalla navigazione a sinistra. Trova Magento 2 nell'elenco e selezionalo.
2. Nella pagina successiva, avrai la possibilità di aggiungere nuovi clienti Magento 2 a un elenco Klaviyo. Fai clic sulla casella di controllo per aggiungere nuovi clienti Magento 2 a un elenco Klaviyo e seleziona un elenco dal menu a discesa. Tieni presente che il controllo di questa impostazione aggiungerà solo i clienti all'elenco selezionato, ma non li iscriverà ai messaggi di marketing. Questa impostazione sincronizzerà solo i nuovi clienti; i clienti esistenti devono essere migrati manualmente dal tuo elenco Magento a Klaviyo.
   
3. Quindi, seleziona le visualizzazioni del negozio da Magento 2 che desideri sincronizzare con Klaviyo. Tutte le visualizzazioni del negozio sono sincronizzate con Klaviyo per impostazione predefinita. Questa impostazione ti consente di scegliere con quali negozi effettuare l'integrazione. Se utilizzi Multi-Source Inventory (MSI) in Magento 2, controlla le visualizzazioni specifiche del negozio Magento 2 e seleziona i negozi che desideri sincronizzare per vedere il tuo inventario rappresentato correttamente in Klaviyo.
4. Alla voce Advanced (Avanzate), abilita le seguenti impostazioni in base alle esigenze:
   
   • Impostazioni di prezzo speciali Questa impostazione si riferisce a un prezzo di vendita speciale per gli articoli che possono avere effetto facoltativo in un determinato intervallo di date. Ti consigliamo vivamente di abilitare questa funzionalità se intendi utilizzarla, poiché è più difficile abilitarla in seguito. Quando abiliti Usa il prezzo speciale per i prezzi dei prodotti, se applicabile, il blocco prodotti visualizzerà il prezzo speciale, se applicabile. Quando utilizzi un feed dinamico dei prodotti, il prezzo speciale viene inserito al momento dell'invio. Quando selezioni manualmente gli articoli dal tuo catalogo, il prezzo speciale viene inserito una volta selezionati i prodotti. Per ogni prodotto, ci sono 4 campi di metadati che verranno sincronizzati:
     • prezzo (obbligatorio, variabile) Il prezzo standard dell'articolo.
     • special_price (facoltativo, variabile) Si tratta di un prezzo di vendita speciale per l'articolo. Quando questo prezzo è in vigore, vedrai questo special_price accanto a un barrato del prezzo.
     • special_from_date (facoltativo, date) Specifica la data di inizio dell'effetto di special_price.
     • special_to_date (facoltativo, date) Specifica una data di fine per special_price in vigore.
   • URL principale dei media personalizzati Questa impostazione ti consente di modificare il percorso predefinito delle immagini del tuo sito. Abilita questa impostazione se le immagini dei prodotti sono ospitate su un URL diverso dal tuo sito web.
5. Clicca su Salva.

Ora hai abilitato l'integrazione con Magento 2! I tuoi dati inizieranno a sincronizzarsi con Klaviyo in pochi minuti.

Dopo il completamento della sincronizzazione iniziale dei dati storici, l'integrazione con Magento 2 si sincronizza ogni 30 minuti.

Dati sincronizzati con l'integrazione di Magento 2

L'integrazione di Klaviyo con Magento 2 estrae le informazioni chiave sui clienti dalla sua piattaforma Magento.

Ecco alcuni dei dati che sincronizziamo da Magento:

• Informazioni sul cliente, tra cui nome, cognome e località.
• Dati sulle vendite e sugli ordini, compresi gli articoli acquistati, le immagini degli articoli, le categorie degli articoli e gli sconti applicati.
• Dati sugli ordini evasi, rimborsati e annullati.
• Quando le persone visitano il suo sito web e quali elementi visualizzano; il web tracking è gestito dall'estensione.

Per saperne di più, consulta la nostra guida ai dati di Magento 2.

Converta i valori degli ordini di Magento in un'unica valuta

Klaviyo supporta la conversione di tutte le valute estere in Magento in una valuta principale in Klaviyo. Per abilitare questa funzionalità,contatta l' assistenza. Questo è particolarmente utile se hai più negozi con transazioni in valute diverse.

Quando questa funzione è abilitata:

• La conversione avviene quando Magento sincronizza i dati degli ordini in Klaviyo.
• Klaviyo verificherà se il codice valuta_ordine è uguale al codice valuta_globale impostato. In caso contrario, Klaviyo convertirà il totale dell'ordine dalla valuta dell'ordine alla valuta globale specificata per garantire che i tuoi dati analitici finanziari siano accurati. Tieni presente che le voci dell'ordine rimarranno nel codice della valuta dell'ordine e non saranno convertite.

Aggiorna la sua estensione

Stai cercando di aggiornare la tua estensione Klaviyo Magento 2? Segui le istruzioni dettagliate nella sezioneInstalla di cui sopra ed esegui il comando per installare la versione più recente. Questo sovrascriverà la tua versione attuale e il tuo aggiornamento sarà completo - quindi €™s non è necessario riconfigurare l'estensione o riattivare l'integrazione in Klaviyo.

Sincronizza nuovamente il catalogo

Puoi richiedere una risincronizzazione completa dello storico del catalogo di Magento 2 in qualsiasi momento. Risincronizzare il tuo catalogo può aiutarti a sfruttare gli aggiornamenti di Klaviyo per l'inventario e le funzionalità relative alle varianti.

Per risincronizzare il catalogo:

1. In Klaviyo, seleziona la scheda Integrazioni.
2. Seleziona il tuo Magento 2 integrazioni dall'elenco.
3. Clicca sulla scheda Dati.
4. Alla voce Sincronizza dati del catalogo, clicca su Risincronizza.