Ai-je besoin d'une clé API pour relier Keitaro ?

Non. Les liens de tracking et les postbacks se règlent dans votre portail affilié et ne demandent aucune clé. Une clé n'est nécessaire que si vous voulez lire vos rapports et vos commissions par API.

Quel token dois-je mettre dans sub1 pour Keitaro ?

{subid}. Keitaro le remplace par son click ID à chaque clic, et RevRake renvoie la valeur dans le postback sous la forme {sub1}.

Quels événements RevRake peut-il envoyer à Keitaro ?

Six : registration, ftd, commission_approved, commission_rejected, commission_paid et chargeback. Vous cochez ceux que vous voulez, destination par destination.

Le postback contient-il le montant du dépôt ?

Les modèles envoient votre commission dans {commission}. Le dépôt qui en est à l'origine est disponible dans {amount}, avec sa devise dans {amount_currency} : ajoutez-les au modèle si Keitaro a un paramètre pour eux.

Puis-je envoyer les conversions à Keitaro et à un autre tracker en même temps ?

Oui. Un compte peut avoir jusqu'à 10 destinations, chacune avec son propre modèle et ses propres événements.

Que se passe-t-il si Keitaro est indisponible au moment d'une conversion ?

Le postback est retenté six fois sur environ un jour et demi. Chaque tentative est conservée dans le journal des envois, et un envoi abandonné peut être relancé à la main.

Utiliser RevRake avec Keitaro : lien et postback

Ce qu'il vous faut de Keitaro

Deux choses : le token que Keitaro remplace par son click ID, à savoir {subid}, et votre adresse de postback avec les noms de ses paramètres. RevRake renseigne chaque paramètre avec une macro :

Paramètre de Keitaro	Renseigné par	Signification
`subid`	`{sub1}`	Le `sub1` du clic : le click ID que votre tracker a mis sur le lien.
`status`	`{status}`	Le mot qui dit où en est la conversion, dans les mots que Keitaro connaît. Ils figurent dans le tableau plus bas.
`payout`	`{commission}`	Votre commission sous forme décimale (`40.00`). Vide pour une inscription, `0` pour une commission rejetée, négative pour un chargeback.
`currency`	`{currency}`	Le code ISO de la devise de la commission.
`tid`	`{conversion_id}`	Un identifiant qui est le même pour tous les événements concernant une même commission : son premier dépôt, son approbation, son rejet, son paiement et son chargeback. Une inscription a le sien.

Keitaro affiche son adresse de postback sous Settings → Postback URL. Elle se compose de l'adresse du tracker, de votre clé de postback et des paramètres de conversion : dans le modèle, remplacez YOUR-TRACKER-DOMAIN et POSTBACK-KEY par les deux parties de votre propre adresse.

subid et status sont obligatoires dans Keitaro ; payout, currency et tid sont facultatifs. tid est l'identifiant de transaction de Keitaro : un postback dont Keitaro n'a jamais vu le tid est enregistré comme une conversion distincte, et un postback dont il connaît le tid modifie cette conversion. Le preset y met {conversion_id}.

Pas à pas dans RevRake

1Créez un lien de tracking

Ouvrez la page Liens de tracking de votre portail affilié et créez un lien par campagne. Chaque lien a sa propre adresse courte sur track.revrake.com et peut atterrir sur une page du site du programme que vous choisissez.

2Mettez le click ID de Keitaro dans sub1

Ajoutez au lien sub1= suivi du token de click ID de Keitaro, et utilisez le résultat comme URL de l'offre dans Keitaro :

https://track.revrake.com/c/a8Kq2Zx?sub1={subid}

Keitaro remplace {subid} par son click ID à chaque clic. RevRake enregistre la valeur avec le clic, jusqu'à 200 caractères, et vous la rend dans vos postbacks sous la forme {sub1}. sub2 à sub5 sont libres pour vos propres valeurs, et les tags UTM du lien sont enregistrés aussi.

3Ajoutez une destination de postback

Ouvrez la page Postbacks et cliquez sur « Ajouter une destination ». L'adresse est un modèle : tout ce qui est entre accolades est une macro que RevRake renseigne pour chaque conversion.

