Postback pour les éditeurs : obtenez des informations sur le trafic vendu

Le suivi par postback permet à HilltopAds d’envoyer des notifications d’événements directement à votre système de suivi. Vous pouvez ainsi rapprocher les impressions, les clics et les conversions de vos propres données, et consulter les montants des revenus lorsque cette option est configurée.

Qu’est-ce qu’un postback pour les éditeurs et comment l’utiliser chez HilltopAds ?

Un postback est une requête de serveur à serveur que HilltopAds envoie à votre endpoint de suivi lorsqu’un événement répondant aux critères de notification se produit.

Selon votre configuration, un postback peut vous informer :

D’une impression comptabilisée pour le trafic popunder ou d’un clic comptabilisé sur une publicité display.
D’une conversion.
Du montant des revenus associés à un événement, si vous incluez la variable correspondante.

Lorsque vous recevez un postback pour une impression ou un clic, cela signifie que cet événement a été comptabilisé. Les données de revenus indiquent vos gains issus des impressions au CPM ou des conversions au CPA.

Remarque : Les postbacks ne signalent pas les impressions perdues ou filtrées. Les notifications que vous recevez dépendent des événements sélectionnés et du pourcentage de notification défini avec votre gestionnaire de compte.

Comment configurer le suivi par postback

Votre gestionnaire de compte HilltopAds se chargera de configurer l’intégration pour vous. Avant de commencer, préparez votre endpoint de postback et choisissez les événements que vous souhaitez suivre.

1. Envoyez votre URL de postback à votre gestionnaire de compte

Communiquez l’URL de l’endpoint sur lequel votre système de suivi reçoit les notifications d’événements. Par exemple :

https://website.com/postback?click_uuid={externalid}&payout={payout}&uid=uid

Dans cet exemple :

click_uuid est le paramètre utilisé par votre système de suivi pour recevoir l’identifiant.
{{clickId}} est remplacé par l’identifiant unique transmis via le lien de monétisation HilltopAds.
{{payout}} est remplacé par le montant des revenus associés à l’événement signalé.
uid correspond à l’identifiant de votre compte éditeur. Vous le trouverez dans votre tableau de bord.

Votre endpoint peut utiliser d’autres noms de paramètres. Envoyez à votre gestionnaire de compte l’URL exacte requise par votre système de suivi afin qu’il puisse vérifier la correspondance entre les paramètres et les valeurs.

Si votre endpoint nécessite des valeurs supplémentaires, comme un identifiant utilisateur, convenez de leur correspondance avec votre gestionnaire de compte avant la configuration.

2. Choisissez les événements à recevoir

HilltopAds propose les options de notification suivantes :

Impressions ou clics

Un postback est envoyé lorsqu’une impression popunder ou un clic sur une publicité display est comptabilisé.

Le postback confirme que l’événement a été comptabilisé.

Exemple :

https://website.com/postback?click_uuid={{clickId}}

Conversions uniquement

Un postback est envoyé lorsqu’une conversion se produit. Cette option est utile pour les éditeurs qui utilisent un lien direct.

Exemple :

https://website.com/postback?click_uuid={{clickId}}

Tous les événements générant des revenus

Les postbacks sont envoyés uniquement pour les événements qui génèrent des revenus pour vous.

Par exemple, si une impression dans une campagne au CPA ne génère aucun revenu, elle ne déclenchera pas de postback. Si une conversion génère ensuite des revenus, vous recevrez un postback pour cet événement.

Exemple :

https://website.com/postback?click_uuid={{clickId}}&payout={{payout}}

Remarque : Vous pouvez utiliser la variable {{payout}} avec n’importe quelle option de notification. L’option « Tous les événements générant des revenus » envoie uniquement des notifications pour les événements qui génèrent des revenus.

Tous les événements

Des postbacks sont envoyés pour les impressions ou les clics comptabilisés, ainsi que pour les conversions.

Si une impression ou un clic mène ensuite à une conversion, vous recevrez deux postbacks avec le même clickId : un pour l’impression ou le clic, et un pour la conversion.

Exemple :

https://website.com/postback?click_uuid={{clickId}}

Vérifiez que votre système de suivi peut traiter plusieurs notifications pour un même identifiant.

3. Définissez le pourcentage de notification

Convenez avec votre gestionnaire de compte du pourcentage d’événements admissibles à envoyer à votre endpoint.

L’envoi peut être configuré pour une proportion des événements, par exemple 10 % ou 100 %. La valeur par défaut est généralement de 10 % afin de limiter la charge du système.

La sélection des événements et le pourcentage de notification sont deux paramètres distincts. Choisir « Tous les événements » ne signifie pas que vous recevrez 100 % des notifications. Si l’échantillonnage est activé, votre système de suivi ne recevra que la proportion convenue.

Tenez compte de ce pourcentage lorsque vous comparez vos données de postback à vos statistiques HilltopAds.

4. Ajoutez des paramètres de suivi à votre lien de monétisation

Une fois le postback configuré, votre gestionnaire de compte vous fournira un lien de monétisation HilltopAds et vous expliquera quelles valeurs de suivi utiliser.

https://dengd.com/bC3aV/0.Pf3hp/vpb/m_VLJiZtD/0/3/N/T/QvwrNmTMQ/5kLbTvcJ1WNYDFAx1/NdT-Mf?clickId=PARAM_NAME&sId=PARAM_NAME

Les paramètres de suivi comprennent :

clickId : votre identifiant unique d’impression ou de clic, utilisé pour rapprocher les notifications de postback de vos données de suivi.
sId : l’identifiant de la zone publicitaire.

Remplacez les valeurs d’exemple ou les variables du lien de monétisation par les valeurs appropriées ou les macros dynamiques de votre système, en suivant les instructions de votre gestionnaire de compte.

Votre lien de monétisation et votre URL de postback remplissent des fonctions différentes :

Le lien de monétisation envoie du trafic vers HilltopAds.
L’URL de postback reçoit les notifications d’événements de HilltopAds.

Utilisez toujours le lien de monétisation fourni par votre gestionnaire de compte. N’utilisez pas votre endpoint de postback comme destination du trafic.

5. Vérifiez l’intégration

Testez la configuration avec votre gestionnaire de compte avant de l’appliquer à l’ensemble de votre trafic. Assurez-vous que :

Votre endpoint reçoit les notifications des événements sélectionnés.
Les identifiants reçus correspondent à vos données de suivi.
Les montants des revenus sont reçus lorsque cette option est configurée.
Votre système de suivi peut traiter plusieurs notifications pour un même clickId lorsque l’option « Tous les événements » est utilisée.
Le pourcentage de notification correspond aux paramètres convenus.

Si vous avez besoin d’aide pour configurer votre postback éditeur ou résoudre un problème, contactez votre gestionnaire de compte HilltopAds.

Monétise ton trafic