Implémentation d’Analytics for Target

Plusieurs étapes sont requises lors de l’implémentation de Adobe Analytics comme source de création de rapports pour Adobe Target (A4T). Le processus varie selon que vous implémentez A4T avec la méthode Adobe Experience Platform Web SDK ou avec at.js.

Badge du SDK Web Adobe Experience Platform Étapes de mise en oeuvre d’une mise en oeuvre SDK Web Adobe Experience Platform

Les sections suivantes décrivent les étapes nécessaires au déploiement de cette intégration sur votre site si vous envisagez d’utiliser le SDK Web Platform :

Étape 1 : Demande d’approvisionnement pour Analytics et Target

Avant de mettre en oeuvre A4T, vous devez disposer des privilèges d’accès Analytics et Target. Pour ce faire, utilisez ce formulaire.

Étape 2 : configuration des autorisations d’utilisateur

Les exigences du compte utilisateur doivent être respectées avant de pouvoir créer une activité basée sur Analytics in Target. Voir Exigences d’autorisation des utilisateurs.

Étape 3 : Création d’une configuration Edge

Création d’une configuration Edge à l’aide de Adobe Experience Platform à l’aide de l’outil de configuration edge . Configurez la variable Analytics and Target paramètres de configuration Edge.

Étape 4 : Installation et configuration du SDK Web de Platform

Pour commencer à diffuser Target expériences et à appliquer Analytics à des fins de suivi et d'analyse, Installer et configure le SDK Web Platform sur les pages de votre site.

Étape 5 : Activation des options pour l’utilisation d’A4T

Dans le Target Interface utilisateur, cliquez sur Administration > Compositeur d’expérience visuelle, puis choisissez Sélection par activité ou Adobe Analytics.

  • 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

Badge at.js Étapes de mise en oeuvre d’at.js

Les sections suivantes décrivent les étapes nécessaires au déploiement de cette intégration sur votre site si vous envisagez d’utiliser at.js :

Étape 1 : Demande d’attribution de privilèges d’accès pour Analytics et Target

Après l’implémentation Analytics comme source de création 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 respectées avant de pouvoir créer une Analyticsactivité basée sur dans Target. Voir Exigences d’autorisation des utilisateurs.

É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. Mettez en oeuvre ou migrez vers la version requise de l’identifiant visiteur Experience Cloud. Pour plus d’informations, consultez « Exigences d’implémentation » dans Avant de procéder à l’implémentation.

Voir Mise en oeuvre du service d’ID Experience Cloud pour Target dans le Service d’identification des visiteurs Experience Cloud documentation.

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

Mettez en oeuvre ou migrez vers la version requise d’appMeasurement.js. Pour plus d’informations, consultez « Exigences d’implémentation » dans Avant de procéder à l’implémentation.

Pour de nouvelles implémentations, voir Mise en oeuvre JavaScript - Aperçu dans le Guide de mise en oeuvre Analytics.

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

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

Implémentez ou migrez vers la version requise d’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érencer 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>

Le fichier VisitorAPI.js doit être chargé avant at.js. Si vous mettez à jour un fichier at.js existant, veillez à vérifier l’ordre de chargement.

Le paramètre par défaut pour Target et Analytics du point de vue de l’implémentation, l’intégration consiste à utiliser le SDID transmis à partir de la page pour assembler la variable Target et Analytics demande ensemble sur le serveur principal automatiquement.

Vous pouvez contrôler comment et à quel moment envoyer des données d’analyse liées à Target to Analytics à des fins de création de rapports. Si vous ne souhaitez pas souscrire aux paramètres par défaut d’ Target et Analytics assembler automatiquement les données d’analyse via le SDID, définissez analyticsLogging = client_side via 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, ce qui signifie que chaque appel effectué par at.js a un analyticsLogging: "client_side" envoyé dans Target les requêtes et un payload analytics sont renvoyés pour chaque requête. Lorsque cette option est configurée, le format de la payload 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 payload peut ensuite être transmise à Analytics via la fonction API d’insertion de données. Pour les activités d’affectation automatique et de ciblage automatique, vous devez également transférer l’ID de session. Pour plus d’informations, voir Rapports Analytics for Target (A4T) dans le SDK Adobe Target guide.

Si un paramètre global n’est pas souhaité et qu’une approche plus à la demande est préférable, utilisez la fonction at.js . getOffers() en transmettant analyticsLogging: "client_side". La charge utile Analytics est renvoyée pour cet appel uniquement et la variable Target Le serveur principal ne transfère pas la charge utile vers Analytics. En appliquant cette approche, chaque fichier at.js Target La requête renvoie la charge utile par défaut, mais uniquement si elle est souhaitée et spécifiée.

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 payload peut ensuite être transférée vers Analytics via le 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 confirmer que la variable mboxMCSDID valeurs de paramètre dans Target correspond à la variable sdid de la variable Analytics appel page-vue.

Il est particulièrement important de confirmer que ces valeurs correspondent dans les applications d’une seule page (SPA) où l’ordre des appels n’est pas toujours prévisible.

REMARQUE

La correspondance de ces valeurs est requise pour que A4T fonctionne correctement.

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

Adobe recommande de supprimer l’intégration précédente afin de simplifier votre mise en oeuvre et d’éliminer la nécessité de résoudre les incohérences entre les systèmes. Vous pouvez supprimer tout code que vous avez déployé pour une intégration SC à T&T précédente, y compris 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 > Rapports et choisissez Sélection 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

Sur cette page