Come integrarsi con Spree

Imparerai

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

• Dati sulle vendite e sugli ordini, compresi i prodotti acquistati, le immagini dei prodotti, i dettagli delle varianti e gli sconti applicati.
• Le informazioni sui clienti includono il nome e il cognome, la località e il modo in cui hanno trovato il suo negozio.
• Dati dell'ordine evaso

Aggiungi l'integrazione Spree a Klaviyo

1. In Klaviyo, seleziona la scheda Integrazioni.
2. Clicchi su Aggiungi integrazioni, cerchiSpree e clicchi sulla scheda. Poi, faccia clic su Installa.
3. Nella pagina successiva, dovrà fornire l'URL del suo negozio e una chiave API Spree / Password criptata. Può generare questa chiave API nell'amministrazione di Spree, navigando su Utenti, scegliendo un account e poi selezionando Genera chiave API.
4. Di nuovo in Klaviyo, incolli il suo URL del negozio e la sua chiave API/password criptata nelle caselle.
   
5. Se sta utilizzando una versione di Spree API (v1), selezioni la casella corrispondente.
6. Clicchi su Connetti a Spree. 
7. Se desidera aggiungere i clienti che hanno scelto di ricevere e-mail dal suo negozio Spree ad una lista in Klaviyo, selezioni la casella Aggiungi nuovi clienti Spree ad una lista Klaviyo nella pagina successiva. Dopo aver selezionato questa casella, selezioni un elenco al quale verranno aggiunti i nuovi opt-in.
8. Quando è pronto, clicchi su Completa la configurazione. Dovrebbe quindi visualizzare un messaggio di successo che indica che l'integrazione è avvenuta con successo.

Installare il monitoraggio in loco di Klaviyo

Per installare il tracciamento in loco, che consiste in due eventi: Attivo sul sito e Prodotto visto, deve innanzitutto trovare la sua chiave API pubblica. Acceda al suo account Klaviyo e vada su Nome account > Impostazioni > Chiavi API. La sua chiave pubblica è lunga sei caratteri. Copia in modo sicuro questa chiave per utilizzarla nella fase successiva. 

Ci sono due tipi di tracciamento in loco che può sfruttare:

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

"Tracciamento attivo sul sito"

Questa metrica viene tracciata ogni volta che un browser identificabile visita il suo sito web.

1. Per iniziare a tracciare l'attività di Active on Site, aggiunga il seguente frammento di codice al modello principale del suo negozio, in modo che sia incluso in tutte le pagine. Dovrebbe collocare questo snippet insieme ad altri script di analisi che utilizza oppure subito prima del tag di chiusura </body >.</body>
2. Si assicuri di sostituire Public API Key con la chiave Public API del suo account Klaviyo:

   <tipo di script="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=PUBLIC_API_KEY"></script>
   <tipo di script="text/javascript"> 
   //Inizializza l'oggetto Klaviyo al caricamento della pagina
   !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]=argomenti[w];var t="function"==typeof o[o.length-1]?o.pop():void 0,e=new Promise((function(n){finestra._klOnsite.push([i].concat(o,[function(i){t&&t(i),n(i)}]))});return e}}})}catch(n){finestra.klaviyo=finestra.klaviyo||[],finestra.klaviyo.push=funzione(){var n;(n=finestra._klSito).push.apply(n,argomenti)}}}}(); </script>

3. A seconda dei tipi di template che utilizza per il suo sito web, le sintassi {% if user.is_logged_in %} e {{ user.email }} sono probabilmente diverse. Utilizzando la lingua del modello disponibile, desidera verificare se la persona che sta visualizzando la pagina corrente ha effettuato l'accesso. In caso affermativo, dovrebbe fornire la loro e-mail e il loro nome, se disponibili. Se non ha informazioni sul nome, rimuova queste due righe e la virgola dopo la riga $email.
4. Questo codice di monitoraggio Klaviyo le permetterà di tracciare un'Attiva su Sitemetric, in modo da poter vedere e sfruttare i dati relativi alle visite al sito e al comportamento dei visitatori. Attraverso questa metrica, Klaviyo terrà traccia dell'attività sul sito per i browser conosciuti.
5. Per verificare che il suo tracking onsite sia impostato correttamente, vada su una pagina del suo negozio e aggiunga ?utm_email=email@example.com alla fine dell'URL, sostituendo email@example.com con il suo indirizzo e-mail. Dopo aver ricaricato la pagina, cerchi in Klaviyo il suo indirizzo e-mail. Dovrebbe vedere che è stato creato un profilo e che è stata tracciata l'attività del suo sito. 

