Macros Campaign Manager 360

Présentation des macros

En quoi consistent les macros Campaign Manager 360 ?

Les macros Campaign Manager 360 sont de brèves commandes auxquelles l'ad server Campaign Manager 360 substitue les valeurs correspondantes telles que des mots clés, des noms clés de site ou des URL. Certaines macros facilitent l'enregistrement des informations dans les rapports, tandis que d'autres déterminent l'annonce devant être diffusée ou la page vers laquelle l'internaute est redirigé après avoir cliqué sur l'annonce. La plupart des macros se réduisent à quelques caractères, ce qui les rend très faciles à intégrer dans vos tags.

Vous pouvez ajouter des macros Campaign Manager 360 dans divers contextes : dans une URL de page de destination, un tag de suivi des clics, une URL de redirection, le code HTML d'une création, un en-tête de cadre ou une balise Floodlight. La macro peut être remplacée par sa valeur une fois l'annonce diffusée ou après le déclenchement d'autres événements, tels qu'un appel Floodlight. Elle peut aussi se développer de manière dynamique, avec des informations utilisateur spécifiques. Le mode de développement dépend du type et de l'emplacement de la macro utilisée.

Les macros ne fonctionnent pas toutes dans tous les contextes. Si vous intégrez une macro dans une source incompatible, l'ad server Campaign Manager 360 risque de ne pas la développer correctement. Le tableau ci-dessous répertorie toutes les macros disponibles et les sources acceptées par chacune d'elles. Par exemple, les ad servers Campaign Manager 360 développent la macro %g si vous l'insérez dans l'URL de vos pages de destination. En revanche, ils ne la développent pas si vous l'insérez dans un tag de suivi des clics.

Informations générales

• Les macros Campaign Manager 360 sont sensibles à la casse. Vous devez toujours les saisir en minuscules. Par exemple, %c est une macro valide, contrairement à %C.

• Vous pouvez utiliser des séparateurs entre les macros, mais ce n'est pas obligatoire. Dans ce cas, utilisez une virgule (,) ou une barre verticale (|). Évitez les autres séparateurs, sauf si vous êtes un trafficker expérimenté, car certains d'entre eux peuvent engendrer des problèmes lorsqu'ils sont utilisés dans un contexte inapproprié.

• Pour modifier des macros dans les URL de suivi de fournisseurs, utilisez des tags d'événement. Voici le processus de base :

  • Commencez par créer un tag d'événement dans Campaign Manager 360. Puis, ajoutez l'URL de suivi du fournisseur au tag d'événement. Il peut s'agir d'une URL de suivi des clics, d'un pixel d'impression ou d'une URL de sondage. Vous pouvez facilement ajouter des macros à une URL de suivi, ou les supprimer, dans les propriétés du tag d'événement au sein de Campaign Manager 360.

  • Une fois que le tag d'événement est prêt, vous pouvez l'appliquer à vos annonces. L'URL de suivi du tag d'événement sera utilisée par vos annonces lors de leur diffusion. Avec Campaign Manager 360, vous pouvez facilement appliquer votre tag d'événement à plusieurs annonces à la fois. Par exemple, vous pouvez configurer le tag d'événement pour qu'il s'applique automatiquement à toutes les annonces de votre campagne. Pour commencer, suivez les instructions détaillées dans le guide sur les tags d'événement.

• La seule version de la macro de développement qui fonctionne dans les balises Floodlight est %ers!. En savoir plus

Types de macros

%c – Macro de chaîne de clic

La macro %c devient la chaîne de clic Campaign Manager 360 de l'URL de la page de destination de votre création. Une chaîne de clic est une partie d'une URL de la page de destination, qui redirige votre navigateur vers les ad servers Campaign Manager 360.

Utilisez la macro %c_esc au lieu de la macro %c si vous avez besoin d'utiliser une version échappée de la chaîne de clic dans une création personnalisée. Les chaînes de clic Campaign Manager 360 utilisent des esperluettes (&), ce qui peut poser des problèmes avec certains serveurs tiers.

Notez que la macro %c ne permet pas d'inclure des tags d'événement de clic pour les créations display personnalisées. 

Fonctionnement des chaînes de clic : lorsqu'un internaute clique sur une création, le navigateur est redirigé vers l'URL de la page de destination. La chaîne de clic permet de rediriger le navigateur vers les ad servers Campaign Manager 360 avant de le renvoyer vers la page de destination de l'annonceur. La chaîne de clic est ajoutée automatiquement à l'URL de destination au moment de chaque impression dans Campaign Manager 360.

