Come effettuare l'integrazione con Spree

Cosa imparerai

Scopri come integrare Spree con Klaviyo. Dopo aver completato questi passaggi, potrai personalizzare e indirizzare le e-mail in base agli acquisti e all'attività sul sito web di ciascun cliente. Ecco i dati che sincronizziamo da Spree:

• Dati di vendite e ordini, inclusi quali prodotti sono stati acquistati, le immagini dei prodotti, i dettagli della variante ed eventuali sconti applicati
• Informazioni sul cliente, tra cui nome e cognome, posizione e come ha trovato il tuo negozio
• Dati degli ordini evasi

Aggiungi l'integrazione Spree in Klaviyo

1. In Klaviyo, seleziona la scheda Integrazioni.
2. Clicca su Scopri le app, cerca Spree e clicca sulla scheda. Dopodiché, clicca su Installa.
3. Nella pagina successiva dovrai fornire l'URL del tuo store e una chiave API di Spree / una password crittografata. Puoi generare questa chiave API nell'admin di Spree andando su Users, scegliendo un account e poi selezionando Generate API Key.
4. Di nuovo in Klaviyo, incolla l'URL del tuo negozio e la chiave API/password crittografata nelle caselle.
   

5. Se stai utilizzando una versione con controllo delle versioni dell'API Spree (v1), seleziona la casella corrispondente.
6. Clicca su Connetti a Spree.
7. Se vuoi aggiungere a un elenco in Klaviyo i clienti che scelgono di ricevere e-mail dal tuo store Spree, seleziona la casella Add new Spree customers to a Klaviyo list nella pagina successiva. Dopo aver selezionato questa casella, scegli un elenco a cui verranno aggiunti i nuovi opt-in.
8. Quando hai finito, fai clic su Completa la configurazione. Dovresti quindi vedere un messaggio di conferma che indica che l’integrazione è stata completata correttamente.

Installa il tracciamento sul sito Klaviyo

Per installare il tracciamento onsite, che consiste di due eventi - Attivo sul sito e Prodotto visualizzato, trova innanzitutto la tua chiave API pubblica. Accedi al tuo account Klaviyo e vai a Nome account > Impostazioni > Chiavi API. La tua chiave pubblica è lunga sei caratteri. Copia questa chiave in modo sicuro per utilizzarla nel passaggio successivo.

Esistono due tipi di tracciamento sul sito che puoi sfruttare:

• Attivo sul sito
  Questa metrica viene tracciata ogni volta che un browser identificabile visita il tuo sito web
• Prodotto visualizzato
  Questa metrica viene rilevata ogni volta che un browser identificabile visualizza una pagina prodotto sul tuo sito web

Tracciamento "Attivo sul sito"

Questa metrica viene monitorata ogni volta che un browser identificabile visita il tuo sito web.

1. Per iniziare il tracciamento dell'attività Active on Site, aggiungi il seguente snippet di codice al modello principale del tuo negozio, in modo che sia incluso in tutte le pagine. Dovresti inserire questo snippet insieme agli altri script di analisi che usi oppure subito prima del tag di chiusura </body>.
2. Assicurati di sostituire Public API Key con la chiave API pubblica del tuo account Klaviyo:

<script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
<script type="text/javascript"> 
//Initialize the Klaviyo object on page load
!function(){if(!window.klaviyo){window._klOnsite=window._klOnsite||[];try{window.klaviyo=new Proxy({},{get:function(n,i){return"push"===i?function(){var n;(n=window._klOnsite).push.apply(n,arguments)}:function(){for(var n=arguments.length,o=new Array(n),w=0;w<n;w++)o[w]=arguments[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){window._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))}));return e}}})}catch(n){window.klaviyo=window.klaviyo||[],window.klaviyo.push=function(){var n;(n=window._klOnsite).push.apply(n,arguments)}}}}(); </script>

1. A seconda dei tipi di modelli che usi per il tuo sito web, la sintassi {% if user.is_logged_in %} e {{ user.email }} probabilmente è diversa. Utilizzando il linguaggio del modello disponibile, devi verificare se la persona che visualizza la pagina corrente ha effettuato l’accesso. Se sì, dovresti restituire il loro e-mail e nome, se disponibili. Se non hai informazioni sul nome, rimuovi quelle due righe e la virgola finale dopo la riga dell’e-mail $email.
2. Questo codice di tracciamento di Klaviyo ti consentirà di tracciare una metrica Active on Sitein modo da poter visualizzare e sfruttare i dati relativi alle visite al sito e al comportamento dei visitatori. Tramite questa metrica, Klaviyo terrà traccia dell’attività sul sito per i browser conosciuti.
3. Per verificare che il tracciamento sul sito sia configurato correttamente, vai a una pagina del tuo negozio e aggiungi ?utm_email=email@example.com alla fine dell'URL sostituendo email@example.com con il tuo indirizzo e-mail. Dopo aver ricaricato la pagina, cerca il tuo indirizzo e-mail in Klaviyo. Dovresti vedere che è stato creato un profilo e che ha tracciato l'attività sul tuo sito.

