Guide de suivi pour annonceurs

Configuration du postback annonceur pour les campagnes CPA et CPI

Utilisez les postbacks CPAlead pour renvoyer les installations, les prospects ou les actions approuvés à CPAlead après que votre outil de suivi ait reçu une conversion. L'élément clé consiste à enregistrer l'ID de clic CPAlead depuis l'URL de suivi et à renvoyer exactement la même valeur en tant que click_id.

Démarrer l'inscription annonceur Voir les tarifs

Format de l'URL de postback

Votre compte possède un ID de postback unique. Utilisez-le avec l'ID de clic CPAlead que votre système de suivi a enregistré depuis le clic initial.

Exemple

https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&click_id={CLICK_ID}&campaign_id={CAMPAIGN_ID}

Plusieurs événements rémunérés

Conservez le click_id d’origine. Pour chaque événement accompli, envoyez son event_id numérique ou son event_name exact enregistré. Ajoutez campaign_id pour plus de protection. Chaque récompense utilise le paiement enregistré dans la campagne.

Envoyez le numéro de l’événement ou son nom exact enregistré dans la campagne. Si votre outil envoie un autre nom ou code, enregistrez-le comme valeur de suivi supplémentaire.

Set a separate payment for each event. Each event can be paid once per participant. Include the install as an event if you want to pay for it.
Participants have 30 days from their click to complete events. Keep enough balance for later events, including while the campaign is paused. Event details and payments cannot change after the first click.
The daily limit counts each participant at their first paid event. Later events do not count again. Reaching the limit stops new traffic. Earlier clicks can still earn rewards within 30 days, so pending completions may exceed the limit.
Multiple events use standard server postbacks, or AppsFlyer for CPI campaigns. Tracking pixels are not supported.
Multiple-event campaigns can run on Offerwall V2, the offers API, and direct links. Classic offerwalls and lockers are not supported yet.
Les événements peuvent arriver dans tout ordre. Renvoyer les mêmes click_id et event_id retourne postback_duplicate sans nouveau débit. Si la réponse indique low_balance, ajoutez des fonds puis réessayez le même événement après le délai Retry-After.
Une retenue pouvant aller jusqu’à $3.00 peut s’appliquer si votre postback contient un identifiant de clic manquant ou invalide, des informations de campagne incohérentes, ou un identifiant d’événement manquant ou invalide sur un clic vérifié de campagne par événement. Utilisez l’identifiant du clic CPAlead d’origine et, pour les campagnes par événement, l’identifiant d’événement enregistré pour résoudre le problème.

Exemple de postback événement

Exemple : pour l’événement 1 nommé 150gems, envoyez event_id=1 ou event_name=150gems. event_id=150gems fonctionne aussi. Gardez le même click_id d’origine pour chaque récompense.

https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&campaign_id=YOUR_CAMPAIGN_ID&click_id=REAL_CLICK_ID&event_id=SAVED_EVENT_ID

Remplacez SAVED_EVENT_ID par le numéro de l’événement. Pour envoyer un nom, utilisez event_name avec le nom exact ou la valeur de suivi enregistrée.

AppsFlyer event rewards

For AppsFlyer CPI events, map each saved numeric event ID as the AppsFlyer partner event identifier. The optional appsflyer_event_name must match the SDK name exactly, including capital letters. Different rewards may use the same SDK name when the partner event identifiers distinguish them. Name-only callbacks require a unique saved name. To pay for installs, set one reward name mapping to install and use an explicit event_type=install callback; a blank event name does not mean install.

Enable CPAlead-attributed in-app event postbacks in the AppsFlyer integration and review the dedicated callback templates in Postback Setup. Do not add the standard /aff_lsr advertiser URL to AppsFlyer. In-app callbacks send event_type=in_app, partner_event_id, event_name, app_id, and the original clickid. Review any custom sender IP whitelist. Ask CPAlead support to check whether AppsFlyer has enabled optional retries for 5xx responses; it can retry four times at 15-minute intervals after the first attempt. Tracking cost macros stay zero for event campaigns; event reports show actual credited reward spend. Saving a CPAlead campaign does not change the AppsFlyer account.

Étapes de configuration

Le flux fonctionne lorsque l'ID de clic CPAlead est conservé.

CPAlead crédite les diffuseurs en faisant correspondre le postback de conversion au clic qui a envoyé l'utilisateur vers votre campagne.

Ajoutez le suivi CPAlead à l'URL de votre campagne

Placez la macro de l'ID de clic CPAlead dans votre outil de suivi afin que chaque visiteur puisse être associé plus tard.

Stockez l'ID de clic CPAlead

Enregistrez notre ID de clic dans votre plateforme de suivi lorsque l'utilisateur arrive sur votre offre ou sur votre parcours de redirection.

Renvoyez la conversion

Lorsque l'installation, le prospect ou l'action est approuvé, appelez l'URL de postback CPAlead avec le même click_id.