https://YOUR-TRACKER-DOMAIN/POSTBACK-KEY/postback?subid={sub1}&status={status}&payout={commission}&currency={currency}&tid={conversion_id}

RevRake fournit ce modèle comme preset Keitaro : choisissez Keitaro dans la liste et il est rempli pour vous.

Remplacez YOUR-TRACKER-DOMAIN par l'adresse de votre propre postback Keitaro, telle que Keitaro vous l'affiche. Le portail refuse un modèle qui contient encore l'hôte placeholder. Si un paramètre de votre adresse de postback porte un autre nom que dans le modèle, changez le nom et gardez la macro.

4Choisissez les événements

Cochez les événements dont cette destination doit être informée. registration et ftd signalent à Keitaro un nouveau joueur et son premier dépôt quelques secondes après que l'opérateur les a déclarés. commission_approved, commission_rejected, commission_paid et chargeback suivent l'argent par la suite.

RevRake a deux identifiants pour un postback. {conversion_id} est le même pour tous les événements concernant une même commission : un tracker qui met à jour une conversion d'après son identifiant garde donc une seule conversion par commission. {event_id} est différent pour chaque événement. Le preset Keitaro utilise celui qui convient à la façon dont Keitaro traite un identifiant répété ; les sections ci-dessous disent lequel. Un compte peut avoir jusqu'à 10 destinations.

5Envoyez un test et lisez le journal des envois

Cliquez sur « Envoyer un test » sur la destination. RevRake envoie immédiatement une conversion fictive et montre ce que Keitaro a répondu, et en combien de temps. Le test ressemble à un premier dépôt : il porte le click ID TEST-CLICK-ID et une commission de 40.00. Keitaro ne connaît pas ce clic : il peut donc ignorer le test ou répondre par une erreur. Ce que le test prouve, c'est que l'adresse est joignable, et il montre à quoi ressemble l'adresse une fois renseignée.

Pour une vérification de bout en bout, ouvrez le lien de votre campagne en passant par Keitaro, afin qu'un vrai click ID voyage dans sub1, et demandez à l'opérateur d'inscrire un joueur de test à partir de cette visite. La conversion apparaît alors dans le journal des envois, avec chaque tentative et la réponse de Keitaro, ainsi que dans Keitaro.

Correspondance de {status} avec Keitaro

RevRake nomme chaque événement et lui donne aussi un mot de statut. Une destination créée à partir du preset Keitaro envoie dans {status} les mots que Keitaro connaît ; {event} porte toujours le nom de l'événement. Une destination créée avec « Other / custom » envoie lead, sale, approved, rejected et paid.

Événement	`{status}`	Quand
`registration`	`lead`	Un joueur a été attribué à l'affilié.
`ftd`	`sale`	Un premier dépôt a rapporté une commission CPA à l'affilié.
`commission_approved`	`sale`	Une commission a été approuvée à la fin de sa période de rétention.
`commission_rejected`	`rejected`	Une commission en rétention a été rejetée après examen.
`commission_paid`	`sale`	Une commission a été payée dans un lot de paiement.
`chargeback`	`rejected`	Un chargeback a repris une commission.

Keitaro connaît lead, sale et rejected, et ignore un postback dont il ne connaît pas le statut. Le preset envoie donc sale aussi pour une commission approuvée et pour une commission payée. Ces postbacks portent le même tid que le premier dépôt : Keitaro garde donc une seule vente par commission et ne la compte pas une deuxième fois.

Un rejet et un chargeback arrivent sous la forme rejected avec le tid de la commission, et font passer cette vente à l'état rejeté. Les changements de statut que Keitaro autorise se règlent sous « Next statuses » de chaque type de conversion, dans Settings → Conversion Types. Une inscription est un lead avec un tid qui lui est propre.

Dépannage

