Vue d’ensemble
Pour le tracking d’affiliation, tu enregistres l’adresse de ta boutique, tu copies les scripts de tracking dans ton thème et tu crées quatre webhooks dans ton admin Shopify. Il n’existe pas d’application pour cela. La configuration se fait entièrement via ton thème et ton admin Shopify, et un assistant dans le dashboard te guide à travers les quatre étapes.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.
- Une boutique accessible publiquement. Tant que la protection par mot de passe est active, Highcovery ne peut pas vérifier les scripts et le tracking reste inactif.
Configuration
Dans le dashboard, va dans Affiliation → Intégration et sélectionne ta boutique en ligne en haut à droite. Le récapitulatif indique pour chaque étape si elle est terminée. Commencer la configuration ou Poursuivre la configuration ouvre l’assistant, qui passe directement à la première étape ouverte. Les boutons dans l’assistant t’amènent à l’endroit correspondant dans ton admin Shopify.1
Enregistrer l'adresse de la boutique
Saisis ton adresse Shopify sous la forme
maboutique.myshopify.com. C’est à partir d’elle que le dashboard construit les liens vers ton admin, et que la vérification quotidienne sait quelle boutique appeler.2
Insérer les scripts de tracking
L’assistant affiche deux extraits. Le script principal est obligatoire : il transmet l’ID de clic au panier et constitue la base pour que les commandes te soient attribuées. Le script de cookies est optionnel mais recommandé : il retient l’ID de clic pour les visites suivantes.Copie les deux extraits via Copier le script, ouvre dans Shopify Boutique en ligne → Thèmes → … → Modifier le code et colle-les dans
layout/theme.liquid juste avant </body>. Les extraits contiennent déjà les balises <script>. Enregistre le thème et clique dans l’assistant sur Vérifier la configuration maintenant.3
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 et saisis-la dans l’assistant. Sans ce secret, Highcovery rejette chaque webhook, car son authenticité ne peut pas être vérifiée.
4
Créer les webhooks
L’assistant affiche quatre URLs. Dans Shopify, sous Paramètres → Notifications → Webhooks, crée un webhook pour chaque URL :
Choisis JSON comme format et, comme version de l’API du webhook, la version stable la plus récente proposée par Shopify. Highcovery ne lit que les champs standard de la commande, présents dans toutes les versions actuelles.Le dashboard ne peut constater qu’un webhook fonctionne qu’à partir du premier événement reçu. Jusque-là, il affiche Aucun événement pour le moment. Tu peux le déclencher tout de suite, car Shopify propose une notification de test pour chaque webhook.
5
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.
6
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.
La vérification quotidienne des scripts
Une fois par jour, Highcovery appelle la page d’accueil de ta boutique et y cherche les signatures des deux scripts. La balise de script contient en plus une empreinte dans l’attributdata-hc-tracking. Elle indique au dashboard quelle version du script tourne chez toi.
Une vérification réussie vaut comme preuve pendant 14 jours. Au-delà, seul le résultat de la dernière vérification compte. Avec Vérifier la configuration maintenant, tu déclenches une vérification immédiate au lieu d’attendre le passage quotidien suivant.
Si le script manque, s’il est obsolète ou si ta boutique ne peut pas être appelée, nous t’envoyons un e-mail à ce sujet au maximum une fois par semaine. Notre équipe reçoit la même information. Dès que la vérification passe à nouveau, le rappel s’arrête de lui-même.
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 principal inscrit l’ID de clic comme attribut du panier. C’est ainsi qu’il arrive dans la commande.
- Le script de cookies enregistre en plus les deux valeurs comme cookie pendant 30 jours, afin que l’attribution fonctionne aussi lors d’une visite ultérieure sans ID de clic. Il respecte la Shopify Customer Privacy API : sans consentement marketing, aucun cookie n’est déposé.
- 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 d’abord l’étape Insérer les scripts de tracking dans l’assistant, puis les bannières de statut sur ta page d’affiliation. Elles indiquent la raison, par exemple un script manquant ou une boutique que nous n’avons pas pu atteindre.