Hoe integreren met OpenCart

Wat je leert

Leer hoe je OpenCart kunt integreren met Klaviyo. Na het voltooien van deze stappen kun je e-mail personaliseren en targeten op basis van de aankoop en websiteactiviteit van elke klant. De OpenCart integratie synchroniseert elk uur.

Voordat je van start gaat 

Houd er rekening mee dat Klaviyo je catalogus niet synchroniseert vanuit OpenCart.

Voeg de OpenCart integraties toe

Het proces van het toevoegen van Klaviyo's OpenCart integraties bestaat uit meerdere stappen en vereist het nemen van acties binnen zowel OpenCart als Klaviyo.

Om te beginnen: Klaviyo ondersteunt momenteel OpenCart 1.4.x en 1.5.x. Download de Klaviyo OpenCart module hier: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Unzip het bestand in de root van je OpenCart installatie.
2. Log in op OpenCart admin en ga naar de pagina Extensies > Modules.
3. Installeer de Klaviyo-module en klik vervolgens op Bewerken voor de Klaviyo-module.
4. Het laatste wat je moet doen met je OpenCart installatie is de volgende PHP code kopiëren en plakken aan het einde van de `upload/index.php`, vlak voor de regel `$response->getOutput();`:

   // [Klaviyo] Sla het winkelwagentje van de klant op als het bestaat.
   als ($registry->get('cart')->hasProducts()) {
    $registry->get('load')->model('module/Klaviyo');
   
    als ($registry->get('klant')->isLogged()) {
       $registry->get('model_module_klaviyo')->saveCustomerCart(
         session_id(),
         $registry->get('customer')->getId(),
         $session->data['cart']
       );
     } anders als (array_key_exists('guest', $session->gegevens)) {
       $registry->get('model_module_klaviyo')->saveGuestCart(
         session_id(),
         $session->data['guest'],
         $session->data['cart']
       );
     }
   }

5. Selecteer in Klaviyo het tabblad Integraties.
6. Klik op 'Apps verkennen ' en zoek naar OpenCart. Klik vervolgens op de kaart. Klik vervolgens op Installeren.
7. Je komt op de pagina met integratie-instellingen . Voer op de instellingenpagina de URL van je OpenCart site in en klik op Verbinden met OpenCart.
   
8. Kopieer op de volgende pagina de API-sleutel onder Klaviyo OpenCart Module en plak deze in de instellingen van de Klaviyo module in OpenCart. Sla de instellingen van de Klaviyo module op in de OpenCart admin.
   
9. Vink desgewenst de instelling Nieuwe OpenCart klant toevoegen aan een Klaviyo lijst aan en selecteer vervolgens een lijst in de vervolgkeuzelijst.
10. terug in Klaviyo, klik op Installatie voltooien om te beginnen met het synchroniseren van gegevens.

Klaviyo onsite tracking installeren

Om onsite activiteiten te volgen in OpenCart, zoek eerst je Klaviyo publieke API-sleutel door in te loggen op je account, te klikken op je account naam in de linkerbenedenhoek en te navigeren naar Instellingen > API-sleutel. Je publieke sleutel is zes tekens lang. Er zijn twee soorten onsite tracking die je kunt installeren:

• actief op Site
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser uw website bezoekt
• Bekeken product
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser een productpagina op je website bekijkt.

Voeg "actief toe op Site" tracking

Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser je website bezoekt. Om te beginnen met tracking actief op Site activiteit:

1. Voeg het volgende stukje code toe aan je hoofdzaak template zodat het op alle pagina's staat. Je moet dit fragment plaatsen bij andere analysescripts die je gebruikt of vlak voor de afsluitende </body </body>tag > :
   

   <script type="text/javascript" async="" src="https://static.klaviyo.com/onsite/js/PUBLIC_API_KEY/klaviyo.js></script>
   <script type="text/javascript"> 
    //Initialiseer Klaviyo object 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>
   

2. Zorg ervoor dat je PUBLIC_API_KEY vervangt door je Klaviyo account's Publieke API-sleutel.
3. Als bezoekers of klanten een account kunnen aanmaken voor je zaak, voeg dan de volgende snippet toe direct onder de eerste snippet:

   <script type="text/javascript"> 
    var Klaviyo = window.Klaviyo || [];
     {% if user.is_logged_in %}
     Klaviyo.identify({
       $email: '{{ user.email }}',
    $first_name: '{{ user.first_name }}',
    $last_name: '{{ user.last_name }}'
    });
     {% endif %}
   </script>

4. Afhankelijk van het type sjabloon dat je voor je website gebruikt, zijn de {% if user.is_logged_in %} en {{ user.email }} syntaxis waarschijnlijk anders. Met de beschikbare taal template wil je controleren of de persoon die de huidige pagina bekijkt ingelogd is. Zo ja, dan moet je hun e-mail en naam uitvoeren, indien beschikbaar. Als je geen naamgegevens hebt, verwijder dan deze twee regels en de laatste komma na de regel e-mail $e-mail.

