Microsoft Monetize - Macros créatives prises en charge

Nous avons des macros créatives qui peuvent être utilisées pour toutes les impressions, mobiles et vidéo. Nous prenons également en charge les macros de confidentialité et de fonction.

Remarque

Les macros créatives respectent la casse et ne sont pas disponibles pour les pixels de conversion piggyback.

Macros créatives pour toutes les impressions

Les macros suivantes peuvent être utilisées pour toutes les impressions :

Macro	Description
`${CLICK_URL}`	URL de suivi des clics. Par exemple : `https://xandr.com`
`${CLICK_URL_ENC}`	URL de suivi des clics encodée (uniquement nécessaire pour certains serveurs publicitaires tiers). Par exemple : `https%3A%2F%2Fxandr.com`

Les macros suivantes peuvent être utilisées dans des balises tierces créatives et des URL de page d’accueil :

Macro	Description
`${ADV_CODE}`	Code de l’annonceur auquel appartient le créateur.
`${ADV_FREQ}`	Nombre total d’impressions vues par un utilisateur sur toutes les campagnes de l’annonceur.
`${ADV_ID}`	ID de l’annonceur auquel appartient le créatif.
`${AGE}`	Âge de l’utilisateur, le cas échéant. Les valeurs prises en charge sont un entier ou 0.
`${APPNEXUS_AUCTION_ID}`	Cette macro est un alias pour `${AUCTION_ID}`et se comporte de la même manière.
`${AUCTION_ID}`	Chaîne de caractères 64 bits représentant l’enchère individuelle qui a conduit à l’impression.
`${BID_PRICE}`	Première offre de prix pour cette impression, par opposition au prix payé après la réduction du prix.
`${BIDPRICE}`	Cette macro est un alias pour `${BID_PRICE}`et se comporte de la même manière.
`${CACHEBUSTER}`	Chaîne de nombre aléatoire utilisée pour limiter la mise en cache de l’URL. Remarque : cette macro garantit qu’un nouvel appel est effectué au serveur publicitaire chaque fois que la balise est appelée pour compter avec précision toutes les impressions. Si vous n’ajoutez pas cette macro à la balise, vous pouvez voir des totaux d’impression inexacts.
`${CP_CODE}`	Code de campagne de l’impression servie.
`${CP_ID}`	ID de campagne ou fractionnement de l’impression servie.
`${CPG_CODE}`	Code d’élément de ligne de l’impression servie.
`${CPG_ID}`	ID d’élément de ligne de l’impression servie.
`${CREATIVE_CODE}`	Code du créatif servi, le cas échéant.
`${CREATIVE_HEIGHT}`	La hauteur de la créativité servie.
`${HEIGHT}`	Il s’agit d’un alias pour `${CREATIVE_HEIGHT}`et se comporte de la même manière.
`${CREATIVE_ID}`	ID créatif qui a gagné l’impression.
`${CREATIVE_SIZE}`	Largeur et hauteur du créatif servi. Par exemple : 300 x 250.
`${CREATIVE_WIDTH}`	Largeur du créatif servi.
`${WIDTH}`	Cette macro est un alias pour `${CREATIVE_WIDTH}`et se comporte de la même manière.
`${CUSTOM_MODEL_ID}`	du `id` modèle personnalisé utilisé dans la vente aux enchères. Lorsqu’aucun modèle personnalisé n’est utilisé, cette macro retourne `0`. Remarque : cette macro personnalisée fonctionne uniquement pour les clients APB Alpha Test.
`${CUSTOM_MODEL_LAST_MODIFIED}`	Date et heure (en heure d’époque Unix) depuis la dernière modification du modèle personnalisé utilisé dans la mise aux enchères. Si aucun modèle n’a été utilisé, cette macro retourne `0`. Remarque : cette macro personnalisée fonctionne uniquement pour les clients APB Alpha Test.
`${CUSTOM_MODEL_LEAF_NAME}`	`leaf_name` spécifié dans la feuille qui a déterminé l’enchère gagnante. Si aucun nom n’est spécifié ou si aucun modèle n’a été utilisé, cette macro retourne `---`. Cela s’aligne sur le `leaf_name` champ du flux standard dans les données de niveau journal. Pour plus d’informations, consultez Flux standard. Remarque : cette macro personnalisée fonctionne uniquement pour les clients APB Alpha Test.
`${DATACENTER}`	ID du centre de données (1 = NYM, 2 = LAX, 3 = AMS, 4 = FRA, 5 = SIN).
`${DEAL_ID}`	L’ID de transaction Microsoft Advertising associé à l’enchère gagnante, le cas échéant. En l’absence de transaction, cette macro retourne `0`.
`${ECP}`	Le prix clair estimé côté éditeur (ECP) pour la vente aux enchères.
`${EXTENDED_IDS}`	Valeurs d’ID universel transmises par le vendeur, que l’acheteur a l’autorisation d’afficher.
`${GENDER}`	Le sexe de l’utilisateur, le cas échéant. Les valeurs admises sont les suivantes : - `f` (femelle) - `m` (mâle) - `u` (inconnu)
`${INV_SOURCE_ID}`	Déconseillé
`${IO_CODE}`	Code d’ordre d’insertion de l’impression servie.
`${IO_ID}`	ID de l’ordre d’insertion de l’impression servie.
`${OZONE_ID}`	Déconseillé
`${PMT_RULE_ID}`	ID de la règle de paiement utilisée pour établir le prix de l’impression.
`${POSTAL_CODE}`	Code postal de l’utilisateur.
`${PRICE_PAID}`	Prix payé pour cette impression après la réduction du prix. C’est le deuxième prix.
`${SECOND_PRICE}`	Prix qui représente la deuxième offre la plus élevée dans l’enchère.
`${PT1}`, `${PT2}`, `${PT3}`, `${PT4}`, `${PT5}`, `${PT6}`, `${PT7}`, `${PT8}`, `${PT9}`	Ces macros peuvent être remplies avec des données personnalisées arbitraires que vous envoyez lorsque vous utilisez les paramètres de chaîne de requête de balise de placement suivants : - `pt1` - `pt2` - `pt3` - `pt4` - `pt5` - `pt6` - `pt7` - `pt8` - `pt9` Pour plus d’informations, consultez Create une macro de balise de placement.
`${PUBLISHER_CODE}`	Code de l’éditeur qui vend l’impression. Remarque : cet ID est disponible uniquement si l’éditeur utilise un code et l’a exposé pour la création de rapports.
`${PUBLISHER_ID}`	ID de l’éditeur qui vend l’impression. Remarque : cet ID est disponible uniquement si le serveur de publication est exposé pour la création de rapports.
`${REFERER_URL}`	Déconseillé Remarque : utilisez `${REFERER_URL_ENC}` à la place.
`${REFERER_URL_ENC}`	URL de référence encodée si disponible. Pour les impressions d’application mobile, cette macro renvoie l’URL de l’App Store si disponible.
`${REM_USER}`	Valeur booléenne qui indique si l’utilisateur est en cours de remarketing.
`${RESERVE_PRICE}`	Prix de réserve fixé par l’éditeur. Lorsqu’il n’y a pas de prix de réserve, cette macro retourne `0`.
`${SCHEME}`	Remplit le protocole d’application approprié (HTTP ou HTTPS) en fonction du type d’inventaire.
`${SEG_CODES}`	Codes pour les segments que l’acheteur gagnant possède ou auxquels il a accès dans le cookie de cet utilisateur (par ordre d’heure de dernière consultation). Si l’utilisateur se trouve dans plus de 15 segments accessibles, cette macro retourne uniquement les 15 premiers segments (classés par segment le plus récent vers le segment le plus ancien).
`${SEG_IDS}`	ID des segments que l’acheteur gagnant possède ou auxquels il a accès dans le cookie de cet utilisateur (par ordre d’heure de dernière consultation). Si l’utilisateur se trouve dans plus de 15 segments accessibles, cette macro retourne uniquement les 15 premiers segments (classés par segment le plus récent vers le segment le plus ancien).
`${SELLER_MEMBER_ID}`	ID de membre du membre qui vend l’impression.
`${SITE_ID}`	ID du site sur lequel l’impression est servie.
`${SSP_DATA}`	Requis pour les pixels de conversion côté serveur. Pour plus d’informations, consultez Pixels de conversion côté serveur.
`${TAG_CODE1}`	Code d’intégration défini sur le placement.
`${TAG_CODE2}`	Code d’intégration supplémentaire défini sur le placement.
`${TAG_ID}`	ID de placement Microsoft Advertising qui a lancé la demande d’offre.
`${TIMESTAMP}`	Horodatage UNIX pour la vente aux enchères.
`${USE_COOKIES}`	Cela est utilisé pour les créatifs tiers afin d’indiquer si des cookies doivent être définis pour l’utilisateur qui consulte l’impression. Les valeurs autorisées sont notamment les suivantes : - `0` pour non - `1` pour oui Pour plus d’informations sur les paramètres liés aux cookies, consultez Paramètres de confidentialité des cookies et service publisher.
`${USER_AGENT}`	Chaîne de l’agent utilisateur de l’en-tête HTTP de la requête. L’agent utilisateur identifie souvent des informations telles que l’application, le système d’exploitation et le fournisseur de logiciels agissant au nom de l’utilisateur. Par exemple : Mozilla/5.0 (Macintosh ; U; Intel Mac OS X 10.5 ; en-US ; rv :1.9.0.4) Gecko/2008102920 Firefox/3.0.4.
`${USER_AGENT_ENC}`	Chaîne d’agent utilisateur encodée à partir de l’en-tête HTTP de la requête.
`${USER_CITY}`	Chaîne de caractères de la ville de l’utilisateur.
`${USER_COUNTRY}`	Chaîne de caractères du pays de l’utilisateur.
`${USER_ID}`	Chaîne de caractères Microsoft Advertising 64 bits représentant l’utilisateur pour l’impression.
`${USER_IP}`	Adresse IP de l’utilisateur, qui est tronquée.
`${USER_LOCALE}`	Langue et dialecte (aa-DD) signalés par l’appareil de l’utilisateur. Par exemple, en-ZA représente l’anglais (en) utilisé en Afrique du Sud (ZA).
`${USER_STATE}`	Chaîne de caractères de l’état ou de la région de l’utilisateur. - Aux États-Unis : abréviation de 2 lettres - En dehors des États-Unis : URL encodée avec le pays de l’utilisateur suivi de l’ID de région de l’utilisateur (FIPS 10-4 ou généré par Microsoft Advertising). Par exemple, la région entourant Riva en Lettonie est LV%3A25 (encodage pour LV :A25).

