Comment connecter le postback de la source de trafic Keitaro à Adgora

Conditions préalables avant de commencer

Avant d'essayer de connecter la source de trafic Keitaro au postback d'Adgora, assurez-vous que les deux comptes sont actifs et que vous pouvez modifier la source de trafic dans Keitaro. Cela peut sembler simple, mais c'est là que de nombreuses configurations échouent : un utilisateur a un accès administrateur dans Adgora, mais seulement un accès en lecture dans Keitaro, donc le champ de postback reste verrouillé. Vous avez besoin du compte Adgora exact dans lequel vous souhaitez envoyer des événements, et vous avez besoin de l'entrée de source de trafic dans Keitaro qui reçoit réellement les clics.

Vérifiez d'abord trois choses. Premièrement, la source de trafic Keitaro doit déjà exister. Deuxièmement, vous devez savoir quelle offre ou campagne générera l'événement de conversion. Troisièmement, vous avez besoin des identifiants que Adgora attend dans ses paramètres de compte. Si l'un de ces éléments est manquant, arrêtez-vous là et corrigez l'accès avant de coller une seule URL.

En pratique, la configuration la plus propre consiste à ouvrir les deux outils dans des onglets séparés et à comparer le nom de la source, le champ de postback et le champ d'identifiant de clic côte à côte. Une petite faute de frappe, un gros problème. Une source de trafic appelée “Meta US” dans Keitaro et “meta_us” dans Adgora peut encore fonctionner, mais seulement si les paramètres réels correspondent, pas l'étiquette que vous utilisez pour votre propre commodité.

Si vous souhaitez un aperçu plus large des termes de reporting avant de transmettre la demande, le glossaire de la publicité programmatique peut vous aider avec les mots de base qui apparaissent constamment dans les écrans de suivi. Il vaut également la peine de consulter le reste des guides sur la publicité crypto, la monétisation & Ad-Tech si vous construisez une pile de suivi plus complète, car la configuration de postback ne vit que rarement seule.

Trouvez le point de terminaison de postback Adgora et les paramètres requis

La première étape technique consiste à copier le point de terminaison de postback Adgora depuis la zone de compte Adgora où les conversions sont configurées. Ne devinez pas l'URL. Ne réutilisez pas un postback d'un autre compte. Un seul caractère dans le chemin du point de terminaison peut transformer une conversion valide en un échec silencieux, et les échecs silencieux sont les pires car ils ressemblent à « pas de trafic » au lieu de « mauvaise configuration ».

Adgora s'attend généralement à un point de terminaison de base plus plusieurs paramètres qui identifient l'événement. Dans une configuration de postback de source de trafic, ces paramètres incluent souvent un ID de clic, un identifiant de source et une référence de conversion. Keitaro doit envoyer tout ce qu'Adgora utilise pour relier l'événement à la bonne ligne de source. Si la ligne de source est incorrecte, la conversion atterrit au mauvais endroit ou pas du tout.

Copiez le point de terminaison exactement comme indiqué dans Adgora, puis notez quels macros Adgora liste pour la demande. Certaines équipes conservent une note textuelle avec le point de terminaison, la méthode HTTP, les noms de paramètres requis et toutes valeurs optionnelles comme le paiement ou le statut. Cette note fait gagner du temps plus tard, surtout lorsqu'une seconde source de trafic nécessite le même modèle.

Si votre compte Adgora est utilisé pour des campagnes crypto, la logique de configuration est la même, que vous gériez un réseau publicitaire crypto pour les éditeurs ou autre chose. Le postback a toujours besoin des bons identifiants. Rien de magique ne se produit parce que la campagne est liée à la crypto.

Construisez l'URL de postback dans Keitaro

Ouvrez les paramètres de la source de trafic dans Keitaro et trouvez le champ de postback ou de rappel de conversion pour cette source. Collez le point de terminaison Adgora là, pas dans la boîte de postback de la campagne. Cette distinction est importante. Le postback au niveau de la source envoie des données de la configuration de la source de trafic elle-même, ce dont Adgora a besoin pour le reporting basé sur la source ; le suivi au niveau de la campagne est une couche différente et peut créer de la confusion si vous les mélangez.

