Zum Inhalt springen

Shopify-Integration

So binden Sie PureMetrix in Ihren Shopify-Shop ein: cookiefreies Skript laden, Custom Pixel für Seitenaufrufe und Funnel-Schritte setzen, und den Umsatz serverseitig über den Shopify-Webhook „Bestellzahlung“ (orders/paid) melden. Sie brauchen dafür keine App, keinen Code und keinen privaten Schlüssel.

Voraussetzungen

  • Eine PureMetrix-Website, deren Hostname zu Ihrem Shop passt (eigene Domain oder *.myshopify.com).
  • Öffentlicher Schlüssel in der App: Website öffnen → Dialog Installation und Tracking-Code → Reiter HTML-Skript (Bezeichnung Öffentlicher Schlüssel, im Snippet als data-key).
  • Zugriff auf den Shopify-Admin: Einstellungen → Kundenereignisse (Custom Pixel), Theme-/App-Embed und Einstellungen → Benachrichtigungen → Webhooks (Umsatz, Schritt 3).
  • Die Rolle Inhaber oder Admin für die PureMetrix-Website, um den Shopify-Signatur-Schlüssel zu speichern (Bearbeiter sehen die Einrichtungsseite, können den Schlüssel aber nicht ändern).

1. PureMetrix-Skript einbinden

Das Custom Pixel ruft window.puremetrix() auf. Laden Sie zuerst das Tracking-Skript (Snippet oder Theme-App-Erweiterung) mit Domain und öffentlichem Schlüssel. Bei einem Proxy nutzen Sie die Pfade auf Ihrer eigenen Domain.

<script defer data-domain="your-shop.myshopify.com" data-key="YOUR_PUBLIC_KEY"
  data-api="https://collect.puremetrix.org/api/event"
  src="https://collect.puremetrix.org/js/script.js"></script>

Tragen Sie in data-domain Ihre eigene Shop-Domain ein, wenn diese als Hostname Ihrer PureMetrix-Website hinterlegt ist.

2. Custom Pixel hinzufügen

  1. Öffnen Sie im Shopify-Admin Einstellungen → Kundenereignisse und legen Sie ein Custom Pixel an.
  2. Fügen Sie das PureMetrix-Shopify-Pixel ein (adapters/shopify/pixel.js im PureMetrix-Repository).
  3. Verbinden Sie das Pixel und veröffentlichen Sie es für Ihren Shop.

Das Pixel empfängt die Analytics-Ereignisse von Shopify und leitet sie so weiter:

  • page_viewed → pageview
  • product_added_to_cart → Add to cart
  • checkout_started → Begin checkout
  • checkout_completed → Purchase ohne Umsatz (nur für den Funnel — damit Browser und Webhook denselben Betrag nicht doppelt zählen)

3. Umsatz: Shopify-Webhook

Der Umsatz kommt direkt von Shopify, nicht aus dem Browser: Sobald eine Bestellung bezahlt ist, schickt Shopify sie an PureMetrix. Sie richten das einmalig an zwei Stellen ein.

In PureMetrix: Webhook-URL kopieren

  1. Öffnen Sie die Website in PureMetrix → Website-Einstellungen → Shopify.
  2. Kopieren Sie die Webhook-URL. Sie sieht so aus: https://collect.puremetrix.org/webhooks/shopify/orders-paid?site=IHR_ÖFFENTLICHER_SCHLÜSSEL und gilt nur für diese Website.

In Shopify: Webhook anlegen

  1. Öffnen Sie im Shopify-Admin Einstellungen → Benachrichtigungen und klicken Sie auf Webhooks.
  2. Klicken Sie auf Webhook erstellen.
  3. Ereignis: Bestellzahlung (englisch „Order payment“). Format: JSON.
  4. URL: Fügen Sie die Webhook-URL aus PureMetrix ein. Lassen Sie die Webhook-API-Version unverändert und klicken Sie auf Speichern.

Zurück in PureMetrix: Signatur-Schlüssel einfügen

  1. Auf derselben Webhook-Seite zeigt Shopify den Hinweis, dass Ihre Webhooks mit einem langen Code signiert werden. Kopieren Sie diesen Code.
  2. Fügen Sie ihn unter Website-Einstellungen → Shopify in das Feld Shopify-Signatur-Schlüssel ein und klicken Sie auf Schlüssel speichern.

PureMetrix speichert den Schlüssel verschlüsselt und zeigt danach nur noch die letzten vier Zeichen an. Damit prüft PureMetrix bei jeder Zustellung die Shopify-Signatur (X-Shopify-Hmac-Sha256); Bestellungen aus anderen Quellen werden abgelehnt. Jede Bestellung wird nur einmal gezählt, auch wenn Shopify sie erneut sendet.

Dieser Webhook ist die Quelle für revenue.amount und Währung beim Kauf. Bestellungen werden erfasst, solange die Website Daten sammelt; die Umsatzberichte im Dashboard gibt es ab dem Growth-Tarif.

Für Entwickler: Die bisherige Server-zu-Server-Variante funktioniert weiterhin: POST https://collect.puremetrix.org/webhooks/shopify/orders-paid (ohne ?site=) mit Authorization: Bearer <PRIVATER_SCHLÜSSEL> oder Header data-key, signiert mit dem gemeinsamen Shopify-Secret des Collect-Hosts. Die Query ?key= wird abgelehnt.

4. Ziele in PureMetrix

Legen Sie Ereignis-Ziele für Add to cart, Begin checkout und Purchase an (und schalten Sie die E-Commerce-/Umsatz-Widgets frei, wenn Ihr Tarif sie enthält — ab Growth). Mehr dazu unter E-Commerce-Umsatz erfassen.

Prüfen

  1. Öffnen Sie in einem privaten Fenster eine Kollektion → Produkt → Warenkorb. Unter Entwicklertools → Netzwerk sollten Skript und Ereignis-Anfragen erscheinen.
  2. Die Seitenaufrufe im Dashboard aktualisieren sich nach etwa einer Minute.
  3. Geben Sie eine Testbestellung auf, zum Beispiel mit dem Test-Zahlungsanbieter von Shopify: Das Pixel kann einen Purchase-Schritt für den Funnel zeigen; Umsatz und durchschnittlicher Bestellwert erscheinen wenige Minuten, nachdem Shopify die bezahlte Bestellung zugestellt hat.
  4. Nutzen Sie dafür eine echte Testbestellung statt der Schaltfläche Test senden: Die Beispielbestellung, die Shopify dabei schickt, ist wie eine echte signiert und würde ebenfalls als Kauf gezählt.
  5. Kein Umsatz zu sehen? Prüfen Sie, ob die URL in Shopify genau der URL unter Website-Einstellungen → Shopify entspricht und ob der gespeicherte Schlüssel von derselben Shopify-Webhook-Seite stammt.

Datenschutz

PureMetrix setzt keine Cookies bei Ihren Besuchern. Andere Shopify-Apps tun das unter Umständen — dann richten Sie Ihr Einwilligungs-Tool (CMP) für diese Apps ein. Die Besucherstatistiken von PureMetrix liegen in der EU bei Hetzner.

Verwandte Themen