Skip to main content

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

​
Vereisten

  • Een actief affiliatecontract met partner-ID, zie Partnerovereenkomst. 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

1

Integratie openen

Ga in het dashboard naar Affiliate → Integratie, kies rechtsboven je online shop en open het tabblad Handmatig script.
2

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

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

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

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):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.
6

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

Instelling controleren

Open een deeplink uit de Highcovery app en plaats daarmee een testbestelling. Die verschijnt op je affiliate-pagina onder Recente activiteit.

​
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.
Wissel je van thema, dan moet je beide scripts opnieuw in het nieuwe thema plaatsen. De webhooks blijven behouden.

​
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.
Bij problemen kun je je met je shopdomein en het geschatte tijdstip van de bestelling melden bij support@highcovery.com.