Overzicht
Voor de affiliate-tracking leg je je shopadres vast, kopieer je de trackingscripts in je thema en maak je vier webhooks aan in je Shopify-beheer. Een app is er niet voor. Het instellen verloopt volledig via je thema en je Shopify-beheer, en een assistent in het dashboard leidt je door de vier stappen.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.
- Een openbaar bereikbare shop. Zolang de wachtwoordbeveiliging actief is, kan Highcovery de scripts niet controleren en blijft de tracking inactief.
Instellen
Ga in het dashboard naar Affiliate → Integratie en kies rechtsboven je online shop. Het overzicht laat per stap zien of die klaar is. Met Instellen starten of Instellen voortzetten open je de assistent, die meteen naar de eerste openstaande stap springt. De knoppen in de assistent brengen je naar de bijbehorende plek in je Shopify-beheer.1
Shopadres vastleggen
Vul je Shopify-adres in de vorm
mijnshop.myshopify.com in. Daaruit bouwt het dashboard de links naar je beheeromgeving, en de dagelijkse controle weet welke shop ze moet opvragen.2
Trackingscripts toevoegen
De assistent toont twee fragmenten. Het kernscript is verplicht: het geeft de klik-ID door aan de winkelwagen en is de basis voor het toewijzen van bestellingen aan jou. Het cookiescript is optioneel maar aanbevolen: het onthoudt de klik-ID voor latere bezoeken.Kopieer beide fragmenten via Script kopiëren, open in Shopify Online Store → Thema’s → … → Code bewerken en plak ze in
layout/theme.liquid direct vóór </body>. De fragmenten bevatten de <script>-tags al. Sla het thema op en klik in de assistent op Instelling nu controleren.3
Webhook-geheim vastleggen
Open in Shopify Instellingen → Meldingen → Webhooks. Helemaal onderaan staat de handtekeningsleutel waarmee Shopify webhooks ondertekent. Kopieer die en vul hem in de assistent in. Zonder dit geheim weigert Highcovery elke webhook, omdat de echtheid ervan niet te controleren is.
4
Webhooks aanmaken
De assistent toont vier URL’s. Maak in Shopify onder Instellingen → Meldingen → Webhooks voor elke URL een webhook aan:
Kies als formaat JSON en als webhook-API-versie de nieuwste stabiele versie die Shopify aanbiedt. Highcovery leest alleen de standaardvelden van de bestelling, die in alle huidige versies zitten.Of een webhook werkt, ziet het dashboard pas zodra de eerste gebeurtenis binnenkomt. Tot dan staat er Nog geen gebeurtenis. Je kunt dat meteen uitlokken, want Shopify biedt bij elke webhook een testmelding aan.
5
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.
6
Instelling controleren
Open een deeplink uit de Highcovery app en plaats daarmee een testbestelling. Die verschijnt op je affiliate-pagina onder Recente activiteit.
De dagelijkse scriptcontrole
Highcovery vraagt eenmaal per dag de startpagina van je shop op en zoekt daar de signaturen van de twee scripts. In de script-tag staat bovendien een vingerafdruk in het attribuutdata-hc-tracking. Daaraan ziet het dashboard welke versie van het script bij jou draait.
Een geslaagde controle geldt 14 dagen als bewijs. Daarna telt alleen nog het resultaat van de laatste controle. Met Instelling nu controleren start je meteen een controle in plaats van op de volgende dagelijkse ronde te wachten.
Ontbreekt het script, is het verouderd of is je shop niet op te vragen, dan sturen we je daarover hooguit eens per week een mail. Ons team krijgt dezelfde melding. Zodra de controle weer slaagt, stopt de herinnering vanzelf.
Zo werkt de tracking
- Een gebruiker klikt in de Highcovery app op je product en komt met de URL-parameters
hc_cid(klik-ID) enhc_pid(partner-ID) in je shop terecht. - Het kernscript schrijft de klik-ID als winkelwagenattribuut in de winkelwagen. Zo belandt die in de bestelling.
- Het cookiescript slaat beide waarden daarnaast 30 dagen op als cookie, zodat de toewijzing ook bij een later bezoek zonder klik-ID werkt. Het respecteert de Shopify Customer Privacy API: zonder marketingtoestemming wordt er geen cookie geplaatst.
- 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.
- Annuleringen en terugbetalingen worden eveneens gemeld en corrigeren de commissie.
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 eerst de stap Trackingscripts toevoegen in de assistent en daarna de statusbanners op je affiliate-pagina. Die noemen de reden, bijvoorbeeld een ontbrekend script of een shop die we niet konden bereiken.