Catégorie: Tutorials

Le Guide Complet du Débutant sur le Suivi Postback pour les Annonceurs CPAlead

Auteur: CPAlead
Le Guide Complet du Débutant sur le Suivi Postback pour les Annonceurs CPAlead

Le nombre 1234567890 ci-dessous sert uniquement d'illustration. Les vrais click IDs de CPAlead contiennent des chiffres ; renvoyez toujours la valeur exacte insérée par CPAlead dans votre URL de suivi. N'envoyez jamais ce nombre d'exemple pour un test réel.

Ajouter une offre CPI ou CPA à CPAlead est facile une fois que vous comprenez comment fonctionne le suivi postback. Nous écrivons ceci comme un guide de suivi pour Guide de l'annonceur CPAlead : Configurer votre première campagne . Apprenons le suivi postback de la manière la plus simple possible ! Imaginez que vous tenez un stand de limonade (votre offre), et que CPAlead est votre voisin sympathique qui aide à vous envoyer des clients. Voici comment cela fonctionne :

  1. Lorsque CPAlead envoie un client (trafic) à votre stand de limonade, ils donnent au client un billet numéroté spécial (par exemple, billet #1234567890)
  2. Le client prend ce billet numéroté à votre stand (tout comme un utilisateur suivant votre URL de suivi avec le paramètre click_id)
  3. Lorsque le client achète de la limonade (convertit), le gardien de votre stand (votre réseau) prend le billet et lit le numéro
  4. Votre gardien de stand envoie alors un message à CPAlead disant "Le billet #1234567890 a effectué un achat !" (c'est ce qui se passe lorsque l'URL de postback est déclenchée)
  5. CPAlead associe ce numéro de billet à ses dossiers et sait exactement quel client a effectué l'achat

De cette façon, CPAlead sait exactement quels clients ont acheté de la limonade et peut récompenser le voisin qui les a envoyés ! Nous allons vous montrer exactement comment configurer cela avec des exemples réels.

Qu'est-ce qu'un Click ID ?

Un click ID est comme un autocollant spécial que nous mettons sur chaque clic. Lorsque quelqu'un clique sur votre offre :

  • CPAlead génère un identifiant unique au format suivant : 1234567890. Nous utiliserons cela comme exemple.
  • Cet identifiant suit l'utilisateur, similaire à un badge nominatif.
  • Lorsque l'utilisateur installe votre application ou complète une action, votre réseau renvoie cet identifiant à CPAlead en l'insérant dans l'URL de postback CPAlead comme le click ID (par exemple, 1234567890) et en déclenchant programmatique l'URL de postback CPAlead qui ressemblera à ceci :
    https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&click_id=1234567890.
  • Lorsque CPAlead reçoit un postback contenant l'identifiant (par exemple, 1234567890), il reconnaît qu'un lead a été généré à partir du clic correspondant. En utilisant cet identifiant, CPAlead récupère tous les détails pertinents, tels que votre ID annonceur, ID de campagne et le sub-ID de l'utilisateur qui a cliqué. CPAlead traite ensuite la récompense en conséquence.

Notes importantes :

  • Remarquez comment {CLICK_ID} dans l'URL de suivi est remplacé par le véritable click ID (1234567890)
  • Le même click ID apparaît à la fois dans l'URL de suivi et l'URL de postback, créant une correspondance parfaite
  • Le click ID reste inchangé tout au long du processus - c'est crucial pour un suivi correct
  • Votre réseau gère automatiquement le remplacement du paramètre avec la valeur réelle du click ID

Comment trouver le paramètre Click ID de votre réseau

Vous ne savez pas quel paramètre utilise votre réseau ? Voici ce qu'il faut faire :

  1. Ouvrez le centre d'assistance ou la documentation de votre réseau
  2. Recherchez "paramètre click ID" ou "paramètre de suivi"
  3. Ou demandez simplement à votre responsable de réseau : "Quel paramètre utilisez-vous pour stocker les click IDs ?"

Configurations d'exemple simplifiées

Exemple 1 : Votre réseau vous dit d'utiliser le paramètre 'aff_sub'

URL de suivi que vous fournissez à CPAlead dans le processus de configuration de la campagne :

http://yournetwork.com/click?offer=123&aff_sub={CLICK_ID}

URL de postback de CPAlead que vous fournissez à votre réseau :

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

Exemple 2 : Votre réseau vous dit d'utiliser le paramètre 'sid'

URL de suivi que vous fournissez à CPAlead dans le processus de configuration de la campagne :

http://network.example.com/track?campaign=456&sid={CLICK_ID}

URL de postback de CPAlead que vous fournissez à votre réseau :

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

Exemple 3 : Votre réseau vous dit d'utiliser le paramètre 'click'

URL de suivi que vous fournissez à CPAlead dans le processus de configuration de la campagne :

http://tracker.net/path?offer=789&click={CLICK_ID}

URL de postback de CPAlead que vous fournissez à votre réseau :

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

Exemple 4 : Votre réseau vous dit d'utiliser le paramètre 'sub1'

URL de suivi que vous fournissez à CPAlead dans le processus de configuration de la campagne :

http://track.domain.com/click?id=101112&sub1={CLICK_ID}

URL de postback de CPAlead que vous fournissez à votre réseau :

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

Exemple 5 : Votre réseau vous dit d'utiliser le paramètre 'clickid'

URL de suivi que vous fournissez à CPAlead dans le processus de configuration de la campagne :

http://affnetwork.com/track?offer=131415&clickid={CLICK_ID}

URL de postback de CPAlead que vous fournissez à votre réseau :

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

Exemples de Click ID dans le monde réel

Voyons à quoi ressemblerait notre exemple de click ID (1234567890) dans des URL de suivi et de postback réelles :

Exemples d'URL Avant et Après

Modèle d'URL de suivi original :

http://yournetwork.com/click?offer=123&aff_sub={CLICK_ID}

URL réelle avec le Click ID inséré :

http://yournetwork.com/click?offer=123&aff_sub=1234567890

Modèle d'URL de postback original :

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

URL de postback réelle lorsque la conversion se produit :

https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&click_id=1234567890

Postbacks pour plusieurs récompenses par événement

Une campagne CPA ou CPI peut payer plusieurs événements pour un même clic initial. Le système de suivi doit indiquer à CPAlead quel événement enregistré a été terminé.

Pour les postbacks standard, envoyez votre propre identifiant de postback, le click_id d’origine enregistré et une valeur qui identifie la récompense accomplie. Ajoutez campaign_id pour plus de protection ; il doit correspondre à la campagne du clic d’origine. Utilisez l’URL générée pour votre compte et n’inventez jamais d’identifiants.

https://net.go2trck.org/aff_lsr?id=YOUR_POSTBACK_ID&campaign_id=YOUR_CAMPAIGN_ID&click_id=REAL_CLICK_ID&event_id=1
  • Événement 1 : Une installation rapporte $0.50. Envoyez event_id=1 uniquement si 1 est l'identifiant enregistré pour cette récompense d'installation.
  • Événement 2 : Atteindre le niveau 5 rapporte $1.25. Envoyez le même click_id initial avec event_id=2 si 2 est l'identifiant enregistré pour cette récompense.
  • Renvoyer l'événement 1 ne le paie pas deux fois. Un autre événement admissible sur le même clic peut toujours être payé. Chaque événement accepté possède son propre lead_id.

Une valeur d’événement absente ou incorrecte renvoie HTTP 400 sans payer la récompense. Corrigez la correspondance, puis renvoyez le même clic réel avec le numéro, le nom ou la valeur de suivi correspondant et pris en charge par votre configuration. Ne devinez pas un événement d’installation et ne remplacez pas le clic. Les retenues existantes doivent toujours être examinées sur la page des retenues de postback.

Postbacks standard : numéros et noms d’événements

Ouvrez la configuration des postbacks de votre campagne enregistrée et utilisez l’une des URL affichées. Continuez à utiliser le numéro de l’événement tant qu’une URL utilisant son nom n’est pas disponible.

Exemple uniquement : si la récompense enregistrée porte le numéro 1 et le nom 150gems, ces trois valeurs désignent la même récompense :

  • event_id=1
  • event_name=150gems
  • event_id=150gems

Le nom enregistré fonctionne déjà avec les postbacks utilisant un nom. Si votre outil de suivi envoie un autre nom ou code, saisissez-le comme valeur de suivi supplémentaire facultative de la récompense. Pour un code numérique comme 42, utilisez event_name=42 ; les valeurs numériques de event_id désignent toujours le numéro d’événement CPAlead.

Copiez le nom exactement, en respectant les majuscules. Toutes les valeurs d’événement d’un même postback doivent désigner la même récompense. Une valeur inconnue, contradictoire ou ambiguë ne déclenche aucun paiement.

Conservez le même click_id d’origine pour chaque événement. Envoyer un nom puis réessayer avec son numéro ne paie pas la récompense deux fois. Supprimer campaign_id ne corrige pas une erreur de correspondance d’événement.

Vous pouvez corriger une valeur de suivi supplémentaire après le début du trafic. Les numéros, noms, ordre, instructions et paiements des événements enregistrés restent verrouillés.

Encodez les espaces et la ponctuation dans l’URL, par exemple event_name=Reach%20level%205. L’URL générée à partir du nom le fait pour vous.

Signalez chaque événement dans les 30 jours suivant le clic initial. En cas de HTTP 503 low_balance, ajoutez des fonds et renvoyez l'événement identique après le délai Retry-After, tant que la période reste ouverte. La récompense doit être intégralement financée.

Pour le CPI avec AppsFlyer, utilisez la configuration Integrated Partner de CPAlead et associez les identifiants numériques enregistrés aux partner event identifiers. Une installation exige une récompense d'installation explicite. Ne collez pas l'URL standard /aff_lsr dans AppsFlyer.

Consultez les instructions de postback des événements pour la configuration et les réponses.

Tester avant d'envoyer du trafic

  • Ouvrez la page Postback après connexion et utilisez Guided Test pour la campagne.
  • Ouvrez le lien de suivi temporaire et suivez les instructions. Pour une campagne à événements, envoyez l'identifiant enregistré de l'action testée.
  • Vérifiez le résultat et les journaux de postback. Un test guidé réussi enregistre la réception sans créer de conversion payante.
  • Si le test échoue, corrigez le paramètre de stockage du clic ou le mapping d'événement et réessayez pendant la période de test. N'inventez jamais de click ID.

Utilisez le même paramètre pour stocker et renvoyer le click ID de CPAlead, et conservez les exemples fonctionnels pour vos futures campagnes.

Besoin d'aide ?

  • Demandez à votre outil de suivi quel paramètre stocke sûrement le click ID de CPAlead et quel champ de callback peut renvoyer l'identifiant d'événement enregistré.
  • Vous pouvez demander à une IA d'expliquer la documentation de suivi. Retirez les identifiants privés de postback, les jetons et les données de vrais visiteurs avant de partager des exemples.
  • Contactez l'assistance CPAlead si un vrai clic ou événement reste introuvable après vérification de la configuration.

Vous avez remarqué une erreur ou un aspect de cet article qui nécessite une correction ? Merci de fournir le lien de l'article et contactez-nous. Nous apprécions vos commentaires et nous occuperons du problème rapidement.