Cosa imparerai

Scopri come integrare Klaviyo con il tuo store Magento 2 CE o EE. Dovrai installare l’estensione Klaviyo in Magento, configurare l’estensione e configurare OAuth, quindi abilitare l’integrazione in Klaviyo. Questa guida copre tutti i passaggi di integrazione richiesti, oltre a come confermare che la sincronizzazione dello storico dei dati sia avvenuta correttamente.

Prima di iniziare

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

Per garantire che Klaviyo possa effettuare le necessarie chiamate API per l'integrazione, il tuo server Magento 2 deve avere un nome host 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 alla lista consentita del tuo provider di firewall. Per ulteriori informazioni, consulta la sezione Come aggiungere gli indirizzi IP del traffico delle integrazioni Klaviyo alla lista consentita.

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.

Installa l'estensione Klaviyo in Magento 2

  1. Accedi al tuo server Magento 2 e vai alla directory principale della tua app Magento dal tuo strumento da riga di comando. Questa guida mostra esempi di output per Terminal, ma questi passaggi possono essere modificati per qualsiasi strumento da riga di comando a tua scelta.
  2. Esegui il seguente comando per accedere alla versione più recente dell’estensione Klaviyo da Packagist. Packagist è un repository per librerie di codice PHP che ti consente di installare facilmente la versione più recente dell’estensione.
    composer require klaviyo/magento2-extension
  3. Esegui il seguente comando per abilitare l’estensione Klaviyo che hai appena scaricato:
    php bin/magento module:enable Klaviyo_Reclaim  --clear-static-content
composer2.png
composer2.png
  1. Come mostrato nell’output di esempio, ora devi abilitare eventuali moduli aggiuntivi. Esegui il seguente comando per abilitarli:
    php bin/magento setup:upgrade
  2. Esegui una scansione dell’output per Module 'Klaviyo_Reclaim' per confermare che il modulo Klaviyo sia abilitato e in esecuzione.
  3. Per assicurarti che i CSS e i JS del tuo store Magento 2 continuino a funzionare correttamente, dovrai eseguire un comando di distribuzione dei contenuti statici.
    php bin/magento setup:static-content:deploy -f
composer3.png
composer3.png
  1. Ora puoi tornare al pannello di controllo di amministrazione di Magento dal tuo browser.

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

Configura l'estensione Klaviyo

Video dimostrativo

  1. Nel tuo account Klaviyo, vai alla scheda Chiave API.
  2. In una nuova scheda, vai all'amministratore del tuo negozio Magento.
  3. Alla voce Settings (Impostazioni), clicca su Stores (Archivia) > Configuration (Configurazione).
  4. Dal menu a discesa di Klaviyo, clicca su Generale.
  5. Imposta Abilita estensione Klaviyo su Sì.
  6. Copia la tua chiave API pubblica di Klaviyo (ID sito) dalla scheda Chiave API e incollala nella casella corrispondente in Magento.
  7. Nella scheda chiave API di Klaviyo, crea una nuova chiave API privata e copiala nella casella corrispondente in Magento. L'autenticazione con la tua chiave API privata ti permette di sincronizzare le iscrizioni alla newsletter da Magento a Klaviyo.

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

Configura OAuth

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

  1. Vai alla scheda Configura OAuth in 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.
OAUTHtab.png
OAUTHtab.png
  1. Individuare System nel riquadro di navigazione a sinistra e selezionare Integrazioni dalla barra delle applicazioni.
  2. 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.
activateoauth.png
activateoauth.png
  1. Fai clic su Consenti il reindirizzamento a Klaviyo, dove completerai la configurazione dell'integrazione.
oauthperms.png
oauthperms.png
  1. 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 visualizzi l'errore "L'account Klaviyo non corrisponde all'ID dell'azienda", assicurati che le chiavi API inserite in Magento appartengano all'account Klaviyo a cui hai effettuato l'accesso, quindi riprova.

apierror.png
apierror.png

Quando stabilisci la connessione tra Magento e Klaviyo, se invece ricevi un elenco di errori, puoi fare clic su ogni errore per saperne di più sulla causa.

