Macros Advertising DSP
Une macro est une commande courte ou un raccourci pour une instruction et suit généralement le format ${MACRO_NAME}
. Les macros incluses dans le code créatif ou les URL de clic publicitaire se développent en une chaîne de code plus longue que le serveur de publicités peut comprendre. Le serveur de publicités DSP exécute des macros lorsque la publicité est diffusée ou que l’utilisateur clique dessus.
Les macros de serveur de publicités sont utiles pour transmettre des informations importantes à DSP ou à des serveurs de publicités tiers. Les macros sont le plus souvent utilisées lors du trafic de code créatif ou de métadonnées tiers et personnalisés (comme les pixels tiers).
Vous pouvez insérer manuellement une macro n’importe où, par exemple dans une balise VAST, dans n’importe quelle URL ou dans un pixel d’événement DSP ou tiers. Cependant, chaque client et partenaire DSP possède un format de balise publicitaire différent et les macros doivent être insérées à différents endroits dans la balise en conséquence. Chaque fois que vous travaillez avec un nouveau client ou partenaire, demandez-lui de la documentation sur l’emplacement où insérer les macros dans ses balises publicitaires qui font l’objet du trafic DSP.
Macros de tracking générales
Utilisez les macros de suivi générales sur tous les types d’annonces et de balises pour transmettre des données spécifiques, selon les besoins.
${TM_ACCOUNT_ID}
${TM_AD_ID}
${TM_AD_ID_NUM}
${TM_ADVERTISER_ID}
${TM_CAMPAIGN_ID}
${TM_CAMPAIGN_ID_NUM}
${TM_CLICK_URL}
${TM_CLICK_URL_URLENC}
${TM_FEED_ID}
${TM_FEED_ID_NUM}
${TM_MACRO_PLACEMENT_SITE_KEY
${TM_PLACEMENT_ID}
${TM_PLACEMENT_ID_NUM}
${TM_RANDOM}
${TM_SESSION_ID}
${TM_SITE_DOMAIN_URLENC}
${TM_SITE_NAME}
${TM_SITE_URL_URLENC}
${TM_SITE_ID_NUM}
${TM_TIMESTAMP}
${TM_VIDEO_DURATION}
Macros Spécifiques À Mobile
${CS_PLATFORM_ID}
(ComScore) Identifiant de la plateforme, qui correspond au système d’exploitation de l’appareil :
ios
= Apple iOSandroid
= Google Androidwindows
= Windows Mobileblackberry
= Blackberryother
lorsque la plateforme ne correspond à aucune des conditions ci-dessus
${CS_DEVICE_MODEL}
${CS_IMPLEMENTATION_TYPE}
(ComScore) Environnement dans lequel la publicité a été diffusée :
a
= application mobileb
= site web mobile
a
ou b
)${NS_PLATFORM_ID}
(Nielsen) Identifiant de la plateforme, qui correspond au système d’exploitation de l’appareil :
ios
= Apple iOSandroid
= Google Androidwindows
= Windows Mobileblackberry
= Blackberryother
lorsque la plateforme ne correspond à aucune des conditions ci-dessus
${NS_DEVICE_GROUPING}
(Nielsen) Type d’appareil sur lequel la publicité a été visionnée :
TAB
= compriméPHN
= mobilecomputer
= ordinateur
${UOO}
(Nielsen) Que l’utilisateur se soit opposé ou non au suivi des publicités :
1
(indicateur DNT = 1) = l’utilisateur s’est opposé au suivi des publicités0
(indicateur DNT = 0) = l’utilisateur a choisi d’effectuer le suivi des publicités
0
ou 1
)${TM_BUNDLE}
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}
gdpr=${GDPR_ENFORCED}
indique si le soumissionnaire détermine que la demande d’offre provient de l’Union européenne et nécessite l’application du RGPD :
1
= Le RGPD doit être appliqué.0
= Le RGPD ne doit pas être appliqué
gdpr_consent=${GDPR_CONSENT}
est la valeur de consentement transmise par le partenaire d’approvisionnement dans la demande d’offre entrante :
- Dans la plupart des cas, il s’agit d’une chaîne de consentement codée en base64url, ou daisybit (exemple : BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA)
0
= aucun consentement1
= consentement
Clic sur les macros pour les publicités display tierces
Pour effectuer le suivi précis des clics sur les publicités à l’aide de balises d’affichage tierces, DSP requiert une macro de clic d’affichage. Une seule version de la macro est requise ; la macro appropriée dépend du type de balise.
${TM_CLICK_URL}
${TM_CLICK_URL_URLENC}
DSP insère automatiquement des macros de clics d’affichage dans une balise d’affichage tierce lorsque vous :
- Exporter les balises d’annonce publicitaire d’un de partenaire de serveur d’annonces
- Chargement en masse de Flashtalking ou Google DoubleClick for Advertisers ajout de balises directement dans DSP
Si une macro de clic est manquante lorsque vous créez une publicité display, DSP affiche un message d'avertissement qui vous invite à insérer manuellement la macro de clic display appropriée dans la zone appropriée de la balise.
Macros Analytics for Advertising
Pour obtenir des macros supplémentaires disponibles spécifiquement pour les clients Analytics for Advertising, reportez-vous aux sections Append Analytics for Advertising Macros to Flashtalking Ad Tags et Append Analytics for Advertising Macros to Google Campaign Manager 360 Ad Tags.
Résolution des erreurs de macro
Lorsque vous ajoutez des macros à votre code, veillez à utiliser la syntaxe exacte de la macro. Lors de la validation des macros, DSP vérifie que la macro correspond exactement à l’une des macros valides.
Des erreurs sont générées si des caractères manquent au début ou à la fin du nom de la macro. Par exemple, un message d’erreur s’affiche si :
- Vous oubliez un ou plusieurs caractères au début du nom de la macro, tels que
${
. Si vous n’incluez pas la syntaxe complète, l’entrée n’est pas reconnue comme une macro valide. - La macro ne se termine pas par un jeu de caractères valide, tel que
}
.