Come integrare Volusion

Cosa imparerai

Scopri come integrare Volusion con Klaviyo. Dopo aver completato questi passaggi, potrai personalizzare e targetizzare le e-mail in base ai dati degli ordini sincronizzati e alle proprietà del cliente.

Da Volusion, Klaviyo tiene traccia delle metriche Ordered Producte Placed Order; aggiungendo del codice extra possiamo tenere traccia anche delle informazioni sul carrello abbandonato.

Prima di iniziare

Volusion richiede un aggiornamento della password dell’account amministratore del tuo negozio Volusion ogni 90 giorni. Quando esegui questo aggiornamento sul tuo account Volusion, devi eseguire lo stesso aggiornamento anche per la tua integrazione Volusion nel tuo account Klaviyo. Puoi anche creare una chiave API permanente seguendo i passaggi nella sezione corrispondente di questo articolo.

Aggiungi l'integrazione Volusion in Klaviyo

1. In Klaviyo, seleziona la scheda Integrazioni.
2. Clicca su Scopri le app.
3. Cerca Volusion e fai clic sulla scheda, quindi fai clic su Installa.
4. Nella pagina successiva, inserisci l'URL del negozio, l'e-mail di accesso e la chiave API/password crittografata. Quindi, clicca su Connetti a Volusion.
   

5. Nella pagina successiva, vedrai una casella di controllo per Aggiungi nuovi clienti Volusion a un elenco Klaviyo. Se selezioni questa casella, puoi scegliere uno dei tuoi elenchi in Klaviyo a cui verranno aggiunti i clienti futuri quando effettueranno un ordine.
6. Infine, clicca su Completa la configurazione.

Disattiva il tracciamento web da e-mail in Klaviyo

1. La funzionalità "tracciamento da e-mail a web" in Klaviyo utilizza il tracciamento dei clic per identificare un utente che arriva sul tuo sito web tramite una Klaviyo Email prima di quanto saremmo normalmente in grado di identificarlo (ad esempio quando effettua un acquisto o si iscrive al tuo elenco e-mail).
2. Volusion non supporta il formato URL che utilizza il nostro tracciamento dei clic e genera un errore quando un utente prova a visitare il tuo negozio tramite uno di questi link, quindi questa funzionalità dovrà essere disattivata in Klaviyo per assicurarti che i link nella tua e-mail portino correttamente al tuo negozio Volusion.
3. Puoi disattivare questo tracciamento nelle impostazioni del tuo account in Nome account > Impostazioni > E-mail > Attribuzione.
4. L’unica funzionalità che si perde disattivando questa funzionalità è la possibilità di tracciare un nuovo profilo sul tuo sito web tramite un’e-mail su cui ha fatto clic. Finché hai l’analisi del tracciamento onsite di Klaviyo sul tuo sito web (che aggiungeremo nella prossima sezione), potremo comunque tracciare gli utenti non appena otteniamo il loro indirizzo e-mail tramite un acquisto nel tuo negozio o quando si iscrivono a un elenco e-mail.

Aggiungi il tracciamento sul sito al tuo store Volusion

Klaviyo fornisce due snippet di tracciamento onsite per aiutarti a raccogliere informazioni preziose sui tuoi clienti:

• Attivo sul sito
  Questo snippet monitora quando i tuoi clienti visitano il tuo sito. Questo snippet deve essere aggiunto al sito affinché altri snippet, come Prodotto visualizzato, funzionino.
• Prodotto visualizzato
  Questo snippet monitora quando i tuoi clienti visualizzano prodotti specifici. Puoi monitorare questo evento aggiungendo lo snippet di codice Prodotto visualizzato al tuo negozio.

Aggiungi il tracciamento attivo sul sito

Aggiungi il seguente snippet di Klaviyo.js in modo che venga visualizzato su ogni pagina del tuo sito web. Questo abiliterà il tracciamento Active on Site e i moduli Klaviyo. Assicurati di sostituire PUBLIC_API_KEY con la tua 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 to initialize 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>

Aggiungere il tracciamento della metrica "Prodotto visualizzato"

Per abilitare il tracciamento Prodotto visualizzato, dovrai aggiungere lo snippet di codice qui sotto alla pagina del modello del tuo negozio nell’Editor di file di Volusion, che puoi trovare facendo clic su Design > Editor di file.

