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

> Affiliate-tracking handmatig in je Shopify-shop instellen

## Overzicht

Voor de affiliate-tracking voeg je twee kleine scripts toe aan je Shopify-thema en leg je vier webhooks vast in je Shopify-beheer. Er hoeft geen app te worden geïnstalleerd.

<Note>Deze handleiding stelt alleen de technische kant in je shop in. Of kliks en bestellingen daadwerkelijk worden geregistreerd, hangt daarnaast af van je affiliatecontract, zie [Affiliate-tracking](/nl/affiliate/tracking).</Note>

### Vereisten

* Een actief **affiliatecontract** met partner-ID, zie [Partnerovereenkomst](/nl/affiliate/contract). De webhook-URL's worden pas getoond zodra je partner-ID is toegekend.
* Toegang tot de **themacode** van je shop (Online Store → Thema's → Code bewerken).
* Beheerderstoegang tot **Instellingen → Meldingen** in Shopify om webhooks aan te maken.

## Instellen

<Steps>
  <Step title="Integratie openen">
    Ga in het dashboard naar **Affiliate → Integratie**, kies rechtsboven je online shop en open het tabblad **Handmatig script**.
  </Step>

  <Step title="Cookiescript in de head plaatsen">
    Kopieer het **Cookiescript** via *Script kopiëren*. Open in Shopify **Online Store → Thema's → … → Code bewerken** en voeg het script in `layout/theme.liquid` direct vóór `</head>` toe. Het script bevat de `<script>`-tags al.
  </Step>

  <Step title="Kernscript vóór het einde van de body plaatsen">
    Kopieer het **Kernscript** en voeg het in hetzelfde bestand direct vóór `</body>` toe. Sla het thema op.
  </Step>

  <Step title="Webhook-geheim vastleggen">
    Open in Shopify **Instellingen → Meldingen → Webhooks**. Helemaal onderaan staat de handtekeningsleutel waarmee Shopify webhooks ondertekent. Kopieer die, vul hem in het dashboard in onder **Shopify Webhook-geheim** en klik op **Geheim opslaan**.
  </Step>

  <Step title="Webhooks in Shopify aanmaken">
    In het dashboard vind je onder **Shopify Webhooks** vier URL's. Maak in Shopify onder **Instellingen → Meldingen → Webhooks** voor elke URL een webhook aan (formaat **JSON**):

    | Shopify-gebeurtenis      | Highcovery-URL          |
    | ------------------------ | ----------------------- |
    | Bestelling aangemaakt    | Order Created Webhook   |
    | Bestelling betaald       | Order Paid Webhook      |
    | Bestelling geannuleerd   | Order Cancelled Webhook |
    | Terugbetaling aangemaakt | Order Refunded Webhook  |

    Kies als **webhook-API-versie** de nieuwste stabiele versie die Shopify aanbiedt (bijvoorbeeld `2025-10` of nieuwer). Highcovery leest alleen de standaardvelden van de bestelling, die in alle huidige versies zitten.
  </Step>

  <Step title="Kortingscodes vastleggen (optioneel)">
    Onder **Kortingscodes** kun je codes invoeren, gescheiden door komma's. Gebruikt een klant een van deze codes, dan wordt de bestelling ook aan jou toegewezen als er geen klik-ID beschikbaar is.
  </Step>

  <Step title="Instelling controleren">
    Open een deeplink uit de Highcovery app en plaats daarmee een testbestelling. Die verschijnt op je affiliate-pagina onder **Recente activiteit**.
  </Step>
</Steps>

## Zo werkt de tracking

1. Een gebruiker klikt in de Highcovery app op je product en komt met de URL-parameters `hc_cid` (klik-ID) en `hc_pid` (partner-ID) in je shop terecht.
2. Het **Cookiescript** slaat beide waarden **30 dagen** op als cookie. Het respecteert de Shopify Customer Privacy API: zonder marketingtoestemming wordt er geen cookie geplaatst.
3. Het **Kernscript** schrijft de klik-ID als winkelwagenattribuut in de winkelwagen. Zo belandt die in de bestelling.
4. De **webhooks** melden elke bestelling bij Highcovery. Highcovery leest de klik-ID uit de bestelling en maakt de conversie aan. Ontbreekt die, dan grijpt de terugval op kortingscodes in.
5. **Annuleringen en terugbetalingen** worden eveneens gemeld en corrigeren de commissie.

<Warning>Wissel je van thema, dan moet je beide scripts opnieuw in het nieuwe thema plaatsen. De webhooks blijven behouden.</Warning>

## Problemen oplossen

* **Geen conversies ondanks bestellingen** – controleer of beide scripts in het actieve thema staan en of de vier webhooks in Shopify naar de juiste URL's verwijzen.
* **Webhooks worden geweigerd** – het webhook-geheim in het dashboard moet exact overeenkomen met de handtekeningsleutel uit Shopify. Sla het opnieuw op.
* **Bestellingen met kortingscode worden niet toegewezen** – de code moet onder **Kortingscodes** exact zo zijn ingevoerd als hij in Shopify heet.
* **Trackingstatus inactief** – controleer de statusbanners op je affiliate-pagina. Die noemen de reden, bijvoorbeeld een ontbrekende betaalmethode.

<Tip>Bij problemen kun je je met je shopdomein en het geschatte tijdstip van de bestelling melden bij [support@highcovery.com](mailto:support@highcovery.com).</Tip>