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.
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 :
Avant de mettre en oeuvre A4T, vous devez disposer des privilèges d’accès Analytics et Target. Pour ce faire, utilisez ce formulaire.
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.
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.
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.
Dans le Target Interface utilisateur, cliquez sur Administration > Compositeur d’expérience visuelle, puis choisissez Sélection par activité ou Adobe Analytics.
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 :
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.
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.
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.
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.
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.
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.
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.
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.
La correspondance de ces valeurs est requise pour que A4T fonctionne correctement.
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
.
Dans Target, cliquez sur Administration > Rapports et choisissez Sélection par activité ou Adobe Analytics pour activer les options.