<script type="text/javascript">
// Check to see if the customer is on the product page before executing code.
    if ($("meta[property='og:type']").attr("content") == "product") {
        var klaviyo = window.klaviyo || [];
        // Function to track when a product is viewed
        var trackViewedProduct = function(item) {
            klaviyo.track("Viewed Product", item);
            klaviyo.trackViewedItem({
                "Title": item.ProductName,
                "ItemId": item.ProductID,
                "ImageUrl": item.ImageURL,
                "Url": item.URL,
                "Metadata": {
                    "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 ?
                Number(`${$("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 ?
                Number(`${$("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 product_productprice = $("table.colors_pricebox div.product_productprice").length ?
                Number(`${$("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 ?
                Number(`${$("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;
            item = {
                "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>

Aggiungi promemoria per carrello abbandonato

Volusion non offre un modo predefinito per monitorare il carrello abbandonato tramite le nostre integrazioni, ma abbiamo creato uno script personalizzato che puoi aggiungere al tuo negozio Volusion e che ti consentirà di usare questa funzionalità in Klaviyo. Questo richiederà alcune conoscenze su come aggiungere codice al modello del tuo negozio, quindi se hai uno sviluppatore puoi inviargli questo documento per guidarlo nell'aggiunta del codice.

1. Dovrai aggiungere lo snippet di codice qui sotto alla pagina del modello del tuo negozio nell’Editor file di Volusion, che puoi trovare facendo clic su Design > Editor file.

<script type="text/javascript">
    // Check to see if the customer is on the checkout page before executing code.
    if (window.location.pathname == "/one-page-checkout.asp") {
        var klaviyo = window.klaviyo || [];
        // Function to track when a checkout is started.
        var trackStartedCheckout = function() {
            $.post('/AjaxCart.asp', function(data) {
                if (!data || !data.Products || !data.Products.length) {
                    return;
                }
                var items = [],
                    names = [],
                    skus = [];
                // Grab each product and its SKU/Name/Quantity/Price/Total price/Image 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);
                });
                // Push Started Checkout metric to Klaviyo with the customers data.
                klaviyo.track("Started Checkout", {
                    $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                    Items: items,
                    ProductNames: names,
                    SKUs: skus
                });
            }, 'json');
        };
        $(function() {
            // Grab the email form to get your customers email and tie the event to that email in Klaviyo.
            $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
                var email = $(this).val();
                // Do some light validation. Klaviyo will do more validation when the data is received.
                if (email && /@/.test(email)) {
                    klaviyo.identify({
                        $email: email
                    });
                    trackStartedCheckout();
                }
            });
        });
} </script>

1. Questo codice potrà tracciare solo gli eventi di pagamento da questo momento in poi; non potrai popolare retroattivamente i flussi per il carrello abbandonato in Klaviyo.
2. Dopo aver salvato questo codice sul tuo negozio, Klaviyo inizierà automaticamente il tracciamento di una metrica Started Checkout, che puoi usare per attivare un flusso di carrello abbandonato.

Monitora la sincronizzazione di Klaviyo

1. Una volta integrato con Volusion, Klaviyo avrà bisogno di tempo per sincronizzare i tuoi dati prima che siano pronti per essere usati. Puoi controllare lo stato di questa sincronizzazione tornando alla scheda Integrazioni e cercando l'integrazione Volusion nell'elenco delle Integrazioni abilitate.
2. Se è presente un contorno grigio, significa che l'integrazione è ancora in fase di sincronizzazione. Più grande è il tuo negozio, più tempo può richiedere una sincronizzazione. Quando l'integrazione viene visualizzata con un bordo verde, è tutto pronto.
3. Klaviyo importa tutti i tuoi dati storici di Volusion quando abiliti l’integrazione per la prima volta. Per verificarlo, puoi confrontare il numero di ordini in un giorno specifico con quello presente nell’interfaccia Volusion e confermare che corrispondano. Ad esempio, quando esplori la metrica Placed Order (in Analytics > Metriche in Klaviyo), 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 Volusion da ieri e dovresti vedere che corrispondono esattamente. Se non corrispondono, molto probabilmente il problema è che il fuso orario del tuo account Klaviyo non corrisponde al fuso orario di Volusion.
5. Per controllare o aggiornare il fuso orario del tuo account:
   • 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.

Dati sincronizzati da Volusion

Vai a Analisi > Metriche per trovare tutte le metriche nel tuo account. Le metriche con un'icona di Volusion sono sincronizzate dalla tua integrazione Volusion. Le metriche e le proprietà del profilo di Volusion vengono sincronizzate entro un'ora da quando qualcuno effettua un ordine.

Ordine effettuato

Questo evento viene tracciato quando un cliente completa il processo di checkout e crea un ordine nel tuo negozio Volusion. L'evento Placed Order include tutte le informazioni pertinenti sugli articoli acquistati, inclusi nomi dei prodotti, codici prodotto, immagini e informazioni sui prezzi, così puoi usare queste informazioni 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 t-shirt e un paio di pantaloni, viene tracciato un evento Placed Order e due eventi Ordered Product: un evento per la t-shirt e un evento per i pantaloni.

L'evento Ordered Product include informazioni dettagliate su ciascun prodotto acquistato. Ciò è utile quando crei segmenti comportamentali basati sulle opzioni della variante del prodotto e altre informazioni dettagliate che non sono disponibili nell'evento Placed Order. Puoi filtrare e targetizzare gli eventi Ordered Product in base ai seguenti criteri:

• Nome
  Il nome o il titolo del prodotto in Volusion, ad es., t-shirt.
• Codice prodotto
  Il codice prodotto del tuo prodotto all'interno di Volusion.
• Quantità
  La quantità dell'articolo acquistato in un ordine.

Dati dei clienti sincronizzati da Volusion

Oltre alle metriche sopra che Klaviyo sincronizza da Volusion, ci sono anche proprietà cliente che vengono aggiunte a ciascun profilo Klaviyo. Puoi usare queste proprietà nei segmenti e nei flussi. Ecco le proprietà sincronizzate automaticamente da Volusion:

• E-mail
• Nome
• Cognome
• Città
• Stato/Regione
• CAP
• Paese
• Numero di telefono
• Origine (Klaviyo terrà traccia dei clienti da Volusion con una proprietà Origine sul loro profilo impostata su "Volusion")

Risoluzione dei problemi

I dati di ordine effettuato di Volusion non vengono visualizzati nella reportistica in Klaviyo

Potrebbe essere un problema delle impostazioni API di Volusion che consentono l’esportazione dei dati.

1. Per risolvere il problema, vai alla scheda Inventario del tuo pannello di amministrazione Volusion. Seleziona Importa/Esporta dal menu a discesa.
   

2. Fai clic su Volusion API per accedere alla pagina API principale.
3. Nella sezione Generico troverai l'opzione per Esegui l'esportazione di Generico/Ordini del tuo negozio. Dopo l'esecuzione dell'esportazione, la pagina si aggiornerà.
   

4. Seleziona tutte le colonne facendo clic sulla casella di controllo nella colonna denominata * e fai clic su Esegui.
   

5. Dopo aver fatto clic su Esegui per esportare i tuoi ordini generici, nella parte superiore della pagina viene generato un URL API. Ad esempio, l’URL apparirebbe così: 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 nello screenshot qui sopra) funge da chiave API. Usalo per ripristinare le impostazioni di integrazioni dalla scheda integrazioni del pannello di controllo Klaviyo.
7. Una volta completato, fai un test facendo clic su Analytics > Metriche. Visualizza l'attività recente per la metrica Placed Order di Volusion per verificare se sono stati sincronizzati nuovi dati in Klaviyo. Se vedi nuovi dati per la metrica Placed Order, contatta il nostro team di assistenza per eseguire un gap fill per gli ordini mancanti in Klaviyo o per ricevere ulteriore assistenza.
8. Per ulteriori informazioni sull’esportazione dei dati tramite l’API Volusion, consulta il supporto Volusion.

Le persone vedono un errore "Input non valido" quando fanno clic sui link nella mia e-mail

La funzionalità "tracciamento web da Klaviyo Email" in Klaviyo usa il tracciamento dei clic per collegare l'attività a un utente che arriva sul tuo sito web tramite un'e-mail Klaviyo prima che sia possibile identificarlo in origine (ad esempio quando effettua un acquisto o si iscrive al tuo elenco e-mail).

Volusion non supporta il formato URL che utilizza il nostro tracciamento dei clic e genera un errore quando un utente prova a visitare il tuo negozio tramite uno di questi link, quindi questa funzionalità dovrà essere disattivata in Klaviyo per assicurarti che i link nella tua e-mail portino correttamente al tuo negozio Volusion.

Per risolvere questo problema, assicurati di disattivare il tracciamento web da e-mail in Klaviyo come descritto all'inizio di questo articolo.

Come creare una chiave API permanente in Volusion

In genere Volusion ti chiede di reimpostare la chiave API ogni 90 giorni quando reimposti la password del tuo account, costringendoti a riconfigurare le integrazioni Voluision in Klaviyo. I passaggi seguenti ti consentiranno invece di creare una chiave API senza scadenza; richiedono la generazione di credenziali API per un account amministratore a cui non accedi mai:

1. Dal pannello di amministrazione di Volusion, vai su Clienti > Amministratori e crea un nuovo account amministratore.
2. Vai a Inventario > Importazione/Esportazione e seleziona la scheda Volusion API.
3. Nella sezione Generico, fai clic sul link Guida all’integrazione dell’API Volusion.
4. Seleziona Esporta e seleziona dal menu a discesa il nuovo amministratore che hai creato.
5. Espandi il riquadro "URL con stringa di query..." per trovare il tuo URL permanente, l'accesso e la password crittografata (chiave API).

Non accedere con questo account: verrà usato solo per l’accesso API. L’accesso con questo account farà scadere la password dopo 90 giorni e dovrai ripetere questi passaggi per generare una nuova chiave API permanente.

Risultato

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

Risorse aggiuntive