Jetons de réponse

Les jetons de réponse vous permettent de générer automatiquement des informations spécifiques à Target (détails de l’activité, informations sur les profils utilisateur, informations géographiques, etc.) à utiliser dans le débogage ou l’intégration à des systèmes tiers (tels que Clicktale).

Les jetons de réponse vous permettent de choisir les variables à exploiter, puis de les activer pour qu’elles soient envoyées dans le cadre d’une réponse de Cible. Pour ce faire, il vous suffit d'activer une variable à l'aide du commutateur et la variable sera envoyée avec des réponses de Cible, qui peuvent être validées dans les appels réseau. Les jetons de réponse fonctionnent également en mode Prévisualisation.

L’une des différences essentielles entre les modules externes et les jetons de réponse réside dans le fait que les modules externes fournissent du code JavaScript à la page qui s’exécute lors de la diffusion, tandis que les jetons de réponse diffusent un objet qui peut ensuite être lu et utilisé à l’aide de détecteurs d’événements. Pour plus d’informations, voir Événements personnalisés at.js et les exemples plus loin dans cet article. L’approche des jetons de réponse est plus sûre et devrait faciliter le développement et la maintenance des intégrations tierces.

REMARQUE

Les jetons de réponse sont disponibles avec at.js 1.1 ou version ultérieure. Ils ne sont pas pris en charge par mbox.js.

Bibliothèque Target utilisée Actions suggérées
at.js Assurez-vous que vous utilisez at.js version 1.1 ou ultérieure. Pour plus d’informations sur le téléchargement de la dernière version d’at.js, voir Télécharger at.js. Pour en savoir plus sur la nouvelle fonctionnalité de chaque version d’at.js, voir Informations détaillées sur les versions d’at.js.
Les clients utilisant at.js sont encouragés à utiliser les jetons de réponse et à ne plus utiliser les modules externes. Certains modules externes qui reposent sur des méthodes internes existant dans mbox.js, mais pas dans at.js, sont fournis mais échouent. Pour plus d’informations, voir Limites d’at.js.
mbox.js Les modules externes restent pris en charge et fournis lors de l’utilisation de mbox.js.
Cependant, les clients utilisant mbox.js et les modules externes sont invités à passer à at.js et aux jetons de réponse. Pour plus d’informations sur les avantages de l’utilisation d’at.js sur mbox.js, voir Questions fréquentes sur at.js. Pour plus d’informations sur la migration, voir Migration vers at.js à partir de mbox.js.
Après la mise hors service de Target Classic (novembre 2017), vous devrez peut-être contacter le service à la clientèle pour modifier ou désactiver les modules externes existants. Vous devez contrôler vos modules externes et désactiver les modules externes inutiles avant la mise hors service de Target Classic.
Vous ne pouvez pas créer de nouveaux plug-ins dans Target Standard/Premium. Vous devez, au lieu de cela, utiliser des jetons de réponse.
Les anciens modules externes SiteCatalyst doivent être désactivés et remplacés par Adobe Analytics en tant que source de création de rapports pour Adobe Target (A4T). Le module externe ttMeta doit être désactivé et remplacé par Adobe Experience Cloud Debugger.