Macros créatives pour les impressions vidéo

Les macros suivantes peuvent être utilisées spécifiquement pour les impressions vidéo :

Macro	Description
`${VIDEO_CONTEXT}`	Contexte de l’annonce vidéo. Les valeurs autorisées sont notamment les suivantes : - `0`: In-stream unknown - `1`: pré roll in-stream - `2`: mid-roll in-stream - `3`: post-roll in-stream - `4`: Out-stream
`${VIDEO_PLAYBACK_METHOD}`	Spécifie la façon dont la vidéo a été lue. Les valeurs autorisées sont notamment les suivantes : - `0`:Inconnu - `1`: Lecture automatique, sonorité - `2`: Lecture automatique, son off - `3`: Démarrer en un clic - `4`: Survol de la souris - `5`: Lecture automatique, son inconnu
`${VIDEO_PLAYER_HEIGHT}`	Hauteur du lecteur vidéo, exprimée en pixels.
`${VIDEO_PLAYER_WIDTH}`	Largeur du lecteur vidéo, exprimée en pixels.

Macros créatives pour les impressions mobiles

Les macros suivantes peuvent être utilisées spécifiquement pour les impressions mobiles :

Macro	Description
`${CARRIER_ID}`	Entier Microsoft Advertising représentant l’ID de l’opérateur mobile. Pour obtenir la liste complète des ID d’opérateur, consultez service d’opérateur.
`${DEVICE_AAID}`	Identificateur de publicité Android lorsque l’impression est fournie à partir d’un appareil Android.
`${DEVICE_APPLE_IDA}`	Identificateur de publicité Apple lorsque l’impression est remise à partir d’un appareil Apple.
`${DEVICE_IFA_TYPE}`	Type d’identificateur représenté par .`${DEVICE_IFA}` Les valeurs admises sont les suivantes : - AAID (Android Advertising ID/Google) - IDFA (Identificateur pour la publicité/Apple) - AFAI (Amazon Fire ID) - RIDA (ID Roku) - OPENUDID - TIFA (Tizen Identifier for Advertising (Samsung Ad ID)) - VIDA (Vizio Advertising ID) - LGUDID (ID d’appareil unique LG) `${DEVICE_IFA_TYPE}` doit être utilisé conjointement avec `${DEVICE_IFA}`, et cette configuration est recommandée par rapport aux macros d’appareil individuelles spécifiques à chaque type IFA. Ces macros s’appliquent aux types d’appareils mobiles et CTV.
`${DEVICE_IFA}`	Identificateur unique représentant l’appareil.
`${DEVICE_MAKE_ID}`	Entier Microsoft Advertising représentant l’ID de la fabrique de l’appareil mobile, tel que `26`. Pour obtenir la liste complète des ID de création d’appareils mobiles, consultez le service Device Make.
`${DEVICE_MD5}`	Identificateur unique chiffré MD5 représentant l’appareil mobile.
`${DEVICE_MODEL_ID}`	Entier Microsoft Advertising représentant l’ID du modèle d’appareil mobile tel que `301`. Pour obtenir la liste complète des ID de modèle d’appareil mobile, consultez service de modèle d’appareil.
`${DEVICE_ODIN}`	Identificateur unique chiffré par ODIN représentant l’appareil mobile. Pour plus d’informations, consultez ODIN.
`${DEVICE_OPENUDID}`	Identificateur unique chiffré OPENUDID représentant l’appareil mobile.
`${DEVICE_SHA1}`	Identificateur unique chiffré sha1 représentant l’appareil mobile.
`${DEVICE_WIN_ID}`	ID Windows Ad de l’appareil sur lequel cette impression s’est produite, le cas échéant.
`${EXT_APP_ID}`	Identificateur externe de l’application demandant l’impression. Cette macro n’est utile que pour les impressions d’application mobile.
`${GEO_LAT}`	Latitude de la position de l’utilisateur lorsque les données GPS sont disponibles à partir d’un appareil mobile, exprimée au `snn.ddd,snn.ddd` format ou `+12.345-45.123`. Le sud est représenté sous la forme d’un négatif dans cet exemple. Pour se conformer aux normes de confidentialité, la précision maximale est de cinq décimales.
`${GEO_LON}`	Longitude de l’emplacement de l’utilisateur lorsque les données GPS sont disponibles à partir d’un appareil mobile. exprimé à l’aide du format `snn.ddd,snn.ddd`. Par exemple : `+12.345` ou `-45.123`. West est représenté sous la forme d’un négatif dans cet exemple. Pour se conformer aux normes de confidentialité, la précision maximale est de cinq décimales.
`${IS_PREVIEW}`	Un indicateur peut être transmis au serveur tiers afin que les impressions de production ne soient pas comptabilisées dans le nombre total d’impressions lors de l’aperçu des créations. Les valeurs admises sont les suivantes : - `0` pour non - `1` pour oui
`${SUPPLY_TYPE}`	Cette macro est remplie avec une valeur numérique qui indique le type de fourniture de l’impression. Les valeurs autorisées sont notamment les suivantes : - `0`:Web - `1`: web mobile - `2`: application mobile - `4`:Toolbar

