Vue d’ensemble
Pour le tracking d’affiliation, tu ajoutes deux petits scripts dans ton thème Shopify et tu enregistres quatre webhooks dans ton admin Shopify. Aucune application n’a besoin d’être installée.Ce guide ne configure que la partie technique dans ta boutique. Le fait que les clics et les commandes soient réellement enregistrés dépend en plus de ton contrat d’affiliation, voir Tracking d’affiliation.
Prérequis
- Un contrat d’affiliation actif avec un ID de partenaire, voir Accord de partenariat. Les URLs de webhook ne s’affichent qu’une fois ton ID de partenaire attribué.
- L’accès au code du thème de ta boutique (Boutique en ligne → Thèmes → Modifier le code).
- Un accès administrateur à Paramètres → Notifications dans Shopify, pour créer les webhooks.
Configuration
1
Ouvrir l'intégration
Dans le dashboard, va dans Affiliation → Intégration, sélectionne ta boutique en ligne en haut à droite et ouvre l’onglet Script manuel.
2
Insérer le script de cookies dans le head
Copie le Script de cookies via Copier le script. Dans Shopify, ouvre Boutique en ligne → Thèmes → … → Modifier le code et insère le script dans
layout/theme.liquid juste avant </head>. Le script contient déjà les balises <script>.3
Insérer le script principal avant la fin du body
Copie le Script principal et insère-le dans le même fichier juste avant
</body>. Enregistre le thème.4
Enregistrer le secret Webhook
Dans Shopify, ouvre Paramètres → Notifications → Webhooks. Tout en bas se trouve la clé de signature avec laquelle Shopify signe les webhooks. Copie-la, saisis-la dans le dashboard sous Secret Webhook Shopify et clique sur Enregistrer le secret.
5
Créer les webhooks dans Shopify
Dans le dashboard, tu trouves quatre URLs sous Webhooks Shopify. Dans Shopify, crée un webhook pour chaque URL sous Paramètres → Notifications → Webhooks (format JSON) :
Pour la version de l’API du webhook, choisis la version stable la plus récente proposée par Shopify (par exemple
2025-10 ou plus récente). Highcovery ne lit que les champs standard de la commande, présents dans toutes les versions actuelles.6
Enregistrer les codes promo (optionnel)
Sous Codes promo, tu peux saisir des codes, séparés par des virgules. Si un client utilise l’un de ces codes, la commande t’est attribuée même en l’absence d’ID de clic.
7
Vérifier la configuration
Ouvre un lien profond depuis l’app Highcovery et passe une commande test avec celui-ci. Elle apparaît sur ta page d’affiliation sous Activité récente.
Comment fonctionne le tracking
- Un utilisateur clique sur ton produit dans l’app Highcovery et arrive dans ta boutique avec les paramètres d’URL
hc_cid(ID de clic) ethc_pid(ID de partenaire). - Le Script de cookies enregistre les deux valeurs comme cookie pendant 30 jours. Il respecte la Shopify Customer Privacy API : sans consentement marketing, aucun cookie n’est déposé.
- Le Script principal inscrit l’ID de clic comme attribut du panier. C’est ainsi qu’il arrive dans la commande.
- Les webhooks signalent chaque commande à Highcovery. Highcovery lit l’ID de clic dans la commande et crée la conversion. S’il manque, le repli sur le code promo s’applique.
- Les annulations et remboursements sont également signalés et corrigent la commission.
Dépannage
- Aucune conversion malgré des commandes – vérifie que les deux scripts se trouvent dans le thème actif et que les quatre webhooks dans Shopify pointent vers les bonnes URLs.
- Les webhooks sont rejetés – le secret Webhook dans le dashboard doit correspondre exactement à la clé de signature de Shopify. Enregistre-le à nouveau.
- Les commandes avec code promo ne sont pas attribuées – le code doit être saisi sous Codes promo exactement comme il s’appelle dans Shopify.
- Statut du suivi inactif – vérifie les bannières de statut sur ta page d’affiliation. Elles indiquent la raison, par exemple une méthode de paiement manquante.