Ce document explique comment comptabiliser les impressions et les clics en utilisant les API d’Epsilon Retail Media. Il présente les étapes d’intégration et une validation améliorée de l’identifiant de l’annonce.
Pour comptabiliser efficacement les impressions et les clics, utilisez /resource/ un point de terminaison. Les impressions doivent être dirigées vers la first-i ressource, tandis que les clics sont comptabilisés à la second-c .
Condition préalable
Obtenez votre URL de base auprès de votre responsable de compte technique avant de comptabiliser les impressions et les clics.
Intégrer les appels des points de terminaison
Les appels des points de terminaison doivent être exécutés dans votre application ou sur votre site Web. Dans Epsilon Retail Media, le processus d’intégration est similaire pour les applications mobiles et les sites Web grâce à son approche d’intégration « backend to backend ». Cette approche permet de s’assurer que les requêtes d’annonces sont cohérentes sur les plateformes mobiles et de bureau. Toutefois, dans la mesure où les applications mobiles ne prennent pas en charge les bibliothèques JS, vous devez effectuer des requêtes back-end vers nos points de terminaison chargés des clics et des impressions.
Comptabiliser les impressions
Pour comptabiliser une impression, vous devez envoyer une requête GET au format suivant :
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_ID
Remplacer AD_ID avec le adId fourni pour l’annonce que vous comptabilisez.
Par exemple, la requête GET suivante comptabilise une impression pour adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
Comptabiliser les clics
Pour comptabiliser un clic, envoyez une requête GET au format suivant :
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_ID
Remplacer AD_ID avec le adId fourni pour l’annonce que vous comptabilisez.
Par exemple, la requête GET suivante comptabilise une impression pour adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
Validation par API pour les identifiants d’annonces réalisés
L’API comprend la validation des identifiants des annonces afin de garantir l’exactitude des données et réduire les erreurs. Les requêtes dont les identifiants ne sont pas correctement encodés ou qui ne contiennent pas le bon préfixe renvoient une erreur 400 et un message d’erreur détaillé.
Principaux avantages
- Résolution plus rapide : les détaillants trouvent des solutions plus rapidement grâce aux retours rapides.
- Meilleure précision : les rapports et les données gagnent en précision car il y a moins d’erreurs.
Exemple de message d’erreur
« Identifiant de l’annonce non valide. Doit être correctement encodé et contenir le préfixe « display », « banner » ou « shotgun_ ». "