Macros de confidentialité

Pour que nos clients répondent à leurs exigences de transparence, de notification et de choix/consentement en vertu de la loi sur la confidentialité de l’État américain, du RGPD et de la directive ePrivacy, Microsoft Advertising prend en charge la plateforme mondiale de confidentialité et le cadre de consentement IAB Europe Transparency & (le « Framework »). Pour plus d’informations, consultez IAB Europe Transparency & Consent Framework. Les éditeurs doivent faire référence à une partie de la réglementation sur la confidentialité lors de l’utilisation de macros, telles que celles indiquées dans le tableau ci-dessous, pour faire part de la notification, de la transparence et du choix aux utilisateurs finaux situés dans l’EEE, signaler les fournisseurs approuvés et transmettre leur consentement à Microsoft Advertising et aux sources de demande, ainsi que leurs fournisseurs via la plateforme Microsoft Advertising. Pour plus d’informations, consultez Partie des stratégies de service.

Macro	Description
`${GDPR_APPLIES}`	Indique si les réglementations RGPD sont appliquées. Il indique spécifiquement si l’utilisateur se trouve dans un pays concerné par le RGPD, ou si un signal RGPD requis est passé avec la demande. Les valeurs admises sont les suivantes : - `0` pour non - `1` pour oui Remarque : `0` peut être reçu d’un pays de l’EEE. C’est le choix de l’éditeur de signaler de cette manière.
`${GDPR}`	Il s’agit d’un alias pour `${GDPR_APPLIES}`et se comporte de la même manière.
`${GDPR_CONSENT_STRING}`	Cette macro spécifie la chaîne de consentement RGPD IAB. Si le RGPD s’applique, il contient une liste de fournisseurs approuvés par l’utilisateur en fonction de l’infrastructure de transparence et de consentement du RGPD IAB. Pour plus d’informations, consultez Transparence et framework de consentement du RGPD IAB.
`${GDPR_CONSENT}`	Cette macro est un alias pour `${GDPR_CONSENT_STRING}`et se comporte de la même manière.
`${GDPR_CONSENT_[0-9]+}`	Par exemple, GDPR_CONSENT_1, GDPR_CONSENT_12345, etc. Tous ces éléments sont résolus en la même chaîne de consentement RGPD que celle expliquée ci-dessus dans `'${GDPR_CONSENT_STRING}'`.
`${XANDR_DOMAIN}`	Récupère dynamiquement le domaine Microsoft Advertising approprié en fonction des paramètres de consentement des cookies inclus dans la chaîne TCF. Si l’utilisateur a activé les cookies à partir de ses paramètres de navigateur, mais a : - n’a pas donné son consentement pour que leurs cookies soient inclus dans la chaîne TCF, le `adnxs-simple.com` domaine sera utilisé pour empêcher le navigateur d’attacher des cookies aux appels publicitaires suivants. - ayant donné leur consentement pour que leurs cookies soient inclus dans la chaîne TCF, le `adnxs.com` domaine sera utilisé pour passer des cookies dans l’en-tête de chaque appel publicitaire. Remarque : cette macro ne doit être utilisée que si vous envisagez de servir des impressions dans des pays qui nécessitent le consentement pour les cookies.
`${GPP_SID}`	Indique si une section (c’est-à-dire le cadre réglementaire) de la plateforme globale de confidentialité doit être appliquée. Plus précisément, il indique si l’utilisateur se trouve dans un pays concerné par la législation couverte par le GPP.
`${GPP_STRING_XXXXX*}`	Il s’agit de la chaîne GPP ( Global Privacy Platform ) IAB. Si une section du GPP s’applique, celle-ci contient des informations dépendantes de l’infrastructure reflétant les élections de consentement de l’utilisateur. Remarque : * `XXXXX` peut représenter n’importe quel ID numérique.

