Macros pour créations personnalisées

Découvrez comment utiliser des macros avec et sans échappement.

Expertise technique

Cet article s'adresse aux utilisateurs qui développent des créations personnalisées et nécessite des connaissances techniques.

Si vous êtes trafficker et que vous devez associer une création personnalisée à un élément de campagne alors que vous ne possédez pas l'expertise technique requise pour résoudre les problèmes liés à ce type de créations, nous vous conseillons de faire appel à une personne qualifiée. Il peut s'agir d'un collègue qui a conçu la création personnalisée dans Ad Manager ou d'un employé d'une agence publicitaire qui vous fournit le code utilisé dans la création.

Les macros peuvent être ajoutées aux créations personnalisées à des fins diverses. Elles servent essentiellement d'espaces réservés pour des URL de destination et des URL de suivi des clics. Il en existe de plusieurs types : sans échappement, avec un échappement et avec deux échappements.

L'échappement consiste à utiliser un caractère (ou une série de caractères) pour représenter un autre caractère. Les URL ne peuvent être transmises sur Internet que via le jeu de caractères ASCII. Il est toutefois possible d'inclure d'autres caractères dans les URL. Pour être interprétés correctement, ils devront être encodés lors de la transmission.

Pour développer des créations personnalisées, vous devez ajouter dans le code de la création un ou plusieurs des éléments suivants :

  • URL de suivi des clics sans échappement : %%CLICK_URL_UNESC%%
  • URL de suivi des clics avec échappement : %%CLICK_URL_ESC%%
  • URL de destination sans échappement : %%DEST_URL%%
  • URL de destination avec échappement : %%DEST_URL_ESC%%
  • Macro d'URL de destination avec deux échappements : %%DEST_URL_ESC_ESC%%

Pour que les clics soient suivis ou que les utilisateurs puissent accéder à l'URL de destination, vous devez utiliser la variante appropriée. Dans le cas contraire, il se peut que le suivi des clics échoue ou que les utilisateurs n'atteignent pas l'URL de destination. 

Si les URL de destination et les URL de suivi des clics sont obligatoires, vous devez également vous assurer de sélectionner les bonnes macros, en prenant soin de les séquencer ou de les "imbriquer" correctement.

Cet article contient des exemples d'utilisation correcte et incorrecte des macros d'URL de destination et de suivi des clics, et explique comment les associer.

Exemples d'insertion de macro

Vous trouverez ci-dessous un exemple d'URL de suivi des clics sans échappement dans Campaign Manager 360. Les paramètres ont été supprimés ou raccourcis pour plus de clarté :

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=

Comparez cette URL avec sa version avec échappement :

http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253D

Ici, les caractères réservés ont fait l'objet de deux échappements à l'aide de l'encodage avec le signe de pourcentage. Par exemple, les points d'interrogation (?) sont toujours représentés par la série de caractères %253F, tandis que les signes égal (=) sont toujours représentés par la série de caractères %253D.

Exemple 1A — Correct : suivi des clics Ad Manager pour une création personnalisée

Dans cet exemple, supposons que vous disposiez d'une création personnalisée qui redirige vers l'adresse suivante :

http://www.google.com/page.html?param1=red&param2=blue

Une création illustrée peut effectuer le suivi des clics comme suit :

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Dans cet exemple, la création s'affiche de cette façon dans le navigateur de l'utilisateur :

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Il s'agit d'une URL de suivi des clics valide et correcte, puisque l'URL de suivi des clics Ad Manager ne présente pas d'échappement, tandis que l'URL de destination est correctement échappée.

Exemple 1B — Incorrect : suivi des clics Ad Manager pour une création personnalisée

L'utilisation de la macro d'URL de suivi des clics avec échappement est une erreur courante, qui aurait pour conséquence d'empêcher l'exécution du code de la création de l'exemple précédent. Le code de la création se présente alors comme suit :

<a href='%%CLICK_URL_ESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Dans le navigateur de l'utilisateur, la création s'affiche de cette façon :

<a href='http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Ce code est incorrect, car un échappement est appliqué à tous les paramètres. Le serveur adclick ne peut donc pas les analyser correctement. Au lieu de cela, il interprète ce code comme une demande pour une page nommée : /aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue

Comme cette page n'existe pas, le serveur adclick renvoie une erreur HTTP 404 (page non trouvée) et l'internaute n'est pas redirigé vers la page de destination de l'annonce.

Exemple 1C — Incorrect : suivi des clics Ad Manager pour une création personnalisée

Une autre erreur courante consiste à utiliser la macro d'URL de destination sans échappement. Le code de la création se présente alors comme suit :

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_UNESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Dans le navigateur de l'utilisateur, la création s'affiche de cette façon :

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Remarque : Il est possible que cet exemple fonctionne correctement si le premier serveur de clic est suffisamment sophistiqué pour interpréter les paramètres restants comme des URL et pour leur appliquer un échappement. Dans ce cas précis, Ad Manager est en mesure d'effectuer cette procédure et de rediriger l'utilisateur. Toutefois, il serait risqué de partir du principe que le serveur sera capable de gérer les URL de suivi des clics dont le format est incorrect. Nous vous recommandons fortement d'utiliser une URL de suivi des clics correctement formatée, au lieu de compter sur Ad Manager ou sur un serveur d'analyse tiers pour interpréter les URL comportant des erreurs.

