> ## Documentation Index
> Fetch the complete documentation index at: https://docs.highcovery.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer Shopify

> Configurer manuellement le tracking d'affiliation dans ta boutique Shopify

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

<Note>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](/fr/affiliate/tracking).</Note>

### Prérequis

* Un **contrat d'affiliation** actif avec un ID de partenaire, voir [Accord de partenariat](/fr/affiliate/contract). 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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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>`.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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**) :

    | Événement Shopify      | URL Highcovery              |
    | ---------------------- | --------------------------- |
    | Création de commande   | Webhook Commande créée      |
    | Paiement de commande   | Webhook Commande payée      |
    | Annulation de commande | Webhook Commande annulée    |
    | Remboursement créé     | Webhook Commande remboursée |

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

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>
</Steps>

## Comment fonctionne le tracking

1. 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) et `hc_pid` (ID de partenaire).
2. 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é.
3. Le **Script principal** inscrit l'ID de clic comme attribut du panier. C'est ainsi qu'il arrive dans la commande.
4. 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.
5. Les **annulations et remboursements** sont également signalés et corrigent la commission.

<Warning>Si tu changes de thème, tu dois réinsérer les deux scripts dans le nouveau thème. Les webhooks, eux, sont conservés.</Warning>

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

<Tip>En cas de problème, contacte [support@highcovery.com](mailto:support@highcovery.com) avec le domaine de ta boutique et le moment approximatif de la commande.</Tip>