Présentation des Postbacks
Les postbacks permettent aux affiliés de recevoir des notifications en temps réel serveur à serveur lorsqu’un événement de conversion spécifique se produit, comme des inscriptions ou des achats.
En intégrant les postbacks à votre système de suivi, vous pouvez recevoir automatiquement les données de conversion et les associer au clic d’origine. Cela garantit une attribution précise et un reporting cohérent à la fois dans votre système et dans le nôtre.
Lorsqu’un utilisateur clique sur votre lien d’affilié, nous enregistrons les paramètres que vous transmettez (comme click_id). Vous pouvez consulter la liste complète des macros de paramètres supportées dans le tableau ici : [Lien].
Lorsqu’une conversion a lieu, nous envoyons une requête serveur à serveur à votre URL de postback configurée, ce qui permet à votre système d’associer la conversion au clic d’origine.
Types de Postbacks
Nous supportons actuellement deux types de postbacks :
Postbacks Dynamiques (Recommandés)
- Supporte les paramètres dynamiques dans l’URL de postback
- Compatible avec les principales plateformes de suivi (par exemple, Voluum)
- Permet des points de terminaison URL séparés par type de conversion (inscriptions et achats)
- Offre une plus grande flexibilité et un reporting détaillé
Postbacks Statiques (Héritage)
- Ne supporte pas les paramètres dynamiques dans l’URL de postback
- Retourne un ensemble limité de points de données prédéfinis
Les deux options sont pleinement supportées. Il n’y a pas de projet de suppression des Postbacks Statiques.
Comment Configurer les Postbacks Dynamiques
- Accédez à :
https://chaturbate.com/affiliates/devkit/dynamic_postback/ - Sélectionnez « Ajouter une nouvelle URL » sous l’onglet Postbacks Dynamiques.
- Saisissez votre URL de postback et ajoutez les macros supportées pour recevoir des données spécifiques. Par exemple :
https://example.com/postback?click_id={click_id}&payout={payout}&country={country} - Sélectionnez le type de transaction (Inscription ou Achat) si vous souhaitez différencier les événements.
- (Optionnel) Si votre plateforme de suivi supporte la validation par checksum, saisissez un Sel de Validation pour vérifier l’authenticité du postback.
- Choisissez votre méthode de livraison : GET (la plus courante) ou POST.
Fonctionnement des Postbacks Dynamiques
- Un utilisateur clique sur votre lien affilié.
-
Nous enregistrons votre
click_idainsi que tout paramètre URL supplémentaire que vous transmettez. - Lorsque l’utilisateur complète une inscription, nous envoyons un postback serveur à serveur à votre URL spécifiée, incluant les macros que vous avez définies.
- Si l’utilisateur effectue un achat ultérieur, nous envoyons un postback d’achat en utilisant les mêmes paramètres enregistrés lors de l’inscription, garantissant une attribution précise.
Liste et Définitions des Macros
Ces macros peuvent être utilisées dans les Postbacks Dynamiques du Programme d’Affiliation.
Certaines macros sont générées par le système au moment de la conversion (comme {payout} ou {currency}), tandis que d’autres sont des paramètres transmis fournis par l’affilié qui proviennent de votre lien d’affilié (comme {click_id} ou {track_id}).
Paramètres de Postback Dynamiques
| Catégorie | Macro | Description | Mode de remplissage |
| Conversion | {click_id} |
Identifiant unique pour chaque clic publicitaire utilisé pour suivre l’interaction utilisateur spécifique ayant conduit à une conversion. Limite de caractères : 1024 |
Paramètre transmis par l’affilié |
| Conversion | {source} |
Source de trafic spécifiée dans le lien affilié Limite de caractères : 255 |
Paramètre transmis par l’affilié |
| Suivi | {track} |
Utilisé pour segmenter le trafic par quelques sources de trafic de votre côté, par exemple "websiteA", "websiteB" Limite de caractères : 255 |
Paramètre transmis par l’affilié |
| Identification de la Transaction | {transaction_id} | Identifiant unique de l’événement de conversion (inscription, achat) | Généré par le système |
| Identification de la Campagne | {campaign_id} | Identifiant unique de la campagne | Généré par le système |
| Identification de l’Offre | {program_id} | Identifiant unique du programme/offre | Généré par le système |
| Identification de l’Offre | {program_name} | Nom du programme/offre (par exemple, 1,00 $ par inscription + 50,00 $ par diffuseur + 5 % de revenus affiliés référés, etc.) | Généré par le système |
| Identification de l’Utilisateur | {user_id} | Identifiant unique de l’utilisateur référé | Généré par le système |
| Conversion | {type} |
Le type de conversion qui a eu lieu. Valeurs possibles : tokens_signup-referral, tokens_broadcaster-referral, ppr_signup-referral, ppr_broadcaster-referral, revshare_signup-referral, revshare_broadcaster-referral, revshare_purchase, revshare_webmaster-commission, et revshare_payout-adjustment |
Généré par le système |
| Conversion | {payout} | Montant crédité à l’affilié pour cette conversion (négatif en cas de rétrofacturation) | Généré par le système |
| Conversion | {currency} | La devise dans laquelle le paiement est effectué | Généré par le système |
| Conversion | {amount} | Le montant dépensé par l’utilisateur | Généré par le système |
| Conversion | {token} | Nombre de tokens crédités à l’affilié pour cette conversion | Généré par le système |
| Action Utilisateur | {timestamp} | Horodatage du moment où la conversion a été effectuée | Généré par le système |
| Action Utilisateur | {date} | Date à laquelle la conversion a été effectuée | Généré par le système |
| Action Utilisateur | {time} | Heure à laquelle la conversion a été effectuée | Généré par le système |
| Géolocalisation | {country} | Pays de l’utilisateur | Généré par le système |
| Appareil et Navigateur | {device} | Appareil utilisé par l’utilisateur (mobile, bureau) | Généré par le système |
| Appareil et Navigateur | {language} | Paramètre de langue du navigateur de l’utilisateur | Généré par le système |
| Référence | {referral} | URL du référent | Généré par le système |
| Tentatives | {attempt} | Nombre de tentatives d’envoi d’une requête avant de recevoir une réponse correcte (jusqu’à 6 tentatives) | Généré par le système |
| Géolocalisation | {region} | Région ou état de l’utilisateur | Généré par le système |