Durante una sessione di riproduzione, ogni occorrenza di uno stato (dall’inizio alla fine) deve essere tracciata singolarmente. Media SDK e l’API Media Collection forniscono nuovi metodi di tracciamento per questa funzionalità.
Media SDK include due nuovi metodi per il tracciamento dello stato personalizzato:
trackStateStart("state_name")
trackStateClose("state_name")
L’API Media Collection include due nuovi eventi che hanno media.stateName
come parametro richiesto:
stateStart
e stateEnd
Avvio stato lettore
// StateStart (ex: Mute is switched on)
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Mute);
tracker.trackEvent(ADB.Media.Event.StateStart, stateObject);
Fine stato lettore
// StateEnd (ex: Mute is switched off)
tracker.trackEvent(ADB.Media.Event.StateEnd, stateObject);
Avvio stato lettore
// 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
}
}
Fine stato lettore
// 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
}
}
Le metriche fornite per ogni singolo stato vengono calcolate e inviate ad Adobe Analytics come parametri di dati contestuali e memorizzate a scopo di reporting. Sono disponibili tre metriche per ogni stato:
a.media.states.[state.name].set = true
— Imposta su true se lo stato è stato impostato almeno una volta per ogni specifica riproduzione di un flusso.a.media.states.[state.name].count = 4
— Identifica il numero di occorrenze di uno stato durante ogni singola riproduzione di un flussoa.media.states.[state.name].time = 240
— Identifica la durata totale dello stato in secondi per ogni singola riproduzione di un flussoTutte le metriche dello stato del lettore possono essere utilizzate per qualsiasi visualizzazione di reporting disponibile in Analysis Workspace o in un componente (segmento, metriche calcolate) una volta che una suite di rapporti è abilitata per il tracciamento dello stato del lettore. Le nuove metriche possono essere abilitate nell’Admin Console per ogni singolo rapporto utilizzando la configurazione Media Reporting (Modifica impostazioni > Gestione media > Media Reporting).
In Analysis Workspace, tutte le nuove proprietà si trovano nel pannello metriche. Ad esempio, puoi eseguire ricerche per full screen
per visualizzare i dati a schermo intero nel pannello metriche.
I dati memorizzati in Analytics possono essere utilizzati per qualsiasi scopo e le metriche dello stato del lettore possono essere importate in Adobe Experience Platform utilizzando XDM e utilizzate con Customer Journey Analytics. Le proprietà dello stato standard hanno proprietà specifiche, mentre gli stati personalizzati sono proprietà disponibili utilizzando gli eventi personalizzati. Per ulteriori informazioni sulle proprietà dello stato standard, consulta la sezione Elenco delle proprietà per le identità XDM dalla pagina Parametri dello stato del lettore.