Dokumentation

Ihren Website-Schlüssel holen

Beide Schritte brauchen Ihren Website-Schlüssel. Das ist eine kurze Folge aus Buchstaben und Zahlen, die Privatrak sagt, dass die Besuche zu Ihrem Shop gehören.

1. Öffnen Sie in Privatrak die Seite Einrichtung.
2. Kopieren Sie den dort angezeigten Website-Schlüssel.

In beiden Blöcken unten steht your-website-key. Das ist das Einzige, was Sie ersetzen, und Sie ersetzen es durch den gerade kopierten Schlüssel. Lassen Sie die Anführungszeichen darum genau so stehen.

1. Shopify Analytics auf Ihren Shop-Seiten einbinden

Dieser Schritt erfasst Ihre Startseite, Ihre Produktseiten, Ihre Kategorien und Ihren Warenkorb. Danach sehen Sie, welche Seiten Ihre Besucher öffnen und worauf sie klicken.

1. Öffnen Sie in Shopify Onlineshop und dann Themes.
2. Ihr veröffentlichtes Theme steht unter Aktuelles Theme. Öffnen Sie dort das Menü Aktionen, die Schaltfläche mit den drei Punkten.
3. Wählen Sie Code bearbeiten.
4. Klicken Sie in der Dateiliste links auf theme.liquid.
5. Suchen Sie die Zeile </head>, sie steht weit oben. Halten Sie zum Suchen Strg gedrückt und drücken Sie F, auf einem Mac Command und F.
6. Klicken Sie an den Anfang dieser Zeile, sodass der Cursor direkt davor steht.
7. Fügen Sie den Block unten ein und drücken Sie einmal die Eingabetaste.
8. Ersetzen Sie your-website-key durch den kopierten Schlüssel und lassen Sie die Anführungszeichen darum stehen.
9. Klicken Sie oben rechts auf Speichern.

<script
  src="https://api.privatrak.com/tracker.js"
  data-api-key="your-website-key"
  defer
></script>

Das ist der ganze Schritt. Besuche Ihrer Shop-Seiten erscheinen in Privatrak, meist innerhalb von ein bis zwei Minuten.

Dieser Block liegt in Ihrem Theme. Wenn Sie zu einem anderen Theme wechseln, Ihr Theme duplizieren oder eine Aktualisierung übernehmen, kann er ohne Hinweis verschwinden. Kommen Sie danach auf diese Seite zurück und prüfen Sie, ob er noch da ist. Die Einrichtung aus Schritt 3 liegt nicht in Ihrem Theme und bleibt bestehen.

2. Privatrak beide Adressen Ihres Shops nennen

Ihr Shop ist unter zwei Adressen erreichbar: unter der, die Sie gekauft haben, und unter einer auf myshopify.com, die Shopify jedem Shop gibt. Vorschauen Ihres Themes laufen immer über die Adresse auf myshopify.com. Privatrak lässt Besuche von Adressen aus, die nicht eingetragen sind. Tragen Sie deshalb beide ein.

1. Öffnen Sie in Privatrak Einstellungen › Datenschutz.
2. Suchen Sie Erlaubte Domains.
3. Tragen Sie Ihre eigene Adresse ein, zum Beispiel ihrshop.de.
4. Tragen Sie auch Ihre Shopify-Adresse ein, zum Beispiel ihrshop.myshopify.com.
5. Klicken Sie auf Änderungen speichern.

3. Ihren Shopify-Checkout messen

Auf dem Checkout lässt Shopify nichts aus Schritt 1 laufen. Sie richten den Checkout getrennt ein, in einem Bereich von Shopify, der genau dafür gemacht ist. Jeder Shopify-Tarif enthält ihn.

1. Öffnen Sie in Shopify Einstellungen und dann Kundenereignisse.
2. Klicken Sie auf Benutzerdefiniertes Pixel hinzufügen.
3. Geben Sie ihm einen Namen. Privatrak passt gut.
4. Klicken Sie auf Pixel hinzufügen.
5. In dem Feld steht bereits Beispielcode. Markieren Sie alles darin und löschen Sie es, sodass das Feld leer ist.
6. Fügen Sie den Block unten in das leere Feld ein.
7. Ersetzen Sie your-website-key durch Ihren Schlüssel und lassen Sie die Anführungszeichen stehen.
8. Klicken Sie auf Speichern und dann auf Verbinden.

