Hoe integreren met Volusion

Wat je leert

Leer hoe je Volusion kunt integreren met Klaviyo. Na het voltooien van deze stappen kun je e-mail personaliseren en targeten op basis van gesynchroniseerde bestelgegevens en klanteigenschappen.

Vanaf Volusion volgt Klaviyo Besteld product en Geplaatste ordermeetwaarde; met de toevoeging van wat extra code kunnen we ook winkelwagenverlateninformatievolgen.

Voordat je van start gaat

Volusion vereist elke 90 dagen eenupdate naar het Volusion beheerderswachtwoord van je account zaak. Als je van deze update je Volusion account maakt, moet je ook van deze update je Volusion integraties maken in je Klaviyo account. Je kunt ook een permanente API-sleutel maken door de stappen in het bijbehorende gedeelte van dit artikel te volgen.

Voeg de Volusion integraties toe in Klaviyo

1. Selecteer in Klaviyo het tabblad Integraties.
2. Selecteer 'Apps verkennen'.
3. Zoek naar Volusion en klik op de kaart, klik dan op Installeren.
4. Voer op de volgende pagina je zaak URL, login e-mail en API-sleutel/versleuteld wachtwoord in. Klik dan op Verbinden met Volusion.
   
5. Op de volgende pagina zie je een selectievakje voor Nieuwe Volusion klant toevoegen aan een Klaviyo lijst. Als je dit vakje aanvinkt, kun je in Klaviyo een van je lijsten kiezen waaraan toekomstige klanten worden toegevoegd als ze een bestelling plaatsen.
6. Klik ten slotte op Installatie voltooien.

uitschakelen e-mail naar webtracking in Klaviyo

1. De "e-mail to webtracking" functies in Klaviyo gebruikt click tracking om een gebruiker te identificeren die via een Klaviyo e-mail op je website terechtkomt voordat we hem oorspronkelijk zouden kunnen identificeren (zoals wanneer hij een aankoop doet of zich aanmeldt bij je e-maillijst).
2. Volusion support niet de URL-indeling die onze click tracking gebruikt en geeft een foutmelding als een gebruiker je zaak probeert te bezoeken via een van deze links, dus deze functie zal moeten worden uitgeschakeld in Klaviyo om ervoor te zorgen dat links in je e-mail correct doorklikken naar je Volusion zaak.
3. Je kunt deze tracking uitschakelen in je account instellingen onder accountnaam > Instellingen > Email > Naamsvermelding.
4. De enige functionaliteit die verloren gaat met het uitschakelen van deze functies is de mogelijkheid om een nieuw profiel op je website te volgen via een e-mail waarop ze hebben geklikt. Zolang je de Klaviyo onsite tracking analyses op je website hebt (die we in de volgende sectie zullen toevoegen), zullen we nog steeds in staat zijn om gebruikers te volgen zodra we hun e-mailadres krijgen via een aankoop in je zaak of wanneer ze Aanmelden voor een e-maillijst.

Onsite tracking toevoegen aan je Volusion zaak

Klaviyo biedt twee onsite tracking snippets om je te helpen waardevolle informatie over je klant te verzamelen:

• actief op site
  Deze snippet houdt bij wanneer je klant je site bezoekt. Deze snippet moet worden toegevoegd aan de site om andere snippets zoals Bekeken product te laten werken.
• Bekeken product
  Dit fragment houdt bij wanneer je klant specifieke producten bekijkt. Je kunt deze gebeurtenis volgen door het codefragment Bekeken product toe te voegen aan je zaak.

Actief toevoegen op site tracking

Voeg de volgende Klaviyo.js snippet toe zodat deze op elke pagina van je website verschijnt. Dit zal actief inschakelen op Site tracking en Klaviyo formulieren. Zorg ervoor dat u PUBLIC_API_KEY vervangt door uw Klaviyo openbare API-sleutel.

<script type="toepassing/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js"></script>
<script type="text/javascript"> 
 //Script om Klaviyo object te initialiseren bij het laden van de 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]=argumenten[w];var t="functie"==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>

Bekeken product toevoegen tracking

