Mise en œuvre et création de rapports
Au cours d’une session de lecture, chaque occurrence d’état (du début à la fin de la lecture) doit faire l’objet d’un suivi individuel. Media SDK et l’API Media Collection fournissent des méthodes de suivi pour cette fonctionnalité.
Media SDK comprend deux méthodes de suivi d’état personnalisé :
trackStateStart("state_name")
trackStateClose("state_name")
L’API Media Collection comprend deux événements qui ont media.stateName comme paramètre obligatoire :
stateStart et stateEnd
Mise en œuvre du SDK Media
Début de l’état du lecteur
// StateStart (ex: Mute is switched on)
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Mute);
tracker.trackEvent(ADB.Media.Event.StateStart, stateObject);
Fin de l’état du lecteur
// StateEnd (ex: Mute is switched off)
tracker.trackEvent(ADB.Media.Event.StateEnd, stateObject);
Mise en œuvre de l’API Media Collection
Début de l’état du lecteur
// StateStart (ex: Mute is switched on)
http(s)://<Analytics_Visitor_Namespace>.hb-api.omtrdc.net/api/v1/sessions/<SID>/events
{
"eventType": "stateStart",
"params": {
"media.state.name": "mute"
},
"playerTime": {
"playhead": 0,
"ts": 1569999130627
}
}
Fin de l’état du lecteur
// StateEnd (ex: Mute is switched off)
http(s)://<Analytics_Visitor_Namespace>.hb-api.omtrdc.net/api/v1/sessions/<SID>/events
{
"eventType": "stateEnd",
"params": {
"media.state.name": "mute"
},
"playerTime": {
"playhead": 600,
"ts": 1569999730638
}
}
Mesures d’état
Les mesures fournies pour chaque état individuel sont calculées et transmises à Adobe Analytics en tant que paramètres de données contextuelles et sont stockées à des fins de création de rapports. Trois mesures sont disponibles pour chaque état :
a.media.states.[state.name].set = true— Défini sur « true » si l’état a été défini au moins une fois au cours de chaque lecture spécifique d’un flux.a.media.states.[state.name].count = 4— Identifie le nombre d’occurrences d’un état au cours de chaque lecture individuelle d’un flux.a.media.states.[state.name].time = 240— Identifie la durée totale de l’état en secondes au cours de chaque lecture individuelle d’un flux.
Création de rapports
Toutes les mesures d’état du lecteur peuvent être utilisées pour toutes les visualisations de rapports disponibles dans Analysis Workspace ou un composant (segment, mesures calculées) une fois qu’une suite de rapports est activée pour le suivi de l’état du lecteur. Ces mesures peuvent être activées à partir de l’Admin Console pour chaque rapport individuel à l’aide de la configuration des rapports multimédia (Modifier les paramètres > Gestion des médias > Rapports multimédia).
Dans Analysis Workspace, toutes les nouvelles propriétés se trouvent dans le panneau des mesures. Par exemple, vous pouvez rechercher par full screen pour consulter les données portant sur le passage en plein écran dans le panneau des mesures.
Importation des mesures d’état du lecteur vers Adobe Experience Platform
Les données stockées dans Analytics peuvent être utilisées à n’importe quelle fin, et les mesures d’état du lecteur peuvent être importées dans Adobe Experience Platform à l’aide de XDM et utilisées avec Customer Journey Analytics. Les propriétés d’état standards possèdent des propriétés spécifiques, tandis que les états personnalisés sont des propriétés disponibles en utilisant des événements personnalisés. Pour plus d’informations sur les propriétés d’état standards, reportez-vous à la section Liste de propriétés des identités XDM sur la page Paramètres d’état du lecteur.