Si vous ajoutez manuellement une URL de page de destination au code HTML d'une création personnalisée, vous devrez peut-être ajouter la macro %c pour vous assurer que les clics redirigent vers les ad servers Campaign Manager 360. Vous pouvez également ajouter la macro %u (macro de page de destination) pour développer à la fois la chaîne de clic et l'URL de la page de destination : %c%u génère une URL de page de destination complète.

Marche à suivre. Voici un exemple de chaîne de clic :

Pour ajouter une chaîne de clic à l'URL de la page de destination d'une création personnalisée, positionnez la macro %c au début de cette URL dans le code de la création, comme dans cet exemple :

Lorsqu'un ad server diffuse une création, la macro %c est remplacée par la chaîne de clic. Voici comment l'URL de la page de destination ci-dessus peut se présenter après l'application de la macro %c :

Comme vous pouvez le constater, la macro %c a été remplacée par la chaîne de clic au début de l'URL de la page de destination, formant ainsi une URL de création complète.

Pour insérer l'URL complète de la création, combinez la macro %c avec la macro %u (URL de la page de destination) : <a href="%c%u">. Les deux macros se développent alors pour donner l'URL de création complète.

Par exemple, si vous insérez <a href="%c%u"> dans le code HTML, l'URL suivante pourrait être générée :

Lorsque la macro %u est remplacée par l'URL de la page de destination, toutes les autres macros de cette URL sont également converties de manière automatique, y compris la macro %c.

%e – Macro de développement

La macro %e peut devenir l'identifiant de diverses propriétés d'une création. Ajoutez un accesseur à la suite de la macro afin d'indiquer en quel ID la macro doit se transformer, et définissez ainsi la propriété de création dont vous voulez effectuer le suivi. La liste des accesseurs est présentée ci-après.

Aidez-vous des tableaux de correspondance pour définir les identifiants et leur associer des propriétés de création : les identifiants sont liés aux descriptions fournies dans Campaign Manager 360 (et dans votre propre base de données interne). Ces ID facilitent le suivi des différentes propriétés de vos créations via les ad servers Campaign Manager 360.

Les balises Floodlight ne sont compatibles qu'avec une seule version de la macro de développement : %ers!. Elles ne sont compatibles avec aucun autre type de macro %e. Notez que %ers! fonctionne là où la macro de développement est compatible (référez-vous au tableau ci-dessous).

Si vous utilisez des annonces de suivi au niveau de l'inventaire d'applications mobiles, ainsi qu'une page de destination statique, la macro %e ne sera pas remplacée correctement.

Une URL de page de destination peut contenir autant de macros %e que nécessaire. Voici un exemple d'URL de page de destination avec trois macros %e :

%g – Macro de données géographiques

La macro %g fournit des informations géographiques relatives à une demande d'annonce. Elle permet d'indiquer, de manière dynamique, l'emplacement des internautes dans les créations standards, personnalisées et rich media. La macro %g se transforme en une chaîne de clé-valeurs reflétant certaines informations telles que l'abréviation du pays, l'abréviation régionale, la ville, le code postal, la zone de marché désignée (DMA^®) et la bande passante de la connexion Internet. Ces informations vous sont transmises par les ad servers Campaign Manager 360.

Par exemple, la macro %g peut se développer comme suit pour un internaute résidant à New York :

%h – Macro de serveur des créations

La macro %h est remplacée par le nom d'hôte du serveur qui diffuse une création. Il n'est donc plus nécessaire de coder en dur le nom d'hôte dans votre tag. Comme le nom d'hôte varie, la macro se développe de manière dynamique pour chaque création.

Ajoutez la macro %h au début de l'URL contenue dans votre tag, comme dans ce tag d'image, où "123456" est un espace réservé pour la référence annonceur :

%i – Macro d'impression

La macro %i est remplacée par une chaîne d'impression qui permet à l'ad server Campaign Manager 360 d'effectuer le suivi des impressions associées à une annonce interstitielle au moment de l'impression.

Ajoutez la macro %i au début de l'URL contenue dans votre tag, comme dans cet exemple :

La macro %i doit être utilisée dans toutes les annonces interstitielles, car elle permet à l'ad server Campaign Manager 360 de déterminer à quel moment l'impression de l'interstitiel a effectivement lieu.

%k – Macro de mot clé