Toevoegen "Bekeken product" tracking

Als je een flow voor websiteverlaters wilt instellen of segmenten wilt bouwen op basis van productbrowsergegevens, moet je JavaScript-event tracking toevoegen voor een "Bekeken product" meetwaarde.

1. Voeg op je productpagina template het volgende fragment toe:

   <script type="text/javascript"> 
    var Klaviyo = window.Klaviyo || [];
       Klaviyo.track("Bekeken Product", {
         Title: '{{ product.title }}',
    ItemId: {{ product.id }},
    Categorieën: {{ category in product.categories|json }}, // De lijst van categorieën is een array van strings. 
         ImageUrl: '{{ product.image_url }}',
    Url: '{{ product.url }}',
    Metadata: {
    Merk: '{{ product.brand }}',
    Prijs: {{ product.price }},
    CompareAtPrice: {{ product.compare_at_price }} // Als je een compare at price hebt. Je kunt dit ook opnemen voor een uitverkoop of speciale prijs.
         }
    });
   </script>

2. Het bovenstaande fragment gebruikt de {{ }} placeholder syntaxis die anders kan zijn voor jouw OpenCart zaak. Het belangrijkste is dat productvelden dynamisch worden weergegeven op basis van welke productpagina je bekijkt.
3. Nadat de tracking van bekeken producten is geconfigureerd voor uw site, zouden de gegevens van bekeken producten moeten beginnen te verschijnen in uw Klaviyo account wanneer bekende bezoekers uw productpagina's bekijken.

Hoe onsite tracking werkt

Als je Klaviyo webtracking aan je site toevoegt, kunnen we alleen de browse-activiteit van "bekende browsers" volgen - dat wil zeggen browsers die ten minste één keer eerder zijn bezocht en betrokken. Er zijn twee belangrijke manieren waarop we een websitebezoeker kunnen identificeren voor webtracking doeleinden:

• Als iemand op een bepaald moment via een Klaviyo E-mail naar je website heeft geklikt
• Als iemand zich op een bepaald moment heeft aangemeld/ingeschreven via een Klaviyo formulier

Klaviyo zal anonieme browsers niet volgen.

in de gaten houden de Klaviyo sync

De tijd die het kost om alle historische klant- en bestelgegevens van je OpenCart zaak te synchroniseren hangt af van de grootte van je zaak. Zodra deze historische synchronisatie is voltooid, zie je een groene rand rond je OpenCart integraties onder integraties inschakelen.

Om je integraties te controleren:

1. Navigeer naar account het tabblad meetwaarde op je, te vinden onder analyses. Hier kun je filteren om alle OpenCart meetwaarde te bekijken. Zoek naar OpenCart' Placed Order meetwaarde en klik op het pictogram Activity Feed. Als je integratie is begonnen met het synchroniseren van gegevens, zul je hier geplaatste bestellingen zien verschijnen.
2. We synchroniseren automatisch alle historische bestelgegevens. Om dit te controleren kun je het aantal gebeurtenissen op een bepaalde dag in Klaviyo vergelijken met wat er in je OpenCart interface staat en bevestigen dat ze overeenkomen.
3. Als je bijvoorbeeld de Meetwaarde geplaatste orders bekijkt, 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 OpenCart 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 ingestelde OpenCart tijdzone.

5. Om de tijdzone van je account te controleren of updaten:

   • Klik linksonder op de naam van je organisatie.

   • Selecteer Instellingen.
   • Ga naar het Organization tabblad. 

gegevens gesynchroniseerd van OpenCart

• Verkoop- en bestelgegevens
  Welke producten zijn gekocht, inclusief productgegevens en afbeeldingen.
• klantinformatie
  Voornaam, achternaam, locatie en klantgroep.
• Opgestart afrekenen gegevens
  Gebruikt om winkelwagen verlaten e-mail te activeren. Dit wordt ingeschakeld door het PHP codefragment dat je hebt toegevoegd bij de integratie.
• Verzonden ordergegevens
  Gebruikt om bij te houden wanneer bestellingen zijn verzonden.
• Onsite tracking
  Wanneer mensen je website bezoeken

Naar je OpenCart meetwaarde, navigeer naar analyses > meetwaarde Klaviyoin, waar je kunt filteren OpenCart op.

Standaard synchroniseert Klaviyo de volgende statussen voor Geplaatste Bestelling en Vervulde Bestelling meetwaarde:

• Geplaatste bestelling: In afwachting, Verwerkt, Verwerkt, Verzonden, Voltooid
• Uitgevoerde bestelling: Verzonden, Compleet

Extra hulpbronnen

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