Macros de fonction

Une macro de fonction exécute une fonction sur une autre macro. Les macros de fonction peuvent être utilisées en combinaison avec n’importe quelle autre macro créative, y compris les macros personnalisées. Si elles ne sont pas reconnues au moment du rendu, elles ne sont pas traduites et la fonction n’est pas appelée.

Microsoft Advertising prend actuellement en charge la {$URL_ENC} macro de fonction, qui peut être utilisée à diverses fins liées à l’encodage. Un cas d’usage clé est lorsqu’une URL doit être passée d’un serveur publicitaire à un serveur publicitaire à l’aide d’une macro créative. En raison de la présence de caractères non pris en charge dans la mise en forme d’URL standard, la {$URL_ENC} macro de fonction doit être encodée à différentes étapes du processus.

Cette macro de fonction prend la forme suivante :

${URL_ENC(${MACRO_NAME},#)}

${MACRO_NAME} est la macro à encoder et # est l’entier représentant le nombre de fois où encoder le contenu. Les valeurs admises sont les suivantes :

Chaque encodage correspond à une étape de la chaîne de redirection, ainsi qu’à la façon dont un suivi des clics tiers donné fonctionne avec la macro. Un double encodage est généralement nécessaire pour les URL de destination finale lorsqu’un deuxième serveur publicitaire est impliqué, et un encodage triple pour un troisième serveur publicitaire.

Pour déterminer si vous devez utiliser l’encodage simple, double ou triple, vous devez case activée avec votre dispositif de suivi des clics tiers, puis tester votre URL_ENC macro pour vous assurer qu’elle fonctionne. Si votre macro ne fonctionne pas, l’une des conséquences peut être la rupture de liaison, ce qui entraîne le fait que les utilisateurs n’atteignent pas l’URL de destination prévue.

Exemple d’encodage	Format
Encodage des URL de clic une seule fois	Utilisez le format suivant : `${URL_ENC(${CLICK_URL},1)}` Remarque : si https://xandr.com est passé comme URL de clic, l’utilisation `${URL_ENC(${CLICK_URL},1)}` de pour encoder l’URL entraîne `https%3A%2F%2Fxandr.com` le remplissage de la création.
Encodage de l’URL du média une seule fois	Utilisez le format suivant : `${URL_ENC(${MEDIA_URL},1)}`
Encodage de l’URL du média à deux reprises	Utilisez le format suivant : `${URL_ENC(${MEDIA_URL},2)}`
Encodage d’une macro personnalisée appelée ADFORMAT une fois	Utilisez le format suivant : `${URL_ENC(#{ADFORMAT},1)}`

Macros DSA (Digital Services Act)

Selon l’article 26 de la DSA, les plateformes en ligne, y compris les clients éditeurs de Microsoft Advertising, doivent fournir des informations claires, concises et sans ambiguïté sur les publicités avant le 17 février 2024. Ces exigences sont les suivantes :

L’identification claire que l’information est une publicité.
Divulgation de l’identité d’une personne ou d’une personne morale au nom de laquelle la publicité est présentée.
Indiquant l’identité d’une personne physique ou morale qui a effectué le paiement de la publicité, si différente de celle de l’annonceur.
Fournir des informations sur les paramètres principaux utilisés pour déterminer le destinataire de l’annonce et, le cas échéant, des instructions sur la façon de modifier ces paramètres.

Macro	Description
`${DSA_REQUIRED}`	Indique si les informations DSA doivent être mises à disposition. Les valeurs admises sont les suivantes : - `0`: non obligatoire. - `1`:Obligatoire. Les réponses d’enchère avec ou sans objet DSA seront acceptées. - `2`:Obligatoire. Les réponses aux enchères sans objet DSA ne seront pas acceptées. - `3`:Obligatoire. Les réponses aux enchères sans objet DSA ne seront pas acceptées. Ici, l’éditeur est une plateforme en ligne.
`${DSA_BEHALF}`	Chaîne de texte UNICODE libre avec un nom au nom de laquelle l’annonce est affichée. Cette macro est remplie à partir de la réponse d’enchère DSA. Par exemple : `Advertiser`.
`${DSA_PAID}`	Chaîne de texte UNICODE gratuite de qui a payé pour l’annonce. Cette macro est remplie à partir de la réponse d’enchère DSA. Par exemple : `Advertiser`.
`${DSA_PARAMS}`	Combinaison de valeurs entières représentant des paramètres utilisateur, séparées par un trait de soulignement « _ ». Par exemple : `1_2_3`. Les valeurs admises sont les suivantes : - `1`: informations sur votre activité en ligne indiquant votre similitude avec les groupes ciblés par l’annonceur. Par exemple, le groupe d’âge, le sexe, le niveau d’éducation ou les centres d’intérêt. - `2`: informations sur le paramètre dans lequel vous affichez une publication spécifique. Par exemple, le contenu du site web, le type d’appareil, l’adresse IP, l’emplacement (pays ou ville). - `3`: informations sur votre emplacement géographique précis, avec une précision d’environ 500 mètres.

Macros créatives

Last updated on 2025-04-01

Partager via