Si le serveur ne corrige pas l'URL mal formatée, celle-ci est interprétée de la façon suivante :

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue

Dans ce cas, le caractère final "&" est interprété comme délimiteur d'un nouveau paramètre pour la PREMIÈRE demande serveur, alors qu'il s'agit d'un paramètre devant être transmis au serveur qui héberge la page de destination de l'annonce. Cette erreur d'interprétation peut modifier la façon dont le serveur de clic traite l'URL de clic et empêcher la redirection de l'internaute vers la page de destination. Même si l'internaute a bien été redirigé, il est probable que le second paramètre (param2) ne soit pas transmis à la page de destination.

Exemple 2A – Correct : macros et outils de suivi des clics tiers

Les annonceurs peuvent vous demander d'inclure un outil de suivi des clics tiers pour leur création. Cet outil comptabilise les clics sur une création de façon indépendante. Il est utile lorsque l'annonceur souhaite effectuer un audit ou un rapprochement.

En général, l'outil de suivi des clics se présente sous la forme d'un formulaire ou d'une URL. Voici un exemple pour Campaign Manager 360 :

http://ad.doubleclick.net/clk;a;b;c?[URL de destination][URL de destination]

L'URL (ad.doubleclick.net) désigne le serveur qui enregistre l'impression ou le clic. Les autres URL tierces sont similaires. L'URL de destination doit être représentée par deux macros :

  • Macro de clic avec échappement : %%CLICK_URL_ESC%%
  • Macro d'URL de destination avec deux échappements : %%DEST_URL_ESC_ESC%%

Ces deux macros représentent la même URL de destination et doivent être ajoutées après le point d'interrogation (?). Voici un exemple de création illustrée avec une URL de suivi des clics Campaign Manager 360 :

<a href='http://ad.doubleclick.net/clk;a;b;c?%%CLICK_URL_ESC%%%%DEST_URL_ESC_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Lorsque vous utilisez un modèle de création, le suivi des clics tiers est habituellement représenté sous forme d'identifiant d'espace réservé d'URL dans le code de la création. Lorsque la création s'affiche dans le navigateur de l'utilisateur, les macros sont remplacées par la valeur prévue. Exemple :

<a href='http://ad.doubleclick.net/clk;a;b;c?http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/page.html%253Fparam1%253Dred%2526param2%253Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Prévisualiser les créations et tester les macros

Tester les créations permet de s'assurer qu'elles se comportent comme prévu. Étant donné que les macros sont des espaces réservés et que le code est parfois complexe, la meilleure façon de tester une création personnalisée consiste à la prévisualiser à partir de l'élément de campagne. Pour ce faire, procédez comme suit :

  1. Ouvrez la création dans une nouvelle fenêtre.

    Le code JavaScript ne fonctionne pas dans l'aperçu disponible directement dans Ad Manager. En outre, les macros ne peuvent pas être affichées dans leur version développée.

  2. Inspectez les éléments et le DOM à l'aide des outils pour les développeurs de votre navigateur ("Outils de développement").

Valider les macros de suivi des clics

Une fois les macros correctement insérées, un clic sur la création dans l'aperçu permet d'accéder à une page de destination Ad Manager. Cette page confirme que le clic a bien été suivi. Vous êtes alors redirigé vers la page de l'URL de destination associée à la création.

Si l'une de ces situations ne se produit pas, il y a un problème avec les macros ou la façon dont elles sont imbriquées. 

Valider les macros d'affichage

Vous devez utiliser un analyseur de trafic pour valider les macros de suivi des impressions. Cet outil permet d'afficher et de capturer les requêtes HTTP. Ce type d'outil figure parfois dans les outils pour les développeurs fournis par le navigateur. Des analyseurs de trafic tiers sont également disponibles.

À l'aide d'un analyseur de trafic, inspectez les requêtes HTTP lors du chargement de la création. Recherchez une requête ou un "ping" qui a abouti vers le serveur qui enregistre l'impression. Notez les erreurs éventuellement renvoyées par les requêtes HTTP.

  • Si vous ne détectez aucune erreur et qu'un ping vers le serveur qui enregistre l'impression a abouti, les macros ont été correctement configurées.
  • En cas d'erreur, revenez au code source de votre création personnalisée pour résoudre le problème. Un code d'erreur courant lorsque les macros sont placées de manière incorrecte est HTTP 204.

Ces informations vous-ont elles été utiles ?

Comment pouvons-nous l'améliorer ?
true
Notes de version

Découvrez les dernières fonctionnalités d'Ad Manager et les mises à jour du centre d'aide.

Nouveautés

Recherche
Effacer la recherche
Fermer le champ de recherche
Menu principal
11611152848314821039
true
Rechercher dans le centre d'aide
true
true
true
true
true
148
false
false