Créer une couche de données
Une couche de données est une structure JavaScript de votre site qui expose les données collectées par votre implémentation Analytics, telles que les noms de page, les détails de produit et les ID de commande. Le code de votre site écrit dans la couche de données, et votre implémentation lit à partir de celle-ci pour définir les variables Analytics. Comme votre implémentation ne dépend pas d’HTML de la page, vous pouvez reconcevoir votre site sans interrompre la collecte de données.
Conditions préalables
Créez un document de conception de solution : il est important que votre organisation s’aligne sur les exigences de suivi. Assurez-vous d’être préparé et de disposer d’un document de conception de solution avant de contacter les équipes de développement de votre organisation. Les données requises par la conception de votre solution déterminent ce que contient votre couche de données.
Choisir une spécification de couche de données specifications
Adobe recommande la couche de données client Adobe (ACDL) pour les nouvelles implémentations ou les implémentations restructurées. ACDL est une bibliothèque JavaScript open source qui fournit à votre site un moyen standard de pousser des données et des événements vers un tableau adobeDataLayer global. Les balises, le SDK Web et AppMeasurement peuvent tous en lire un extrait, et les composants principaux de Adobe Experience Manager peuvent le remplir automatiquement.
Votre entreprise peut utiliser d’autres spécifications, telles que la couche de données numériques de l’expérience client (CEDDL), qui stocke les données dans un objet digitalData global, ou une spécification personnalisée. Le plus important est que votre entreprise s’aligne sur une spécification qui répond à ses besoins.
Le tableau suivant compare l’ACDL aux couches de données basées sur des objets telles que CEDDL :
adobeDataLayer)digitalData)adobeDataLayer.push({ page: { name: "Home" } })digitalData.page.pageInfo.pageName = "Home"adobeDataLayer.getState("page.name") ou un élément de données État calculé de la couche de données à partir de l’extension de balise de la couche de données client AdobedigitalData.page.pageInfo.pageName ou un élément de données Variable JavaScript de l’extension de balise Core{ event: "page view" }, et votre implémentation l’écoute. Les écouteurs s’exécutent également pour les événements qui ont été transmis avant leur ajout.Exemple de couche de données example
ACDL ne nécessite pas de structure de données spécifique. Concevez la structure autour de votre document de conception de solution et documentez-le pour toutes les personnes qui écrivent dans la couche de données ou qui en lisent. Les exemples de ce guide utilisent la structure suivante.
Lors du chargement d’une page, le code du site transmet les données de la page et un événement de page vue :
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push({
event: "page view",
page: {
name: "Home",
section: "Products",
url: "https://example.com/products",
referrer: "https://example.com/"
}
});
Lorsqu’un visiteur effectue un achat, le code du site transmet les détails de la commande et un événement d’achat :
window.adobeDataLayer.push({
event: "purchase",
transaction: { id: "ABC123" },
products: [
{ name: "Example product", category: "Example category", quantity: 1, price: 25 }
]
});
ACDL fusionne chaque notification push dans un seul objet appelé état calculé, que votre implémentation lit. Les objets d’événement indiquent à votre implémentation quand le lire. Voir Données et l’état calculé et Événements.
Workflow workflow
La mise en œuvre d’Adobe Analytics à l’aide d’une couche de données suit généralement les étapes suivantes :
- Collaborez avec l’équipe de développement de votre site pour implémenter une couche de données : l’équipe de développement de votre site est principalement chargée de s’assurer que la couche de données contient les valeurs correctes. Consultez cette page avec votre équipe de développement de site pour vous assurer que les attentes sont harmonisées entre les équipes. Voir Installation de la couche de données client Adobe.
- Validez la couche de données à l’aide d’une console de navigateur : ouvrez la console de développement de votre navigateur, ce que vous pouvez faire dans la plupart des navigateurs avec la clé
F12. ExécutezadobeDataLayer.getState()pour afficher l’état calculé, ouadobeDataLayer.getState("page.name")pour afficher une seule valeur. Voir Vérification de l’installation. - Connecter la couche de données à Adobe Analytics : cette étape varie en fonction de la méthode de mise en œuvre de votre organisation. Voir Connexion de la couche de données à Adobe Analytics.
Connecter la couche de données à Adobe Analytics connect
Le tableau suivant montre comment chaque méthode d’implémentation lit à partir de la couche de données client Adobe :
data avec l’action Mettre à jour la variable de Web SDK, puis envoyez-les avec l’action Envoyer l’événement.addEventListener() et définissez les champs XDM ou data de la couche de données lorsque vous appelez sendEvent.getState() après le chargement de l’ACDL, puis appeler s.t().Lire la couche de données avec AppMeasurement appmeasurement
L’ACDL ajoute sa méthode getState() au tableau adobeDataLayer lors du chargement de la bibliothèque. Pour vous assurer que la bibliothèque a été chargée et que l’état calculé inclut les données les plus récentes, lisez les valeurs dans un écouteur d’événement :
window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
dl.addEventListener("page view", function(event) {
s.pageName = dl.getState("page.name");
s.channel = dl.getState("page.section");
s.t();
});
});
Le listener s’exécute une fois pour chaque événement page view, y compris les événements qui ont été transmis avant l’ajout du listener. Les pages de variables de ce guide, telles que pageName, montrent comment lire des valeurs individuelles avec getState(). Utilisez ces exemples dans un écouteur comme celui-ci ou dans l’éditeur de code personnalisé d’une règle d’extension Analytics déclenchée par un événement de couche de données push.
Si votre implémentation envoie plusieurs accès par page, par exemple dans une application d’une seule page, utilisez clearVars() afin que les valeurs d’un accès ne persistent pas à l’autre.
Étapes suivantes
- Mapper des objets de couche de données aux éléments de données : utilisez la couche de données de votre site dans les balises Adobe Experience Platform.
- Documentation sur la couche de données client Adobe : découvrez chaque méthode ACDL, événement et bonnes pratiques.