Schéma de reporting XDM
Lorsque vous envoyez des événements de suivi multimédia à l’aide de Adobe Experience Platform Edge Network, le serveur principal Media Analytics traite ces événements et écrit les événements d’expérience calculés dans les jeux de données Platform. Comprendre quels événements atteignent Platform et ce que le serveur principal calcule pour vous permet de valider votre implémentation et de créer des rapports précis dans Customer Journey Analytics ou Adobe Analytics.
Deux schémas XDM distincts sont utilisés dans différentes parties du pipeline de collecte et de création de rapports :
xdm.mediaCollectionxdm.mediaReportingLes champs présents dans mediaReporting mais absents de la payload mediaCollection sont dérivés de la séquence complète d’événements d’une session. Ces champs ne sont jamais envoyés, ils sont générés par Adobe.
Événements qui écrivent dans les jeux de données Platform
Sur les 12 types d’événements pouvant faire l’objet d’un suivi, seuls cinq génèrent des écritures d’événement d’expérience individuelles dans les jeux de données :
Champs calculés du serveur principal
Les champs suivants apparaissent dans les payloads mediaReporting, mais ne font jamais partie de la payload de collection. Le serveur principal les dérive de la séquence d’événements complète.
Niveau de session (s’affiche sur sessionComplete) :
xdm.mediaReporting.sessionDetails.timePlayedxdm.mediaReporting.sessionDetails.totalTimePlayedxdm.mediaReporting.sessionDetails.uniqueTimePlayedxdm.mediaReporting.sessionDetails.averageMinuteAudiencetimePlayed divisé par la longueur du contenuxdm.mediaReporting.sessionDetails.estimatedStreamsxdm.mediaReporting.sessionDetails.adCountxdm.mediaReporting.sessionDetails.chapterCountxdm.mediaReporting.sessionDetails.pauseCount / xdm.mediaReporting.sessionDetails.pauseTimexdm.mediaReporting.sessionDetails.hasProgress10 … xdm.mediaReporting.sessionDetails.hasProgress95xdm.mediaReporting.sessionDetails.hasSegmentViewxdm.mediaReporting.sessionDetails.isCompleted / xdm.mediaReporting.sessionDetails.isPlayedxdm.mediaReporting.sessionDetails.secondsSinceLastCallxdm.mediaReporting.sessionDetails.segment[0-1])Niveau de l’annonce (apparaît sur adComplete) :
xdm.mediaReporting.advertisingDetails.timePlayedxdm.mediaReporting.advertisingDetails.isCompletedAu niveau du chapitre (apparaissant sur chapterComplete) :
xdm.mediaReporting.chapterDetails.timePlayedxdm.mediaReporting.chapterDetails.isCompletedxdm.mediaReporting.chapterDetails.isStartedQoE (agrégé sur sessionComplete) :
xdm.mediaReporting.qoeDataDetails.bitrateAveragexdm.mediaReporting.qoeDataDetails.bitrateAverageBucketxdm.mediaReporting.qoeDataDetails.bitrateChangeCountxdm.mediaReporting.qoeDataDetails.errorCountxdm.mediaReporting.qoeDataDetails.droppedFramesxdm.mediaReporting.qoeDataDetails.playerSdkErrorsxdm.mediaReporting.qoeDataDetails.hasErrorImpactedStreamsxdm.mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreamsxdm.mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreamsContenu téléchargé
Pour les sessions suivies à l’aide du point d’entrée téléchargé, le serveur principal définit automatiquement le xdm.mediaReporting.sessionDetails.isDownloaded sur true sur l’événement de création de rapports sessionStart. Tous les autres événements de création de rapports pour les sessions téléchargées suivent le même schéma que les sessions actives. Utilisez ce champ dans CJA ou Adobe Analytics pour filtrer ou segmenter la lecture téléchargée.
Voir Point d’entrée téléchargé dans Référence de l’API Media Edge pour les détails d’implémentation de la collection.
Valider votre mise en œuvre
Après avoir envoyé des événements par le biais de l’API Media Edge, vérifiez que vos données ont bien atterri en utilisant l’une des méthodes suivantes :
Aperçu du jeu de données
- Dans CX Enterprise, accédez à Jeux de données et sélectionnez votre jeu de données de médias en flux continu.
- Sélectionnez Prévisualiser le jeu de données pour afficher les événements d’expérience les plus récemment ingérés.
- Vérifiez que
eventTypevaleurs telles quemedia.sessionStartetmedia.sessionCompletes’affichent avec des champs demediaReportingrenseignés.
inspection du jeu de données
- Dans CJA, ouvrez la connexion associée à votre jeu de données de médias en flux continu.
- Sélectionnez Ajouter des jeux de données et examinez le schéma pour confirmer que les champs
mediaReportingsont mappés aux dimensions et mesures attendues.
Règles de traitement Adobe Analytics (si vous utilisez la destination Analytics)
Pour les suites de rapports Adobe Analytics recevant des données via le connecteur source Analytics, vous pouvez utiliser des règles de traitement pour mapper des variables de données contextuelles mediaReporting à des props ou des eVars personnalisées. L’indicateur isDownloaded est disponible en tant que a.media.downloaded.
Exemples de payload XDM
Les exemples suivants montrent la structure XDM mediaReporting complète pour chaque événement de création de rapports tel qu’il est écrit dans les jeux de données Platform. La propriété _{tenantName} représente l’espace de noms du client de votre organisation pour tous les champs personnalisés.
| code language-json |
|---|
|
| code language-json |
|---|
|
| code language-json |
|---|
|
| code language-json |
|---|
|
| code language-json |
|---|
|
Les sessions suivies à l’aide du point d’entrée téléchargé suivent le même schéma de création de rapports avec une différence clé : xdm.mediaReporting.sessionDetails.isDownloaded est défini sur true sur l’événement de création de rapports sessionStart. Tous les autres types d’événements sont identiques aux exemples de contenu en direct ci-dessus.
| code language-json |
|---|
|