oauthgenerror.png
oauthgenerror.png

Imposta un elenco di newsletter

Successivamente, selezionerai un elenco Klaviyo a cui sincronizzare gli iscritti al tuo newsletter. Hai anche la possibilità di utilizzare le impostazioni di opt-in di Klaviyo o le impostazioni di opt-in di Magento 2 per l'elenco scelto.

  1. In Magento, clicca su Newsletter.
  2. Seleziona l'elenco Klaviyo a cui desideri sincronizzare il tuo modulo d'iscrizione Magento dal menu a discesa.
  3. Fai clic su Salva configurazione.
newsletterm2.png
newsletterm2.png

Abilitare il consenso durante il pagamento

Puoi raccogliere il consenso al checkout per le e-mail e per i canali mobile (SMS, WhatsApp o entrambi).

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.
m2cac-new.png
m2cac-new.png
  1. Vedrai una sezione per la raccolta del consenso all'invio di e-mail e di messaggi su dispositivi mobili (SMS/WhatsApp). I due canali vengono trattati separatamente, in modo da poter raccogliere solo e-mail, solo SMS/WhatsApp o entrambi. Se raccogli iscritti sia all'SMS/WhatsApp sia alle e-mail, scegli un elenco diverso per SMS/WhatsApp rispetto alle e-mail. In questo modo, il consenso sarà sempre attribuito correttamente al canale corretto.
    • Il consenso non verrà sincronizzato (sia per e-mail che per SMS/WhatsApp) fino a quando il cliente non avrà terminato l'ordine e, se applicabile, non avrà confermato l'iscrizione a causa del doppio opt-in.
    • Tieni presente che per gli utenti già connessi al tuo negozio Magento 2, la casella di controllo del consenso all'invio di e-mail non apparirà al momento del pagamento per impostazione predefinita.
  2. Alla voce E-mail, seleziona Sì per iscrivere i contatti al marketing via e-mail al momento del pagamento.
  3. Seleziona un elenco e-mail a cui sincronizzare gli iscritti, ad esempio un newsletter.
  4. Inserisci il testo della casella di controllo opt-in per l'e-mail che desideri utilizzare.
2021-03-24_13-00-56.png
2021-03-24_13-00-56.png
  1. Alla voce Mobile, seleziona Sì per Raccogli gli iscritti ai messaggi di testo e WhatsApp.
  2. Scegli l’elenco a cui vuoi sincronizzare i tuoi contatti SMS/WhatsApp. Per maggiori dettagli su queste impostazioni, consulta la nostra guida su come raccogliere il consenso SMS e/o WhatsApp al checkout.
Una pagina delle impostazioni per i dispositivi mobili in cui raccogliere il consenso per i messaggi di testo e WhatsApp, con opzioni per i canali, gli elenchi di iscritti e il testo del consenso.
  1. L'ordinamento ti consente di modificare il posizionamento delle caselle di consenso per e-mail e SMS. Per impostazione predefinita, queste caselle appaiono rispettivamente nel primo campo di inserimento dell'e-mail e nel campo del numero di telefono di spedizione. Pertanto, se non hai riorganizzato la pagina di pagamento, non è necessario modificare l'ordinamento. Se hai modificato il layout, regola l'ordinamento di conseguenza.
  2. 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 pannello di controllo di amministrazione, vai su Negozi > 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.
m2webhooktab.png
m2webhooktab.png
  1. Accanto ai webhook che vuoi 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.
  2. Fai clic su Salva configurazione.

Abilita l'integrazione di Magento 2 in Klaviyo

Video dimostrativo

  1. Apri Klaviyo, quindi seleziona Integrazioni dal menu di navigazione a sinistra. Trova Magento 2 nell'elenco e selezionalo.
  2. Nella pagina successiva, puoi scegliere di aggiungere i clienti Magento 2 a un elenco Klaviyo. Seleziona Aggiungi nuovi clienti Magento 2 a un elenco Klaviyo e seleziona un elenco dal menu a discesa. L’aggiunta di un cliente a un elenco non concede di per sé il consenso al marketing. Usa le impostazioni di consenso della newsletter e del checkout in Magento per raccogliere questo consenso.

    I profili cliente esistenti sono inclusi nella sincronizzazione dello storico dei dati. Per caricare gli iscritti alla newsletter esistenti da un CSV, segui la guida su come caricare gli iscritti Magento 2 esistenti in un elenco Klaviyo.
