Come integrarsi con Volusion

Imparerai

Scopra come integrare Volusion con Klaviyo. Dopo aver completato questi passaggi, sarà in grado di personalizzare e indirizzare le e-mail in base ai dati degli ordini sincronizzati e alle proprietà dei clienti.

Da Volusion, Klaviyo tiene traccia delle statistiche relative al Prodotto Ordinato e all' Ordine Effettuato; con l'aggiunta di un po' di codice supplementare, possiamo tenere traccia anche delle informazioni sul Carrello Abbandonato.

Prima di iniziare

Volusion richiede un aggiornamento della password dell'account amministratore del suo negozio Volusion ogni 90 giorni. Quando effettua questo aggiornamento sul suo account Volusion, deve anche effettuare l'aggiornamento dell'integrazione Volusion nel suo account Klaviyo. Può anche creare una chiave API permanente seguendo i passaggi nella sezione corrispondente di questo articolo.

Aggiungere l'integrazione Volusion in Klaviyo

1. Per abilitare Klaviyo's Volusion integrazioni, navighi su Klaviyo e clicchi sul nome del suo account nell'angolo in basso a sinistra, quindi selezioni integrazioni > Aggiungi integrazioni.
2. Cerchi Volusion e clicchi sulla scheda, quindi su Installa.
3. Nella pagina successiva, inserisca il suo URL del negozio, l'e-mail di accesso e la chiave API/password criptata. Poi, clicchi su Connetti a Volusion.
   
4. Nella pagina successiva, vedrà una casella di controllo per Aggiungere nuovi clienti Volusion a un elenco Klaviyo. Se seleziona questa casella, può scegliere una delle sue liste in Klaviyo a cui verranno aggiunti i futuri clienti quando effettueranno un ordine.
5. Infine, faccia clic su Completa la configurazione.

Disabilita il tracciamento da e-mail a web in Klaviyo

1. La funzione "email to web tracking" di Klaviyo utilizza il click tracking per identificare un utente che arriva al suo sito web attraverso un'email di Klaviyo prima che noi siamo in grado di identificarlo (ad esempio quando effettua un acquisto o si iscrive alla sua lista email).
2. Volusion non supporta il formato URL che il nostro tracciamento dei clic utilizza e produce un errore quando un utente cerca di visitare il suo negozio attraverso uno di questi link, quindi questa funzione dovrà essere disattivata in Klaviyo per assicurarsi che i link nelle sue e-mail arrivino correttamente al suo negozio Volusion.
3. Può disattivare questo tracciamento nelle impostazioni del suo account alla voce Nome account > Impostazioni > Email > Attribuzione.
4. L'unica funzionalità persa con la disattivazione di questa funzione è la possibilità di rintracciare un nuovo profilo sul suo sito web attraverso un'e-mail che ha cliccato. Finché avrà l'analitica di tracciamento onsite di Klaviyo sul suo sito web (che aggiungeremo nella prossima sezione), saremo comunque in grado di tracciare gli utenti non appena riceveremo il loro indirizzo e-mail attraverso un acquisto nel suo negozio o quando si iscriveranno a una lista e-mail.

Aggiunga il tracking onsite al suo negozio Volusion

Klaviyo fornisce due snippet di monitoraggio in loco per aiutarla a raccogliere informazioni preziose sui suoi clienti:

• Attivo sul sito
  Questo snippet rileva quando i suoi clienti visitano il suo sito. Questo snippet deve essere aggiunto al sito affinché altri snippet, come Viewed Product, funzionino.
• Prodotto visto
  Questo snippet tiene traccia di quando i suoi clienti visualizzano determinati prodotti. Può tracciare questo evento aggiungendo lo snippet di codice Viewed Product al suo negozio.

Aggiungere il monitoraggio di Attivo sul sito

Aggiunga il seguente snippet Klaviyo.js in modo che appaia in ogni pagina del suo sito web. Questo abiliterà il monitoraggio Active on Site e i moduli Klaviyo. Si assicuri di sostituire PUBLIC_API_KEY con la sua chiave API pubblica di Klaviyo.

<script type="application/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> //Script per inizializzare 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>

Aggiungi il monitoraggio dei prodotti visti

