Les macros sont des chaînes spéciales dans le code de la création. Ad Manager les remplace ensuite par une valeur ou un code différents en fonction des paramètres de la création. Les macros sont utiles, car vous n'avez pas besoin de mettre à jour directement le code de la création si vous devez apporter des modifications. Il vous suffit de mettre à jour la référence des macros.
Nous avons inclus des suggestions sur la manière d'utiliser chaque macro. Toutefois, vous pouvez vous en servir de la façon qui vous convient le mieux. Vous pouvez ajouter ces macros à tout type de code traité par l'ad server lors de la diffusion : code de créations tierces ou personnalisées, code Studio, URL de destination ou tags d'emplacement publicitaire.
Remarques importantes concernant les macros
- Casse
Les macros sont sensibles à la casse. Utilisez%%CACHEBUSTER%%, mais pas%%Cachebuster%%. - Échappements
Le comportement des macros diffère selon qu'elles incluent ou non des échappements. Découvrez comment utiliser des macros avec et sans échappement. - Insertion des macros
Si Ad Manager reconnaît le fournisseur tiers, les macros sont automatiquement insérées pour les créations tierces ou les URL de tags VAST. Pour les créations personnalisées et les modèles de création, vous devez ajouter les macros manuellement. Si vous ne savez pas à quel endroit placer une macro, contactez votre fournisseur de créations.
Lors du trafficking avec un modèle de création, une URL de destination n'est présente que si une macro de clic est utilisée dans le modèle. - Caractères réservés et encodage des URL (encodage avec le signe de pourcentage)
Certaines lettres minuscules précédées du signe "%" sont réservées dans Ad Manager :%a
%c
%h
%i
%n
%p
%kVous ne devez pas utiliser ces chaînes pour encoder les URL, car elles peuvent interférer avec le remplacement des macros.
- Les macros ne sont pas compatibles avec le programmatique direct
Consultez les fonctionnalités disponibles pour le programmatique direct.
Accéder à une macro spécifique de la liste
Macros de rendu
Ces macros sont couramment utilisées pour afficher les créations, et s'assurer qu'elles apparaissent et fonctionnent correctement.
Bloc d'annonces| Macro |
|---|
%%ADUNIT%% |
Cette macro permet d'insérer le chemin du bloc d'annonces à partir de votre tag Google Publisher Tag dans le code de la création lors de sa diffusion.
Pour ajouter la macro ADUNIT à un extrait de code de création tierce, procédez comme suit :
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=%%ADUNIT%%"></scr'+'ipt>');
</script>
La macro de bloc d'annonces est remplacée par le chemin complet du bloc d'annonces (y compris le code de réseau) contenu dans la demande d'annonce d'origine. Voici un exemple de chemin d'accès au bloc d'annonces renvoyé lorsque l'annonce est diffusée :
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/?dfpAdUnit=/1234/site/section"<>/scr'+'ipt>');
</script>
Cette macro n'est valable que pour les blocs d'annonces suggérés qui ont été approuvés. Si le bloc d'annonces suggéré est situé au troisième niveau, cette macro ne s'applique qu'au bloc d'annonces de deuxième niveau lorsqu'elle est utilisée dans l'extrait de création. Une fois que le bloc d'annonces suggéré a été approuvé, la macro s'applique au bloc d'annonces de troisième niveau dans l'extrait de création.
| Macro | Échappement |
|---|---|
%%DEST_URL_ESC%% |
Un échappement |
%%DEST_URL_ESC_ESC%% |
Deux échappements |
%%DEST_URL_UNESC%% |
Sans échappement |
La macro d'URL de destination est remplacée par l'URL de destination de la création. Cette dernière correspond soit à l'URL de destination d'un élément de campagne, soit à une valeur de remplacement définie dans l'élément de campagne pour la création.
Cette macro est utile pour les créations personnalisées et les modèles de création, notamment si l'URL de destination de la création doit être incluse dans le code de cette dernière et change en fonction de l'élément de campagne au niveau duquel la création ou le modèle sont utilisés.
Il existe trois macros d'URL de destination : avec un échappement, avec deux échappements et sans échappement. Généralement, le nombre d'échappements (un, deux ou aucun) dépend de l'entreprise tierce qui effectue le suivi des clics. Certaines entreprises tierces exigent une URL avec échappement, d'autres non. Le nombre d'échappements requis est souvent indiqué avec la chaîne click= dans le tag d'emplacement publicitaire tiers ou dans le code de création personnalisée qui est utilisé dans Ad Manager :
-
click=: un échappement (%%DEST_URL_ESC%%). -
click0=: aucun échappement (%%DEST_URL_UNESC%%). -
click1=: un échappement (%%DEST_URL_ESC%%). -
click2=: deux échappements (%%DEST_URL_ESC_ESC%%).
%%DEST_URL%%, qui correspond exactement à %%DEST_URL_ESC%%. Nous vous recommandons d'utiliser %%DEST_URL_ESC%% pour plus de clarté, mais vous n'avez pas besoin de remanier le code des anciennes créations ni des anciens modèles.%u ou %%DEST_URL%%, vous êtes redirigé vers l'URL xsd:string lorsque vous cliquez sur la création. Elle peut comporter jusqu'à 1 024 caractères.| Macro |
|---|
%%FILE:file_display_name%% |
La macro de serveur de fichiers %%FILE:file_display_name%% est remplacée par l'URL complète d'un élément de création qui a été importé. Elle permet d'appeler les éléments importés (une image, par exemple) à l'aide du code d'une création personnalisée.
Pour utiliser cette macro, remplacez file_display_name par le nom à afficher de l'élément de création, tel qu'il figure dans Ad Manager lorsque vous consultez les informations sur la création.
| Macro |
|---|
%%HEIGHT%% |
%%WIDTH%% |
Ces macros permettent d'insérer la hauteur et la largeur d'une création (telles qu'elles sont définies dans Ad Manager par la valeur du champ "Taille du bloc d'annonces cible") dans le code personnalisé de cette dernière au cours du processus de diffusion d'annonces.
Elles peuvent être utiles en particulier si vous créez un modèle devant être appliqué à des créations de différentes tailles. Au lieu de coder en dur la taille des différentes créations, vous pouvez utiliser ces macros pour inclure la largeur et la hauteur de chaque création de façon dynamique.
| Macro |
|---|
%%PATTERN:key%% |
%%PATTERN:TARGETINGMAP%% |
%%PATTERN:url%% |
La macro de correspondance de structure permet de transmettre une ou plusieurs variables personnalisées (une valeur de ciblage, par exemple) à une création. Vous pouvez utiliser cette macro pour transmettre des clé-valeurs, ou remplacer la totalité de la chaîne de ciblage ou l'URL de provenance. Elle peut être employée, par exemple, si vous souhaitez diffuser différentes créations en fonction des informations dont vous disposez sur un utilisateur, telles que ses préférences en matière de contenu.
La macro de correspondance de structure est limitée à 100 remplacements par création.
Échappement de la macro de correspondance de structure
La macro de correspondance de structure renvoie la valeur reçue. Si vous l'utilisez dans l'un des champs d'URL, tels que les champs "URL de la balise VAST" ou "URL de suivi tierce" d'une création vidéo, il est préférable que la valeur renvoyée comporte un échappement. Pour ce faire, vous devez inclure trois échappements dans la valeur figurant dans la demande.
%%PATTERN:key%%
Supposons, par exemple, que vous disposiez de deux créations pour un élément de campagne, l'une visant les utilisateurs de sexe féminin et l'autre destinée aux utilisateurs de sexe masculin. La "clé" utilisée dans la macro doit comprendre des caractères alphanumériques ou un trait de soulignement (_).
Voici comment fonctionne le processus :
- Transmettez la valeur personnalisée (le genre de l'internaute, dans notre cas) au tag d'emplacement publicitaire de votre page à l'aide de clé-valeurs :
googletag.defineSlot("/1234/adunit1/adunit2", [728, 90], "div-gpt-ad-123456789-0")
.addService(googletag.pubads())
.setTargeting("gender", "male"); - Dans la création personnalisée ou tierce, transmettez de façon dynamique la valeur personnalisée (genre de l'internaute) à l'aide de la macro suivante :
<script de création à insérer ici>...&gender=%%PATTERN:gender%%. - L'intégralité de la macro
%%PATTERN:gender%%va être remplacée parmale. - Ad Manager appelle le fichier de création "male" et le diffuse auprès de l'internaute concerné.
%%PATTERN:TARGETINGMAP%%
Vous pouvez utiliser %%PATTERN:TARGETINGMAP%% pour remplacer l'intégralité de la carte de ciblage et créer les tags de passback de manière dynamique.
Voici comment ajouter la macro TARGETINGMAP à un tag d'emplacement publicitaire :
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%).display();
Voici un exemple de chaîne complète de clés-valeurs utilisée lorsque l'annonce est diffusée :
.updateTargetingFromMap({"key1":["value1"], "key2": ["value2","value3"]}).display();
Vous pouvez utiliser cette macro pour configurer un tag de passback entre deux réseaux Ad Manager ("Réseau A" et "Réseau B").
Voici un exemple de création réservée sur le réseau Ad Manager A :
<script type='text/javascript' src='http://www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads().definePassback('/network_B/Homepage', [468, 60])
.setTargeting("myAdUnit", "%%ADUNIT%%")
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.display();
</script>
Si le réseau Ad Manager B ne dispose pas de campagne vendue à diffuser, il peut renvoyer l'impression au réseau A à l'aide d'une création de renvoi, comme suit :
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('%%PATTERN:myAdUnit%%', [468, 60])
.updateTargetingFromMap(%%PATTERN:TARGETINGMAP%%)
.setTargeting("kwd", "noloop") // to avoid infinite loops
.display();
</script>Vous pouvez également utiliser TARGETINGMAP dans un tag de passback envoyé dans une demande adressée à un ad server tiers, ce qui vous permet de disposer de plusieurs valeurs dans une création dynamique.
Voici un exemple de création réservée dans Ad Manager :
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=%%ADUNIT%%&targeting='+encodeURIComponent(JSON.stringify(%%PATTERN:TARGETINGMAP%%))+'"></scr'+'ipt>');
</script>
Lorsque l'annonce est diffusée par Ad Manager, cet extrait est remplacé par celui-ci :
<script type="text/javascript">
document.write('<sc'+'ript type="text/javascript" src="http://www.3rdparty.com/generatePassback.php?dfpAdUnit=/network_A/first_level_ad_unit/second_level_ad_unit&targeting=%7B%22kw%22%3A%5B%22testpercentp%22%5D%7D"></scr'+'ipt>');
</script>
Le tiers a désormais accès aux paramètres dfpAdUnit et targeting générés dynamiquement et peut créer le renvoi suivant :
<script src='//www.googletagservices.com/tag/js/gpt.js'>
googletag.pubads()
.definePassback('/network_A/first_level_ad_unit/second_level_ad_unit', [728, 90])
.setTargeting("kw", "noloop") // to avoid infinite loop (see https://support.google.com/admanager/answer/2811375)
.updateTargetingFromMap({"kw":["testpercentp"]}).display();
</script>
Pour ce faire, le tiers peut recevoir un modèle de code pouvant ressembler à cet extrait :
myTargetingObject = JSON.parse('$targeting'); document.write('<sc'+'ript src="https://www.googletagservices.com/tag/js/gpt.js"></scr'+'ipt>');
document.write('<scr'+'ipt>');
callback = function() {
googletag.pubads().definePassback('$dfpAdUnit', [728, 90])
.setTargeting("kwd", "noloop")
.updateTargetingFromMap(myTargetingObject)
.display();
};
window.googletag = window.googletag || {};
googletag.cmd = googletag.cmd || [];
googletag.cmd.push(callback);
document.write('</sc'+'ript>'); %%PATTERN:url%%
Vous pouvez également utiliser la clé réservée url pour remplacer la macro par l'URL de la page de provenance.
Sachez que url est une clé réservée. Toute clé-valeur contenue dans vos tags Campaign Manager 360 et portant le nom de clé url sera remplacée par l'URL de provenance.
| Macro |
|---|
%%TAG_PARAM%% |
La macro de paramètre de balise est utilisée avec d'autres paramètres de tag d'emplacement publicitaire et ne peut être utilisée qu'avec les paramètres suivants :
Si le paramètre est compatible, il est remplacé par sa valeur.
Par exemple, le paramètre %%TAG_PARAM:correlator%% (compatible) est remplacé par la valeur de "correlator" dans le tag d'emplacement publicitaire. En revanche, le paramètre %%TAG_PARAM:ppid%% (non compatible). n'est remplacé par aucune valeur.
| Macro |
|---|
%%TARGET_IN_NEW_WINDOW%% |
La macro de nouvelle fenêtre cible indique si le paramètre de fenêtre cible spécifié pour le bloc d'annonces servant à la diffusion d'une création est défini sur "_blank" (nouvelle fenêtre) ou sur une autre valeur.
-
Si la fenêtre cible est
_blank, la macro est remplacée par1. -
Si la fenêtre cible correspond à une autre valeur ou si elle n'est pas spécifiée, la macro est remplacée par
0.
Utilisez la macro %%TARGET_WINDOW%% si vous souhaitez insérer la valeur réelle du paramètre de fenêtre cible.
| Macro |
|---|
%%TARGET_WINDOW%% |
La macro de fenêtre cible est remplacée par la fenêtre cible spécifiée pour le bloc d'annonces dans lequel une création est diffusée. Dans le code d'une création, par exemple, elle permet de spécifier si un clic sur cette dernière charge la page de destination dans une nouvelle fenêtre ou dans la même fenêtre, en fonction des paramètres définis pour chaque site sur lequel l'annonce est diffusée.
Par exemple, la fenêtre cible du bloc d'annonces "AdManager_News.com" est définie sur _top et celle du bloc d'annonces "AdManager_Fashion.com" est définie sur _new. Si la macro %%TARGET_WINDOW%% est incluse dans le code de la création, elle est remplacée par _top pour AdManager_News.com et par _new pour AdManager_Fashion.com.
Voici un exemple de mise en œuvre :
<a href="%%CLICK_URL_UNESC%%%%DEST_URL%%" target="%%TARGET_WINDOW%%"><img src="my ad"></a>
La macro %%TARGET_IN_NEW_WINDOW%% permet de déterminer si le paramètre de fenêtre cible est défini sur "_blank" ou sur une autre valeur.
| Macro |
|---|
%%TFCD%% |
Le tag pour un traitement adapté aux contenus destinés aux enfants (Tag For Child-Directed content, TFCD) vous permet d'indiquer à des tiers qu'une demande d'annonce provient d'une page qui comprend des contenus destinés aux enfants. Cette macro est conçue pour garantir la conformité avec la loi COPPA (Children's Online Privacy Protection Act) en vigueur aux États-Unis.
Vous pouvez inclure cette macro dans toutes les URL de redirection ou demandes de créations tierces, au format coppa=%%TFCD%% ou dans un autre format similaire. Elle peut également être utilisée en JavaScript pour indiquer dans les demandes de tag de passback GPT que vous souhaitez un traitement adapté aux contenus destinés aux enfants. La macro est remplacée par la valeur 1 pour un traitement adapté aux contenus destinés aux enfants et par 0 dans le cas contraire, selon les informations sur la nature de la page, du site ou de l'application mobile à l'origine de la demande envoyée à Ad Manager.
Si vous utilisez les services publicitaires de Google et souhaitez mettre en œuvre, au niveau d'un site ou d'une application, un traitement adapté aux contenus destinés aux enfants, consultez l'article traitant de l'ajout des tags appropriés.
| Macro |
|---|
[%URI_ENCODE:variable%] |
La macro d'encodage d'URI permet de traduire correctement les espaces et d'autres caractères spéciaux dans les valeurs des variables d'un modèle de création pour les utiliser dans les URI, également appelés URL.
Exemple
Imaginons que votre modèle de création comporte une variable "list" appelée "Color" pour laquelle les deux valeurs possibles sont "dark blue" et "light green". Par défaut, Ad Manager ajoute [%Color%] à l'extrait de code de votre modèle de création :
<a href="https://paint.com/wall.html?color=[%Color%]">Peignez !</a>
Lorsque la création est générée, Ad Manager remplace [%Color%] par la chaîne de texte littérale de l'élément de liste sélectionné. Dans cet exemple, les chaînes de texte littérales contiennent des espaces et vont donc rompre l'URL, car les espaces doivent être encodés. Pour éviter ce problème, utilisez [%URI_ENCODE:Color%].
<a href="https://paint.com/wall.html?color=[%URI_ENCODE:Color%]">Peignez t!</a>
[%Color%] |
dark blue |
[%URI_ENCODE:Color%] |
dark%20blue |
Cette macro est particulièrement utile lorsque vous utilisez une variable de modèle de création pour définir une URL de destination ou une URL de redirection. Faute d'encodage correct, l'URL complète dans votre création pourrait ne pas fonctionner.
Exemple
Imaginons que votre modèle de création comporte une variable "URL" appelée "LandingPage". Par défaut, Ad Manager ajoute [%LandingPage%] à l'extrait de code de votre modèle de création :
<a href="%%CLICK_URL_UNESC%%[%LandingPage%]">Cliquez ici !</a>
Si l'URL [%LandingPage%] contient des paramètres de requête (par exemple, ?page=home&sport=baseball), elle est incorrecte, et la redirection ne fonctionne pas comme prévu. Dans cet exemple, le contenu placé après l'esperluette (&) est attribué à l'URL complète et non à l'URL de redirection. Pour éviter ce problème, utilisez [%URI_ENCODE:LandingPage%].
<a href="%%CLICK_URL_UNESC%%[%URI_ENCODE:LandingPage%]">Cliquez ici !</a>
[%LandingPage%] |
https://www.mysportswebsite.com? |
[%URI_ENCODE:LandingPage%] |
https%3A%2F%2Fwww.mysportswebsite.com%3F |
Macros de suivi
Ces macros sont principalement utilisées à des fins de suivi et de création de rapports.
Cache buster (nombre aléatoire)| Macro |
|---|
%%CACHEBUSTER%% |
La macro cache buster permet d'envoyer un nouvel appel à l'ad server à chaque exécution du code, afin de comptabiliser précisément les impressions. Si vous n'ajoutez pas cette macro au code de la création, vous risquez de constater davantage d'écarts dans la comptabilisation des impressions entre Google Ad Manager et un ad server tiers. Notez que tous les fournisseurs tiers n'exigent pas la macro cache buster.
La plupart des fournisseurs de créations prévoient un espace réservé dans leur tag pour insérer des macros cache buster. Supposons, par exemple, que le code de la création tierce contienne un élément de type :
http://abc.3rd-party-serving.com/Targeting/;adServer.php?ab=cd&e=12fg=click&ord=[RANDOM_NUMBER]
Vous devez sélectionner [RANDOM_NUMBER] et cliquer sur le bouton Insérer une macro de cache busting afin que celle-ci remplace l'espace réservé :
http://abc.3rd-party-serving.com/Targeting/adServer.php?ab=cd&e=12fg=click&ord=%%CACHEBUSTER%%
CACHEBUSTER pour réduire les écarts lorsque vous utilisez l'outil de suivi des impressions Campaign Manager 360 pour Ad Manager.
http://ad.doubleclick.net/ad/Nxxxx.site/Byyyy;sz=1x1;
ord=%%CACHEBUSTER%%?
Macros cache buster dans les réponses VAST
La macro %%CACHEBUSTER%% est remplacée par le même nombre aléatoire pour tous les événements d'une création donnée. Cette fonctionnalité est particulièrement utile pour les annonces vidéo, car la macro est remplacée par le même nombre aléatoire pour tous les événements de suivi de vidéo d'une réponse VAST.
| Macro | Échappement |
|---|---|
%%CLICK_URL_UNESC%% |
Sans échappement |
%%CLICK_URL_ESC%% |
Un échappement |
%%CLICK_URL_ESC_ESC%% |
Deux échappements |
La macro de clic est remplacée par une URL spéciale afin que vous puissiez effectuer le suivi des clics dans Ad Manager pour les créations tierces. Elle est généralement associée à l'URL de destination d'une création dans la balise d'ancrage (<a>). Ne déclarez pas la macro de clic comme la source d'une image ou d'un cadre iFrame. Sinon, un clic est enregistré chaque fois que l'image ou le cadre iFrame s'affiche, ce qui n'est pas correct. Le clic est donc supprimé, car il est considéré comme incorrect.
Utilisez %%CLICK_URL_UNESC%% au début d'un lien. Utilisez %%CLICK_URL_ESC%% lorsque le tracker de clics sert de paramètre à une autre URL.
<a href="%%CLICK_URL_UNESC%%http://www.google.com">lien</a>
<a href="http://www.google.com?rd_url=%%CLICK_URL_ESC%%">lien</a>
En savoir plus sur les macros avec échappement et sans échappement.
Vérifier l'intégration d'une macro de clic
Si une macro de clic n'est pas positionnée au bon endroit, elle n'effectue pas le suivi des clics. Suivez les étapes ci-dessous pour vous assurer que les clics sont enregistrés comme vous le souhaitez par Ad Manager.
- Prévisualisez la création.
- Cliquez sur l'aperçu.
Un message de confirmation indique que les clics sont enregistrés dans Ad Manager. Si ce message ne s'affiche pas, cela signifie que la macro de clic n'a pas été intégrée correctement.
| Macro | Valeur de remplacement de la macro |
|---|---|
%eaid! |
ID de l'élément de campagne |
%eadv! |
Référence annonceur de l'élément de campagne diffusé |
%ebuy! |
ID de campagne de l'élément de campagne diffusé |
%ecid! |
ID de la création |
%eenv! |
Indicateur d'environnement (type de tag) : i pour iFrame, j pour JavaScript |
%epid! |
ID du bloc d'annonces au niveau duquel l'élément de campagne est diffusé |
%esid! |
ID de bloc d'annonces de niveau supérieur à celui du bloc d'annonces où l'élément de campagne est diffusé
Il s'agit d'une ancienne macro qui risque de ne pas fonctionner comme prévu avec votre réseau.
|
Utilisez les macros remplacées par une valeur dans le code des créations personnalisées ou dans une URL de destination pour afficher les valeurs d'ID issues d'Ad Manager lors de la diffusion de créations sur une page. Elles sont souvent employées pour mettre en correspondance les ID d'Ad Manager avec ceux issus de la base de données d'un éditeur, à des fins de dépannage ou de création de rapports.
Vous pouvez dissocier les macros remplacées par une valeur dans l'URL de destination à l'aide de n'importe quel caractère compatible avec les URL de destination Ad Manager. Par exemple, l'URL http://www.site.com/?%eaid!;%ecid! peut être remplacée par http://www.site.com/?1234567;4265598.
| Macro |
|---|
%%ADVERTISING_IDENTIFIER_PLAIN%% (identifiant de l'appareil) |
%%ADVERTISING_IDENTIFIER_TYPE%% (type d'appareil) |
%%ADVERTISING_IDENTIFIER_IS_LAT%% (paramètre de suivi publicitaire limité) |
La macro %%ADVERTISING_IDENTIFIER_PLAIN%% permet aux éditeurs diffusant des annonces dans les applications d'envoyer un ID d'appareil réinitialisable aux partenaires publicitaires pour diffuser des annonces par centres d'intérêt. Vous pouvez ainsi accorder plus facilement à vos annonceurs et à vos agences un accès à l'ID d'appareil réinitialisable.
Les éditeurs diffusant des annonces dans les applications peuvent également utiliser la macro %%ADVERTISING_IDENTIFIER_TYPE%% pour envoyer le type d'appareil, et la macro %%ADVERTISING_IDENTIFIER_IS_LAT%% pour envoyer le paramètre de limite du suivi publicitaire (LAT), qui indique le signal "suivi publicitaire limité" d'un appareil.
Découvrez comment cibler des utilisateurs avec des ID d'appareil réinitialisables, qui incluent les types d'appareils compatibles.
Prérequis
Vous devez configurer le chiffrement HTTPS pour les créations. Cette exigence s'applique aussi bien à la création qu'aux pixels tiers utilisés pour le suivi des conversions. Si les créations ne sont pas chiffrées à l'aide du protocole HTTPS ou si vous ignorez la vérification automatique de la compatibilité SSL, la macro n'est pas remplacée par la valeur. Néanmoins, les créations sont diffusées.
Comment ça marche ?
- Dans Ad Manager, l'éditeur inclut les macros dans ses URL de suivi et/ou de création.
-
Les macros sont remplacées par l'ID de l'appareil de l'utilisateur, par le type d'appareil et/ou par le paramètre de suivi publicitaire limité. Ces valeurs sont ensuite incluses dans la création lors des appels vers un tiers.
La macro d'identifiant n'est pas remplacée par une valeur si la demande d'annonce provient d'une application destinée aux enfants (TFCD) ou si le paramètre de suivi publicitaire limité est activé. Dans ces cas de figure, cette macro renvoie une chaîne vide ("").
Format
Cette macro envoie 32 caractères hexadécimaux en majuscules, divisés en cinq groupes séparés par des tirets, au format 8-4-4-4-12, soit un total de 36 caractères (32 caractères alphanumériques et 4 tirets).
Example: 201F2EB1-8041-9E39-CD07-FCBBA5A29B41
Consultez les valeurs possibles pour les types d'appareil compatibles et le paramètre de suivi publicitaire limité.
| Macro |
|---|
%%PREVIEW_MODE%% |
Dans le code d'une création personnalisée, la macro de mode de prévisualisation permet d'empêcher votre système ou le système tiers de comptabiliser les impressions de prévisualisation. Elle est remplacée par la valeur true si la création est affichée en tant qu'aperçu Ad Manager et par false s'il s'agit d'une impression standard.
| Macro |
|---|
%%SCHEME%% |
La macro de protocole est remplacée par http: ou https:, selon le protocole de sécurité de la page Web sur laquelle la création est diffusée. Vous pouvez la placer au début d'une URL.
<img src=%%SCHEME%%//www.website.com/img/logo.gif>
| Macro |
|---|
%%SITE%% |
Cette macro est remplacée par le domaine du paramètre d'URL dans un tag d'emplacement publicitaire (par exemple, google.com). Elle permet de modifier la création en fonction de la provenance de la demande. Notez qu'elle n'est pas compatible avec les annonces Ad Exchange marquées comme anonymes.
| Macro | Échappement |
|---|---|
%%VIEW_URL_ESC%% |
Un échappement |
%%VIEW_URL_UNESC%% |
Sans échappement |
La macro d'impressions vues permet à Ad Manager de comptabiliser une impression chaque fois qu'une création est téléchargée sur l'appareil de l'utilisateur et a commencé à se charger. N'utilisez cette macro que dans les créations hors page.
Il existe plusieurs façons d'envoyer un ping d'affichage. Nous vous conseillons d'utiliser un tag <img> :
<!-- Ce tag IMG est invisible. Il incite le navigateur à envoyer une requête à VIEW_URL. -->
<img src="%%VIEW_URL_UNESC%%" style="display:none">
<!-- Ce tag IMG affiche l'annonce réelle.-->
<img src="[%Imagefile%]" border="0">
Le premier tag <img> récupère une image 1x1 à partir de VIEW_URL. Définissez le style sur display:none pour qu'il soit caché et n'affecte pas la mise en page.
Macros de demande d'annonce pour le RGPD
Ces macros sont principalement utilisées avec des demandes d'annonces soumises au RGPD.
RGPD| Macro |
|---|
${GDPR} |
Cette macro est remplacée par la valeur gdpr= associée à la demande d'annonce.
| Macro |
|---|
${GDPR_CONSENT_XXXX} |
Cette macro est remplacée par la chaîne TC (Transparency & Consent) associée à la demande d'annonce. Si la chaîne TC est vide ou incorrecte, cette macro ne sera pas remplacée. Utilisez-la pour transmettre la chaîne TC à un fournisseur de créations tierces à l'intérieur d'une URL dans les créations non programmatiques.
Remplacez XXXX par l'ID du fournisseur tiers qui figure sur la LGF (Liste globale des fournisseurs) de l'IAB. Si la chaîne TC est vide ou incorrecte, cette macro ne sera pas remplacée.
Les créations qui incluent la macro ${GDPR_CONSENT_XXXX} peuvent être bloquées si le fournisseur tiers associé à l'ID repris dans la LGF de l'IAB que vous avez inséré n'a pas obtenu le consentement des utilisateurs.
Lorsqu'elle est utilisée dans un tag VAST et que le fournisseur tiers ne dispose pas du consentement de l'utilisateur, cette macro n'est pas remplacée.
La macro ${GDPR_CONSENT_XXXX} ne doit apparaître qu'une seule fois dans l'URL. Contactez votre fournisseur de créations tiers pour connaître ses exigences en termes de transmission de la chaîne TC et les restrictions de longueur des URL. La macro sera remplacée par la chaîne TC complète et non modifiée dans les demandes appropriées de la version 2.0 du Transparency and Consent Framework (TCF) de l'IAB.
Les macros TCF ne se développent pas lorsqu'elles sont intégrées au code HTML d'une création HTML5. Seules les créations de type display en redirect et display personnalisé sont compatibles avec les macros TCF expand, via les champs "URL tierce" et "Code HTML", respectivement.
| Macro |
|---|
${ADDTL_CONSENT} |
Cette macro est remplacée par la chaîne de consentement supplémentaire associée à la demande d'annonces.
| Macro |
|---|
%%TFUA%% |
Cette macro est remplacée par la valeur 1 pour ajouter un tag à la demande pour les utilisateurs de l'EEE et du Royaume-Uni n'ayant pas atteint l'âge de consentement.
Macros de vidéo
Ces macros sont généralement utilisées dans les créations vidéo pour inclure des informations sur le contexte ou le contenu.
Durée de l'annonce vidéo (en millisecondes)| Macro |
|---|
%%VIDEO_AD_DURATION%% |
Cette macro est remplacée par la durée de l'annonce vidéo en millisecondes. Pour les redirections/wrappers VAST, la macro est remplacée par la durée déclarée de l'annonce dans Ad Manager.
| Macro | Échappement |
|---|---|
%%DESCRIPTION_URL_UNESC%% |
Sans échappement |
%%DESCRIPTION_URL_ESC%% |
Un échappement |
%%DESCRIPTION_URL_ESC_ESC%% |
Deux échappements |
Si la macro se trouve dans une URL, utilisez %%DESCRIPTION_URL_ESC%% (un échappement). Dans les autres cas de figure, utilisez %%DESCRIPTION_URL_UNESC%% (sans échappement). En savoir plus sur les macros avec et sans échappement
Dans les tags d'emplacement publicitaire de redirection, ces macros sont remplacées par le paramètre de l'URL de description correspondant au paramètre de requête description_url du tag Google Publisher Tag d'origine. Généralement, l'URL de description doit être identique à l'URL de provenance. Vous devez spécifier le paramètre description_url dans le tag Google Publisher Tag dans les cas où le SDK IMA risque de ne pas détecter correctement l'URL de la page, ou si vous utilisez une vidéo dans Ad Exchange ou AdSense pour les vidéos.
%%DESCRIPTION_URL%%, qui correspond exactement à %%DESCRIPTION_URL_UNESC%%. Vous n'avez donc pas besoin de recoder les anciennes créations ni les anciens modèles.| Macro | Échappement |
|---|---|
%%REFERRER_URL_UNESC%% |
Sans échappement |
%%REFERRER_URL_ESC%% |
Un échappement |
%%REFERRER_URL_ESC_ESC%% |
Deux échappements |
Si la macro se trouve dans une URL, utilisez %%REFERRER_URL_ESC%% (un échappement). Dans les autres cas, utilisez %%REFERRER_URL_UNESC%% (sans échappement). En savoir plus sur les macros d'URL avec et sans échappement
Cette macro est remplacée par l'URL de provenance (URL de la page sur laquelle se situe le lecteur vidéo) dans les tags d'emplacement publicitaire de redirection. En voici le fonctionnement : Ad Manager analyse le paramètre de requête d'URL du tag d'emplacement publicitaire, isole l'URL de provenance et remplace le texte de la macro par cette URL. Elle ne fonctionne qu'avec le SDK IMA de Google, avec les caractéristiques suivantes :
- L'accès au script doit être activé sur la page pour que la macro fonctionne.
- La macro ne doit pas être incluse dans un cadre iFrame.
%%REFERRER_URL%%, qui correspond exactement à %%REFERRER_URL_UNESC%%. Vous n'avez donc pas besoin de recoder vos anciennes créations ni vos anciens modèles.Macros de contenu vidéo
Ces macros sont utilisées pour les annonces qui ciblent les sources de contenu vidéo.
| Macro |
|---|
%%VIDEO_DURATION%% |
Cette macro est remplacée par la durée de la vidéo en millisecondes.
| Macro |
|---|
%%VIDEO_ID%% |
Cette macro est remplacée par l'ID du contenu vidéo en cours de lecture. Il s'agit de l'ID unique du CMS ou de la valeur dfpvideo:ContentID de l'élément MRSS des solutions vidéo.
| Macro |
|---|
%%VIDEO_METADATA:key%% |
Cette macro est remplacée par les métadonnées relatives à la vidéo où la création est diffusée, selon les clé-valeurs associées au contenu vidéo. Les clé-valeurs sont définies dans l'onglet "Vidéo" d'Ad Manager.
Une fois qu'une clé de métadonnées de vidéo a été ciblée, elle peut être développée par la macro de métadonnées de vidéo. La "clé" utilisée dans la macro doit comprendre des caractères alphanumériques ou un trait de soulignement (_).
| Macro | Échappement |
|---|---|
%%VIDEO_TITLE%% |
Un échappement |
Cette macro est remplacée par le titre d'une vidéo tel qu'il est défini dans Ad Manager.
L'ingestion du contenu est obligatoire pour que cette macro fonctionne.
| Macro |
|---|
%%CMS_ID%% |
L'ID de la source du contenu permet de cibler la publicité vidéo.
Les paramètres d'ID vidéo et d'ID de source du contenu acceptent des valeurs variables.
Pour cibler du contenu vidéo avec des annonces, votre tag vidéo maître doit inclure ces paramètres simultanément.
Le paramètre cmsid est un numéro unique attribué à chaque source de contenu. Pour le repérer dans Ad Manager, cliquez sur Sources de contenu vidéo, puis sur le nom de la source. Découvrez comment ingérer du contenu vidéo à l'aide de flux Media RSS (MRSS).
Le paramètre vid est une chaîne ou un numéro qui identifie une vidéo spécifique. Cet identifiant est attribué par le système de gestion de contenu qui héberge votre contenu. Pour le repérer dans Ad Manager, cliquez sur Contenu vidéo, puis sur le contenu vidéo spécifique.
cmsid=[valeur]&vid=[valeur]Si vous créez un tag pour l'insertion dynamique d'annonces avec vidéo à la demande, il est conseillé d'utiliser les macros qui insèrent dynamiquement la source de contenu et l'ID vidéo appropriés.
cmsid=%%CMS_ID%%&vid=%%VIDEO_ID%%| Macro |
|---|
%%FW_CAID%% |
Cette macro est remplacée par l'ID d'annonce personnalisée FreeWheel.
Cette macro n'est valable que pour les éditeurs qui utilisent FreeWheel pour diffuser des annonces vidéo.
| Macro |
|---|
%%IAB_CATEGORIES%% |
Cette macro permet de transmettre des catégories d'annonces pour les créations que vous avez classées manuellement à l'aide de libellés. Elle renvoie une liste d'éléments séparés par une virgule qui répertorie des catégories IAB standards applicables (converties à partir de catégories Google classées).
La macro peut être utilisée par les éditeurs qui partagent un inventaire vidéo avec FreeWheel et souhaitent transmettre des catégories d'annonces en tant que paramètres personnalisés. Par exemple, vous pouvez ajouter &iab_categories=%%IAB_CATEGORIES%% à votre tag de redirection VAST.