"Tracciamento del prodotto visualizzato"

Se desidera impostare un flusso di abbandono della navigazione o costruire segmenti basati sui dati di navigazione dei prodotti, dovrà aggiungere il tracciamento degli eventi JavaScript per la metrica Prodotto visto.

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

   <script type="text/javascript">
    var klaviyo = window.klaviyo || [];
    klaviyo.track("Visualizzato Prodotto", {
       Titolo: '{{ product.name }}',
       ItemId: {{ product.id }},
       Categorie: {{ category in product.categories|json }}, // L'elenco delle categorie è un array di stringhe.
       ImageUrl: '{{ product.image_url }}',
       Url: '{{ product.permalink }}',
       Metadati: {
       Marchio: '{{ product.brand }}',
       Prezzo: {{ product.price }},
       In vendita: {{ product.on_sale }},
       Prezzo regolare: {{ product.regular_price }},
       Prezzo di vendita: {{ product.sale_price }}
    }
    });
   </script>

2. Lo snippet qui sopra utilizza la sintassi del segnaposto {{ }}, che potrebbe essere diversa per il suo negozio Spree. La parte importante è che i campi del prodotto sono resi dinamicamente in base alla pagina del prodotto che sta visualizzando.
3. Dopo aver configurato il tracciamento dei prodotti visti per il suo sito, i dati dei prodotti visti dovrebbero iniziare a comparire nel suo account Klaviyo quando i visitatori noti sfogliano le pagine dei prodotti.

Come funziona il monitoraggio in loco

Quando aggiunge il tracciamento onsite di Klaviyo al suo sito, siamo in grado di tracciare solo l'attività di navigazione dei browser noti "" - cioè i browser che hanno visitato e si sono impegnati almeno una volta in precedenza. Ci sono due modi principali in cui siamo in grado di identificare un visitatore del sito ai fini del tracciamento in loco:

• Se qualcuno, a un certo punto, ha cliccato attraverso un'email di Klaviyo per raggiungere il suo sito web
• Se qualcuno, a un certo punto, si è iscritto/optato attraverso un modulo Klaviyo

Klaviyo non terrà traccia dei browser anonimi.

Monitorare la sincronizzazione di Klaviyo 

Per verificare la sua integrazione:

1. Clicchi sul menu a tendina Analytics in Klaviyo e selezioni Metriche. Qui può filtrare per visualizzare tutte le metriche di Spree.
2. Trovi l'Ordinatore posizionatodi Spree e clicchi sull'icona Feed di attività. Se la sua integrazione ha iniziato a sincronizzare i dati, inizierà a vedere popolarsi gli eventi dell'Ordine Effettuato.
3. Sincronizzeremo automaticamente tutti i dati storici degli ordini. Per verificarlo, può confrontare il numero di eventi in un determinato giorno in Klaviyo con quello presente nella sua interfaccia Spree e confermare che corrispondono. Per esempio, quando esplora la metrica Ordine effettuato, può 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. Confronti questo numero con quello memorizzato in Spree da ieri e vedrà che corrispondono esattamente. Se non lo fanno, il problema è molto probabilmente che il fuso orario del suo account Klaviyo non corrisponde al fuso orario di Spree impostato.
5. Per verificare l'impostazione del fuso orario in Klaviyo:
   • Clicchi sul nome del suo account in basso a sinistra.
   • Selezioni poi Impostazioni > Organizzazione.
   • Scorra in basso fino a Fuso orario.
6. Una volta completata questa sincronizzazione storica, vedrà un bordo verde chiaro intorno alla sua integrazione Spree nella scheda Integrazioni.

Dati sincronizzati da Spree

Di seguito sono elencate le metriche che Spree sincronizza con Klaviyo. Può visualizzare tutte le metriche Spree che si sincronizzano con il suo account alla voce Analytics > Metriche. 

Ordine effettuato 

Questa metrica registra un evento ogni volta che qualcuno effettua un ordine e lo paga con successo. Corrisponde agli ordini in Spree che sono completi, il che significa che il cliente ha completato l'intero processo di checkout. Con questa metrica, può facilmente creare elenchi dinamici di persone in base al numero di ordini effettuati o al loro valore di vita. Può anche creare e-mail per coinvolgere nuovamente i clienti passati o inviare e-mail di ringraziamento per i primi acquirenti. Può filtrare e indirizzare gli eventi di Ordine piazzato in base ai seguenti criteri:

• IsDiscounted
  Se ad un ordine è stato applicato uno sconto, ad esempio, vero o falso.
• ItemNames
  I nomi dei prodotti acquistati in questo evento.

Prodotto ordinato

Questa metrica è simile a quella dell'Ordine effettuato, tuttavia viene registrato un evento per ogni articolo che qualcuno ordina. Ad esempio, se qualcuno acquista una maglietta e un paio di pantaloncini, questo apparirà in Klaviyo come un evento Ordine effettuato e due eventi Prodotto ordinato, uno per la maglietta e uno per il paio di pantaloncini. Questa metrica è utile per costruire elenchi che si rivolgono a clienti che hanno acquistato (o non hanno acquistato) articoli specifici o articoli in categorie specifiche. Può anche utilizzare la metrica Prodotto ordinato come trigger per i flussi per inviare e-mail su prodotti correlati che vanno naturalmente insieme, ma che alcuni clienti non hanno ancora acquistato.

• Categorie
  Le categorie a cui appartiene il prodotto ordinato, ad esempio Camicie, Uomo o Vendita.
• Nome
  Il nome del prodotto acquistato, ad esempio T-Shirt rossa da uomo.
• ProductId
  L'id del suo prodotto come è impostato nel suo negozio, ad esempio 2022, 2023, 2024.
• Quantità
  La quantità di un prodotto ordinato.
• SKU
  Lo SKU del prodotto come è impostato nel suo negozio.
• Opzione Variante: Colore
  Il colore del prodotto, se disponibile, ad esempio Rosso o Blu.
• Opzione Variante: Taglia
  La taglia del prodotto, se disponibile, ad esempio Medium o Large.

Ordine evaso

Questa metrica registra un evento quando l'ordine di un cliente viene spedito. L'evento in Klaviyo include il numero di tracking per qualsiasi spedizione, quindi può utilizzare questa metrica come trigger per le e-mail di conferma della spedizione. Un'altra email comune basata sulla metrica Ordine evaso è l'email di recensione del prodotto, in cui si chiede ai clienti di lasciare una recensione sugli articoli che hanno acquistato di recente. L'utilizzo della metrica Ordine evaso le consente di programmare queste e-mail in base al momento in cui qualcuno riceve l'ordine, in modo da non doversi preoccupare di inviare loro un'e-mail prima che abbiano ricevuto il pacco. Può filtrare e indirizzare gli eventi Ordine evaso in base ai seguenti criteri:

• IsDiscounted
  Se ad un ordine è stato applicato uno sconto, ad esempio, vero o falso.
• ItemNames
  I nomi degli articoli acquistati in questo evento.

Avviato il checkout

Questa metrica registra un evento ogni volta che qualcuno inizia un checkout e ha inserito il proprio indirizzo e-mail. L'uso principale di questa metrica è l'invio di e-mail sui carrelli abbandonati. Con Klaviyo, può facilmente impostare un flusso di e-mail per inviare un promemoria del carrello se qualcuno ha iniziato il checkout ma non ha effettuato l'ordine dopo alcune ore. L'evento Checkout avviato contiene tutte le informazioni sul carrello di una persona, per cui può mostrare i prodotti presenti nel carrello e le relative immagini. Per gli utenti più avanzati, può impostare due flussi di carrello abbandonato: uno per i primi clienti che include un codice di sconto e uno per gli acquirenti abituali che non include un codice di sconto. Può filtrare e indirizzare gli eventi di Checkout avviato in base ai seguenti criteri:

• IsDiscounted
  Se ad un ordine è stato applicato uno sconto, ad esempio, vero o falso.
• ItemNames
  I nomi degli articoli acquistati in questo evento.

Dati del cliente

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

• Email
• Nome
• Cognome
• Città
• Stato/Regione
• Codice postale
• Paese
• Numero di telefono

Risultato

Ora ha integrato il suo account Klaviyo con Spree, ha installato il monitoraggio in loco e ha esaminato i dati sincronizzati.

Risorse aggiuntive

• Con quale frequenza le integrazioni sincronizzano il riferimento
• Ha bisogno di ulteriore aiuto per l'integrazione con Klaviyo? Scopra le agenzie partner di Klaviyo