Tracciamento di "Prodotto visualizzato"

Se desideri impostare un flusso di abbandono della navigazione o creare segmenti basati sui dati di navigazione dei prodotti, ti consigliamo di aggiungere il tracciamento degli eventi JavaScript per la metrica Viewed Product.

1. Nel modello della pagina prodotto, aggiungi il seguente snippet:

<script type="text/javascript">
 var klaviyo = window.klaviyo || [];
 klaviyo.track("Viewed Product", {
    Title: '{{ product.name }}',
    ItemId: {{ product.id }},
    Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings.
    ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.permalink }}',
    Metadata: {
    Brand: '{{ product.brand }}',
    Price: {{ product.price }},
    OnSale: {{ product.on_sale }},
    RegularPrice: {{ product.regular_price }},
    SalePrice: {{ product.sale_price }}
 }
 });
</script>

1. Lo snippet sopra utilizza la sintassi del segnaposto {{ }}, che potrebbe essere diversa per il tuo store Spree. La parte importante è che i campi prodotto vengono visualizzati dinamicamente in base alla pagina prodotto che stai visualizzando.
2. Dopo che il tracciamento Viewed Product è stato configurato per il tuo sito, i dati Viewed Product dovrebbero iniziare a popolarsi nel tuo account Klaviyo mentre i visitatori conosciuti navigano tra le tue pagine prodotto.

Come funziona il tracciamento sul sito

Quando aggiungi il tracciamento sul sito di Klaviyo al tuo sito, possiamo tracciare solo l’attività di navigazione dei "browser noti", ovvero i browser che hanno visitato e coinvolto almeno una volta in precedenza. Ci sono due modi principali in cui possiamo identificare un visitatore del sito ai fini del tracciamento sul sito:

• Nel caso in cui qualcuno a un certo punto abbia fatto clic su un'e-mail Klaviyo che porta al tuo sito web
• Nel caso in cui qualcuno a un certo punto abbia effettuato l’iscrizione tramite un modulo di Klaviyo

Klaviyo non terrà traccia dei browser anonimi.

Monitora la sincronizzazione di Klaviyo

Per verificare la tua integrazione:

1. In Klaviyo, fai clic sul menu a tendina Analisi e seleziona Metrica. Qui puoi filtrare per visualizzare tutte le metriche di Spree.
2. Trova la metrica Placed Orderdi Spree e clicca sull'icona Feed attività. Se la tua integrazione ha iniziato a sincronizzare i dati, inizierai a vedere qui gli eventi Placed Order.
3. Sincronizzeremo automaticamente tutti i dati storici degli ordini. Per verificarlo, puoi confrontare il numero di eventi in un giorno specifico in Klaviyo con quello presente nella tua interfaccia Spree e confermare che corrispondano. Ad esempio, quando esplori la metrica Placed Order, puoi passare il mouse sul punto dati di ieri o guardare la tabella dei dati sotto il grafico per vedere quanti ordini sono stati segnalati ieri.
4. Confronta quel numero con quello memorizzato in Spree da ieri e dovresti vedere che corrispondono esattamente. In caso contrario, è molto probabile che il fuso orario dell’account Klaviyo non corrisponda al fuso orario di Spree impostato.
5. Per verificare l’impostazione del tuo fuso orario in Klaviyo:
   • Fai clic sul nome del tuo account in basso a sinistra.
   • Seleziona, quindi clicca su Impostazioni > Organizzazione.
   • Scorri verso il basso fino a Fuso orario.
6. Una volta completata questa sincronizzazione storica, vedrai un bordo verde chiaro attorno all'integrazione Spree nella scheda integrazioni.

Dati sincronizzati da Spree

Di seguito è riportato un elenco di metriche che Spree sincronizza in Klaviyo. Puoi visualizzare tutte le metriche di Spree che si sincronizzano nel tuo account in Dati analitici > Metriche.

Ordine effettuato

