> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highcovery.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify einrichten

> Affiliate-Tracking manuell in deinem Shopify-Shop einrichten

## Ü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.

<Note>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](/de/affiliate/tracking).</Note>

### Voraussetzungen

* Ein aktiver **Affiliate-Vertrag** mit Partner-ID, siehe [Partnervereinbarung](/de/affiliate/contract). 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

<Steps>
  <Step title="Integration öffnen">
    Gehe im Dashboard zu **Affiliate → Integration**, wähle oben rechts deinen Online-Shop und öffne den Tab **Manuelles Script**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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**):

    | Shopify-Ereignis        | Highcovery-URL          |
    | ----------------------- | ----------------------- |
    | Bestellerstellung       | Order Created Webhook   |
    | Bestellzahlung          | Order Paid Webhook      |
    | Bestellstornierung      | Order Cancelled Webhook |
    | Rückerstattung erstellt | Order Refunded Webhook  |

    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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

## 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.

<Warning>Wechselst du dein Theme, musst du beide Scripts im neuen Theme erneut einfügen. Die Webhooks bleiben erhalten.</Warning>

## 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.

<Tip>Bei Problemen melde dich mit deiner Shop-Domain und dem ungefähren Zeitpunkt der Bestellung bei [support@highcovery.com](mailto:support@highcovery.com).</Tip>