Utilisation des jetons de réponse

  1. Assurez-vous que vous utilisez at.js version 1.1 ou ultérieure.

    Pour plus d’informations, voir Téléchargement d’at.js.

  2. Dans Target, cliquez sur Administration > Jetons de réponse.

  3. Activez les jetons de réponse souhaités, tels que activity.id, option.id, etc.

    Les paramètres suivants sont disponibles par défaut :

    Type Paramètre Remarques
    Profils intégrés profile.activeActivities Renvoie une multitude de activityIds pour lesquels le visiteur est qualifié. Elle s’incrémente lorsque les utilisateurs sont qualifiés. Par exemple, sur une page contenant deux demandes Target qui délivrent deux activités différentes, la deuxième demande comprend les deux activités.
    profile.isFirstSession Renvoie « true » ou « false ».
    profile.isNewSession Renvoie « true » ou « false ».
    profile.daysSinceLastVisit Renvoie le nombre de jours depuis la dernière visite du visiteur.
    profile.tntId Renvoie le tntID du visiteur.
    profile.marketingCloudVisitorId Renvoie l’identifiant visiteur Experience Cloud du visiteur.
    profile.thirdPartyId Renvoie l’identifiant tiers du visiteur.
    profile.categoryAffinity Renvoie la catégorie préférée du visiteur.
    profile.categoryAffinities Renvoie un tableau des 5 catégories favorites du visiteur sous la forme de chaînes.
    Activité activity.name
    activity.id
    experience.name
    experience.id
    option.name
    option.id
    Détails de l’activité en cours. Notez que « option » est égal à « offer ».
    Géo geo.country
    geo.state
    geo.city
    geo.zip
    geo.dma
    geo.domainName
    geo.ispName
    geo.connectionSpeed
    geo.mobileCarrier
    Pour plus d’informations sur l’utilisation du géociblage dans les activités, voir Géociblage.
    Méthode d’affectation du trafic
    (s’applique uniquement aux activités Cible automatique et Automated Personalization.)
    experience.trafficAllocationId Renvoie 0 si un visiteur a reçu une expérience provenant d’un trafic de "contrôle" et 1 si un visiteur a reçu une expérience provenant de la distribution de trafic "ciblée".
    experience.trafficAllocationType Retourne "contrôle" ou "ciblé".

    Les attributs de profil utilisateur et les attributs du client s’affichent également dans la liste.

    REMARQUE

    Les paramètres dotés de caractères spéciaux ne s’affichent pas dans la liste. Seuls les caractères alphanumériques et les traits de soulignement sont pris en charge.

  4. (Conditionnel) Si vous souhaitez utiliser un paramètre de profil comme jeton de réponse, mais que le paramètre n'a pas été transmis par le biais d'une requête Target et n'a donc pas été chargé dans l'interface utilisateur de la Cible, vous pouvez utiliser le bouton Ajouter le jeton de réponse pour ajouter le profil à l'interface utilisateur.

    Cliquez sur Ajouter le jeton de réponse, indiquez le nom du jeton, puis cliquez sur Activer.

  5. Créez une activité.

Utilisez les Événements personnalisés at.js pour écouter la réponse et lire les jetons de réponse.Target

L’échantillon de code suivant ajoute un gestionnaire d’événements personnalisés at.js directement dans la page HTML :

<html> 
  <head> 
    .... 
    <script src="at.js"></script> 
    <script> 
      document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
        console.log("Request succeeded", e.detail); 
      }); 
    </script> 
  <head> 
  <body> 
  ... 
  </body> 
</html>

Les instructions suivantes expliquent comment ajouter un gestionnaire d’événements personnalisés at.js à l’aide d’Adobe Gestionnaire dynamique de balises (DTM) :

  1. Connexion à la gestion dynamique des balises.

  2. Accédez à la propriété appropriée.

  3. Ouvrez l’outil Target.

    Étant donné que DTM ne prend pas en charge at.js de manière native, vous devrez utiliser un éditeur de code.

  4. Dans l’éditeur de code, ajoutez le code suivant à at.js :

    document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
      console.log("Request succeeded", e.detail); 
    });
    

Vous pouvez ajouter le fragment de code suivant à la page de configuration du pied de page d’at.js si vous souhaitez que tout soit un fichier unique.

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
  console.log("Request succeeded", e.detail); 
});

Questions fréquentes relatives aux jetons de réponse

Quel rôle est requis pour activer ou désactiver les jetons de réponse ?

Les jetons de réponse peuvent uniquement être activés ou désactivés par les utilisateurs disposant du rôle d’administrateur Target.

Que se passe-t-il si j’utilise at.js version 1.0 ou antérieure ?

Les jetons de réponse sont visibles, mais at.js ne peut pas les utiliser.

Que se passe-t-il si j’utilise at.js version 1.1 (ou ultérieure) sur certaines pages de mon site et mbox.js sur d’autres pages ?

