Analytics pour Target implémentation

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 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 : demander la mise en service de Analytics et Target

Avant de mettre en oeuvre A4T, vous devez disposer des privilèges d’accès Analytics et Target. Utilisez ce formulaire pour demander à être configuré..

É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 Création et configuration des flux de données.

É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 > Visual Experience Composer, puis choisissez Select per activity ou Adobe Analytics.

  • Select per activity permet de choisir entre Target et Analytics lors de la création de chaque activité.
  • Adobe Analytics sets Analytics comme source de création de rapports pour toutes les activités que vous créez.

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

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’approvisionnement 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. Utilisez ce formulaire pour demander à être configuré..

É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 d’identification des visiteurs vous permet d’identifier les utilisateurs sur plusieurs Adobe Experience Cloud solutions. 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 la 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ébergement d’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érencement d’at.js sur toutes les pages du site step7

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 reporting. 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 le 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 step8

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 valeur du paramètre dans 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.

NOTE
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 > Reporting et choisissez Select per activity ou Adobe Analytics pour activer les options.

  • Select per activity permet de choisir entre Target et Analytics lors de la création de chaque activité.
  • Adobe Analytics sets Analytics comme source de création de rapports pour toutes les activités que vous créez.
recommendation-more-help
3d9ad939-5908-4b30-aac1-a4ad253cd654