So integrierst du OpenCart

Übersicht

Erfahre, wie du OpenCart in Klaviyo integrierst. Nach Abschluss dieser Schritte kannst du E-Mails auf der Grundlage der Käufe und Website-Aktivitäten der einzelnen Kund*innen personalisieren und gezielt versenden. Die OpenCart-Integration wird stündlich synchronisiert.

Bevor du anfängst

Bitte beachte, dass Klaviyo deinen Katalog nicht aus OpenCart synchronisiert.

OpenCart-Integration hinzufügen

Das Hinzufügen der OpenCart-Integration von Klaviyo erfolgt in mehreren Schritten und erfordert Aktionen sowohl in OpenCart als auch in Klaviyo.

Für den Einstieg unterstützt Klaviyo derzeit OpenCart 1.4.x und 1.5.x. Lade das Klaviyo-OpenCart-Modul hier herunter: https://www.klaviyo.com/media/downloads/OpenCartKlaviyo-1.1.0.tgz.

1. Entpacke das Archiv in das Stammverzeichnis deiner OpenCart-Installation.
2. Melde dich im OpenCart-Adminbereich an und gehe zur Seite Erweiterungen > Module.
3. Installiere das Klaviyo-Modul und klicke dann für das Klaviyo-Modul auf Bearbeiten.
4. Kopiere den folgenden PHP-Code und füge ihn am Ende von upload/index.php ein, direkt vor der Zeile $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. Wähle in Klaviyo die Registerkarte Integrationen.
2. Klicke auf Apps entdecken und suche nach OpenCart, und klicke dann auf die Karte. Klicke dann auf Installieren.
3. Gib die URL deiner OpenCart-Website unter Shop-URL ein und klicke dann auf Mit OpenCart verbinden.

4. Kopiere auf der nächsten Seite den API-Schlüssel unter Klaviyo OpenCart module und füge ihn in die Einstellungen des Klaviyo-Moduls in OpenCart ein. Speichere die Einstellungen des Klaviyo-Moduls in der OpenCart-Administration. Speichere vor Abschluss der Einrichtung eine Kopie dieses Schlüssels an einem sicheren Ort; Klaviyo zeigt ihn danach nicht noch einmal an.

5. Wähle in Klaviyo Neue OpenCart-Kund*innen zu einer Klaviyo-Liste hinzufügen aus und wähle eine Liste aus, wenn du Kund*innen hinzufügen möchtest, die sich für deinen OpenCart-Newsletter angemeldet haben, wenn ihre Bestelldaten synchronisiert werden. Diese Einstellung abonniert sie nicht für Marketing-Nachrichten in Klaviyo. Wenn du keine Kund*innen zu einer Liste hinzufügen möchtest, deaktiviere das Kontrollkästchen.
6. Zurück in Klaviyo klickst du auf Setup abschließen , um mit der Datensynchronisierung zu beginnen.

Klaviyo-Onsite-Tracking installieren

Um die Aktivität vor Ort in OpenCart zu tracken, suche zuerst deinen öffentlichen API-Schlüssel von Klaviyo, indem du unten links auf deinen Kontonamen klickst und zu Einstellungen > API-Schlüssel navigierst. Kopiere den Schlüssel unter Öffentlicher API-Schlüssel / Website-ID. Dein öffentlicher Schlüssel ist 6 Zeichen lang und unterscheidet sich vom OpenCart-Modulschlüssel, der oben verwendet wird. Es gibt 2 Arten von Tracking vor Ort, die du installieren kannst:

• Auf Seite aktiv
  Diese Metrik wird immer dann getrackt, wenn jemand deine Website über einen identifizierbaren Browser besucht.
• Viewed Product
  Diese Metrik wird immer dann getrackt, wenn ein identifizierbarer Browser eine Produktseite auf deiner Website aufruft

„Auf Website aktiv“-Tracking hinzufügen

Diese Metrik wird immer dann getrackt, wenn ein identifizierbarer Browser deine Website besucht. So startest du das Tracking der Aktivität Auf Seite aktiv:

1. Füge den folgenden Codeausschnitt zu deiner Hauptshop-Vorlage hinzu, damit er auf allen Seiten enthalten ist. Platziere dieses Code-Fragment entweder zusammen mit anderen Analytics-Skripten, die du verwendest, oder direkt vor dem schließenden </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. Stelle sicher, dass du PUBLIC_API_KEY durch den öffentlichen API-Schlüssel deines Klaviyo-Kontos ersetzt.
2. Wenn Besucher*innen oder Kund*innen Konten für deinen Shop erstellen können, passe das folgende Beispiel an die Sprache deiner OpenCart-Vorlage an und füge es dann direkt unterhalb des ersten Snippets hinzu. Ersetze die Beispiel-Kund*innenfelder vor der Veröffentlichung durch die Kund*innendaten aus deinem Shop, wenn sie eingeloggt sind:

<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. Je nach den Arten von Vorlagen, die du für deine Website verwendest, ist die {% if user.is_logged_in %} - und {{ user.email }} -Syntax wahrscheinlich anders. Mit der verfügbaren Vorlagensprache möchtest du prüfen, ob die Person, die die aktuelle Seite ansieht, angemeldet ist. Wenn ja, solltest du ihre E-Mail-Adresse und ihren Namen ausgeben, falls verfügbar. Wenn du keine Namensinformationen hast, entferne diese beiden Zeilen und das nachgestellte Komma nach der E-Mail-Zeile $email. Escape E-Mail- und Namenswerte für JavaScript, damit Anführungszeichen das Snippet nicht beschädigen.

„Produkt angesehen“-Tracking hinzufügen

Wenn du einen Browse-Abandonment-Flow einrichten oder Segmente auf der Grundlage von Daten zum Produkt-Surfverhalten erstellen möchtest, solltest du das JavaScript-Ereignis-Tracking für eine Metrik „Produkt aufgerufen“ hinzufügen.

1. Füge auf deiner Produktseitenvorlage das folgende Beispiel nach dem wichtigsten Onsite-Tracking-Snippet und seinem Initialisierungscode hinzu. Passe die Platzhalter an deine OpenCart-Vorlagensprache an, bevor du veröffentlichst:

<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. Der obige Codeausschnitt verwendet Beispielplatzhalter {{ }}. Ersetze sie durch Werte, die für das gerade angezeigte Produkt dynamisch gerendert werden, und verwende dabei deine OpenCart-Vorlagensprache. Rendere Kategorien als Array von Strings und Preise als Zahlen, und maskiere Textwerte für JavaScript, damit Namen mit Anführungszeichen den Codeausschnitt nicht beschädigen. Entferne das Feld für den Vergleichspreis, wenn dein Shop es nicht verwendet.
2. Nachdem das Viewed Product -Tracking für deine Website konfiguriert wurde, sollten Viewed Product -Daten in deinem Klaviyo-Konto angezeigt werden, sobald bekannte Besucher*innen deine Produktseiten durchsuchen.

So funktioniert Onsite-Tracking

Klaviyo ordnet die Aktivität auf der Website einem Profil zu, sobald der Browser der Besucher*innen identifiziert wurde. Ein vorheriger Besuch ist nicht erforderlich. Dein Shop kann Besucher*innen auf folgende Arten identifizieren:

• Jemand hat irgendwann über eine Klaviyo Email auf deine Website geklickt
• Jemand hat irgendwann ein Klaviyo-Formular abonniert oder eine Einwilligung darüber erteilt
• Wenn sich jemand in deinem Shop anmeldet und das oben stehende Identifikations-Snippet seine Kund*innendaten an Klaviyo sendet

Wenn Anonymous backfill aktiviert ist, kann Klaviyo Onsite-Aktivitäten im Browser der Besucher*innen speichern, bevor sie identifiziert werden, und sie anschließend zu ihrem Profil hinzufügen. Erfahre mehr über den Anonymen Besucheraktivitätsnachtrag.

Klaviyo-Synchronisierung überwachen