Questa metrica registra un evento ogni volta che qualcuno effettua un ordine e lo paga correttamente. Corrisponde agli ordini in Spree che sono completati, ovvero quando un cliente ha completato l’intero processo di checkout. Con questa metrica, puoi creare facilmente elenchi dinamici di persone in base al numero di ordini effettuati o al valore del ciclo di vita. Puoi anche creare e-mail per coinvolgere di nuovo i clienti passati o inviare e-mail di ringraziamento ai clienti per chi acquista per la prima volta. Puoi filtrare e targetizzare gli eventi Placed Order in base ai seguenti criteri:

• IsDiscounted
  Se a un ordine è stato applicato uno sconto, ad es. true o false.
• ItemNames
  I nomi dei prodotti acquistati in questo evento.

Prodotto ordinato

Questa metrica è simile alla metrica Placed Order; tuttavia, viene registrato un evento per ogni articolo ordinato. Ad esempio, se qualcuno ha acquistato una t-shirt e un paio di shorts, in Klaviyo ciò apparirà come un evento Placed Order e due eventi Ordered Product, uno per la t-shirt e uno per il paio di shorts. Questa metrica è utile per creare elenchi che si rivolgono a clienti che hanno acquistato (o non hanno acquistato) articoli specifici o articoli in categorie specifiche. Puoi anche usare la metrica Ordered Product come attivatore per i flussi, per inviare e-mail su prodotti correlati che si abbinano naturalmente tra loro, ma che alcuni clienti non hanno ancora acquistato.

• Categorie
  Le categorie a cui appartengono i prodotti ordinati, ad esempio Camicie, Uomo o Saldi.
• Nome
  Il nome del prodotto acquistato, ad esempio T-shirt rossa da uomo.
• ProductId
  L'ID del tuo prodotto, come è impostato nel tuo negozio, ad esempio 2022, 2023, 2024.
• Quantity
  La quantità di un prodotto ordinata.
• SKU
  Lo SKU del prodotto così come è impostato nel tuo negozio.
• Opzione variante: colore
  Il colore del prodotto, se disponibile, ad es., Rosso o Blu.
• Opzione variante: dimensione
  La dimensione del prodotto, se disponibile, ad esempio Media o Grande.

Ordine evaso

Questa metrica registra un evento quando l’ordine di un cliente viene spedito. L’evento in Klaviyo include il numero di tracciamento per tutte le spedizioni, quindi puoi usare questa metrica come attivatore per le e-mail di conferma della spedizione. Un'altra e-mail comune basata sulla metrica Fulfilled Order è l'e-mail di recensione del prodotto, in cui chiedi ai clienti di lasciare una recensione sugli articoli acquistati di recente. L'uso della metrica Fulfilled Order ti consente di programmare queste e-mail in base a quando una persona riceve l'ordine, così non devi preoccuparti di inviare un'e-mail prima che abbia ricevuto il pacco. Puoi filtrare e targetizzare gli eventi Fulfilled Order in base ai seguenti criteri:

• IsDiscounted
  Se a un ordine è stato applicato uno sconto, ad es. true o false.
• ItemNames
  I nomi degli articoli acquistati in questo evento.

Pagamento avviato

Questa metrica registra un evento ogni volta che una persona avvia un checkout e ha inserito il suo indirizzo e-mail. L'uso principale di questa metrica è l'invio di e-mail sul carrello abbandonato. Con Klaviyo puoi configurare facilmente un flusso e-mail per inviare un promemoria del carrello se una persona ha iniziato il checkout ma non ha effettuato un ordine dopo alcune ore. L'evento Started Checkout contiene tutte le informazioni sul carrello di una persona, quindi puoi mostrare i prodotti nel suo carrello e anche le immagini di questi prodotti. Per utenti più avanzati, puoi configurare due flussi di carrello abbandonato -- uno per i clienti alla prima esperienza che include un codice sconto e uno per chi acquista di nuovo che non include un codice sconto. Puoi filtrare e targetizzare gli eventi Started Checkout in base ai seguenti criteri:

• IsDiscounted
  Se a un ordine è stato applicato uno sconto, ad es. true o false.
• ItemNames
  I nomi degli articoli acquistati in questo evento.

Dati dei clienti

Oltre alle metriche che Klaviyo sincronizza da Spree, ci sono anche proprietà dei clienti che vengono aggiunte a ogni profilo Klaviyo. Puoi usare queste proprietà nei segmenti e nei flussi. Ecco le proprietà sincronizzate automaticamente da Spree:

• E-mail
• Nome
• Cognome
• Città
• Stato/Regione
• CAP
• Paese
• Numero di telefono

Risultato

Ora hai integrato il tuo account Klaviyo con Spree, hai installato il tracciamento onsite e hai esaminato i dati sincronizzati.

Risorse aggiuntive