Iniziare con Magento 2.x (CE ed EE)

Imparerai

Scopra come integrare Klaviyo con il suo negozio Magento 2 CE o EE. Dovrà installare l'estensione Klaviyo in Magento, configurare l'estensione e impostare OAuth, quindi abilitare l'integrazione in Klaviyo. Questa guida illustra tutti i passaggi necessari per l'integrazione, nonché come confermare la riuscita della sincronizzazione dei dati storici. 

Prima di iniziare

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.

Trovi la versione della sua estensione Klaviyo

Tutti gli intervalli di versioni nella tabella sono inclusi. Tutte le estensioni sono disponibili per l'installazione tramite Composer. 

Il processo di installazione varia a seconda della versione di Magento 2 che sta utilizzando. 

Se sta utilizzando Magento 2 versione 2.4.0 o superiore, segua le istruzioni dettagliate in Installare con Composer qui sotto.

Per coloro che utilizzano versioni di Magento 2 inferiori a 2.4.0: Abbiamo rilasciato delle patch per garantire la compatibilità tra le vecchie versioni delle nostre estensioni e le nostre nuove API. I link a Github sono riportati nella tabella precedente e sono anche disponibili per l'installazione tramite Packagist/Composer. Dovrà effettuare l'installazione tramite il metodo che utilizza attualmente per installare le estensioni (se si tratta di Composer, può seguire la sezione Installare con Composer qui sotto). Se sta utilizzando la versione 2.2.0 di Magento 2, dovrà anche abilitare manualmente OAuth dopo l'installazione.

Installi l'estensione Klaviyo in Magento 2

Come fare un video

Installare con Composer

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. Esegua il seguente comando per accedere all'ultima versione dell'estensione Klaviyo da Packagist. Packagist è un repository per le librerie di codice PHP che le permette di installare facilmente l'ultima versione dell'estensione.
   composer richiede klaviyo/magento2-extension
3. Se deve installare una versione precedente dell'estensione Magento 2 con Composer, specifichi la versione che desidera installare. Per esempio:
   composer require klaviyo/magento2-extension:3.0.4-patch
4. Esegua il seguente comando per abilitare l'estensione Klaviyo che ha appena scaricato:
   php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
5. Come mostrato nell'output di esempio, ora deve abilitare tutti i moduli aggiuntivi. Esegua il seguente comando per abilitarli:
   php bin/magento setup:upgrade
6. Esamini l'output per il modulo 'Klaviyo_Reclaim' per confermare che il modulo Klaviyo è abilitato e funzionante.
7. Per assicurarsi che i CSS e i JS del suo negozio Magento 2 continuino a funzionare correttamente, dovrà eseguire un comando di distribuzione di contenuti statici.
   php bin/magento setup:static-content:deploy -f
8. 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 suo account Klaviyo, si rechi nella 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, abiliterà l'autenticazione OAuth per connettere in modo sicuro il suo account Klaviyo all'estensione Magento 2. Abbiamo una guida separata per coloro che hanno un'integrazione esistente e devono aggiungere OAuth. Se utilizza Magento 2 versione 2.2.0, visiti la nostra guida su come abilitare manualmente OAuth per la sua integrazione. 

1. Si rechi nella scheda Setup OAuth di Magento.
2. Assegni alla sua integrazione un nome memorabile, perché in seguito dovrà individuarla con questo nome.
3. Clicchi su Salva configurazione per procedere.
   
4. Individui Sistema nel riquadro di navigazione sinistro e selezioni Integrazioni dalla barra del sistema .
5. Individui il nome della sua integrazione e clicchi su Attiva. Attivando l'integrazione si aprirà una finestra che le chiederà di approvare l'accesso.
   
6. Clicchi su Consenti per essere reindirizzato a Klaviyo, dove completerà la configurazione dell'integrazione.
   
7. Acceda a Klaviyo, se richiesto, o confermi che il nome del suo account è corretto e clicchi su Integra .Questo aggiungerà l'integrazione Magento 2 all'account Klaviyo associato alla chiave API che ha utilizzato per la configurazione. Se ha effettuato l'accesso a più account Klaviyo e l'account corretto non viene visualizzato, esca da tutte le altre sessioni.
   

