Macros

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 :

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>

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%%).

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.

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.

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.

%%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 :

1. 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");
2. 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%%.
3. L'intégralité de la macro %%PATTERN:gender%% va être remplacée par male.
4. 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();

%%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.

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 :

• pmad
• pmxd
• pmnd
• correlator
• scor
• pod
• vpos
• mridx
• ppos
• lip
• us_privacy

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.

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 par 1.

• 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.

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.

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.

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.

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.

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%%

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.

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.

1. Prévisualisez la création.
2. 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.

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.

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 ?

1. Dans Ad Manager, l'éditeur inclut les macros dans ses URL de suivi et/ou de création.

2. 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é.

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.

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>

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.

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.

Cette macro est remplacée par la valeur gdpr= associée à la demande d'annonce.

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.

Cette macro est remplacée par la chaîne de consentement supplémentaire associée à la demande d'annonces.

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.

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.

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.

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.

Cette macro est remplacée par la durée de la vidéo en millisecondes.

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. 

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 (_).

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. 

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.

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. 

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.

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.