Skip to main content

​
Overview

For affiliate tracking you store your shop address, copy the tracking scripts into your theme and create four webhooks in your Shopify admin. There is no app for this. The setup runs entirely through your theme and your Shopify admin, and a wizard in the dashboard guides you through the four steps.
This guide only sets up the technical side in your shop. Whether clicks and orders are actually recorded also depends on your affiliate agreement, see Affiliate tracking.

​
Requirements

  • An active affiliate agreement with a partner ID, see Partner agreement. The webhook URLs are shown only once your partner ID has been assigned.
  • Access to your shop’s theme code (Online Store → Themes → Edit code).
  • Admin access to Settings → Notifications in Shopify to create webhooks.
  • A publicly reachable shop. While password protection is active, Highcovery cannot verify the scripts and tracking stays inactive.

​
Setup

In the dashboard go to Affiliate → Integration and select your online shop at the top right. The summary shows for each step whether it is done. Start setup or Continue setup opens the wizard, which jumps straight to the first open step. The buttons inside the wizard take you to the matching page in your Shopify admin.
1

Store the shop address

Enter your Shopify address in the form myshop.myshopify.com. The dashboard builds the links into your admin area from it, and the daily check knows which shop to request.
2

Add the tracking scripts

The wizard shows two snippets. The core script is mandatory: it passes the click ID to the cart and is the basis for orders being attributed to you. The cookie script is optional but recommended: it remembers the click ID for later visits.Copy both snippets via Copy script, open Online Store → Themes → … → Edit code in Shopify and paste them into layout/theme.liquid directly before </body>. The snippets already include the <script> tags. Save the theme and click Check setup now in the wizard.
3

Store the webhook secret

In Shopify open Settings → Notifications → Webhooks. At the bottom you find the signing key Shopify uses to sign webhooks. Copy it and enter it in the wizard. Without this secret Highcovery rejects every webhook, because its authenticity cannot be verified.
4

Create the webhooks

The wizard shows four URLs. In Shopify, under Settings → Notifications → Webhooks, create one webhook per URL:Choose JSON as the format and the latest stable webhook API version Shopify offers. Highcovery only reads the standard order fields, which are included in all current versions.The dashboard can only tell that a webhook works once the first event arrives. Until then it shows No event yet. You can trigger that right away, as Shopify offers a test notification for every webhook.
5

Add coupon codes (optional)

Under Coupon codes you can enter codes separated by commas. If a customer uses one of these codes, the order is attributed to you even when no click ID is available.
6

Check the setup

Open a deeplink from the Highcovery app and place a test order with it. It appears on your affiliate page under Recent activity.

​
The daily script check

Once a day Highcovery requests the home page of your shop and looks for the signatures of the two scripts. The script tag also carries a fingerprint in the attribute data-hc-tracking. From it the dashboard sees which version of the script is running in your shop. A successful check counts as proof for 14 days. After that only the result of the latest check applies. With Check setup now you trigger a check immediately instead of waiting for the next daily run.
Without a proven script your tracking is inactive. Your deeplinks then no longer lead into your shop and clicks are not counted.
If the script is missing, outdated or your shop cannot be requested, we send you an email about it at most once a week. Our team receives the same notice. As soon as the check passes again, the reminder stops on its own.

​
How tracking works

  1. A user clicks your product in the Highcovery app and lands in your shop with the URL parameters hc_cid (click ID) and hc_pid (partner ID).
  2. The core script writes the click ID into the cart as a cart attribute. That is how it ends up on the order.
  3. The cookie script additionally stores both values as cookies for 30 days, so attribution still works on a later visit without a click ID. It respects the Shopify Customer Privacy API: without marketing consent no cookie is set.
  4. The webhooks report every order to Highcovery. Highcovery reads the click ID from the order and creates the conversion. If it is missing, the coupon code fallback applies.
  5. Cancellations and refunds are reported as well and adjust the commission.
If you switch your theme, you must add both scripts to the new theme again. The webhooks remain in place.

​
Troubleshooting

  • No conversions despite orders: check that both scripts are in the active theme and that the four webhooks in Shopify point to the correct URLs.
  • Webhooks are rejected: the webhook secret in the dashboard must match the signing key from Shopify exactly. Save it again.
  • Orders with a coupon are not attributed: the code must be entered under Coupon codes exactly as it is named in Shopify.
  • Tracking status inactive: first check the step Add the tracking scripts in the wizard, then the status banners on your affiliate page. They name the reason, for example a missing script or a shop we could not reach.
If you run into problems, contact support@highcovery.com with your shop domain and the approximate time of the order.