Incluez campaign_id quand c'est possible

L'ID de campagne est recommandé car il aide CPAlead à faire correspondre les rapports et à résoudre les problèmes plus rapidement.

Valeurs requises

Paramètres dont CPAlead a besoin sur votre postback de conversion.

id Obligatoire

Votre ID de postback annonceur CPAlead. Vous pouvez le trouver dans le tableau de bord annonceur après avoir créé un compte.

click_id Obligatoire

L'ID de clic CPAlead exact que vous avez reçu lorsque l'utilisateur a cliqué sur l'URL de suivi de votre campagne.

campaign_id Recommandé

L'ID de campagne CPAlead. Incluez-le quand c'est possible pour améliorer la correspondance et l'examen du support.

event_id / event_name Requis pour les événements

Installations CPI AppsFlyer

Les propriétaires d'applications mobiles et les agences peuvent utiliser l'attribution AppsFlyer.

CPAlead prend en charge la configuration AppsFlyer pour les campagnes CPI lorsque vous possédez l'application ou que vous avez accès au compte d'attribution de l'application. Utilisez le lien de suivi complet AppsFlyer et conservez l'ID de clic de CPAlead dans le paramètre clickid.

Exemple de lien AppsFlyer

https://app.appsflyer.com/[YOUR_APP_ID]?pid=cpalead_int&af_click_lookback=5d&clickid={CLICK_ID}&af_siteid={PUBLISHER_ID}&af_cost_value={PAYOUT}&af_cost_currency=USD&af_cost_model=CPI

Utilisez un lien de suivi complet https://app.appsflyer.com/[APP_ID].
Conservez pid=cpalead_int pour une configuration AppsFlyer CPAlead normale.
Utilisez clickid={CLICK_ID} afin qu'AppsFlyer enregistre l'ID de clic CPAlead.
Incluez af_siteid={PUBLISHER_ID} et les paramètres de coût exigés par le formulaire de campagne.
N'utilisez pas af_prt pour une configuration CPAlead normale.

Exemples d'URL

Stockez notre ID de clic, puis renvoyez-le lors du moment de la conversion.

Exemple d'URL de suivi

https://your-tracker.example/click?cpalead_click_id={CLICK_ID}&campaign_id={CAMPAIGN_ID}

Remplacez les macros fictives par les valeurs que votre outil de suivi utilise pour enregistrer l'ID de clic CPAlead et l'ID de campagne.

Exemple d'URL de postback CPAlead

https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&click_id={CLICK_ID}&campaign_id={CAMPAIGN_ID}

Envoyez cette URL uniquement lorsque votre outil de suivi confirme une vraie conversion.

Erreurs courantes de configuration

Évitez les problèmes qui font échouer les postbacks annonceur.

Envoyer l'ID de clic de votre propre outil de suivi au lieu de l'ID de clic CPAlead.
Laisser une macro factice dans l'URL finale de postback.
Envoyer des conversions sans campaign_id lorsque votre outil de suivi peut le fournir.
Tester avec de faux ID de clic au lieu d'utiliser le test guidé dans le tableau de bord annonceur.

Obtenez de l'aide de votre assistant IA

Copiez ce prompt lorsque vous voulez une aide de configuration spécifique à votre outil de suivi.

Collez cela dans ChatGPT, Claude, Gemini ou un autre assistant IA. Il demande le système de suivi, le reseau, l'URL de suivi et les détails AppsFlyer avant de suggérer les étapes de configuration.

Vous m'aidez à configurer le suivi annonceur pour une campagne CPAlead.

Faits de suivi CPAlead :
- CPAlead a besoin que le postback annonceur inclue id, click_id et campaign_id lorsqu'ils sont disponibles.
- id est mon ID de postback annonceur CPAlead.
- click_id doit être l'ID de clic CPAlead exact qui a été enregistré depuis l'URL de suivi initiale.
- campaign_id est l'ID de campagne CPAlead et doit être inclus lorsque mon outil de suivi ou mon reseau peut l'envoyer.
- Exemple standard de postback CPAlead :
  https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&click_id={CLICK_ID}&campaign_id={CAMPAIGN_ID}
- N'inventez pas un paramètre de clic enregistré. Si vous ne pouvez pas déterminer où l'ID de clic de CPAlead est stocké, demandez-moi l'URL de suivi exacte ou dites-moi de confirmer la macro avec mon outil de suivi ou mon reseau.

Faits de configuration AppsFlyer CPI :
- CPAlead prend en charge la configuration AppsFlyer pour les campagnes mobiles CPI.
- Le lien de suivi doit utiliser l'URL complète https://app.appsflyer.com/[APP_ID].
- La configuration AppsFlyer CPAlead normale doit conserver pid=cpalead_int.
- L'ID de clic de CPAlead doit généralement être enregistré en tant que clickid={CLICK_ID}.
- Le lien doit inclure af_siteid={PUBLISHER_ID}.
- Le formulaire de campagne peut exiger des paramètres de coût tels que af_cost_value, af_cost_currency et af_cost_model.
- N'utilisez pas af_prt pour une configuration CPAlead normale.