La macro %k est remplacée par une sous-chaîne contenue dans les tags d'emplacement publicitaire (en particulier, dans l'URL de demande). Cette macro permet d'afficher les mots clés saisis par l'internaute dans les créations.

Par ailleurs, elle facilite les achats de plusieurs mots clés : elle est remplacée par l'un des mots clés associés à une création spécifique, sur la base du mot clé saisi par l'internaute. À titre d'exemple, voyons de quelle façon la macro %k aide un annonceur à acheter les deux mots clés car insurance (assurance auto) et car loans (prêt auto). Lorsqu'un internaute recherche car insurance, la création contenant cette macro affiche Click Here for Car Insurance ("Cliquez ici pour une assurance auto"). S'il recherche car loans, la même création affiche Click Here for Car Loans ("Cliquez ici pour un prêt auto").

Utilisez une paire valeur/clé pour désigner la sous-chaîne en laquelle la macro doit se transformer. Une paire clé-valeur se compose d'une clé (start_key_string) et d'une valeur correspondante (end_character).

Ajoutez la macro et la paire clé-valeur dans l'ordre suivant : la macro, la première valeur, un point d'exclamation (!) et la deuxième valeur. Le format est le suivant :

La macro %k capture une sous-chaîne désignée par ces paramètres. Elle recherche le mot clé indiqué qui va la remplacer. Vous pouvez insérer la paire clé-valeur dans un tag Campaign Manager 360 ad ou jump.

La macro %k permet également de supprimer la protection des caractères échappés. Lorsque la macro transmet une sous-chaîne au code HTML d'une création, tous les caractères échappés de la sous-chaîne capturée sont automatiquement remplacés par leurs jeux de caractères d'origine. Exemple :

Pour afficher car insurance dans la création, vous devez déchiffrer le caractère échappé +. L'annonceur ajoute donc %k dans le code de la création. L'ad server capture la sous-chaîne kw=car+insurance, décode le caractère +, puis affiche car insurance (assurance auto) dans la création.

Le code se présente maintenant comme suit :

Notez que les macros %k et %p se ressemblent en ce sens qu'elles capturent toutes les deux une sous-chaîne désignée par start_key_string, mais qu'elles diffèrent sur le plan de la transmission de la sous-chaîne. La macro %k transmet la sous-chaîne au code HTML d'une création, alors que la macro %p la transmet à l'URL. Contrairement à la macro %p, la macro %k ne fonctionne que dans le code HTML d'une création.

%m – Macro de code de correspondance

La macro %m est remplacée par la valeur du cookie DoubleClick de l'internaute qui clique sur la création, si les cookies sont autorisés dans les paramètres du navigateur. Cette macro permet notamment de générer une liste d'ID utilisateur, puis de recibler les internautes ayant précédemment interagi avec la création. L'ID utilisateur est chiffré avec la clé de chiffrement de l'ID d'annonceur. Pour en savoir plus sur le chiffrement de l'ID utilisateur, accédez à votre compte Campaign Manager 360.

Vous pouvez insérer la macro dans l'URL de la page de destination, l'URL de redirection, le code de la création ou un tracker de clics codé en dur comme ad.doubleclick.net/clk. Le cookie DoubleClick est un entier de 64 bits comportant jusqu'à 20 caractères.

Les ad servers ne développent pas la macro %m dans une création, mais dans la chaîne de clic qui suit un événement de clic.

• Si un internaute désactive les cookies de son navigateur ou a choisi de ne pas recevoir de cookies, l'ad server développe %m en 0.
• Dans le code de création, la macro %m reste sans effet pour les navigateurs situés derrière un proxy. Dans ce cas, l'ad server remplace également la macro %m par 0.

%n – Macro de nombre aléatoire

La macro %n est remplacée par un nombre aléatoire. Les nombres aléatoires empêchent les navigateurs de mettre en cache une URL. Lorsque l'annonce est diffusée, les ad servers génèrent un nombre aléatoire de façon dynamique et l'ajoutent dans l'URL à la place de %n. Étant donné qu'un nouveau nombre aléatoire est transmis à l'URL à chaque diffusion de l'annonce, le navigateur ne peut pas charger une version mise en cache de cette annonce. En contournant la mise en cache, vous évitez que les serveurs tiers sous-évaluent le nombre d'impressions.

La macro %n est souvent utilisée côté éditeur lorsque Campaign Manager 360 doit rediriger l'utilisateur vers un tiers pour une création. Les tiers possèdent généralement leur propre syntaxe de nombre aléatoire, semblable à la syntaxe ord=[nombre_aléatoire]? utilisée par Campaign Manager 360.