Pagina delle impostazioni di integrazione di Magento 2 e Klaviyo con opzioni per la sincronizzazione dei dati, le visualizzazioni del negozio e le funzionalità avanzate.
  1. Successivamente, seleziona quali viste store di Magento 2 vuoi sincronizzare con Klaviyo. Per impostazione predefinita, tutte le viste store vengono sincronizzate con Klaviyo. Questa impostazione ti consente di scegliere in modo selettivo con quali negozi integrarti. Se utilizzi Multi-Source Inventory (MSI) in Magento 2, seleziona Viste store specifiche di Magento 2 e seleziona gli store che vuoi sincronizzare per vedere le scorte correttamente rappresentate in Klaviyo.
  2. In Avanzate, configura le seguenti impostazioni secondo necessità:
    • Impostazioni del prezzo speciale
      Questa impostazione si riferisce a un prezzo di vendita speciale per gli articoli che, facoltativamente, può entrare in vigore in un determinato intervallo di date. Attivalo prima della prima sincronizzazione del catalogo se intendi usare i prezzi speciali. Se lo abiliti in un secondo momento, sincronizza di nuovo il tuo catalogo per aggiornare i prodotti esistenti. Quando attivi Usa prezzo speciale per i prezzi dei prodotti, quando applicabile, il blocco prodotto mostrerà il prezzo speciale quando applicabile. Quando utilizzi un feed dei prodotti dinamico, il prezzo speciale verrà compilato all'ora di invio. Quando selezioni manualmente gli articoli dal catalogo, il prezzo speciale verrà compilato una volta selezionato il prodotto o i prodotti. Per ogni prodotto, ci sono 4 campi di metadati che verranno sincronizzati:
      • prezzo
        (Obbligatorio, fluttuante) Il prezzo standard dell'articolo.
      • prezzo_speciale
        (Facoltativo, flottante) 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.
      • data_da_speciale
        (Facoltativo, data) Specifica la data di inizio dell'effetto di special_price.
      • speciale_ad_oggi
        (Facoltativo, data) Specifica la data di fine dell'applicazione di special_price.
    • URL radice dei media
      Per modificare il percorso predefinito delle immagini del tuo sito, seleziona Modifica URL radice dei media e inserisci l’URL radice dei media. Usa questa impostazione se le tue immagini sono ospitate su un URL diverso da quello del tuo sito web.
    • Limita la sincronizzazione agli ordini recenti
      Le sincronizzazioni periodiche degli ordini recuperano gli ordini aggiornati dalla sincronizzazione precedente. Per limitare queste sincronizzazioni in base alla data di creazione degli ordini, seleziona Limita la sincronizzazione agli ordini recenti e scegli un intervallo di tempo dal menu a discesa. Solo gli ordini aggiornati creati entro quel periodo verranno inclusi nelle sincronizzazioni periodiche degli ordini. Questo aiuta a evitare che gli ordini meno recenti vengano recuperati di nuovo dopo aggiornamenti minori. Tuttavia, tutti gli ordini creati prima dell’intervallo selezionato vengono esclusi, anche se hanno aggiornamenti significativi. Questa impostazione non influisce sulla sincronizzazione iniziale dello storico dei dati.
  3. Clicca su Completa la configurazione.

La tua integrazione Magento 2 è ora abilitata e la sincronizzazione dello storico dei dati è iniziata.

Una volta completata la sincronizzazione dello storico dei dati iniziale, l'integrazione con Magento 2 si sincronizza ogni 30 minuti.

