Dépannage du tracking

RefCampaign suit les visites via un SDK navigateur installé sur votre site. Cette page couvre l'installation, la vérification et les points à contrôler quand le tracking ne marche pas. Vous la trouverez dans Réglages → Configuration SDK.

Installer et vérifier

1. 1

   Installer le SDK

   Choisissez votre plateforme (Next.js App Router, Next.js Pages Router, script no-code, ou JavaScript custom) et ajoutez le snippet à votre site.

2. 2

   Connecter votre gestionnaire de consentement

   Gardez le SDK passif chargé sur chaque page, puis reliez votre CMP à setConsent. Elle doit transmettre l'accord initial, le refus initial, le choix conservé après rechargement et tout retrait ultérieur.

3. 3

   Confirmer les quatre scénarios de consentement

   Testez chaque scénario sur votre site marchand, puis cochez-le dans la configuration RefCampaign authentifiée. Le refus ne doit créer aucune session d'attribution ; le retrait doit supprimer la session existante. La confirmation des quatre scénarios établit la capacité de consentement de confiance.

4. 4

   Lancer le diagnostic du site

   Utilisez Vérifier la configuration du site après la checklist de consentement. La détection publique du script et le signal d'installation sont des diagnostics indicatifs ; ils n'établissent pas seuls la disponibilité de confiance.

Les liens de recommandation lisibles et directs sont activés uniquement après la checklist de consentement authentifiée et la synchronisation de l'alias. Dans l'intervalle, RefCampaign conserve le lien de redirection opaque comme solution de repli sûre.

Quand le tracking ne marche pas

Lancez Vérifier la configuration du site pour analyser la page. Constats fréquents :

• SDK absent du HTML public — le snippet n'est pas déployé sur la page testée. Vérifiez qu'il est bien en production.
• La CSP bloque le SDK — votre Content Security Policy refuse le script. Ajoutez la source RefCampaign à votre directive script-src.
• La CSP bloque la capture — le SDK se charge mais ne peut pas envoyer de données. Ajoutez la source à votre directive connect-src.

Attribuer les conversions

Le suivi consenti des visites crée la session d'attribution, mais il ne suffit pas à relier un achat ou une inscription au bon affilié. La deuxième étape, Attribuer les conversions, est obligatoire. Choisissez une seule méthode :

• Avec Stripe — transmettez la session RefCampaign dans les metadata Stripe. Connectez d'abord Stripe (voir connecter Stripe), puis choisissez le flux de paiement utilisé par votre backend.
• Depuis votre backend — envoyez chaque conversion avec RefCampaignServer pour une stack JavaScript ou TypeScript, ou utilisez le postback serveur à serveur dans un autre runtime.

Confirmez l'intégration après sa mise en place. La première conversion réelle confirme ensuite le suivi de bout en bout.