Show Menu
SUJETS×

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. Pour ce faire, le SDK Media et l’API Media Collection fournissent de nouvelles méthodes de suivi.
Le SDK Media comprend deux nouvelles méthodes pour le suivi d’état personnalisé :
trackStateStart("state_name")
trackStateClose("state_name")
L’API Media Collection comprend deux nouveaux événements dont le paramètre requis est media.stateName  :
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. Les nouvelles mesures peuvent être activées à partir d’Admin Console pour chaque rapport individuel en configurant la création de rapports multimédia (Modifier les paramètres > Gestion des médias > Création de rapports multimédia).
Dans Analytics 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 .