Primi passi con PrestaShop

Cosa imparerai

Scopri come integrare il tuo negozio PrestaShop con Klaviyo. Klaviyo è il partner di marketing automation preferito di PrestaShop. La procedura prevede due fasi: l'installazione del modulo gratuito (PrestaShop Automation with Klaviyo) in PrestaShop e l'attivazione dell'integrazione in Klaviyo. In questo articolo puoi trovare anche ulteriori informazioni sul controllo della sincronizzazione dei dati, sull'impostazione delle e-mail transazionali e sull'aggiornamento del tuo modulo, in modo da poter crescere insieme a Klaviyo.

Prima di iniziare

Per poter utilizzare il modulo di Klaviyo dovrai utilizzare una delle seguenti versioni di PrestaShop:

• PrestaShop 1.7.0 e versioni successive (utilizzando inoltre PHP 7.1 o versioni successive)
  • Se desideri utilizzare la nostra funzionalità di acquisizione del consenso all'invio di SMS al momento del pagamento, devi utilizzare PrestaShop 1.7.6 o versioni successive.
• PrestaShop Edition 8.0 e versioni successive.
• Progetto PrestaShop 8.0 e versioni successive.

Se utilizzi una versione di PrestaShop precedente alla 1.7.0 e desideri effettuare l'upgrade per utilizzare un modulo Klaviyo, consulta la guida di PrestaShop per l'aggiornamento del tuo negozio online.

Leggi le seguenti informazioni prima di procedere all'integrazione:

• Se utilizzi PrestaShop Edition, il modulo PrestaShop Automation with Klaviyo è già preinstallato. Se stai utilizzando un'altra versione di PrestaShop, dovrai invece installarla (ti spiegheremo come nella prossima sezione). 
• PrestaShop Automation with Klaviyo è progettato per integrarsi con le funzionalità di back office di PrestaShop, come PrestaShop Account. Per utilizzare il modulo di Klaviyo, i negozi attivi su PrestaShop Project 8.0 dovranno installare il modulo PS_MBO.
• Non vuoi integrare la funzionalità di back office sul tuo negozio PrestaShop open source? Allora puoi utilizzare il nostro modulo Klaviyo by PrestaShop Partners, che contiene la stessa serie di funzionalità di PrestaShop Automation with Klaviyo e non richiede PS_MBO.

Vuoi aggiornare il tuo attuale modulo di Klaviyo? Vai alla fine di questo articolo per saperne di più. 

Video dimostrativo

Installa il modulo in PrestaShop

1. Se utilizzi PrestaShop Edition, il modulo PrestaShop Automation with Klaviyo è già preinstallato. Segui questi passaggi:
1. Accedi al tuo negozio PrestaShop.
2. Alla voce Configure (Configurazione) nel menu di sinistra, seleziona Klaviyo.
3. Salta alla sezione successiva di questo articolo per configurare il modulo.
2. Se non utilizzi PrestaShop Edition, vai alla pagina del modulo PrestaShop Automation with Klaviyo sul marketplace di PrestaShop e procedi al passaggio successivo.
   
3. Nella pagina del modulo, fai clic su Download (Scarica). Convalida i tuoi dati se necessario, quindi seleziona la versione di PrestaShop che stai utilizzando e scarica il file zip. Non è necessario estrarre il file zip.
   
4. Accedi al tuo negozio PrestaShop e vai su Modules > Module Manager (Moduli > Gestione moduli). Fai clic su Upload a module (Carica un modulo), quindi trascina e rilascia il file zip in gestione moduli.
   
5. Al completamento, viene visualizzato un messaggio di installazione riuscita. Quindi, clicca su Configure (Configurazione) e continua con la sezione successiva.

Configura il modulo in PrestaShop

