Implémentation d’Analytics for Target

Plusieurs étapes sont requises lors de l’implémentation de Adobe Analytics en tant que source de rapports pour Target (A4T).

Etapes de mise en oeuvre

Les sections suivantes décrivent les étapes requises pour déployer cette intégration sur votre site.

Étape 1 : Demander l’approvisionnement pour Analytics et la Cible

Après avoir implémenté Analytics en tant que source de rapports pour Target, vous devez être configuré pour Analytics et Target. Pour ce faire, utilisez ce formulaire.

Étape 2 : configuration des autorisations d’utilisateur

Les exigences du compte utilisateur doivent être satisfaites pour que vous puissiez créer une activité basée sur Analytics dans Target. Voir Exigences d’autorisation utilisateur.

Étape 3 : implémentation du service Identification des visiteurs d’Experience Cloud

Le service Identifiant visiteur permet d’identifier les utilisateurs sur l’ensemble des solutions Adobe Experience Cloud. Vous devez mettre en œuvre la version requise de l’identifiant visiteur Experience Cloud ou effectuer la migration vers cette dernière. Pour plus d’informations, consultez « Exigences d’implémentation » dans Avant de procéder à l’implémentation.

Voir Mise en oeuvre du service d’identification des Experience Cloud pour la Cible dans la documentation Service d’identification des Visiteurs Experience Cloud.

Étape 4 : mise à jour d’AppMeasurement pour JavaScript ou s_code

Vous devez mettre en œuvre la version requise d’appMeasurement.js ou effectuer la migration vers cette dernière. Pour plus d’informations, voir « Exigences d’implémentation » dans Avant de procéder à l’implémentation.

Pour les nouvelles implémentations, voir Présentation de l’implémentation JavaScript dans le Guide d’implémentation Analytics.

Pour une migration, voir Migration vers AppMeasurement pour JavaScript dans le Guide de mise en oeuvre d’Analytics.

Étape 5 : Téléchargement et mise à jour d’at.js

Vous devez implémenter at.js ou effectuer la migration vers la version requise de at.js à l’aide de votre compte de production. Aucune modification du code n’est requise.

Pour plus d’informations, consultez « Exigences d’implémentation » dans Avant de procéder à l’implémentation.

Étape 6 : Hôte at.js

Si vous avez déjà déployé at.js, vous pouvez remplacer votre fichier existant par la version mise à jour. Pour plus d’informations, voir « Exigences d’implémentation » dans Avant de procéder à l’implémentation.

Sinon, ce fichier peut être hébergé avec le service Identifiant visiteur et les fichiers AppMeasurement pour JavaScript. Ces fichiers doivent être hébergés sur un serveur web accessible par toutes les pages de votre site. Vous aurez besoin du chemin d’accès à ces fichiers à l’étape suivante.

Étape 7 : Référence au fichier at.js sur toutes les pages du site

Insérez at.js sous VisitorAPI.js en ajoutant la ligne de code suivante dans la balise de chaque page :

Pour at.js :

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

Il est essentiel que VisitorAPI.js soit chargé avant at.js. Si vous mettez à jour un fichier at.js ou mbox.js existant, veillez à vérifier l’ordre de chargement.

La façon dont les paramètres prêts à l’emploi sont configurés pour l’intégration Target et Analytics du point de vue de l’implémentation consiste à utiliser le SDID transmis à partir de la page pour regrouper automatiquement les requêtes Target et Analytics sur le serveur principal.

Cependant, si vous souhaitez avoir plus de contrôle sur la manière et le moment d’envoyer les données d’analyse liées à Target à Analytics à des fins de rapports et que vous ne souhaitez pas vous inscrire aux paramètres par défaut, à savoir que Target et Analytics assemblent automatiquement les données d’analyse via le SDID, vous pouvez définir analyticsLogging6 = client_side via <a5/<a./>window.targetGlobalSettings . Remarque : Toutes les versions antérieures à 2.1 ne prennent pas en charge cette approche.

Par exemple :

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Cette configuration a un effet global. Cela signifie que chaque appel effectué par at.js aura analyticsLogging: "client_side" envoyé dans les requêtes et une charge utile Analytics est renvoyée pour chaque requête. Target Lors de la configuration, le format de la charge utile renvoyé ressemble à ce qui suit :

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

La charge utile peut ensuite être transférée à Analytics via l’API d’insertion de données. Notez que, pour les activités Affectation automatique et Cible automatique, vous devez également transférer le paramètre sessionId. Pour plus d’informations, voir le rapports Analytics for Cible (A4T) dans le guide Adobe Target SDKs.

Si un paramètre global n’est pas souhaité et qu’une approche plus à la demande est préférable, vous pouvez utiliser la fonction at.js getOffers() pour obtenir ce résultat en transmettant analyticsLogging: "client_side". La charge utile d’analyse sera renvoyée pour cet appel uniquement et le serveur principal Target ne transmettra pas la charge utile à Analytics. En suivant cette approche, chaque requête at.js Target ne retournera pas la charge par défaut, mais uniquement lorsque cela est souhaité et spécifié.

Par exemple :

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Cet appel appelle une réponse à partir de laquelle vous pouvez extraire la charge utile Analytics.

La réponse ressemble à ce qui suit :

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

La charge utile peut ensuite être transférée à Analytics par l'intermédiaire de l'API d'insertion de données.

Étape 8 : validation de l’implémentation

Chargez vos pages après avoir mis à jour les bibliothèques JavaScript pour vérifier que les valeurs de paramètre mboxMCSDID dans les appels Target correspondent à la valeur de paramètre sdid dans l'appel de vue de page Analytics.

Ceci s’avère particulièrement important dans les applications à une seule page, où l’ordre des appels n’est pas toujours prévisible.

Remarque : Ces valeurs doivent correspondre pour qu’A4T fonctionne correctement.

Étape 9 (facultative) : suppression du code d’intégration précédent

Il est recommandé de supprimer l’intégration précédente afin de simplifier la mise en œuvre et d’éliminer la nécessité d’avoir à résoudre les incohérences entre les systèmes. Vous pouvez supprimer tout code que vous pouvez avoir déployé lors d’une intégration SC à T&T précédente, notamment mboxLoadSCPlugin.

Étape 10 : activation des options pour utiliser Analytics en tant que source de création de rapports pour Target

Dans Target, cliquez sur Administration > Compositeur visuel d’expérience et sélectionnez Sélectionner par activité ou Adobe Analytics pour activer les options.

• **L’option Sélection par activité vous permet de choisir entre et lors de la création de chaque activité.**TargetAnalytics
• **L’option Adobe  définit Analytics en tant que source des rapports pour toutes les activités que vous créez.**Analytics