Hoe je integreert met OpenCart

Wat je leert

Leer hoe je OpenCart kunt integreren met Klaviyo. Nadat je deze stappen hebt afgerond, kun je e-mails personaliseren en targeten op basis van de aankoop- en websiteactiviteit van elke klant. De OpenCart-integratie synchroniseert elk uur.

Voordat je van start gaat

Let op: Klaviyo synchroniseert je catalogus niet vanuit OpenCart.

De OpenCart-integratie toevoegen

Het proces om Klaviyo's OpenCart-integratie toe te voegen bestaat uit meerdere stappen en vereist dat je acties uitvoert in zowel OpenCart als Klaviyo.

Om te beginnen ondersteunt Klaviyo 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. Pak het bestand uit in de hoofdmap van je OpenCart-installatie.
2. Log in op het OpenCart-beheerdersgedeelte 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`, direct vóór de regel `$response->getOutput();`:

// [Klaviyo] Save customer cart if it exists.
if ($registry->get('cart')->hasProducts()) {
  $registry->get('load')->model('module/klaviyo');

  if ($registry->get('customer')->isLogged()) {
    $registry->get('model_module_klaviyo')->saveCustomerCart(
      session_id(),
      $registry->get('customer')->getId(),
      $session->data['cart']
    );
  } else if (array_key_exists('guest', $session->data)) {
    $registry->get('model_module_klaviyo')->saveGuestCart(
      session_id(),
      $session->data['guest'],
      $session->data['cart']
    );
  }
}

1. Selecteer in Klaviyo het tabblad Integraties.
2. Klik op Apps ontdekken en zoek naar OpenCart, en klik vervolgens op de kaart. Klik vervolgens op Installeren.
3. Je wordt naar een pagina met Integratie-instellingen geleid. Voer op de instellingenpagina de URL van je OpenCart-site in en klik op Verbinden met OpenCart.
   

4. 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-beheeromgeving.
   

5. Als je wilt, vink je de instelling Nieuwe OpenCart-klanten toevoegen aan een Klaviyo-lijst aan en selecteer je vervolgens een lijst in de dropdown.
6. Terug in Klaviyo klik je op Installatie voltooien om te beginnen met het synchroniseren van gegevens.

Installeer Klaviyo onsite-tracking

Om onsite activiteit in OpenCart te tracken, zoek je eerst je openbare API-sleutel van Klaviyo door in te loggen op je account, op je accountnaam linksonder te klikken en naar Instellingen > API-sleutel te navigeren. Je openbare sleutel is zes tekens lang. Er zijn twee soorten onsite tracking die je kunt installeren:

• Actief op website
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser je website bezoekt
• Product bekeken
  Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser een productpagina op je website bekijkt

"Actief op site"-tracking toevoegen

Deze meetwaarde wordt bijgehouden wanneer een identificeerbare browser je website bezoekt. Om te beginnen met het tracking van Actief op Website -activiteit:

1. Voeg het volgende codefragment toe aan je hoofdtemplate van je webshop, zodat het op alle pagina's wordt opgenomen. Je moet dit snippet plaatsen bij andere analytics-scripts die je gebruikt of net vóór de afsluitende </body> -tag:
   

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

1. Zorg dat je PUBLIC_API_KEY vervangt door de openbare API-sleutel van je Klaviyo-account.
2. Als bezoekers of klanten accounts voor je winkel kunnen aanmaken, voeg je het volgende snippet direct onder het eerste snippet toe:

<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>

1. Afhankelijk van de typen templates die je voor je website gebruikt, is de syntaxis {% if user.is_logged_in %} en {{ user.email }} waarschijnlijk anders. Met de beschikbare templatetaal wil je controleren of de persoon die de huidige pagina bekijkt is ingelogd. Als dat zo is, moet je hun e-mailadres en naam weergeven, als die beschikbaar zijn. Als je geen naamgegevens hebt, verwijder je die twee regels en de afsluitende komma na de regel met het e-mailadres $email.

Tracking voor "Product bekeken" toevoegen

Als je een flow voor website verlaten wilt instellen of segmenten wilt maken op basis van gegevens over productbrowsen, wil je JavaScript-eventtracking toevoegen voor een meetwaarde voor "Product bekeken".

1. Voeg in je productpagina-template het volgende snippet toe:

<script type="text/javascript">
    var klaviyo = window.klaviyo || [];
    klaviyo.track("Viewed Product", {
      Title: '{{ product.title }}',
      ItemId: {{ product.id }},
      Categories: {{ category in product.categories|json }}, // The list of categories is an array of strings. 
      ImageUrl: '{{ product.image_url }}',
      Url: '{{ product.url }}',
      Metadata: {
        Brand: '{{ product.brand }}',
        Price: {{ product.price }},
        CompareAtPrice: {{ product.compare_at_price }} // If you have a compare at price. You could also include this for a sale or special price.
      }
  });
</script>

1. In het fragment hierboven wordt de plaatsaanduidingssyntaxis {{ }} gebruikt, die mogelijk anders is voor je OpenCart-winkel. Het belangrijkste is dat productvelden dynamisch worden gerenderd op basis van welke productpagina je bekijkt.
2. Nadat Viewed Product -tracking is geconfigureerd voor je site, zouden Viewed Product -gegevens in je Klaviyo-account moeten worden ingevuld terwijl bekende bezoekers door je productpagina's bladeren.

Hoe tracking op je site werkt

Wanneer je webtracking van Klaviyo aan je site toevoegt, kunnen we alleen de browseactiviteit van "bekende browsers" volgen - oftewel browsers die eerder minstens één keer hebben bezocht en betrokken zijn geweest. Er zijn twee belangrijke manieren waarop we een websitebezoeker kunnen identificeren voor webtrackingdoeleinden:

• Als iemand op een bepaald moment via een Klaviyo Email op je website heeft geklikt
• Als iemand zich op een bepaald moment heeft aangemeld/opgegeven via een Klaviyo-formulier

Klaviyo houdt geen gegevens bij van anonieme browsers.

Houd de Klaviyo-sync in de gaten

Hoe lang het duurt om alle historische klant- en bestelgegevens van je OpenCart-winkel te synchroniseren, hangt af van de grootte van je winkel. Zodra deze historische synchronisatie is voltooid, zie je een groene rand rond je OpenCart-integraties onder Ingeschakelde integraties.

Om je integratie te controleren:

1. Ga naar het tabblad Meetwaarden van je account, onder Analytics. Hier kun je filters gebruiken om alle OpenCart-meetwaarden te bekijken. Zoek de meetwaarde Bestelling geplaatst van OpenCart en klik op het pictogram Activiteitenfeed. Als je integratie is begonnen met het synchroniseren van gegevens, zie je hier Bestelling geplaatst -events verschijnen.
2. We synchroniseren automatisch alle historische bestelgegevens. Om dit te verifiëren, 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 Placed Order bekijkt, kun je met je muis over het datapunt van gisteren gaan of naar de gegevenstabel onder de grafiek kijken om te zien hoeveel bestellingen er gisteren zijn gerapporteerd.
4. Vergelijk dat getal met wat er gisteren in OpenCart is opgeslagen en je zou moeten zien dat ze exact overeenkomen. Als dat niet zo is, komt het probleem waarschijnlijk doordat de tijdzone van je Klaviyo-account niet overeenkomt met de ingestelde tijdzone van OpenCart.
5. Zo kun je de tijdzone van je account te controleren of bijwerken:
   • Klik linksonder op de naam van je organisatie.
   • Selecteer Instellingen.
   • Ga naar het tabblad Organisatie .

Gegevens gesynchroniseerd vanuit OpenCart

• Verkoop- en bestelgegevens
  Welke producten zijn gekocht, inclusief productdetails en afbeeldingen.
• Klantgegevens
  Voornaam, achternaam, locatie en klantgroep.
• Gegevens van gestarte checkout
  Wordt gebruikt om e-mails voor winkelwagen verlaten te activeren. Dit wordt ingeschakeld door het PHP-codefragment dat je hebt toegevoegd bij het integreren.
• Gegevens van uitgevoerde bestellingen
  Wordt gebruikt om bij te houden wanneer bestellingen worden verzonden.
• Tracking op de site
  Wanneer mensen je website bezoeken

Ga voor je OpenCart-meetwaarden in Klaviyo naar Analyse > Meetwaarden , waar je kunt filteren op OpenCart.

Standaard synchroniseert Klaviyo de volgende statussen voor de meetwaarden Geplaatste bestelling en Uitgevoerde bestelling:

• Bestelling geplaatst: In behandeling, Verwerkt, Wordt verwerkt, Verzonden, Voltooid
• Bestelling uitgevoerd: Verzonden, Voltooid