1. Devi recuperare la tua chiave API pubblica Klaviyo (ovvero l'ID del tuo sito), nonché generare una chiave API privata Klaviyo da utilizzare in PrestaShop. 
   • Accedi a Klaviyo, quindi clicca sul nome della tua organizzazione in basso a sinistra.
   • Seleziona Impostazioni > Chiavi API.
   • Copia la tua chiave API pubblica dalla pagina e incollala nell'impostazione corrispondente in PrestaShop.
   • Tornando in Klaviyo, clicca su Crea chiave API privata, assegna un nome alla chiave, seleziona Chiave di accesso completo e clicca su Crea.
   • Copia in modo sicuro la tua chiave API privata appena creata e incollala nell'impostazione corrispondente in PrestaShop.
2. Se desideri che gli eventi di ordine transazionale si sincronizzino in tempo reale, attiva Invia eventi di ordine in tempo reale a Klaviyo. Questi eventi possono essere utilizzati per inviare messaggi transazionali e appaiono come un secondo insieme di eventi etichettati come transazionali (ad esempio, metrica in Klaviyo etichettata come Ordine Transazionale effettuato, che si sincronizza in tempo reale, oltre a una metrica etichettata Ordine effettuato che si sincronizza ogni 30 minuti).
   
3. Attiva Disattiva le e-mail transazionali generate da PrestaShop per gli ordini, se lo desideri. Raccomandiamo di lasciare questa impostazione disabilitata fino a quando non avrai delle e-mail transazionali pronte per l'uso in Klaviyo. Puoi tornare a questa pagina in qualsiasi momento e attivare l'impostazione per disabilitare l'invio di PrestaShop. Si noti che l'attivazione di questa impostazione blocca le e-mail transazionali associate all'Ordine effettuato, all'Ordine evaso, all'Ordine annullato e all'Ordine rimborsato, nonché le e-mail di promemoria di pagamento. 
4. Abilita la funzione di sincronizzazione degli iscritti e-mail di PrestaShop con Klaviyo se desideri sincronizzare gli iscritti e-mail raccolti al momento del pagamento o tramite un modulo di iscrizione.
5. Se desideri consentire agli utenti di attivare il marketing via SMS durante il pagamento, abilita Sincronizza gli iscritti all'invio di SMS PrestaShop in Klaviyo .
   
   Prima di poter sincronizzare gli iscritti all'invio di SMS, devi configurare gli SMS in Klaviyo.
   
6. Clicca su Salva per procedere.
7. Se hai attivato l'impostazione di sincronizzazione degli iscritti e-mail, ti verrà richiesto di selezionare un elenco dal tuo account Klaviyo a cui aggiungere gli iscritti e-mail. Tutti i nuovi iscritti saranno aggiunti all'elenco scelto da te. Consigliamo di utilizzare l'Elenco e-mail.
   
8. Se desideri iscrivere i profili a un elenco Klaviyo utilizzando il modulo di Iscrizione alla newsletter di PrestaShop, assicurati di aver abilitato il modulo e che il modulo utilizzi la versione 2.6.0 o successiva.
9. Se hai attivato l'impostazione di sincronizzazione degli iscritti all'invio di SMS:
1. Ti verrà chiesto di selezionare un elenco dal tuo account Klaviyo a cui aggiungere iscritti SMS. Tutti i nuovi iscritti saranno aggiunti all'elenco scelto da te. Ti consigliamo di utilizzare un elenco separato per gli iscritti a e-mail e SMS.
2. Vuoi scegliere Quando i clienti si iscrivono? Puoi farlo dopo l'avvio della procedura di pagamento o dopo aver effettuato un ordine
3. Aggiungi un'etichetta di autorizzazione per la casella di marketing: utilizza un'etichetta chiara per informare gli utenti su ciò che stanno accettando (ad esempio, "Iscriviti a comunicazioni di marketing via SMS").
4. Aggiungi la comunicazione di consenso alla divulgazione. Deve includere la comunicazione per la divulgazione. Assicurati di includere le condizioni del tuo programma di marketing via SMS nei termini di servizio e nell'informativa sulla privacy. Importante: ricorda di utilizzare il linguaggio HTML nella casella di divulgazione. Esempio di comunicazione per la divulgazione:
   Selezionando questa casella e inserendo il tuo numero di telefono in alto, acconsenti a ricevere comunicazioni a scopo di marketing (ad es. promozioni, promemoria di acquisto) da [Nome dell'azienda] al numero fornito. Potrebbero essere applicate tariffe per messaggi e dati. La frequenza dei messaggi è soggetta a variazioni. Puoi annullare l'iscrizione in qualsiasi momento rispondendo STOP o cliccando sul link di annullamento dell'iscrizione (se disponibile). <a href="link">Informativa sulla privacy</a> e <a href="link">Termini</a>.
5. Puoi utilizzare l'attivatore di modifica della lingua a destra della casella dell'informativa per aggiungere un testo informativo specifico per ogni area geografica in cui il negozio viene visualizzato. 
   
10. Clicca su Salva per procedere.
11. Quindi, completa il modulo di mappatura dello stato dell'ordine, accettando i valori predefiniti o selezionando valori diversi. Gli stati dell'ordine corrispondono a quali eventi dell'ordine vengono registrati in Klaviyo. Puoi selezionare più valori per ogni evento dell'ordine. Utilizza Cmd o Ctrl+Clic per selezionare più elementi. Lo stesso valore non può essere selezionato in più eventi d'ordine. La selezione di un valore duplicato comporta un messaggio di errore e non può essere salvata. Sia gli eventi transazionali sia quelli non transazionali rispettano la mappatura degli ordini scelta da te.
12. Al termine della configurazione degli stati dell'ordine, clicca su Salva.
13. Vedrai una sezione Coupon dove potrai generare dei coupon. Nel campo Limite regola carrello, seleziona Una regola carrello per prefisso o Una regola carrello per ordine per limitare il modo in cui i clienti possono utilizzare i coupon. Per impostazione predefinita, è impostato su Una regola del carrello per prefisso, impedendo al cliente di aggiungere più di un codice con lo stesso prefisso al momento del pagamento.
    
14. Se desideri generare anche dei codici coupon utilizzando il campo Quantità da generare, puoi tornare su questa pagina in seguito. Per maggiori informazioni, leggi come creare coupon statici per PrestaShop.
15. Quindi, seleziona Advanced Parameters (Parametri avanzati) nella sezione Configure (Configurazione) della navigazione a sinistra. Seleziona Webservice. Copia la chiave webservice Klaviyo, generata per te, e continua con la sezione successiva. 
    • La chiave verrà utilizzata abilitando l'integrazione in Klaviyo nella fase successiva. Ti consigliamo di verificare che la chiave webservice abbia le autorizzazioni Klaviyo corrette selezionando l'icona della matita accanto alla chiave webservice Klaviyo. Scorri verso il basso l'elenco di tutte le autorizzazioni e individua Klaviyo. Assicurati che tutte le caselle di controllo delle autorizzazioni siano selezionate. Seleziona Salva per applicare le modifiche.

Abilita l'integrazione in Klaviyo

1. Quindi, abilita l'integrazione PrestaShop all'interno dell'account Klaviyo. In Klaviyo, seleziona il nome della tua organizzazione nell'angolo in basso a sinistra; quindi, seleziona Integrazioni. 
2. Fai clic su Aggiungi integrazioni, cerca PrestaShop e seleziona la carta. Poi, fai clic su Installa.
3. Nella pagina successiva, clicca su Connetti PrestaShop.
   
4. Nella pagina successiva, inserisci l'URL del negozio PrestaShop nel campo URL negozio . Puoi trovare l'URL del negozio nel tuo account PrestaShop in Parametri del negozio > Traffico e SEO > URL del negozio. Puoi anche cliccare su Visualizza il mio negozio per accedere rapidamente al tuo sito PrestaShop da qualsiasi pagina del tuo account per recuperare l'URL del negozio.
   
5. Incolla la chiave webservice copiata da PrestaShop nel campo chiave webservice.
6. Se desideri convertire tutte le valute utilizzate dai negozi in un'unica valuta in Klaviyo, seleziona Converti tutte le valute in una valuta standard e seleziona un codice valuta globale dall'elenco a discesa.
   • Ciò non cambia la valuta del tuo account Klaviyo. Per modificare la valuta utilizzata a livello di account, consulta la nostra guida alla Modifica della valuta per il tuo account.
7. Estrai un elenco dei tuoi negozi PrestaShop disponibili selezionando Recupera elenco di negozi. Quindi, controlla i negozi che desideri integrare. Per procedere, devi selezionare almeno 1 negozio.
8. Clicca su Connetti a PrestaShop. Verrà visualizzato un messaggio di conferma che indica che i tuoi account sono stati collegati.
   

Dati PrestaShop in Klaviyo

Esistono 3 tipi di eventi sincronizzati da PrestaShop a Klaviyo: 

• Eventi di ordine sincronizzati ogni 30 minuti (ad esempio, Ordine effettuato).
• Eventi di ordine transazionale sincronizzati in tempo reale, se scegli di abilitarli (ad esempio, Ordine transazionale effettuato).
• Eventi onsite Klaviyo (ad esempio, Attivo sul sito, Prodotto visualizzato e Aggiunto al carrello). 

Inoltre, le informazioni sui clienti vengono sincronizzate da PrestaShop ai profili Klaviyo, inclusi indirizzo e-mail, numero di telefono, consenso e-mail e consenso SMS, se applicabile. 

Puoi visualizzare tutti questi eventi in Klaviyo accedendo ad Dati analitici > Metriche. Filtra per PrestaShop se vuoi vedere gli eventi di ordini e di ordini transazionali (con icona PrestaShop) o filtra per API se vuoi vedere gli eventi onsite di Klaviyo (con icona a forma di ingranaggio). Per un elenco completo delle metriche sincronizzate da PrestaShop, consulta il documento sui dati di PrestaShop.

Quando integri PrestaShop per la prima volta, Klaviyo sincronizza i dati degli ultimi 90 giorni, in modo da poter iniziare subito a coinvolgere i clienti più recenti. Dopo la sincronizzazione dei dati degli ultimi 90 giorni, Klaviyo inizia la sincronizzazione completa dello storico dei dati. A seconda del numero di ordini, clienti e prodotti del negozio, la sincronizzazione di tutti i dati può richiedere da pochi minuti a diversi giorni.

Durante la sincronizzazione dei dati storici ti consigliamo di disporre di almeno 1024 MB di memoria PHP attribuita. Potrai così completare la sincronizzazione in modo tempestivo. Se lo desideri, i requisiti di memoria iniziali possono essere ridotti al termine della sincronizzazione cronologica.

Al termine della sincronizzazione, l'integrazione PrestaShop nella scheda Integrazioni viene contrassegnata come completata. Per verificare che tutti i dati di PrestaShop siano sincronizzati correttamente, puoi controllare gli ordini totali per alcuni giorni o una settimana. Prima di iniziare la convalida, assicurati che il fuso orario del tuo account corrisponda alle impostazioni di PrestaShop. Per controllare o aggiornare il fuso orario del tuo account:

1. Clicca sul nome della tua organizzazione in basso a sinistra.
2. Seleziona Impostazioni.
3. Seleziona la scheda Organizzazione. 

Invia e-mail transazionali

Vuoi inviare e-mail transazionali utilizzando i dati degli ordini in tempo reale sincronizzati da PrestaShop? Per farlo, devi creare flussi da zero in Klaviyo. Leggi Come utilizzare i flussi per inviare e-mail transazionali se vuoi scoprire come funzionano le e-mail transazionali in Klaviyo. Devi impostare questi flussi e poi contattare il team di supporto di Klaviyo per farli approvare. Una volta approvati, puoi disattivare l'invio di e-mail transazionali in PrestaShop e impostare i tuoi flussi transazionali in Klaviyo. 

Aggiorna il modulo

Stai utilizzando una versione del modulo PrestaShop precedente alla 1.4.1? Ti consigliamo di aggiornare immediatamente alla versione 1.4.1 o successive. Le versioni precedenti del modulo utilizzano le API v1 e v2 di Klaviyo, che sono state ritirate dal mercato e non funzionano più come previsto.

Inoltre, l'aggiornamento alla versione 1.4.1 o successiva ti consente di sfruttare le seguenti funzionalità rilasciate per la prima volta nella versione 1.3.0:

1. Visualizza facilmente il prezzo reale e l'imposta sul valore aggiunto (IVA) inclusa per i prodotti promossi nelle tue e-mail. Tieni presente che l'aggiornamento dalla versione precedente alla versione 1.2.10 o successiva può causare imprecisioni nei modelli di e-mail a causa della modifica. Per informazioni su come rimediare, leggi il nostro articolo.
2. Invia e-mail transazionali ai tuoi clienti con la sincronizzazione degli eventi in tempo reale.
3. Genera e importa rapidamente coupon in blocco in Klaviyo.

Per aggiornare il tuo modulo alla versione più recente:

1. Accedi all'account amministratore PrestaShop.
2. Vai a Moduli > Gestione moduli.
3. Scorri per trovare il modulo Klaviyo e seleziona Upgrade (Aggiorna). 
   

Per conoscere le modifiche apportate in ciascuna versione, vai al modulo Klaviyo sul marketplace Addons, scorri verso il basso fino a Novità e clicca su Mostra cronologia del registro delle modifiche. 

Ti interessa una versione con patch?

Se stai utilizzando il modulo PrestaShop di Klaviyo versione 1.2.18 o 1.2.9 e desideri utilizzare una versione con patch corrispondente (al contrario del modulo più recente di Klaviyo), queste patch sono disponibili. Per eseguire l'aggiornamento a questi moduli:

1. Accedi all'account amministratore PrestaShop. 
2. Vai a Moduli > Gestione moduli.
3. Trova il modulo Klaviyo, clicca sul menu a discesa accanto ad Aggiorna e seleziona Disinstalla.
   
4. Utilizza questi link per scaricare la versione della patch:
   • 1.2.18+v3api.zip 
   • 1.2.9+v3api.zip
5. Carica il modulo nel gestore dei moduli di PrestaShop, iniziando con il passaggio 4 nella sezione precedente. 
6. Reintegra PrestaShop con Klaviyo continuando a seguire i passaggi. 

Risultato 

Ora hai integrato PrestaShop con Klaviyo e puoi iniziare a utilizzare Klaviyo per le tue esigenze di marketing. 

Risorse aggiuntive

• Documento sui dati PrestaShop

• Come abilitare i prezzi con IVA inclusa per PrestaShop
• Come creare coupon per PrestaShop