Se la finestra si chiude automaticamente, la connessione ha avuto successo. Può anche confermare il successo aprendo il suo account Klaviyo in una nuova scheda o finestra del browser, cliccando sul nome del suo account nell'angolo in basso a sinistra, quindi selezionando Integrazioni e cercando Magento 2 nell'elenco .

Se invece riceve il seguente errore, si assicuri che le chiavi API utilizzate nel primo passaggio corrispondano all'account a cui è attualmente collegato.

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. Clicchi 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.

Tenga presente che se abilita il consenso alla cassa, dovrà anche abilitare i webhook (di seguito) affinché il consenso alla cassa funzioni correttamente. 

1. Nella pagina di Configurazione, sotto Klaviyo, vada su Consenso alla cassa.
   
2. Vedrà una sezione per la raccolta del consenso via e-mail e del consenso via SMS. Le due cose vengono trattate separatamente, in modo da poter raccogliere solo le e-mail, solo gli SMS o entrambi. Se raccoglie sia abbonati agli SMS che alle e-mail, scelga una lista diversa per gli SMS rispetto a quella per le e-mail. Questo assicura che il consenso venga 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 Email, selezioni Sì per Abbonare i contatti all'email marketing al momento del checkout.
4. Selezioni un elenco di e-mail su cui sincronizzare gli iscritti, ad esempio una newsletter.
5. Inserisca il testo della casella di controllo opt-in via e-mail che desidera utilizzare.
   
6. Alla voce SMS, selezioni Sì per Abbonare i contatti al marketing via SMS al momento del checkout.
7. Scelga l'elenco in cui desidera sincronizzare i contatti SMS. Per ulteriori dettagli su queste impostazioni, consulti la nostra guida sulla raccolta del consenso agli 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. Quando ha finito, clicchi su Salva configurazione in alto a destra.

Abilita i webhook

1. Dal cruscotto dell'amministratore, navighi su Stores > Configurazione.
2. Clicchi su Klaviyo e selezioni la scheda Webhooks . 
3. Crei un segreto webhook e lo inserisca nel campo segreto webhookcorrispondente. Il segreto webhook è una chiave che Klaviyo utilizzerà per la convalida. Questo segreto può essere qualsiasi cosa lei scelga, ma consigliamo di creare una stringa sicura di lettere e numeri. Magento nasconderà il suo segreto webhook con degli asterischi per motivi di sicurezza, quindi faccia attenzione ad inserirlo correttamente.
   
   Se utilizza un'integrazione multi-store, il segreto webhook in questo campo deve essere inserito nella configurazione predefinita, e lo stesso segreto sarà utilizzato come validazione per ogni configurazione del negozio. Il segreto webhook deve essere aggiunto solo alla configurazione predefinita e non deve essere aggiunto per ogni negozio.
4. Accanto ai webhook che desidera abilitare, selezioni Sì dal menu a tendina. Per saperne di più sui webhooks supportati da Klaviyo, consulti la nostra guida ai webhooks per Magento 2.
5. Clicchi su Salva configurazione.

Abilitare l'integrazione di Magento 2 in Klaviyo

Come fare un video