Maintenant, associez les tokens de Keitaro aux paramètres d'Adgora. Par exemple, si Adgora s'attend à un ID de clic, Keitaro doit passer le token qui contient cette valeur de clic. Si Adgora s'attend à un nom de source ou à un ID de source, Keitaro doit envoyer le token lié à l'enregistrement de la source de trafic, pas le nom de la campagne. Gardez l'association littérale. Gardez-le ennuyeux.

Une habitude prudente fait gagner des heures : écrivez l'URL terminée dans un éditeur de texte simple avant de l'enregistrer dans Keitaro. Ensuite, comparez chaque paramètre un par un. Un ampersand manquant, un espace copié ou un token enveloppé dans les mauvaises accolades peuvent casser la requête. C'est particulièrement ennuyeux lorsque l'URL semble correcte au premier coup d'œil.

Certaines équipes testent d'abord cela avec une source à faible enjeu, comme une petite campagne test, avant de passer à des achats plus importants. C'est sensé. Si vous travaillez également avec des verticales de niche, telles que les campagnes d'installation d'applications mobiles ou les offres de forex et de trading, la même logique de postback s'applique toujours, même si la page de l'offre a l'air complètement différente.

Associez correctement les ID de clic et les identifiants de source

C'est la partie où les intégrations échouent généralement. Keitaro peut recevoir de nombreux ID, mais Adgora ne reconnaît l'événement que si l'identifiant de clic ou de source exact revient dans le format attendu. Si l'ID est manquant, tronqué ou envoyé sous un mauvais nom de paramètre, Adgora ne peut pas lier la conversion au clic original.

Utilisez un seul modèle de nom dès le départ. Si votre source est “fb_us_01” dans Keitaro, gardez la même logique dans les notes d'Adgora, votre feuille de suivi et toute documentation interne. Un nom non assorti ne casse pas toujours la demande, mais cela complique le dépannage humain. Trois étiquettes différentes pour une seule source peuvent faire perdre un après-midi.

Lorsque la liste des paramètres d'Adgora inclut un champ ID de clic, associez-le au jeton Keitaro qui stocke l'identifiant de clic de l'enregistrement de clic source. Lorsqu'elle inclut un identifiant de source de trafic, passez le jeton de source, pas le jeton de campagne. L'identifiant de source et l'identifiant de clic ne sont pas la même chose, et les confondre peut faire apparaître une conversion comme valide tout en pointant vers la mauvaise source.

Pour les équipes comparant des flux basés sur le CPA, la même discipline compte également à travers les modèles de tarification. Si vous êtes encore en train de trier la logique des rapports, l'article sur CPC vs CPM vs CPA est un compagnon utile, car le postback ne vous dit que ce qui s'est passé ; il n'explique pas pourquoi vous avez choisi ce modèle en premier lieu.

Envoyez une conversion de test et confirmez la demande

Exécutez une conversion de test après que l'URL soit enregistrée. Une. Pas cinq. Déclenchez l'événement de manière contrôlée, puis vérifiez les deux systèmes. Dans Keitaro, ouvrez le journal des sources ou des campagnes et recherchez la demande sortante, le code HTTP et l'URL finale qui a été envoyée. Dans Adgora, recherchez l'enregistrement d'événement correspondant et l'horodatage. Ces deux horodatages devraient être proches, même s'ils ne sont pas identiques à la seconde.

Si Keitaro montre une réponse 200 mais qu'Adgora ne montre rien, la demande a atteint quelque chose, juste pas le gestionnaire d'événements prévu. Si Keitaro montre un code 4xx, l'endpoint, la méthode ou les noms de paramètres sont probablement incorrects. Si la demande n'apparaît jamais dans le journal, le placement du token dans Keitaro est probablement incorrect, ou le postback source n'a jamais été enregistré.

