Skip to main content

​
Überblick

Für das Affiliate-Tracking fügst du zwei kleine Scripts in dein Shopify-Theme ein und legst vier Webhooks in deinem Shopify Admin an. Es muss keine App installiert werden.
Diese Anleitung richtet nur die technische Seite in deinem Shop ein. Ob Klicks und Bestellungen tatsächlich erfasst werden, hängt zusätzlich von deinem Affiliate-Vertrag ab, siehe Affiliate-Tracking.

​
Voraussetzungen

  • Ein aktiver Affiliate-Vertrag mit Partner-ID, siehe Partnervereinbarung. Die Webhook-URLs werden erst angezeigt, wenn deine Partner-ID vergeben ist.
  • Zugriff auf den Theme-Code deines Shops (Online Store → Themes → Code bearbeiten).
  • Admin-Zugang zu Einstellungen → Benachrichtigungen in Shopify, um Webhooks anzulegen.

​
Einrichtung

1

Integration öffnen

Gehe im Dashboard zu Affiliate → Integration, wähle oben rechts deinen Online-Shop und öffne den Tab Manuelles Script.
2

Cookie-Skript im Head einfügen

Kopiere das Cookie-Skript über Skript kopieren. Öffne in Shopify Online Store → Themes → … → Code bearbeiten und füge das Skript in layout/theme.liquid direkt vor </head> ein. Das Skript enthält bereits die <script>-Tags.
3

Core-Skript vor dem Body-Ende einfügen

Kopiere das Core-Skript und füge es in derselben Datei direkt vor </body> ein. Speichere das Theme.
4

Webhook Secret hinterlegen

Öffne in Shopify Einstellungen → Benachrichtigungen → Webhooks. Ganz unten steht der Signaturschlüssel, mit dem Shopify Webhooks signiert. Kopiere ihn, trage ihn im Dashboard unter Shopify Webhook Secret ein und klicke auf Secret speichern.
5

Webhooks in Shopify anlegen

Im Dashboard findest du unter Shopify Webhooks vier URLs. Lege in Shopify unter Einstellungen → Benachrichtigungen → Webhooks für jede URL einen Webhook an (Format JSON):Wähle als Webhook-API-Version die neueste stabile Version, die Shopify anbietet (z. B. 2025-10 oder neuer). Highcovery wertet nur die Standardfelder der Bestellung aus, die in allen aktuellen Versionen enthalten sind.
6

Gutscheincodes hinterlegen (optional)

Unter Gutscheincodes kannst du Codes eintragen, getrennt durch Kommas. Nutzt ein Kunde einen dieser Codes, wird die Bestellung auch dann dir zugeordnet, wenn keine Klick-ID vorliegt.
7

Einrichtung prüfen

Öffne einen Deeplink aus der Highcovery App und lege damit eine Testbestellung an. Sie erscheint auf deiner Affiliate-Seite unter Letzte Aktivität.

​
So funktioniert das Tracking

  1. Ein Nutzer klickt in der Highcovery App auf dein Produkt und landet mit den URL-Parametern hc_cid (Klick-ID) und hc_pid (Partner-ID) in deinem Shop.
  2. Das Cookie-Skript speichert beide Werte für 30 Tage als Cookie. Es respektiert die Shopify Customer Privacy API: Ohne Marketing-Einwilligung wird kein Cookie gesetzt.
  3. Das Core-Skript schreibt die Klick-ID als Warenkorb-Attribut in den Warenkorb. So gelangt sie in die Bestellung.
  4. Die Webhooks melden Highcovery jede Bestellung. Highcovery liest die Klick-ID aus der Bestellung und erzeugt die Conversion. Fehlt sie, greift der Gutscheincode-Fallback.
  5. Stornos und Erstattungen werden ebenfalls gemeldet und korrigieren die Provision.
Wechselst du dein Theme, musst du beide Scripts im neuen Theme erneut einfügen. Die Webhooks bleiben erhalten.

​
Fehlerbehebung

  • Keine Conversions trotz Bestellungen – prüfe, ob beide Scripts im aktiven Theme liegen und ob die vier Webhooks in Shopify auf die richtigen URLs zeigen.
  • Webhooks werden abgelehnt – das Webhook Secret im Dashboard muss exakt dem Signaturschlüssel aus Shopify entsprechen. Speichere es erneut.
  • Bestellungen mit Gutschein werden nicht zugeordnet – der Code muss unter Gutscheincodes exakt so eingetragen sein, wie er in Shopify heißt.
  • Tracking-Status inaktiv – prüfe die Statusbanner auf deiner Affiliate-Seite. Sie nennen den Grund, etwa eine fehlende Zahlungsmethode.
Bei Problemen melde dich mit deiner Shop-Domain und dem ungefähren Zeitpunkt der Bestellung bei support@highcovery.com.