Aller au contenu principal

Statuts d'attribution

Chaque clic sur un lien de parrainage (et chaque utilisation de code promo) crée un événement d'attribution — un enregistrement du type « ce visiteur pourrait convertir pour ce partenaire ». Le journal d'attribution affiche le statut de chaque événement et une explication complète de la raison pour laquelle il a fini dans cet état. Cette page est le glossaire de ces statuts.

Glossaire des statuts

StatutSignification
En attenteLe visiteur a cliqué (ou utilisé un code) mais n'a pas encore converti. L'événement reste en attente jusqu'à ce que la fenêtre d'attribution du programme expire
ConvertiLe visiteur a effectué un achat dans la fenêtre d'attribution. Une commission a été créée pour le partenaire
ExpiréLa fenêtre d'attribution est passée sans conversion. Aucune commission ne sera jamais créée à partir de cet événement
DoublonL'événement a été mis de côté — supplanté par un référencement plus récent pour le même visiteur, ou signalé par la détection de fraude (voir ci-dessous)

Converted, expired, et duplicate sont définitifs — un événement n'en sort jamais. Les paiements de renouvellement d'un abonnement rattachent des conversions supplémentaires au même événement converted sans changer son statut.

Comment un événement change de statut

  • En attente → Converti — une conversion (webhook Stripe ou appel à l'API de conversion) arrive et est attribuée à cet événement dans la fenêtre d'attribution du programme (1 à 365 jours, définie dans les Paramètres du programme).
  • En attente → Expiré — la fenêtre d'attribution s'écoule sans conversion. L'expiration est une opération de maintenance normale, pas une erreur.
  • En attente → Doublon — l'événement est supplanté ou signalé ; les raisons sont ci-dessous.

Pourquoi un événement devient Doublon

Le panneau de détail du journal affiche la raison précise de chaque doublon :

  • Supplanté par un référencement plus récent — le même visiteur a été réattribué avant de convertir. Le cas le plus courant : le visiteur est arrivé via le lien du partenaire A, puis a utilisé le code promo du partenaire B au paiement. Le code l'emporte (c'est le contact le plus récent et le plus explicite), l'événement basé sur le clic est marqué comme doublon, et le panneau de détail de l'événement gagnant affiche les deux côtés — quel partenaire a gagné et lequel a été supplanté, avec horodatages.
  • Auto-parrainage détecté — la détection de fraude a fait correspondre l'identité du client à celle du partenaire lui-même ; l'événement est mis de côté et aucune commission n'est créée.

Un cas voisin ne touche jamais aux statuts d'attribution : une conversion arrivant avec un external_transaction_id déjà traité est rejetée comme une conversion en double au niveau de la conversion. L'événement d'attribution conserve son statut ; le rejet est tout de même enregistré dans le journal avec sa propre explication.

Signaux de fraude dans le journal

Les événements touchés par la détection de fraude portent un indicateur distinct dans le journal, et le panneau de détail précise la règle qui s'est déclenchée (auto-parrainage, conversion en double) ainsi que l'action prise. Les partenaires ne voient qu'une note simplifiée (« Cette conversion a été signalée pour examen ») — le détail technique reste réservé au marchand.

Quand quelque chose semble anormal

Si une conversion que vous attendiez est manquante, ou si un événement a expiré alors que vous attendiez une conversion, consultez le Dépannage — il couvre le snippet, les identifiants de clic et l'API de conversion de bout en bout.