Per abilitare il monitoraggio del Prodotto Visualizzato, dovrà aggiungere il frammento di codice qui sotto alla pagina del modello del suo negozio nel File Editor di Volusion, che può trovare cliccando su Design > File Editor.

<script type="text/javascript">
// Controlla se il cliente si trova sulla pagina del prodotto prima di eseguire il codice.
    se ($("meta[property='og:type']").attr("contenuto") == "prodotto") {
        var klaviyo = window.klaviyo || [];
        // Funzione per tracciare quando un prodotto viene visualizzato
        var trackViewedProduct = function(item) {
            klaviyo.track("Visualizzato Prodotto", articolo);
            klaviyo.trackViewedItem({
                "Titolo": articolo.ProductName,
               "ItemId": articolo.ProductID,
               "ImageUrl": articolo.ImageURL,
               "Url": articolo.URL,
               "Metadati": {
                    "Price": item.Price,
                    "Description": item.Description,
                    "CompareAtPrice": item.CompareAtPrice,
                    "YouSave": item.YouSave
                }
            });
        };
        var item = {}
        $.get(`/ProductDetails.asp?ProductCode=${global_Current_ProductCode}`, function(data) {
            var product_saleprice = $("table.colors_pricebox div.product_saleprice").length ?
                Numero(`${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_saleprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_listprice = $("table.colors_pricebox div.product_listprice").length ?
                Numero(`${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_listprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var prezzo_prodotto = $("table.colors_pricebox div.product_productprice").length ?
                Numero(`${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_productprice").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : null;
            var product_yousave = $("table.colors_pricebox div.product_yousave").length ?
                Numero(`${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[0]}.${$("table.colors_pricebox div.product_yousave").text().trim().split("$")[1].split(".")[1].substring(0,2)}`) : 0;
            articolo = {
                "ProductName": $("meta[property='og:title']").attr("content"),
                "ProductID": global_Current_ProductCode,
                "Description": $("meta[property='og:description']").attr("content"),
                "ImageURL": $("meta[property='og:image']").attr("content"),
                "URL": $("meta[property='og:url']").attr("content"),
                "Price": product_saleprice ? product_saleprice : product_productprice,
                "CompareAtPrice": product_listprice ? product_listprice : product_productprice,
                "YouSave": product_yousave
            };
            trackViewedProduct(item);
        });
    } 
</script>

Aggiungere promemoria per i carrelli abbandonati

Volusion non fornisce un modo immediato per tracciare i carrelli abbandonati attraverso la nostra integrazione, ma abbiamo creato uno script personalizzato che può aggiungere al suo negozio Volusion e che le permetterà di utilizzare questa funzione in Klaviyo. Questo richiederà una certa conoscenza dell'aggiunta di codice al modello del suo negozio, quindi se ha uno sviluppatore, può inviargli questo documento per spiegargli come aggiungere il codice.

1. Dovrà aggiungere il frammento di codice qui sotto alla pagina del modello del suo negozio nel File Editor di Volusion, che può trovare cliccando su Design > File Editor.

   <script type="text/javascript">
       // Controlla se il cliente si trova nella pagina di checkout prima di eseguire il codice.
       if (window.location.pathname == "/one-page-checkout.asp") {
           var klaviyo = window.klaviyo || [];
           // Funzione per tracciare quando viene avviato un checkout.
           var trackStartedCheckout = function() {
               $.post('/AjaxCart.asp', function(data) {
                   if (!data |||data.Products ||data.Products.length) {
                       return;
                   }
                   var items = [],
                       nomi = [],
                       skus = [];
                   // Cattura ogni prodotto e il suo SKU/nome/quantità/prezzo/prezzo totale/immagine url
                   $.each(data.Products, function(i, record) {
                       var item_price = +(record.ProductPrice.replace(/[\$,]+/g, '')) / record.Quantity;
                       items.push({
                           SKU: record.ProductCode,
                           Name: record.ProductName,
                           Quantity: +record.Quantity,
                           ItemPrice: item_price,
                           RowTotal: item_price * record.Quantity,
                           ImageURL: record.ImageSource
                       });
                       names.push(record.ProductName);
                       skus.push(record.ProductCode);
                   });
                   // Spinga la metrica Started Checkout a Klaviyo con i dati dei clienti.
                   klaviyo.track("Avviata Checkout", {
                       $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                       Items: items,
                       ProductNames: names,
                       SKUs: skus
                   });
               }, 'json');
           };
           $(function() {
               // Prenda il modulo e-mail per ottenere l'e-mail del cliente e leghi l'evento a tale e-mail in Klaviyo.
               $('[nome"OnePageCheckoutForm"] [nome"Email"]').change(function(e) {
                   var email = $(this).val();
                   // Effettua una leggera convalida. Klaviyo effettuerà un'ulteriore convalida al momento della ricezione dei dati.
                   if (email && /@/.test(email)) {
                       klaviyo.identify({
                           $email: email
                       });
                       trackStartedCheckout();
                   }
               });
           });
   } 
   </script>

2. Questo codice sarà in grado di tracciare solo gli eventi di checkout in futuro; non sarà in grado di ripopolare i flussi di carrelli abbandonati all'interno di Klaviyo. 
3. Dopo aver salvato questo codice nel suo negozio, Klaviyo inizierà automaticamente a tracciare una metrica di Checkout avviato, dalla quale potrà attivare un flusso di carrello abbandonato.

Monitorare la sincronizzazione di Klaviyo

1. Una volta integrato con Volusion, Klaviyo avrà bisogno di tempo per sincronizzare i dati prima di essere pronto per l'uso. Può verificare lo stato di questa sincronizzazione tornando alla scheda Integrazioni (cliccando sul nome del suo account in basso a sinistra) e cercando la sua integrazione Volusion nell'elenco delle Integrazioni abilitate.
2. Se c'è un contorno grigio, significa che l'integrazione sta ancora sincronizzando. Più grande è il suo negozio, più lunga può essere la sincronizzazione. Quando la sua integrazione viene visualizzata con un bordo verde, è pronto a partire.
3. Klaviyo importa tutti i suoi dati storici di Volusion quando attiva per la prima volta l'integrazione. Per verificarlo, può confrontare il numero di ordini in un determinato giorno con quello presente nell'interfaccia Volusion e confermare che corrispondono. Ad esempio, quando esplora la metrica Ordine effettuato (in Analytics > Metrics in Klaviyo) può passare con 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 Volusion 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 a quello di Volusion.
5. Per controllare o aggiornare il fuso orario del suo account: 
   • Clicchi sul nome del suo account in basso a sinistra.
   • Selezioni poi Impostazioni > Organizzazione.
   • Scorra in basso fino a Fuso orario.

Dati sincronizzati da Volusion

Vada su Analytics > Metriche per trovare tutte le metriche del suo account. Le metriche con l'icona Volusion sono sincronizzate dalla sua integrazione Volusion. Le metriche e le proprietà del profilo di Volusion vengono sincronizzate entro un'ora dall'invio di un ordine.

Ordine effettuato

Questo evento viene rilevato quando un cliente completa il processo di checkout e crea un ordine nel suo negozio Volusion. L'evento Ordine effettuato include tutte le informazioni rilevanti sugli articoli acquistati, compresi i nomi dei prodotti, i codici dei prodotti, le immagini e le informazioni sul prezzo, in modo da poterle utilizzare nelle e-mail di follow-up dell'acquisto.

Prodotto ordinato

Questo evento viene tracciato anche quando un cliente effettua un ordine, ma viene tracciato un evento per ogni articolo dell'ordine. Ad esempio, se qualcuno acquista una maglietta e un paio di pantaloni, viene tracciato un evento Ordine effettuato e due eventi Prodotto ordinato - un evento per la maglietta e un evento per i pantaloni.

L'evento Prodotto ordinato include informazioni dettagliate su ogni prodotto acquistato. Questo è utile per creare segmenti comportamentali basati su opzioni di varianti di prodotto e altre informazioni dettagliate che non sono disponibili nell'evento Ordine effettuato. Può filtrare e indirizzare gli eventi Prodotto ordinato in base ai seguenti criteri:

• Nome
  Il nome o il titolo del prodotto in Volusion, ad esempio, maglietta.
• Codice prodotto
  Il codice prodotto del suo prodotto all'interno di Volusion.
• Quantità
  La quantità dell'articolo acquistato in un ordine.

Dati dei clienti sincronizzati da Volusion

Oltre alle metriche di cui sopra, Klaviyo sincronizza da Volusion, 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 Volusion:

• Email
• Nome
• Cognome
• Città
• Stato/Regione
• Codice postale
• Paese
• Numero di telefono
• Fonte (Klaviyo rintraccerà i clienti provenienti da Volusion con una proprietà Fonte sul loro profilo impostata su "Volusion")

Risoluzione dei problemi

I dati degli ordini effettuati da Volusion non sono riportati in Klaviyo

Potrebbe trattarsi di un problema con le impostazioni dell'API di Volusion che consentono l'esportazione dei dati.

1. Per risolvere questo problema, si rechi nella scheda Inventario del suo pannello di amministrazione Volusion. Selezioni Importazione/Esportazione dal menu a discesa.
   
2. Clicchi su Volusion API per accedere alla pagina API principale.
3. Nella sezione Generici, troverà l'opzione per eseguire l'esportazione dei Generici/Ordini del suo negozio. Una volta eseguita l'esportazione, la pagina si aggiornerà.
   
4. Selezioni tutte le colonne cliccando sulla casella di controllo nella colonna denominata * e faccia clic su Esegui.
   
5. Dopo aver cliccato su Esegui per esportare i suoi Ordini generici, viene generato un URL API nella parte superiore della pagina. Ad esempio, l'URL appare come: https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789&EDI_Name=GenericOrder.
   
6. Il valore che appare tra "EncryptedPassword=" e "& EDI_Name=GenericOrders" (evidenziato nella schermata precedente) serve come chiave API. Utilizzi questa funzione per ristabilire le impostazioni di integrazione dalla scheda Integrazioni della sua dashboard Klaviyo. 
7. Al termine, esegua il test cliccando su Analytics > Metrics. Visualizzi l'attività recente per la metrica Ordine effettuato di Volusion per vedere se sono stati sincronizzati nuovi dati in Klaviyo. Se vede nuovi dati per la metrica Ordine effettuato, contatti il nostro team di assistenza per eseguire un gap fill per gli ordini mancanti in Klaviyo o per ulteriore assistenza.
8. Per ulteriori informazioni sull'esportazione dei dati utilizzando l'API di Volusion, faccia riferimento al supporto di Volusion.

Le persone visualizzano un errore "Invalid Input" quando fanno clic sui miei link e-mail.

La funzione "email to web tracking" di Klaviyo utilizza il tracciamento dei clic per associare l'attività di un utente che arriva al suo sito web attraverso un'email di Klaviyo prima che noi siamo in grado di identificarlo (ad esempio, quando effettua un acquisto o si iscrive alla sua lista email).

Volusion non supporta il formato URL che il nostro tracciamento dei clic utilizza e produce un errore quando un utente cerca di visitare il suo negozio attraverso uno di questi link, quindi questa funzione dovrà essere disattivata in Klaviyo per assicurarsi che i link nelle sue e-mail arrivino correttamente al suo negozio Volusion.

Per risolvere questo problema, si assicuri di disabilitare il tracciamento da e-mail a web in Klaviyo, come descritto all'inizio di questo articolo.

Come creare una chiave API permanente in Volusion

Normalmente Volusion le richiede di reimpostare la sua chiave API ogni 90 giorni quando reimposta la password del suo account, per cui deve riconfigurare la sua integrazione Voluision in Klaviyo. I passaggi seguenti le consentiranno invece di creare una chiave API non scadente; si trattava di generare le credenziali API per un account amministratore a cui non accede mai:

1. Dal suo pannello di amministrazione Volusion, vada su Clienti > Amministratori e crei un nuovo account di amministratore.
2. Si rechi in Inventario > Importazione/Esportazione e selezioni la scheda Volusion API.
3. Sotto la sezione Generici, clicchi sul link per l'Aiuto per l'integrazione API di Volusion.
4. Selezioni Esporta e selezioni il nuovo amministratore creato dal menu a tendina.
5. Espanda il riquadro "URL with Query String..." per trovare il suo URL permanente, il login e la password criptata (API Key).

Non acceda con questo account, che sarà utilizzato solo per l'accesso alle API. Accedendo con questo account, la password scadrà dopo 90 giorni e dovrà ripetere questi passaggi per generare una nuova chiave API permanente.

Risultato

Ora ha integrato Klaviyo con Volusion, ha aggiunto il tracking onsite, ha esaminato i dati sincronizzati e ha imparato a creare una chiave API permanente.

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