Keitaro n'affiche aucune conversion. Ouvrez le journal des envois sur la page Postbacks. S'il n'y a aucune ligne, l'événement n'a pas encore eu lieu, ou il n'est pas coché pour cette destination. S'il y a une ligne, elle montre l'adresse qui a été appelée et ce que Keitaro a répondu.
Le click ID arrive vide. Le clic n'avait pas de sub1. Vérifiez que l'URL de l'offre dans Keitaro se termine par sub1= et {subid}, et que le clic est passé par Keitaro : un lien ouvert directement n'a aucun click ID à transporter.
Une macro arrive telle qu'elle est écrite, entre accolades. RevRake envoie tel quel un nom qu'il ne connaît pas, de sorte qu'une faute de frappe apparaît dans le journal des envois. Comparez le nom avec la liste des macros.
Le montant est vide ou nul. Une inscription ne porte pas d'argent : {commission} est donc vide pour elle. Il vaut 0 pour une commission rejetée et il est négatif pour un chargeback.
Un envoi a échoué. Keitaro doit être joignable sur une adresse publique et répondre par un statut 2xx en moins de 5 secondes. Un envoi échoué est retenté après 1 minute, 5 minutes, 25 minutes, 2 heures, 10 heures et 24 heures, puis marqué comme abandonné ; vous pouvez le relancer à la main.
La destination a été désactivée. Après 20 échecs d'affilée, RevRake désactive une destination, avec un e-mail après 5 et après 15. Corrigez l'adresse et réactivez-la : chaque postback mis en file d'attente entre-temps est envoyé.
Le journal de Keitaro indique « Conversion type not found ». Le mot de statut est un mot que Keitaro ne connaît pas. Cela arrive avec une destination créée avec « Other / custom », qui envoie approved et paid : choisissez pour elle le preset Keitaro.
Le même joueur est compté plusieurs fois dans Keitaro. Une destination enregistrée avec une version antérieure du preset a tid={event_id} dans son adresse, différent pour chaque événement. Modifiez la destination et écrivez tid={conversion_id}.

Keitaro est un produit de son propre éditeur (https://keitaro.io/) et n'est nommé ici que pour dire à quel tracker ce guide s'adresse. RevRake n'est pas affilié à cet éditeur.

Questions

Ai-je besoin d'une clé API pour relier Keitaro ?: Non. Les liens de tracking et les postbacks se règlent dans votre portail affilié et ne demandent aucune clé. Une clé n'est nécessaire que si vous voulez lire vos rapports et vos commissions par API.
Quel token dois-je mettre dans sub1 pour Keitaro ?: {subid}. Keitaro le remplace par son click ID à chaque clic, et RevRake renvoie la valeur dans le postback sous la forme {sub1}.
Quels événements RevRake peut-il envoyer à Keitaro ?: Six : registration, ftd, commission_approved, commission_rejected, commission_paid et chargeback. Vous cochez ceux que vous voulez, destination par destination.
Le postback contient-il le montant du dépôt ?: Les modèles envoient votre commission dans {commission}. Le dépôt qui en est à l'origine est disponible dans {amount}, avec sa devise dans {amount_currency} : ajoutez-les au modèle si Keitaro a un paramètre pour eux.
Puis-je envoyer les conversions à Keitaro et à un autre tracker en même temps ?: Oui. Un compte peut avoir jusqu'à 10 destinations, chacune avec son propre modèle et ses propres événements.
Que se passe-t-il si Keitaro est indisponible au moment d'une conversion ?: Le postback est retenté six fois sur environ un jour et demi. Chaque tentative est conservée dans le journal des envois, et un envoi abandonné peut être relancé à la main.

Sources

Ce que ce guide dit de Keitaro vient de la documentation de Keitaro, telle qu'elle se lisait le jour indiqué. Les trackers changent : si un nom sur votre page de postback diffère de ce guide, fiez-vous à votre page de postback. Ce qu'il dit de RevRake se trouve dans le guide d'intégration et la référence de l'API.

Postback | Keitaro https://docs.keitaro.io/en/conversions-and-postback/postback.html lu le 4 octobre 2026
Affiliate network postback | Keitaro https://docs.keitaro.io/en/conversions-and-postback/affiliate-network-postback.html lu le 4 octobre 2026
Conversion types | Keitaro https://docs.keitaro.io/en/settings/conversion-types.html lu le 4 octobre 2026
Placeholders | Keitaro https://docs.keitaro.io/en/landing-pages-and-offers/placeholders.html lu le 4 octobre 2026
Postback Troubleshooting | Keitaro https://docs.keitaro.io/en/conversions-and-postback/postback-troubleshooting.html lu le 4 octobre 2026

Comment utiliser RevRake avec Keitaro.