Die Zeit, die für die Synchronisierung historischer Kund*innen- und Bestelldaten aus deinem OpenCart-Shop benötigt wird, hängt von der Größe deines Shops ab. Um den Fortschritt zu überprüfen, öffne Integrationen und wähle OpenCart aus. Öffne dann die Registerkarte Daten. Der Abschnitt historische Daten zeigt den Synchronisierungsfortschritt an und bestätigt, wann die historische Synchronisierung abgeschlossen ist.

So überprüfst du deine Integrationen:

1. Navigiere zu Analytics > Metriken und filtere nach OpenCart. Öffne Placed Order und wähle den Tab Aktivitätsfeed aus. Wenn deine Integration begonnen hat, Daten zu synchronisieren, wirst du hier nach und nach sehen, wie sich Placed-Order-Ereignisse füllen.
2. Klaviyo importiert automatisch historische Bestellungen mit gültigen Kund*innen-E-Mail-Adressen und den unten aufgeführten Bestellstatus. Nachdem die Synchronisierung der historischen Daten abgeschlossen ist, vergleiche die Anzahl der Placed Order-Ereignisse an einem bestimmten Tag mit den entsprechenden Bestellungen in OpenCart.
3. Öffne zum Beispiel den Tab Diagramm für Bestellung aufgegeben, wähle Täglich und Gesamt aus und wähle einen Datumsbereich aus, der gestern einschließt. Bewege den Mauszeiger über den gestrigen Datenpunkt oder sieh dir die Tabelle unterhalb des Diagramms an, um zu sehen, wie viele Bestellungen gemeldet wurden.
4. Vergleiche diese Anzahl mit OpenCart-Bestellungen vom selben Tag, die die oben genannten Anforderungen an E-Mail und Status erfüllen. Wenn die Anzahlen unterschiedlich sind, prüfe, ob die Synchronisierung abgeschlossen ist und ob beide Ansichten dieselbe Zeitzone verwenden.
5. So überprüfst oder aktualisierst du die Zeitzone deines Kontos:
   • Klicke unten links auf deinen Kontonamen.
   • Wähle Einstellungen.
   • Gehe zum Tab Konto und suche nach Zeitzone.
   • Wähle bei Bedarf die richtige Zeitzone aus und klicke auf Speichern.

Daten, die von OpenCart synchronisiert wurden

• Verkaufs- und Bestelldaten
  Welche Produkte gekauft wurden, einschließlich Produktdetails und Bildern.
• Kund*inneninformationen
  E-Mail-Adresse, Vorname, Nachname, Telefonnummer, Kund*innengruppe, OpenCart-Shop und Newsletter-Opt-in-Informationen.
• Daten zur begonnenen Kaufabwicklung
  Wird verwendet, um Warenkorbabbruch-E-Mails auszulösen. Dazu sind das PHP-Code-Fragment erforderlich, das du beim Integrieren hinzugefügt hast, sowie ein Warenkorb, der einer angemeldeten Kund*in zugeordnet ist, oder Gast-Checkout-Details, die eine gültige E-Mail-Adresse enthalten.
• Daten zu erfüllten Bestellungen
  Werden verwendet, um zu verfolgen, wann Bestellungen versendet werden.
• Onsite-Tracking
  Aktivitäten zu Aktiv auf der Website und Angesehenes Produkt, die über die JavaScript-Snippets erfasst werden, die du separat installierst. Diese Ereignisse sind getrennt von der OpenCart-Bestell- und Checkout-Synchronisierung.

Um deine OpenCart-Metriken anzuzeigen, navigiere zu Analytics > Metrik in Klaviyo, wo du nach OpenCart filtern kannst.

Standardmäßig synchronisiert Klaviyo die folgenden Status für die Metriken Placed Order und Fulfilled Order:

• Bestellung aufgegeben: Ausstehend, Bearbeitet, Verarbeitet, Versendet, Abgeschlossen
• Erfüllte Bestellung: Versandt, abgeschlossen

Weitere Ressourcen