Collecte de données dans Content Analytics
Cet article explique en détail comment Content Analytics collecte les données
Définitions
Les définitions suivantes sont utilisées dans le cadre de cet article :
-
Expérience :
- Pour le canal web, une expérience est définie comme le contenu textuel d’une page web entière. Pour la collecte de données, Content Analytics enregistre l’Experience ID basé sur l’URL de la page. Ensuite, le texte de la page est capturé via le service de récupération.
- Pour le canal mobile, une expérience est définie et suivie dans l’application mobile à l’aide de l’extension Content Analytics pour Adobe Experience Platform Mobile SDK.
-
Experience ID :
-
Pour le canal web, l’ID d’expérience est une combinaison unique de l’URL appropriée (URL de base plus tous les paramètres qui génèrent du contenu sur la page) et de la version de l’expérience.
- Dans le cadre de la configuration, vous spécifiez les paramètres pertinents pour toute URL complète donnée.
- Vous définissez un identifiant de version à utiliser afin de collecter correctement les modifications apportées à vos expériences.
-
Pour le canal mobile, l’ID d’expérience est la valeur renvoyée par à l’aide de l’appel API
registerExperience.
-
-
Ressource : une image. Content Analytics enregistre l’URL de la ressource.
-
ID de ressource : URL de la ressource.
-
URL appropriée : l’URL de base ainsi que tous les paramètres qui pilotent le contenu sur la page.
Fonctionnalité
Content Analytics nécessite Experience Platform Edge Network Web SDK (pour le canal web) et Experience Platform Edge Network Mobile SDK (pour le canal mobile) pour collecter des données d’événement de contenu. Ces données d’événement sont combinées avec des données comportementales existantes à l’aide d’Experience Platform Edge Network (Web SDK, Mobile SDK ou API du serveur) ou d’un connecteur source Analytics, tel qu’Adobe AppMeasurement.
La bibliothèque Content Analytics collecte des données lorsque :
- Content Analytics est inclus dans la bibliothèque de balises chargée sur la page ou utilisée dans l’application mobile.
- L’URL de la page et l’URL de la ressource sont configurées dans l’extension web 🔗, qui fait partie de la bibliothèque de balises incluse.
- L’URL de la ressource, l’emplacement de la ressource ou l’emplacement de l’expérience ne sont pas exclus dans l’extension mobile Content Analytics 🔗.
Événement Content Analytics
Cette section décrit les spécificités des événements Web Content Analytics. Voir Tracking d’expérience pour plus d’informations sur les événements Content Analytics mobiles.
Un événement Content Analytics comprend les éléments suivants :
-
Champs standard
- Date et heure
- Identité
-
Vues d’expérience (le cas échéant, et si configurées)
-
Clics sur l’expérience (le cas échéant, et si configurés)
-
Vues de ressources (le cas échéant, et si configurées)
-
Clics sur les ressources (le cas échéant, et si configurés)
Les événements Content Analytics sont collectés comme une séquence des éléments suivants :
Content Analytics collecte les données de cette manière pour refléter cette séquence, au lieu de collecter une vue ou un clic séparément à partir de l’événement qui suit immédiatement. Cette méthode de collecte des données d’analyse de contenu réduit également la quantité de données collectées.
Vue ou clic enregistrés
Une vue de ressource est enregistrée lorsque :
- La ressource n’a pas été exclue conformément à la configuration de l’extension Content Analytics.
- La ressource est vue à 75 %.
- Cette ressource n’a pas encore été enregistrée pour cette page.
Un clic sur une ressource est enregistré dans les cas suivants :
- La ressource a été vue.
- La ressource n’a pas été exclue conformément à la configuration de l’extension Content Analytics.
- Un clic direct sur la ressource, qui est un lien, mène à une autre page.
Une vue d’expérience est enregistrée lorsque :
- Les expériences sont activées dans la configuration Content Analytics.
Un clic sur une expérience est enregistré lorsque :
- Tout clic sur un lien activé déclenche une expérience.
Déclencheur pour envoyer un événement Content Analytics
Pour réduire le nombre de requêtes réseau envoyées à partir de la page, Content Analytics collecte des informations mais ne les envoie pas immédiatement. Les informations d’interaction de contenu sont collectées et un événement contenant ces informations n’est envoyé que lorsque l’un des déclencheurs suivants se produit :
-
Web SDK ou Adobe AppMeasurement envoient un événement.
-
La visibilité passe à masquée, par exemple :
- Charger une page
- Basculer d’onglet à un autre
- Réduire le navigateur
- Fermer le navigateur
- Verrouiller l’écran
-
L’URL est modifiée en conséquence.
-
Les vues de ressources enregistrées et prêtes à être envoyées dépassent 32.
Identités
Cette section explique comment Content Analytics gère les identités.
Web
Content Analytics gère les identités du canal web de la manière suivante :
- L’ECID est automatiquement renseigné dans la partie
identityMapdu schéma Content Analytics. - Si vous avez besoin d’autres valeurs d’identité dans le
identityMap, vous devez définir ces valeurs dans le rappelonBeforeEventSenddans l’extension Web SDK. - Le groupement basé sur les champs n’est pas pris en charge, car le schéma est détenu par le système. Vous ne pouvez donc pas ajouter un autre champ au schéma pour prendre en charge le groupement basé sur les champs.
Pour vous assurer que les données d’identité Content Analytics et les données d’identité des données Web SDK sont correctement regroupées au niveau du champ, modifiez l’option de rappel de la SDK Web activé avant l’envoi de l’événement.
-
Accédez à la propriété Balises qui contient l’extension du SDK Web Adobe Experience Platform et l’extension Adobe Content Analytics.
-
Sélectionnez
Extensions.
-
Sélectionnez l’extension SDK Web Adobe Experience Platform.
-
Sélectionnez Configurer.
-
Dans la section Instances SDK, faites défiler l’écran jusqu’à Collecte de données - Rappel OnBeforeEventSend.
-
Sélectionnez </> Fournir le code du rappel OnBeforeEventSend.
-
Ajoutez le code suivant :
code language-javascript window.adobeContentAnalytics?.forwardEvent(content); content.xdm.identityMap = _satellite.getVar('identityMap'); if ((content.xdm.eventType === "content.contentEngagement") && (_satellite.getVar('identityMap') != null)) { return true; } -
Sélectionnez Enregistrer pour enregistrer le code.
-
Sélectionnez Enregistrer pour enregistrer l’extension.
-
Publiez les mises à jour de la propriété Balises.
Mobile
Consultez les sections Extension du service d’identité pour Experience Cloud ID et Extension mobile d’identité pour Edge Network pour plus d’informations sur l’utilisation des identités dans votre application mobile.
Dès que l’identité change dans l’application mobile, le lot actuel de données Content Analytics est réinitialisé afin de démarrer une nouvelle collecte de données Content Analytics pour la nouvelle identité.
Schémas
Experience Platform collecte des données Content Analytics dans des jeux de données en fonction de schémas Content Analytics spécifiques. Les schémas de référence sont accessibles au public :