1. Apra Klaviyo, clicchi sul nome del suo account nell'angolo inferiore sinistro, quindi selezioni Integrazioni. Trovi Magento 2 nell'elenco e lo selezioni.
2. Nella pagina successiva, avrà la possibilità di aggiungere nuovi clienti Magento 2 ad un elenco Klaviyo. Clicchi sulla casella di controllo per Aggiungere nuovi clienti Magento 2 ad un elenco Klaviyo e selezioni un elenco dal menu a tendina. Si noti che selezionando 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 suo elenco Magento a Klaviyo.
3. In Avanzate, attivi le seguenti impostazioni, come necessario :
   • Negozi
     Tutti i negozi Magento 2 sono sincronizzati con Klaviyo per impostazione predefinita. Questa impostazione le consente di essere selettivo sui negozi con cui si integra. Per saperne di più, visiti il sito Supporting multiple Magento stores. 
   • Impostazioni prezzo speciale
     Questa impostazione si riferisce ad un prezzo di vendita speciale per gli articoli che può entrare in vigore facoltativamente in un determinato intervallo di date. Consigliamo vivamente di abilitare questa funzione se ha intenzione di utilizzarla, in quanto è più difficile da abilitare in seguito. Quando attiva l'opzione Utilizza il prezzo speciale per i prezzi dei prodotti quando è applicabile, il blocco prodotto visualizzerà il prezzo speciale quando è applicabile. Quando utilizza un'alimentazione dinamica del prodotto, il prezzo speciale verrà popolato al momento dell'invio. Quando seleziona manualmente gli articoli dal suo catalogo, il prezzo speciale verrà visualizzato una volta selezionato il prodotto o i prodotti. Per ogni prodotto, ci sono 4 campi di metadati che verranno sincronizzati:
     
     • prezzo
       (Richiesto, float) Il prezzo standard dell'articolo.
     • prezzo_speciale
       (Opzionale, float) Si tratta di un prezzo di vendita speciale per l'articolo. Quando questo prezzo è in vigore, vedrà questo prezzo_speciale accanto a una barra del prezzo.
     • data_speciale
       (Opzionale, data) Specifica una data di inizio per l'entrata in vigore di prezzo_speciale.
     • data_speciale
       (Opzionale, data) Specifica la data di fine dell'efficacia di prezzo_speciale.
   • URL radice media personalizzato
     Questa impostazione le consente di modificare il percorso predefinito per le immagini del suo sito. Attivi questa impostazione se ospita le immagini dei suoi prodotti su un URL diverso da quello del suo sito web. 
4. Clicchi su Salva.

Ora ha attivato con successo l'integrazione con Magento 2! I suoi 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ù, visiti il nostro riferimento 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 primaria in Klaviyo - contatti l'assistenza per abilitare questa funzione. Questo è particolarmente utile se ha più negozi con transazioni in valute diverse.

Quando questa funzione è abilitata:

• La conversione avviene quando Magento sincronizza i dati degli ordini con Klaviyo. 
• Klaviyo verificherà se il codice_valuta_ordine è uguale al codice_valuta_globaleimpostato. In caso contrario, Klaviyo convertirà il totale dell'ordine dalla valuta dell'ordine alla valuta globale specificata, per garantire l'accuratezza delle analisi finanziarie. Tenga presente che le voci dell'ordine rimarranno nel codice di valuta dell'ordine e non saranno convertite. 

Aggiorna la sua estensione

Consulti la tabella sottostante: sta utilizzando una versione di estensione inferiore a quella specificata per la sua versione di Magento 2? In tal caso, le consigliamo di aggiornare immediatamente la sua estensione. Alcune versioni precedenti dell'estensione utilizzano le API v1 e v2 di Klaviyo, che sono state ritirate e non funzionano più come previsto. Forniamo versioni patchate specifiche per assistere i clienti che utilizzano versioni precedenti di Magento 2, che sono collegate nella tabella.

Per prima cosa, determini la versione dell'estensione a cui deve effettuare l'aggiornamento utilizzando la tabella seguente. 

Tutti gli intervalli di versioni nella tabella sono inclusi. Tutte le estensioni sono disponibili per l'installazione tramite Composer. 

Ora che ha stabilito a quale versione effettuare l'aggiornamento, è il momento di farlo. Il processo di aggiornamento varia a seconda della versione di Magento 2 che sta utilizzando. 

Se utilizza Magento 2 versione 2.4.0 o superiore, segua le istruzioni dettagliate in Installare con Composer qui sopra ed esegua il comando per installare l'ultima versione. Questo sovrascriverà la sua versione attuale e l'aggiornamento sarà completo - non è necessario riconfigurare l'estensione o riattivare l'integrazione in Klaviyo.

Per coloro che utilizzano versioni di Magento 2 inferiori a 2.4.0: Abbiamo rilasciato delle patch per garantire la compatibilità tra le vecchie versioni delle nostre estensioni e le nostre nuove API. I link di Github si trovano nella tabella precedente e sono anche disponibili per l'installazione tramite Packagist/Composer. Dovrà effettuare l'installazione tramite il metodo che utilizza attualmente per installare le estensioni (se si tratta di Composer, può seguire la sezione Installare con Composer qui sopra).

Risorse aggiuntive

• Riferimento dati Magento 2
• Come raccogliere il consenso via SMS al momento del checkout su Magento 2
• Comunità Klaviyo: Magento 2 "Ask Me Anything" Domande e Risposte Video