Om Bekeken product tracking in te schakelen, moet je het onderstaande stukje code toevoegen aan de template pagina van je zaak in Volusion's Bestandseditor, die je kunt vinden door te klikken op Ontwerp > Bestandseditor.

<script type="text/javascript"> 
 // Controleer of de klant op de productpagina is voordat de code wordt uitgevoerd.
    if ($("meta[property='og:type']").attr("content") == "product") {
 var Klaviyo = window.Klaviyo || [];
 // Functie om bij te houden wanneer een product wordt bekeken
 var trackViewedProduct = function(item) {
            Klaviyo.track("Bekeken 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(gegevens) {
 var product_saleprice = $("table.colors_pricebox div.product_saleprice").length ?
                Aantal(`${$("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 ?
                Aantal(`${$("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_productprijs = $("table.colors_pricebox div.product_productprijs").lengte ?
                Aantal(`${$("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 ?
                Aantal(`${$("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>

winkelwagen verlaten herinneringen toevoegen

Volusion biedt geen out-of-the-box manier om winkelwagen verlaten te volgen via onze integraties, maar we hebben een aangepast script gemaakt dat je kunt toevoegen aan je Volusion zaak en waarmee je deze functies kunt gebruiken in Klaviyo. Dit vereist enige kennis van het toevoegen van code aan de template van je winkel, dus als je een ontwikkelaar hebt, kun je hem of haar dit document sturen om de code toe te voegen.

1. Je moet het onderstaande stukje code toevoegen aan je zaak's template pagina in Volusion's Bestandseditor, die je kunt vinden door te klikken op Ontwerp > Bestandseditor.

   <script type="text/javascript"> 
    // Controleer of de klant op de afrekenpagina staat voordat je code uitvoert.
       if (window.location.pathname == "/one-page-afrekenen.asp") {
    var Klaviyo = window.Klaviyo || [];
    // Functie om bij te houden wanneer een afrekening wordt gestart.
           var trackStartedCheckout = function() {
    $.post('/AjaxCart.asp', functie(gegevens) {
    if (gegevens || gegevens.Products || gegevens.Products.length) {
                       return;
                   }
                   var items = [], names = [], skus = []; // Pak elk product en zijn SKU/Naam/Hoeveelheid/Prijs/Totale prijs/Afbeelding url $.each(gegevens.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 afrekenen meetwaarde naar Klaviyo met de klantgegevens.
                   Klaviyo.track("Gestart afrekenen", {
                       $value: +(data.Totals[0].CartTotal.replace(/[\$,]+/g, "")),
                       Items: items,
                       ProductNames: names,
                       SKUs: skus
                   });
    }, 'json');
    };
    $(function() {
    // Pak het e-mail formulier om je klant e-mail te krijgen en koppel het evenement aan die e-mail in Klaviyo.
               $('[name="OnePageCheckoutForm"] [name="Email"]').change(function(e) {
    var e-mail = $(this).val();
                   // Doe wat lichte validatie. Klaviyo zal meer validatie uitvoeren wanneer de gegevens worden ontvangen.
                   if (e-mail && /@/.test(e-mail)) {
                       Klaviyo.identify({
                           $email: email
                       });
                       trackStartedCheckout();
    }
              });
    });
   } 
   </script>

2. Met deze code kunnen alleen afrekersevenementen worden bijgehouden; je kunt winkelwagen verlaten stroom niet terug-poppen binnen Klaviyo. 
3. Nadat je deze code in je zaak hebt opgeslagen, begint Klaviyo automatisch met tracking een Started afrekenen meetwaarde van waaruit je een winkelwagen verlaten flow kunt activeren.

in de gaten houden de Klaviyo sync

1. Eenmaal geïntegreerd met Volusion, heeft Klaviyo tijd nodig om je gegevens te synchroniseren voordat ze klaar zijn voor gebruik. Je kunt de status van deze synchronisatie controleren door terug te navigeren naar het tabblad integraties en te zoeken naar je Volusion integraties op de lijst van ingeschakelde integraties.
2. Als er een grijze omlijning is, betekent dit dat de integraties nog aan het synchroniseren zijn. Hoe groter je zaak, hoe langer een synchronisatie kan duren. Als je integraties met een groene rand worden weergegeven, ben je klaar om te gaan.
3. Klaviyo Importeer al je historische Volusion gegevens wanneer je de integraties voor het eerst inschakelt. Om dit te controleren kun je het aantal bestellingen op een bepaalde dag vergelijken met wat er in de Volusion-interface staat en bevestigen dat ze overeenkomen. Als je bijvoorbeeld de meetwaarde van geplaatste orders bekijkt (onder analyses > meetwaarde in Klaviyo) kun je met je muis over het gegevenspunt van gisteren gaan of in de tabel met gegevens onder de grafiek kijken om te zien hoeveel orders er gisteren zijn gemeld.
4. Vergelijk dat getal met de zaak op Volusion van gisteren en je zou moeten zien dat ze precies overeenkomen. Als dat niet zo is, is het probleem waarschijnlijk dat de tijdzone van je Klaviyo account niet overeenkomt met de tijdzone van Volusion.
5. Om de tijdzone van je te controleren of:update account 
   • Klik linksonder op je accountnaam.
   • Selecteer en klik op Instellingen > Organization.
   • Scroll naar beneden naar Tijdzone.

gegevens gesynchroniseerd van Volusion

Navigeer naar analyses > meetwaarde om alle meetwaarde in jouw account te vinden. De meetwaarde met een Volusion pictogram worden gesynchroniseerd vanaf je Volusion integraties. meetwaarde en profieleigenschappen van Volusion worden gesynchroniseerd binnen het uur nadat iemand een bestelling heeft geplaatst.

Bestelling geplaatst

Deze gebeurtenis wordt bijgehouden wanneer een klant het afrekenproces voltooit en een bestelling aanmaakt in je Volusion zaak. De gebeurtenis Geplaatste bestelling bevat alle relevante informatie over de items die iemand heeft gekocht, inclusief productnamen, productcodes, afbeeldingen en prijsinformatie, zodat je die informatie kunt gebruiken in de e-mail met de aankoopvervolgactie.

Product besteld

Deze gebeurtenis wordt ook bijgehouden als een klant een bestelling plaatst, maar er wordt één gebeurtenis bijgehouden voor elk artikel in de bestelling. Als iemand bijvoorbeeld een t-shirt en een broek koopt, wordt er één Geplaatste Bestelling-gebeurtenis bijgehouden en twee Bestelde Product-gebeurtenissen - één gebeurtenis voor het t-shirt en één gebeurtenis voor de broek.

De gebeurtenis Besteld product bevat gedetailleerde informatie over elk gekocht product. Dit is handig bij het maken van gedragssegmenten op basis van productvariatie-opties en andere gedetailleerde informatie die niet beschikbaar is in de gebeurtenis Geplaatste bestelling. Je kunt Geordend product gebeurtenissen filteren en targeten op basis van de volgende criteria:

• Naam
  De naam of titel van het product in Volusion, bijvoorbeeld t-shirt.
• Productcode
  De productcode voor je product in Volusion.
• Hoeveelheid
  De hoeveelheid van het gekochte artikel in een bestelling.

klantgegevens gesynchroniseerd van Volusion

Naast de bovenstaande meetwaarde Klaviyo syncs van Volusion zijn er ook klant eigenschappen die worden toegevoegd aan elk Klaviyo profiel. Je kunt deze eigenschappen gebruiken in segmenten en stromen. Dit zijn de eigenschappen die automatisch worden gesynchroniseerd vanuit Volusion:

• E-mail
• Voornaam
• Achternaam
• City
• Staat/regio
• Zip Code
• Country
• Telefoonnummer
• Bron (Klaviyo zal klanten volgen van Volusion met een Bron eigenschap op hun profiel ingesteld op "Volusion" )

Probleemoplossing

Volusion Geplaatste Bestelgegevens is geen rapportage in Klaviyo

Dit kan een probleem zijn met je Volusion API instellingen die het exporteren van gegevens toestaan.

1. Om dit op te lossen, ga je naar het tabblad Inventaris van je Volusion-adminpaneel. Selecteer importeren/exporteren in het vervolgkeuzemenu.
   
2. Klik op Volusion API om naar de API-hoofdpagina te gaan.
3. In het gedeelte Algemeen vind je de optie om de export van de Generieke/Orders van je zaak uit te voeren. Zodra de export is uitgevoerd, wordt de pagina vernieuwd.
   
4. Selecteer alle kolommen door op het selectievakje in de kolom met de naam * te klikken en klik op Uitvoeren.
   
5. Nadat je op Uitvoeren hebt geklikt om je Generieke Bestellingen te exporteren, wordt er boven aan de pagina een API URL gegenereerd. De URL zou er bijvoorbeeld als volgt uitzien: https://storename.com/net/WebService.aspx?Login=user@storename.com&EncryptedPassword=ABCDEFGHIJKLMNOPQRSTUVWXYZ123456789&EDI_Name=GenericOrder.
   
6. De waarde die verschijnt tussen "EncryptedPassword=" en "& EDI_Name=GenericOrders" (gemarkeerd in de bovenstaande schermafbeelding) dient als je API-sleutel. Gebruik dit om je integratie-instellingen opnieuw in te stellen vanaf het tabblad integraties van je Klaviyo dashboard. 
7. Test na voltooiing door te klikken op analyses > meetwaarde. Bekijk recente activiteit voor de Volusion Placed Order meetwaarde om te zien of er nieuwe gegevens zijn gesynchroniseerd in Klaviyo. Als je nieuwe gegevens ziet voor de geplaatste order meetwaarde, neem dan contact op met ons supportteam om een gap fill uit te voeren voor ontbrekende orders in Klaviyo of voor verdere assistentie.
8. Meer informatie over het exporteren van gegevens via Volusion API vind je op Volusion support.

Mensen zien een foutmelding "Invalid Input" als ze op mijn e-mailkoppelingen klikken.

De "e-mail to webtracking" functies in Klaviyo gebruikt klik tracking om activiteit te koppelen aan een gebruiker die via een Klaviyo e-mail op je website terechtkomt voordat we ze oorspronkelijk zouden kunnen identificeren (zoals wanneer ze een aankoop doen of zich aanmelden bij je e-maillijst).

Volusion support niet de URL-indeling die onze click tracking gebruikt en geeft een foutmelding als een gebruiker je zaak probeert te bezoeken via een van deze links, dus deze functie zal moeten worden uitgeschakeld in Klaviyo om ervoor te zorgen dat links in je e-mail correct doorklikken naar je Volusion zaak.

Om dit probleem op te lossen, moet je e-mail uitschakelen naar webtracking in Klaviyo zoals beschreven aan het begin van dit artikel.

Hoe maak je een permanente API-sleutel in Volusion?

Normaal gesproken moet je op Volusion elke 90 dagen je API-sleutel opnieuw instellen als je het wachtwoord op account opnieuw instelt, waardoor je je Voluision-integratie opnieuw moet configureren in Klaviyo. Met de volgende stappen kun je in plaats daarvan een niet-verlopende API-sleutel maken; het ging om het genereren van API inloggegevens voor een admin account waar je nooit op bent ingelogd:

1. Ga in je beheerpaneel Volusion naar klant > Beheerders en maak een nieuwe beheerder account.
2. Navigeer naar Inventaris > importeren/Exporteren en selecteer het Volusion API tabblad.
3. Klik in het gedeelte Algemeen op de link Volusion API integraties Help.
4. Selecteer Exporteren en selecteer de nieuwe admin die je hebt gemaakt in de vervolgkeuzelijst.
5. Vouw het vak "URL with Query String..." uit om je permanente URL, login en gecodeerde wachtwoord te vinden (API-sleutel).

Niet inloggen met deze account, deze wordt alleen gebruikt voor API toegang. Als je met dit account inlogt, verloopt het wachtwoord na 90 dagen en moet je deze stappen opnieuw uitvoeren om een nieuwe permanente API-sleutel te genereren.

Resultaat

Je hebt nu Klaviyo geïntegreerd met Volusion, onsite tracking toegevoegd, je gesynchroniseerde gegevens bekeken en geleerd hoe je een permanente API-sleutel aanmaakt.

Extra hulpbronnen

• Hoe vaak integraties referentie synchroniseren
• Heb je meer hulp nodig bij het integreren met Klaviyo? afrekenen Klaviyo's Agentschap partner