Utilisez un seul clic de test avec une note unique dans votre carnet de notes. Par exemple, "test manuel le mardi, 14h20." Cela vous donne une ligne propre à rechercher plus tard. Un test désordonné avec plusieurs clics et sans notes semble chargé, mais il est difficile à déboguer.

La phrase comment connecter le postback de la source de trafic Keitaro à Adgora ne devient claire que lorsque vous pouvez faire correspondre un clic source, une demande sortante et un événement à l'intérieur d'Adgora. Si les trois s'alignent, la configuration est réelle. S'il en manque un, ne passez pas encore à autre chose.

Corrigez les erreurs de source-postback les plus courantes

Le placement incorrect des macros est l'erreur la plus courante. Un jeton destiné aux données de campagne est collé dans un champ source, ou un jeton d'ID de clic est placé là où un ID source devrait aller. La requête se déclenche toujours, c'est pourquoi l'erreur est facile à manquer. L'URL existe, la conversion ne l'est pas.

L'encodage d'URL cause le prochain niveau de problèmes. Si un paramètre contient des caractères spéciaux et que la valeur n'est pas encodée comme Adgora l'attend, la requête peut arriver avec des parties cassées. Cela se manifeste le plus souvent dans les noms de source, les notes personnalisées ou les valeurs de redirection. Un signe plus peut devenir un espace. Un slash peut diviser le champ. De petits caractères, une grande douleur.

Des paramètres incorrects causent également des échecs. Si Adgora s'attend à GET et que Keitaro envoie POST, ou vice versa, le point de terminaison peut rejeter la requête ou l'ignorer. Vérifiez la méthode dans les deux outils avant de changer quoi que ce soit d'autre. Changer trois champs à la fois rend impossible de savoir lequel a corrigé le problème.

Des paramètres dupliqués créent un autre désordre silencieux. Deux valeurs dans le même champ peuvent amener un système à lire la première et un autre système à lire la dernière. Gardez un paramètre par objectif. Si vous devez tester une valeur de secours, faites-le dans une version séparée, pas dans l'URL en direct.

Parfois, le problème n'est pas du tout l'URL. La source de trafic dans Keitaro peut être nommée d'une certaine manière, tandis que l'entrée source dans Adgora s'attend à un autre compte ou à un autre ID de réseau. Ce décalage peut faire en sorte que chaque requête semble « valide » mais atterrisse au mauvais endroit. Vérifiez la connexion du compte avant de retravailler le postback lui-même.

Allez en direct et surveillez les premiers événements réels

Après que le test soit réussi, passez du trafic de test au trafic réel sans changer le reste de l'entonnoir. Cela signifie que vous laissez l'offre, la page d'atterrissage et la logique de routage intactes pendant que le postback source continue de se déclencher. Une modification à la fois est la règle ici. Si vous modifiez l'entonnoir et le postback en même temps, vous ne saurez pas quelle partie a causé une baisse dans le reporting.

Surveillez de près les premiers événements réels. Les 10 premières conversions sont les plus informatives, car elles montrent si le postback source continue de se déclencher sous un trafic normal au lieu d'un clic manuel. Vérifiez les enregistrements d'événements dans Adgora par rapport aux journaux sources dans Keitaro. Vous recherchez la cohérence, pas seulement une ligne réussie.

Gardez un œil sur le nom de la source, les valeurs des paramètres et le timing. Si un ensemble d'annonces génère des conversions mais qu'un autre n'en génère pas, le problème peut se situer dans la configuration de la source plutôt que dans le postback lui-même. Un transfert en direct propre signifie que la même URL, les mêmes tokens et le même modèle d'identifiant continuent de fonctionner à mesure que le volume de trafic change.

Si votre mix de campagne inclut d'autres verticales, l'habitude de reporting reste la même. Que vous envoyiez des conversions pour des offres de rencontre, que vous construisiez de la publicité crypto, ou que vous compariez une nouvelle source à un ancien trafic, gardez les premiers événements en direct sous surveillance jusqu'à ce que les journaux et les enregistrements soient d'accord. Ensuite, continuez à surveiller le postback source, car le premier échec silencieux apparaît souvent après le premier jour propre, et non pendant.