Les jetons de réponse seront remis aux réponses de la Cible at.js, mais pas aux réponses mbox.js.

Les modules externes de Target Classic et les jetons de réponse peuvent-ils être actifs au même moment ?

Les modules externes et les jetons de réponse sont disponibles en parallèle. Cependant, les modules externes seront obsolètes à l’avenir.

Les jetons de réponse sont-ils distribués par l’intermédiaire de toutes les Target réponses ou uniquement par l’intermédiaire de Target réponses qui fournissent une activité ?

Les jetons de réponse ne sont diffusés que par le biais de réponses Target fournissant une activité.

Mon module externe Target Classic comprenait du code JavaScript. Comment puis-je reproduire ses fonctionnalités à l’aide des jetons de réponse ?

Lors de la migration vers les jetons de réponse, ce type de code JavaScript doit être conservé dans votre codebase ou votre solution de gestion des balises. Vous pouvez déclencher ce code en utilisant les événements personnalisés at.js et transmettre les valeurs des jetons de réponse aux fonctions JavaScript.

Pourquoi mon paramètre d’attribut de profil/client ne s’affiche-t-il pas dans la liste des jetons de réponse ?

Target actualise normalement les paramètres toutes les 15 minutes. Cette actualisation dépend de l’action de l’utilisateur ; les données sont actualisées seulement lorsque vous affichez la page des jetons de réponse. Si les paramètres ne s’affichent pas dans la liste des jetons de réponse, cela peut être dû au fait que Target n’a pas encore actualisé les données.

De même, si le paramètre contient des caractères autres que des caractères alphanumériques ou des symboles autres que des traits de soulignement, le paramètre n’apparaît pas dans la liste. Actuellement, seuls les caractères alphanumériques et les traits de soulignement sont pris en charge.

Si je crée un jeton de réponse à l’aide d’un script de profil ou d’un paramètre de profil, puis que je supprime ce script ou ce paramètre, le jeton de réponse diffuse-t-il toujours du contenu ?

Les jetons de réponse extraient des informations des profils utilisateur, puis diffusent ces informations. Si vous supprimez un script ou un paramètre de profil, cela ne signifie pas que les informations ont été supprimées des profils utilisateur. Les profils utilisateur disposeront toujours des données correspondant au script de profil. Le jeton de réponse continue à diffuser le contenu. Pour les utilisateurs qui ne disposent pas de ces informations dans leurs profils, ou pour les nouveaux visiteurs, ce jeton ne sera pas diffusé car les données ne sont pas présentes dans leurs profils.

Target ne désactive pas automatiquement le jeton. Si vous supprimez un script de profil et que vous ne voulez plus que le jeton soit diffusé, vous devez le désactiver vous-même.

J’ai renommé mon script de profil, mais pourquoi le jeton utilisant ce script est-il toujours actif avec l’ancien nom ?

Comme mentionné ci-dessus, les jetons de réponse fonctionnent selon les informations de profil enregistrées pour les utilisateurs. Même si vous avez renommé le script de profil, les utilisateurs ayant visité votre site web disposent de l’ancienne valeur de script de profil dans leurs profils et le jeton continue à récupérer l’ancienne valeur déjà enregistrée dans les profils utilisateur. Si vous voulez maintenant diffuser du contenu sur le nouveau nom, vous devez désactiver le jeton précédent et activer le nouveau jeton.

Si mes attributs ont changé, quand sont-ils supprimés de la liste ?

Target effectue une actualisation des attributs à intervalles réguliers. Tout attribut qui n’est pas activé est supprimé lors de la prochaine actualisation. Toutefois, si un attribut a été activé et supprimé (par exemple, vous avez supprimé un script de profil utilisé comme jeton), ce script ne sera pas supprimé de la liste des attributs tant que vous ne le désactivez pas. Target supprime les attributs désactivés de la liste seulement lorsqu’ils sont supprimés ou renommés.

Envoi de données à Google Analytics par l’intermédiaire d’at.js

Vous pouvez envoyer des données à Google Analytics par l’intermédiaire d’at.js en ajoutant le code suivant à la page HTML :