Conferma la sincronizzazione dello storico dei dati

  1. In Klaviyo, seleziona integrazioni, quindi apri l’integrazione Magento 2.
  2. Seleziona la scheda Dati.
  3. Rivedi la sezione storico dei dati. Durante l’importazione, viene mostrato l’avanzamento della sincronizzazione. Al termine dell’importazione, la sezione conferma che lo storico degli ordini, dei clienti e dei prodotti è stato sincronizzato e mostra una data Ultima sincronizzazione:.

Dati sincronizzati con l'integrazione di Magento 2

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

Ecco alcuni dei dati che sincronizziamo da Magento:

  • Informazioni sul cliente, tra cui nome, cognome e posizione.
  • Dati sulle vendite e sugli ordini, inclusi gli articoli acquistati, le immagini, le categorie di articoli e gli eventuali sconti applicati.
  • Dati di evasione, rimborso e annullamento dell'ordine.
  • Quando le persone visitano il tuo sito web e quali articoli visualizzano, il tracciamento web viene gestito dall'estensione.

Per saperne di più, vai alla nostra guida di riferimento sui dati di Magento 2.

Converti 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. Contatta l'assistenza tramite contatta l'assistenza per abilitare questa funzionalità. È particolarmente utile se hai più negozi con transazioni in valute diverse.

Quando questa funzionalità è 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 tua estensione

Per aggiornare l’estensione Klaviyo per Magento 2, ripeti i passaggi in Installa l’estensione Klaviyo in Magento 2 qui sopra, inclusi i comandi di aggiornamento di Magento e di distribuzione del contenuto statico. Questi passaggi sostituiscono la versione attuale dell’estensione. Non devi riconfigurare l’estensione né riabilitare l’integrazione in Klaviyo.

Sincronizza nuovamente il catalogo

Puoi avviare una ri-sincronizzazione storica completa del tuo catalogo Magento 2 in qualsiasi momento. Ri-sincronizzare il catalogo può aiutarti a sfruttare gli aggiornamenti di Klaviyo relativi all’inventario e alle funzionalità correlate alle varianti. Ri-sincronizza il catalogo dopo aver modificato le impostazioni di sincronizzazione del catalogo per applicare queste modifiche ai prodotti esistenti.

Per risincronizzare il tuo catalogo:

  1. In Klaviyo, seleziona la scheda Integrazioni.
  2. Seleziona la tua integrazione con Magento 2 dall'elenco.
  3. Clicca sulla scheda Dati.
  4. In Sincronizza i dati del catalogo, clicca su Risincronizza.

Controlla lo stato di sincronizzazione nella stessa sezione mentre è in corso la risincronizzazione. Al termine, la sezione mostra una data Ultima sincronizzazione il.

Risorse aggiuntive

  • Riferimento dati Magento 2

    Scopri quali dati Klaviyo importa dal tuo negozio Magento 2 quando integri le 2 piattaforme. L’integrazione di Klaviyo con Magento 2 acquisisce tutto lo storico dei dati del tuo negozio Magento 2 con la sincronizzazione iniziale dello storico. Una volta abilitata, l’integrazione inizierà anche a sincronizzare i dati sugli ordini e sui clienti ogni 30 minuti. Esempi di questi dati includono le informazioni associate agli ordini effettuati in passato, agli ordini evasi, ecc.

  • Klaviyo Community: Magento 2 "Ask Me Anything" Question and Answer Video
Questo articolo è stato utile?
Usa questo modulo solo per il feedback sull'articolo. Scopri come contattare l'assistenza.

Esplora altri contenuti di Klaviyo

Community
Entra in contatto con altre aziende simili, partner ed esperti di Klaviyo per trovare ispirazione, condividere approfondimenti e ottenere risposte a tutte le tue domande.
Partner
Assumi un esperto certificato Klaviyo per aiutarti con un compito specifico o per la gestione continua del marketing.
Assistenza

Accedi all'assistenza tramite il tuo account.

Assistenza via e-mail (prova gratuita e account a pagamento) Disponibile 24 ore su 24, 7 giorni su 7

Chat/assistente virtuale
La disponibilità può variare in base alla località e al tipo di piano