const API = "https://api.privatrak.com/api/events";
const KEY = "your-website-key";

function safeUrl(href) {
  try {
    const url = new URL(href);
    url.search = "";
    url.hash = "";
    url.pathname = url.pathname.replace(
      /\/checkouts\/(cn|co|c)\/[^/]+/,
      "/checkouts/$1/:id",
    );
    return url.toString();
  } catch {
    return "";
  }
}

function send(name, attrs, href) {
  fetch(API, {
    method: "POST",
    keepalive: true,
    headers: { "Content-Type": "application/json", "X-API-Key": KEY },
    body: JSON.stringify({
      events: [
        {
          event_type: "custom",
          data_track: name,
          data_track_attrs: attrs,
          page_url: safeUrl(href),
          timestamp: new Date().toISOString(),
        },
      ],
    }),
  }).catch(() => {});
}

const line = (l) => ({
  product: String(l?.merchandise?.product?.title ?? ""),
  variant: String(l?.merchandise?.title ?? ""),
  price: String(l?.merchandise?.price?.amount ?? ""),
  currency: String(l?.merchandise?.price?.currencyCode ?? ""),
  quantity: String(l?.quantity ?? ""),
});

const basket = (c) => ({
  total: String(c?.cost?.totalAmount?.amount ?? ""),
  currency: String(c?.cost?.totalAmount?.currencyCode ?? ""),
  items: String(c?.totalQuantity ?? 0),
});

const order = (c) => ({
  total: String(c?.totalPrice?.amount ?? ""),
  currency: String(c?.currencyCode ?? ""),
  items: String(c?.lineItems?.length ?? 0),
});

const DETAIL = {
  product_viewed: (d) => ({
    product: String(d.productVariant?.product?.title ?? ""),
    variant: String(d.productVariant?.title ?? ""),
    price: String(d.productVariant?.price?.amount ?? ""),
    currency: String(d.productVariant?.price?.currencyCode ?? ""),
  }),
  collection_viewed: (d) => ({
    collection: String(d.collection?.title ?? ""),
    products: String(d.collection?.productVariants?.length ?? 0),
  }),
  search_submitted: (d) => ({
    results: String(d.searchResult?.productVariants?.length ?? 0),
  }),
  cart_viewed: (d) => basket(d.cart),
  product_added_to_cart: (d) => line(d.cartLine),
  product_removed_from_cart: (d) => line(d.cartLine),
  checkout_started: (d) => order(d.checkout),
  checkout_completed: (d) => order(d.checkout),
};

[
  "product_viewed",
  "collection_viewed",
  "search_submitted",
  "cart_viewed",
  "product_added_to_cart",
  "product_removed_from_cart",
  "checkout_started",
  "checkout_contact_info_submitted",
  "checkout_address_info_submitted",
  "checkout_shipping_info_submitted",
  "payment_info_submitted",
  "checkout_completed",
  "alert_displayed",
].forEach((name) => {
  analytics.subscribe(name, (event) => {
    const detail = DETAIL[name];
    send(
      name,
      detail ? detail(event.data) : {},
      event.context.document.location.href,
    );
  });
});

Das ist der ganze Schritt. Geben Sie in Ihrem Shop eine Testbestellung auf und öffnen Sie dann in Privatrak Events. Dort erscheinen die beiden Checkout-Events mit den Namen checkout_started und checkout_completed.

Was Sie in Privatrak sehen

Der Block, den Sie eingefügt haben, deckt bereits jeden Moment ab, den Shopify anbietet und der sich zu messen lohnt. Sie müssen dafür nichts ergänzen.

Von Ihren Shop-Seiten

• Jemand hat eine Produktseite geöffnet, mit Produkt, Variante und Preis.
• Jemand hat eine Kategorieseite geöffnet, mit ihrem Namen und der Anzahl der Produkte.
• Jemand hat in Ihrem Shop gesucht, mit der Anzahl der Treffer.
• Jemand hat den Warenkorb geöffnet, mit dem Warenwert und der Anzahl der Artikel.
• Jemand hat einen Artikel in den Warenkorb gelegt, mit Produkt, Variante, Preis und Menge.
• Jemand hat einen Artikel wieder herausgenommen, mit denselben Angaben.

Aus Ihrem Checkout

