Macros Advertising DSP

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Publicité DSP

Créé pour :

Utilisateur ou utilisatrice

Une macro est une courte commande 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 d’annonces peut comprendre. Le serveur de publicités DSP exécute les macros lorsque la publicité est diffusée ou fait l’objet d’un clic.

Les macros de serveur d’annonces sont utiles pour transmettre des informations importantes à DSP ou à des serveurs d’annonces tiers. Les macros sont le plus souvent utilisées lors du trafic de métadonnées ou de code créatif tiers et personnalisés (tels que 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 DSP et partenaire a un format de balise publicitaire différent et les macros doivent être insérées dans différents emplacements de 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 leurs balises publicitaires qui DSP le trafic.

Macros de suivi générales

Utilisez des macros de suivi générales pour tous les types de balises et d’annonces afin de transmettre des données spécifiques, selon les besoins.

Macro

Description du remplacement

Type

${TM_ACCOUNT_ID}

ID du compte.

entier

${TM_AD_ID}

Clé publicitaire (adKey).

string

${TM_AD_ID_NUM}

Identifiant de publicité.

entier

${TM_ADVERTISER_ID}

Identifiant de l’annonceur.

entier

${TM_CAMPAIGN_ID}

Clé de la campagne.

string

${TM_CAMPAIGN_ID_NUM}

Identifiant de campagne.

entier

${TM_CLICK_URL}

L’URL de redirection, qui permet aux serveurs d’annonces de suivre et de comptabiliser les clics publicitaires. Lorsque la publicité est diffusée, si l’utilisateur clique dessus, la macro est activée et le clic est enregistré et comptabilisé à des fins de création de rapports.

string

${TM_CLICK_URL_URLENC}

URL de redirection codée, qui permet aux serveurs d’annonces de suivre et de comptabiliser les clics publicitaires. Lorsque la publicité est diffusée, si l’utilisateur clique dessus, la macro est activée et le clic est enregistré et comptabilisé à des fins de création de rapports. N’utilisez pas cette macro à moins que vous ne créiez des publicités tierces et que votre fournisseur ne nécessite pas de codage d’URL.

string

${TM_FEED_ID}

Clé du placement du média (feedKey).

string

${TM_FEED_ID_NUM}

L’identifiant de l’emplacement du média.

entier

${TM_MACRO_PLACEMENT_SITE_KEY

Clé de site de l’emplacement. Requis pour les AppsFlyer outils de suivi des clics pour les annonces d’installation d’applications mobiles.

string

${TM_PLACEMENT_ID}

Clé d’emplacement (cpKey).

string

${TM_PLACEMENT_ID_NUM}

L’ID d’emplacement.

entier

${TM_RANDOM}

Mise en cache : nombre aléatoire compris entre 1 et 1000000.

long

${TM_SESSION_ID}

Identifiant de la session, qui correspond à une récupération unique de la balise publicitaire.

string

${TM_SITE_DOMAIN_URLENC}

Sous-domaine de page analysé à partir de l’URL dans la demande d’offre ; encodé en URL. Non pris en charge pour les annonces "in-banner" et "click to play".

string

${TM_SITE_NAME}

Nom du site de l’emplacement.

string

${TM_SITE_URL_URLENC}

URL transmise dans la demande d’offre ; encodée en URL. Non pris en charge pour les annonces "in-banner" et "click to play".

string

${TM_SITE_ID_NUM}

Identifiant du site pour l’emplacement.

entier

${TM_TIMESTAMP}

Horodatage Unix indiquant le nombre de secondes écoulées depuis minuit (00:00 UTC) le 1er janvier 1970.

long

${TM_VIDEO_DURATION}

Durée de la vidéo publicitaire en secondes.

entier

Macros spécifiques à Mobile

Macro

Description du remplacement

Type

${CS_PLATFORM_ID}

(ComScore) ID de plateforme, qui correspond au système d’exploitation de l’appareil :

ios = Apple iOS
android = Google Android
windows = Windows Mobile
blackberry = Blackberry
other lorsque la plateforme n’est pas l’une des valeurs ci-dessus

varchar(50)

${CS_DEVICE_MODEL}

(ComScore) Nom du modèle d’appareil, encodé en URL.

string

${CS_IMPLEMENTATION_TYPE}

(ComScore) Environnement dans lequel la publicité a été diffusée :

a = application mobile
b = site web mobile

string (a ou b)

${NS_PLATFORM_ID}

(Nielsen) ID de plateforme, qui correspond au système d’exploitation de l’appareil :

ios= Apple iOS
android = Google Android
windows = Windows Mobile
blackberry = Blackberry
other lorsque la plateforme n’est pas l’une des valeurs ci-dessus

string

${NS_DEVICE_GROUPING}

(Nielsen) Type d’appareil sur lequel la publicité était visionneuse :

TAB = tablette
PHN = mobile
computer = ordinateur

string

${UOO}

(Nielsen) Indique si l’utilisateur a désactivé le suivi publicitaire :

1 (indicateur DNT = 1) = l’utilisateur a désactivé le suivi des publicités
0 (indicateur DNT = 0) = l’utilisateur s’est abonné au suivi des publicités

integer (0 ou 1)

${TM_BUNDLE}

ID de lot de la boutique d’applications iOS ou Android. Exemples : com.zynga.wwf2.free ou id804379658

string

gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED} indique si l’enchérisseur 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 au partenaire d’approvisionnement dans la demande d’offre entrante :

Dans la plupart des cas, il s’agit d’une chaîne de consentement encodée en base64url, ou daisybit (exemple : BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA)
0 = aucun consentement
1 = consentement

daisybit ou integer

Macros de clic pour les publicités tierces

Pour effectuer un suivi précis des clics pour les publicités à l’aide de balises d’affichage tierces, DSP nécessite une macro de clic d’affichage. Une seule version de la macro est requise ; la macro appropriée dépend du type de balise .

Macro

Description du remplacement

Type

${TM_CLICK_URL}

URL de redirection qui permet aux serveurs d’annonces de suivre et de comptabiliser les clics publicitaires dans la plateforme.

string

${TM_CLICK_URL_URLENC}

URL de redirection qui permet aux serveurs de publicités nécessitant un codage URL de suivre et de comptabiliser les clics publicitaires dans la plateforme.

string

DSP insère automatiquement les macros d’affichage des clics dans une balise d’affichage tierce lorsque vous :

Exporter des balises publicitaires d’un partenaire de serveur de publicités
Chargement en masse de Flashtalking ou de Google DoubleClick for Advertisers balises publicitaires directement dans DSP

Si une macro de clic est manquante lors de la création d’une publicité display, DSP affiche un message d’avertissement vous invitant à insérer manuellement la macro de clic d’affichage appropriée dans la zone appropriée de la balise.

Analytics for Advertising Macros

Pour obtenir des macros supplémentaires disponibles spécifiquement pour les clients Analytics for Advertising, voir "Ajouter Analytics for Advertising des macros à Flashtalking Balises publicitaires" et "Ajouter Analytics for Advertising des macros à Google Campaign Manager 360 Balises publicitaires".

Dépannage 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 sont manquants 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 macro valide.
La macro ne se termine pas par un jeu de caractères valide, tel que }.

recommendation-more-help

9ff4800f-94be-45f0-a5bf-09d0d7e96baa