Macros de destination définies destination-macros-defined

Décrit les macros que vous pouvez ajouter à une destination URL.

Lors de la création d’une destination URL, vous pouvez insérer les macros suivantes dans la chaîne URL. Vérifiez auprès de votre partenaire de données/destination le positionnement correct des macros dans la destination URL.

NOTE
Les macros sont facultatives, sauf indication contraire. Le format italique indique un espace réservé variable.
Macro
Description
%alias%

Obligatoire.

Définit l’emplacement de la valeur de segment mappée dans une URL de destination. Il s’agit généralement de l’ identifiant de segment, mais il peut également s’agir du code d’intégration.

%did%
Insère l’ID de l’Audience Manager de l’utilisateur dans l’URL de destination.
%dpid_data source id%

L’ identifiant de source de données correspond à l’identifiant d’une source de données transmise à la macro.

Regardons comment cela fonctionne dans un exemple simple. Dans ce cas, nous avons un partenaire Audience Manager avec les identifiants et conditions suivants :

  • ID de source de données : 1
  • Un ID client interne : CustomerABC
  • Declared ID : le partenaire souhaite transmettre ces valeurs comme identifiant déclaré 1:CustomerABC.

Pour ce faire avec %dpid_data source id%, le partenaire Audience Manager formate la macro comme suit :

  • %dpid_1%

La macro remplacera 1 par CustomerABC.

${GDPR}
Indique si les règlements RGPD s’appliquent ou non au visiteur. Utilisez cette macro pour inclure le consentement dans les segments envoyés aux destinations d’URL intégrées à l’IAB. Voir Module d’Audience Manager pour IAB TCF pour plus d’informations.
${GDPR_CONSENT_XXXX}
Chaîne de consentement (y compris l’ID de fournisseur de l’IAB) collectée lorsque les visiteurs fournissent ou refusent le consentement sur votre site. Utilisez cette macro pour inclure la chaîne de consentement dans les segments envoyés aux destinations d’URL intégrées à l’IAB. Remplacez XXXX par l’ID de partenaire de destination. Voir Module d’Audience Manager pour IAB TCF pour plus d’informations.
%http_proto%

Détecte le protocole utilisé dans la page web parente et l'insère dans l'URL de destination. Par exemple :

  • si la page web est https://aam_client.com, cette macro sera remplacée par https://url-destination.com
  • si la page web est http://aam_client.com, cette macro sera remplacée par http://url-destination.com
%mcid%
Insère l’ID Experience Cloud dans l’URL de destination.
%region%
Insère la région Data Collection Server (DCS) dans l’URL de destination. Afin de minimiser la latence, lorsque le visiteur effectue un appel HTTP vers l’Audience Manager , il est redirigé vers le centre de données DCS le plus proche. Pour ce faire, vous devez utiliser le DNS, qui permet de détecter l’emplacement du visiteur et de le diriger vers le centre de données approprié.
%rnd%
Exécute une fonction de contournement de la mémoire cache en insérant un nombre aléatoire dans l’URL de destination. Cela empêche les navigateurs de diffuser du contenu mis en cache.
%timestamp%
Insère un horodatage UNIX dans l’URL de destination afin d’empêcher les navigateurs de diffuser du contenu mis en cache.

Mise en cache avec les macros de destination destination-cache-busting

Les macros %rnd% et %timestamp% insèrent des valeurs uniques dans une chaîne URL afin d’empêcher la mise en cache du navigateur.

Mise en cache avec %rnd% et %timestamp% dest-cache-busting

Les navigateurs mettent en cache (enregistrent) le contenu fréquemment demandé en mémoire. Lorsqu’une page se charge, le contenu enregistré est diffusé à partir du cache plutôt qu’à partir d’un serveur distant. Ce processus permet de conserver des temps de téléchargement efficaces, car les données sont diffusées localement plutôt qu’à partir d’un autre emplacement. Cependant, comme la mise en cache ne nécessite pas d’appel au serveur, elle peut fausser la création de rapports en réduisant artificiellement le nombre de requêtes uniques.

La suppression de la mémoire cache empêche les navigateurs d’enregistrer et de réutiliser du contenu. Cette technique utilise du code qui insère un nombre aléatoire ou un horodatage dans une chaîne d’URL, ce qui la rend unique au navigateur. Par conséquent, chaque appel HTTP est comptabilisé comme une requête distincte au serveur. L’obligation d’un nouvel appel au serveur pour chaque requête permet de maintenir la précision des rapports et de réduire les incohérences. Audience Manager fournit deux macros pour la mise en mémoire cache :

  • %rnd% : insère un nombre aléatoire dans une URL.
  • %timestamp% : insère la date/l’heure Unix dans une URL.

Comparaison de %rnd% et %timestamp% compare-rnd-timestamp

Les deux macros empêchent la mise en cache, mais %rnd% peut être plus efficace. Par exemple, avec %timestamp%, si plusieurs utilisateurs affichent une page simultanément, ils obtiendront la même valeur de date/heure. Par conséquent, URL n’est pas unique et plusieurs appels sont comptabilisés une seule fois. Cependant, %rnd% génère une valeur numérique unique pour chaque appel (même si les utilisateurs voient simultanément la même page). Cela signifie que la chaîne URL contient des valeurs différentes et est comptabilisée comme unique.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695