• Jemand hat den Checkout geöffnet, mit dem Bestellwert und der Anzahl der Artikel.
• Jemand hat seine Kontaktdaten eingegeben.
• Jemand hat eine Lieferadresse eingegeben.
• Jemand hat eine Versandart gewählt.
• Jemand hat Zahlungsdaten eingegeben.
• Jemand hat die Bestellung abgeschickt, mit dem Bestellwert und der Anzahl der Artikel.

Und noch einer

• Jemand hat eine Fehlermeldung gesehen, zum Beispiel einen Rabattcode, der nicht angenommen wurde. Dieser Moment ist oft der nützlichste von allen, denn er zeigt Ihnen, was Kunden vom Kauf abhält.

Aus jedem dieser Momente können Sie einen Funnel bauen, von der Produktseite bis zur abgeschlossenen Bestellung. Privatrak zählt Ihre Shop-Seiten und Ihren Checkout als denselben Besuch.

Was Privatrak nicht sieht

Shopify gibt dem Checkout viel über Ihre Kunden mit: Name, E-Mail-Adresse und Lieferadresse. Nichts davon erreicht Privatrak. Der Block, den Sie eingefügt haben, sendet drei Dinge und sonst nichts: die Währung, den Bestellwert und die Anzahl der Artikel.

Mit der Suche in Ihrem Shop ist es genauso. Privatrak erfasst, wie viele Treffer eine Suche hatte, nie die eingegebenen Wörter. Was jemand in ein Feld Ihrer Website eingibt, behandelt Privatrak als privat, und die Suche ist keine Ausnahme. Dass 40 Suchen ohne Treffer blieben, sagt Ihnen, was Sie ins Sortiment nehmen sollten. Welches Wort ein einzelner Kunde getippt hat, sagt Ihnen nichts.

Die Adresse einer Checkout-Seite ist die zweite Stelle, die Sie kennen sollten. In ihr steht eine lange Buchstabenfolge. Diese Folge wirkt wie ein Schlüssel zu genau dieser Bestellung. Mit ihr könnte jeder die Bestellung öffnen und die Daten Ihres Kunden lesen. Der Block ersetzt sie, bevor etwas gesendet wird. In Privatrak sieht eine Adresse daher so aus: /checkouts/cn/:id/de-at/thank-you.

Beide Schutzmaßnahmen stecken fest im Block. Sie müssen nichts einschalten und nichts pflegen.

Zwei Grenzen, die von Shopify kommen

Kunden in der EU und in Großbritannien

In diesen Ländern hält Shopify den Checkout-Teil zurück, bis der Kunde der Erfassung zustimmt. Dort fehlen manche Checkouts. Schritt 1 ist davon nicht betroffen und läuft weiter, denn er speichert nichts auf dem Gerät.

Im Checkout sieht niemand die Einzelheiten

Shopify führt seinen Checkout abgeschottet von jedem Messwerkzeug aus, auch von Privatrak. Der Checkout liefert Ihnen die Momente von oben und nicht jeden einzelnen Klick. Für alles bis zum Warenkorb gilt diese Grenze nicht.

Zu den Produktadressen

Adressen von Produktseiten enden auf etwas wie ?variant=54760077885766. Diese Nummer ist nicht privat. Shopify verwendet sie für eine Größe oder eine Farbe, sie ist für alle gleich, und die Seite zeigt sie ohnehin jedem. Sie müssen damit nichts tun, und Privatrak zählt alle Varianten eines Produkts zusammen als eine Seite.

Wenn nichts erscheint

• Warten Sie ein paar Minuten. Die ersten Besuche brauchen manchmal einen Moment.
• Prüfen Sie, ob beide Adressen in Privatrak unter Einstellungen › Datenschutz eingetragen sind. Das ist mit Abstand die häufigste Ursache.
• Prüfen Sie, ob Ihr Schlüssel an beiden Stellen richtig eingefügt ist und die Anführungszeichen noch darum stehen.
• Prüfen Sie für den Checkout, ob das Pixel in Shopify unter Einstellungen › Kundenereignisse als Verbunden angezeigt wird.
• Wenn Sie Ihr Theme kürzlich gewechselt oder aktualisiert haben, ist Schritt 1 vielleicht mit verschwunden. Gehen Sie Schritt 1 noch einmal durch.