En outre, la macro %n permet aux tiers d'effectuer le suivi de chaque clic séparément, du fait que chaque clic d'un internaute génère un nombre aléatoire unique à la place de la macro %n. Les traffickers doivent vérifier auprès du tiers qu'il accepte la chaîne de caractères supplémentaire générée par la macro.

%p – Macro de correspondance de structure

La macro %p est remplacée par une sous-chaîne extraite de l'URL de demande de vos tags d'emplacement publicitaire : lorsque l'annonce est diffusée, la macro est remplacée par la valeur qui se trouve entre la chaîne de départ et le caractère final.

Pour désigner la sous-chaîne : utilisez une paire clé-valeur pour définir le début et la fin du type de sous-chaîne que vous souhaitez faire rechercher par le serveur. Une paire clé-valeur se compose de deux clé-valeurs, à savoir une valeur start_key_string et une valeur end_character.

• [start_key_string] : en tant que partie clé d'une paire clé-valeur, elle doit être incluse dans les tags d'emplacement publicitaire. Elle est sensible à la casse et n'inclut pas les crochets d'espace réservé.

• [end_character] : caractère servant à indiquer la fin d'une clé-valeur. Si aucun caractère de fin n'est indiqué et si la chaîne de départ est la dernière clé-valeur d'un tag, l'ad server copie la chaîne complète. Chaque élément d'une clé-valeur peut être n'importe quelle chaîne de valeurs ASCII, mais doit comporter au moins deux caractères et ne pas inclure les crochets d'espace réservé.

Voici le format de base :

Généralement, la macro %p est utilisée pour être remplacée par un mot clé qui facilite le suivi des informations sur les rapports. Par exemple, si vous souhaitez obtenir le nom d'un modèle de voiture, vous devez insérer une macro %p dans le tag d'emplacement publicitaire, avec votre chaîne de départ (model=) et le caractère final choisi (ici, un point-virgule). Notez également que les crochets d'espace réservé ne sont pas inclus :

Lorsque votre annonce est diffusée, Campaign Manager 360 recherche model= dans les tags d'emplacement publicitaire, et capture tout ce qui se trouve entre model= et le caractère de fin (;). 

Voici quelques exemples d'utilisations courantes de la macro %p :

• Les annonceurs peuvent transmettre les valeurs ou les variables des balises Floodlight aux tags d'éditeur.

• Les éditeurs peuvent transmettre les valeurs de manière dynamique dans les URL de page de destination.

%s – Macro de nom clé de site

La macro %s se développe différemment selon que vous l'ajoutez à des tags d'emplacement publicitaire ou à des balises Floodlight.

• Les tags d'emplacement publicitaire sont remplacés par le nom clé du site DCM : lorsqu'un internaute clique sur une annonce diffusée par Campaign Manager 360, cette macro est remplacée par le nom clé du site sur lequel l'annonce a été diffusée. Ce nom clé doit correspondre au nom clé répertorié dans l'onglet "Propriétés" du site dans Campaign Manager 360 (Admin > Sites).

  Prenons l'exemple de cette URL, qui se termine par une macro %s :

  http://www.advertiser.com/cgi.bin/?%s

  Imaginons que cette URL soit intégrée à une annonce diffusée sur un site ayant le nom clé N255.010101.sandwiches. Lorsque l'internaute clique sur l'annonce, la macro est remplacée par N255.010101.sandwiches :

  http://www.advertiser.com/cgi.bin/?N255.010101.sandwiches

  Si aucune information sur le site n'est disponible en temps réel, la macro %s peut générer une chaîne vide.

• Les balises Floodlight se développent dans l'ID Campaign Manager 360 du site : lorsqu'une balise Floodlight se déclenche sur un site, la macro %s est remplacée par l'ID utilisé par Campaign Manager 360 pour identifier le site.

%u – Macro d'URL de page de destination

La macro %u est remplacée par l'URL de la page de destination d'une création. Par exemple, <a href="%u"> peut générer l'URL de page de destination suivante :

Pour ajouter directement l'URL de création complète, combinez la macro %u avec la macro %c. Les deux macros se développent pour former l'URL complète : %c (chaîne de clic) + %u (URL de la page destination) = une URL complète de création.

Par exemple, si vous insérez <a href="%c%u"> dans le code HTML, l'URL suivante pourrait être générée :

http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fwww.doubleclick.com%2Fpath%2Fpage.html