Veuillez me poser ces questions avant de donner les instructions finales de configuration :
1. Utilise-je AppsFlyer, Voluum, Everflow, HasOffers/TUNE, CAKE, un outil de suivi personnalisé, un partenaire de mesure mobile ou un reseau d'affiliation ?
2. Ma campagne CPAlead est-elle CPA, installation CPI ou événement CPI dans l'application ?
3. Quelle est l'URL de suivi exacte que je prévois de soumettre à CPAlead ?
4. Quel paramètre dans cette URL de suivi stocke {CLICK_ID} de CPAlead ?
5. Quelle macro mon outil de suivi ou mon reseau utilise-t-il pour renvoyer l'ID de clic CPAlead enregistré dans un postback ?
6. Ai-je mon ID de postback annonceur CPAlead et mon ID de campagne CPAlead ?

Après ma réponse, donnez-moi :
- L'URL de suivi corrigée que je dois soumettre à CPAlead.
- L'URL de postback que je dois ajouter à mon outil de suivi, mon reseau ou ma configuration AppsFlyer.
- Toutes les macros manquantes ou les paramètres à risk.
- Une courte liste de vérification que je peux confirmer avant de lancer le trafic.

Multiple rewarded event campaigns:
- First confirm whether I selected one conversion or multiple rewarded events. CPA and CPI support both; CPC does not support events.
- For multiple events using a standard tracker, use server postbacks with id, the original real click_id, and either its numeric event_id or its exact saved event_name. Text values in event_id also match saved names or postback_event_value. Send numeric external codes through event_name. All supplied identifiers must identify the same reward. Include campaign_id for extra protection; CPAlead includes it in generated campaign postback URLs and checks it when supplied. Never invent event IDs or click IDs, and never send a payout to override the agreed reward.
- Each event pays once within 30 days of the original click, in any order. Include the install in the event list only when I want to pay for it. Repeating the same click_id and event_id safely returns postback_duplicate without another payment.
- Keep enough funds for pending events, including after pausing traffic. For low_balance, add funds and retry the same event after Retry-After. The daily cap counts each participant at their first paid event and stops new traffic; pending clicks remain eligible within the completion window.
- The optional postback_event_value field adds an exact tracker name or code. Check event_rules for availability. It can be corrected after traffic with an audit trail; reward IDs, names and prices stay locked.
- Mode and event definitions cannot change after traffic starts. Copy the campaign to change them. Multiple events support standard postbacks or AppsFlyer for CPI; tracking pixels, classic offerwalls and lockers are unsupported. Tracking method and AppsFlyer mapping also freeze after real traffic.
- Offerwall V2 shows event offers only with a stable explicit publisher subid. Use the same user ID on every visit; an advertising ID alone is not enough for V2. Returning participants use the original click and 30-day deadline; another visit does not restart rewards. For direct links, a first-party browser cookie supports returning visitors without an explicit ID, but it cannot preserve identity after cookies are cleared or the browser or tracking domain changes. Recommend stable publisher user IDs in subid.
- AppsFlyer single-goal CPI uses CPAlead Integrated Partners. Do not suggest adding the standard /aff_lsr URL to AppsFlyer. For one in-app event, its AppsFlyer name must match the single campaign conversion goal.
- Explain that temporary AI campaign drafts cannot configure or test tracking. Use the signed-in Guided Test with real campaign and event IDs.
- For AppsFlyer CPI events, map each saved numeric event ID as the AppsFlyer partner event identifier. The optional appsflyer_event_name must match the SDK name exactly, including capital letters. Different rewards may use the same SDK name when the partner event identifiers distinguish them. Name-only callbacks require a unique saved name. To pay for installs, set one reward name mapping to install and use an explicit event_type=install callback; a blank event name does not mean install.
- Enable CPAlead-attributed in-app event postbacks in the AppsFlyer integration and review the dedicated callback templates in Postback Setup. Do not add the standard /aff_lsr advertiser URL to AppsFlyer. In-app callbacks send event_type=in_app, partner_event_id, event_name, app_id, and the original clickid. Review any custom sender IP whitelist. Ask CPAlead support to check whether AppsFlyer has enabled optional retries for 5xx responses; it can retry four times at 15-minute intervals after the first attempt. Tracking cost macros stay zero for event campaigns; event reports show actual credited reward spend. Saving a CPAlead campaign does not change the AppsFlyer account.

Prêt à connecter le suivi annonceur ?

Créez un compte annonceur, ajoutez votre campagne et utilisez le suivi par postback avant de passer à grande échelle sur le trafic.

Démarrer l'inscription annonceur Tarifs annonceur