<script type="text/javascript"> 
  (function(i, s, o, g, r, a, m) { 
    i['GoogleAnalyticsObject'] = r; 
    i[r] = i[r] || function() { 
      (i[r].q = i[r].q || []).push(arguments) 
    }, i[r].l = 1 * new Date(); 
    a = s.createElement(o), 
      m = s.getElementsByTagName(o)[0]; 
    a.async = 1; 
    a.src = g; 
    m.parentNode.insertBefore(a, m) 
  })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga'); 
  ga('create', 'Google Client Id', 'auto'); 
</script> 
 
<script type="text/javascript"> 
  document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(e) { 
    var tokens = e.detail.responseTokens; 
 
    if (isEmpty(tokens)) { 
      return; 
    } 
 
    var activityNames = []; 
    var experienceNames = []; 
    var uniqueTokens = distinct(tokens); 
 
    uniqueTokens.forEach(function(token) { 
      activityNames.push(token["activity.name"]); 
      experienceNames.push(token["experience.name"]); 
    }); 
 
    ga('send', 'event', { 
      eventCategory: "target", 
      eventAction: experienceNames, 
      eventLabel: activityNames 
    }); 
  }); 
 
  function isEmpty(val) { 
    return (val === undefined || val == null || val.length <= 0) ? true : false; 
  } 
 
  function key(obj) { 
     return Object.keys(obj) 
    .map(function(k) { return k + "" + obj[k]; }) 
    .join(""); 
  } 
 
  function distinct(arr) { 
    var result = arr.reduce(function(acc, e) { 
      acc[key(e)] = e; 
      return acc; 
    }, {}); 
   
    return Object.keys(result) 
    .map(function(k) { return result[k]; }); 
  } 
</script>

Débogage (similaire au module externe ttMeta)

Vous pouvez créer l’équivalent du module externe ttMeta à des fins de débogage en ajoutant le code suivant à la page HTML :

<script type="text/javascript" > 
  document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function (e) { 
    window.ttMETA= typeof(window.ttMETA)!="undefined" ? window.ttMETA : []; 
 
    var tokens=e.detail.responseTokens; 
 
    if (isEmpty(tokens)) { 
      return; 
    } 
     
    var uniqueTokens = distinct(tokens); 
 
    uniqueTokens.forEach(function(token) { 
      window.ttMETA.push({ 
        'CampaignName': token["activity.name"], 
        'CampaignId' : token["activity.id"], 
        'RecipeName': token["experience.name"], 
        'RecipeId': token["experience.id"], 
        'OfferId': token["option.id"], 
        'OfferName': token["option.name"], 
        'MboxName': e.detail.mbox}); 
      console.log(ttMETA); 
    }); 
  }); 
 
  function isEmpty(val){ 
    return (val === undefined || val == null || val.length <= 0) ? true : false; 
  } 
 
  function key(obj) { 
     return Object.keys(obj) 
    .map(function(k) { return k + "" + obj[k]; }) 
    .join(""); 
  } 
 
  function distinct(arr) { 
    var result = arr.reduce(function(acc, e) { 
      acc[key(e)] = e; 
      return acc; 
    }, {}); 
   
    return Object.keys(result) 
    .map(function(k) { return result[k]; }); 
  } 
</script>

Vidéo de formation : Jetons de réponse et événements personnalisés at.js Badge didactique

Regardez la vidéo suivante pour savoir comment utiliser les jetons de réponse et les événements personnalisés at.js pour partager des informations de profil de Target avec des systèmes tiers.

REMARQUE

L'interface utilisateur du menu Target Administration (anciennement Setup) a été repensée afin d'améliorer les performances, de réduire le temps de maintenance requis lors de la publication de nouvelles fonctionnalités et d'améliorer l'expérience de l'utilisateur sur l'ensemble du produit. Les informations de la vidéo suivante sont généralement correctes ; toutefois, les options peuvent se trouver à des emplacements légèrement différents. Les vidéos mises à jour seront bientôt publiées.

Sur cette page