Überblick
Für das Affiliate-Tracking hinterlegst du deine Shop-Adresse, kopierst die Tracking-Skripte in dein Theme und legst vier Webhooks in deinem Shopify Admin an. Eine App gibt es dafür nicht. Die Einrichtung läuft vollständig über dein Theme und deinen Shopify-Adminbereich, ein Assistent im Dashboard führt dich durch die vier Schritte.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.
- Ein öffentlich erreichbarer Shop. Solange der Passwortschutz aktiv ist, kann Highcovery die Skripte nicht prüfen und das Tracking bleibt inaktiv.
Einrichtung
Gehe im Dashboard zu Affiliate → Integration und wähle oben rechts deinen Online-Shop. Die Übersicht zeigt zu jedem Schritt, ob er erledigt ist. Über Mit der Einrichtung beginnen oder Einrichtung fortsetzen öffnest du den Assistenten, er springt direkt zum ersten offenen Schritt. Die Schaltflächen im Assistenten führen dich an die passende Stelle in deinem Shopify-Adminbereich.1
Shop-Adresse hinterlegen
Trage deine Shopify-Adresse in der Form
meinshop.myshopify.com ein. Aus ihr baut das Dashboard die Links in deinen Adminbereich, und die tägliche Prüfung weiß, welchen Shop sie abrufen soll.2
Tracking-Skripte einbauen
Der Assistent zeigt zwei Ausschnitte. Das Core-Skript ist Pflicht: Es übergibt die Klick-ID an den Warenkorb und ist die Grundlage dafür, dass Bestellungen dir zugeordnet werden. Das Cookie-Skript ist optional, aber empfohlen: Es merkt sich die Klick-ID für spätere Besuche.Kopiere beide Ausschnitte über Skript kopieren, öffne in Shopify Online Store → Themes → … → Code bearbeiten und füge sie in
layout/theme.liquid direkt vor </body> ein. Die Ausschnitte enthalten die <script>-Tags bereits. Speichere das Theme und klicke im Assistenten auf Einrichtung jetzt prüfen.3
Webhook Secret übernehmen
Öffne in Shopify Einstellungen → Benachrichtigungen → Webhooks. Ganz unten steht der Signaturschlüssel, mit dem Shopify Webhooks signiert. Kopiere ihn und trage ihn im Assistenten ein. Ohne dieses Secret lehnt Highcovery jeden Webhook ab, weil sich seine Echtheit nicht prüfen lässt.
4
Webhooks anlegen
Der Assistent zeigt vier URLs. Lege in Shopify unter Einstellungen → Benachrichtigungen → Webhooks für jede URL einen Webhook an:
Wähle als Format JSON und als Webhook-API-Version die neueste stabile Version, die Shopify anbietet. Highcovery wertet nur die Standardfelder der Bestellung aus, die in allen aktuellen Versionen enthalten sind.Ob ein Webhook läuft, sieht das Dashboard erst, wenn das erste Ereignis eintrifft. Bis dahin steht dort Noch kein Ereignis. Du kannst das sofort auslösen, denn Shopify bietet zu jedem Webhook eine Testbenachrichtigung an.
5
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.
6
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.
Die tägliche Skriptprüfung
Highcovery ruft einmal am Tag die Startseite deines Shops ab und sucht dort die Signaturen der beiden Skripte. Im Script-Tag steht außerdem ein Fingerabdruck im Attributdata-hc-tracking. Daran erkennt das Dashboard, welche Fassung des Skripts bei dir läuft.
Ein bestandener Nachweis hält 14 Tage. Danach zählt nur noch das Ergebnis der letzten Prüfung. Mit Einrichtung jetzt prüfen löst du eine Prüfung sofort aus, statt auf den nächsten Tageslauf zu warten.
Fehlt das Skript, ist es veraltet oder lässt sich dein Shop nicht abrufen, schicken wir dir höchstens einmal pro Woche eine Mail dazu. Unser Team erhält denselben Hinweis. Sobald die Prüfung wieder durchgeht, endet die Erinnerung von selbst.
So funktioniert das Tracking
- Ein Nutzer klickt in der Highcovery App auf dein Produkt und landet mit den URL-Parametern
hc_cid(Klick-ID) undhc_pid(Partner-ID) in deinem Shop. - Das Core-Skript schreibt die Klick-ID als Warenkorb-Attribut in den Warenkorb. So gelangt sie in die Bestellung.
- Das Cookie-Skript speichert beide Werte zusätzlich für 30 Tage als Cookie, damit die Zuordnung auch bei einem späteren Besuch ohne Klick-ID greift. Es respektiert die Shopify Customer Privacy API: Ohne Marketing-Einwilligung wird kein Cookie gesetzt.
- Die Webhooks melden Highcovery jede Bestellung. Highcovery liest die Klick-ID aus der Bestellung und erzeugt die Conversion. Fehlt sie, greift der Gutscheincode-Fallback.
- Stornos und Erstattungen werden ebenfalls gemeldet und korrigieren die Provision.
Fehlerbehebung
- Keine Conversions trotz Bestellungen: prüfe, ob beide Skripte 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 zuerst den Schritt Tracking-Skripte einbauen im Assistenten und danach die Statusbanner auf deiner Affiliate-Seite. Sie nennen den Grund, etwa ein fehlendes Skript oder einen Shop, den wir nicht abrufen konnten.