Implementierung und Reporting
Erstellt für:
- Benutzende
- Admin
- Entwickler
Während einer Wiedergabesitzung muss jedes Statusereignis (vom Beginn bis zum Ende) einzeln getrackt werden. Das Medien-SDK und die Mediensammlungs-API bieten neue Tracking-Methoden für diese Funktion.
Das Medien-SDK beinhaltet zwei neue Methoden zum Tracking benutzerdefinierter Status:
trackStateStart("state_name")
trackStateClose("state_name")
Die Mediensammlungs-API enthält zwei neue Ereignisse mit dem erforderlichen Parameter media.stateName
:
stateStart
und stateEnd
Implementierung des Medien-SDK
Player-Status beginnt
// StateStart (ex: Mute is switched on)
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Mute);
tracker.trackEvent(ADB.Media.Event.StateStart, stateObject);
Player-Status endet
// StateEnd (ex: Mute is switched off)
tracker.trackEvent(ADB.Media.Event.StateEnd, stateObject);
Implementierung der Mediensammlungs-API
Player-Status beginnt
// 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
}
}
Player-Status endet
// 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
}
}
Statusmetriken
Die für die einzelnen Status bereitgestellten Metriken werden berechnet, als Kontextdatenparameter an Adobe Analytics gesendet und für das Reporting gespeichert. Für jeden Status stehen drei Metriken zur Verfügung:
a.media.states.[state.name].set = true
– ist auf „true“ gesetzt, wenn der Status für jede einzelne Wiedergabe eines Streams mindestens einmal festgelegt wurde.a.media.states.[state.name].count = 4
– Identifiziert die Anzahl der Vorkommnisse eines Status während jeder einzelnen Wiedergabe eines Streamsa.media.states.[state.name].time = 240
– Identifiziert die Gesamtstatusdauer in Sekunden für jede einzelne Wiedergabe eines Streams
Berichterstellung
Alle Player-Statusmetriken können für jede in Analysis Workspace verfügbare Visualisierung von Berichten oder für eine Komponente (Segment, berechnete Metriken) verwendet werden, sobald eine Report Suite für das Player-Status-Tracking aktiviert wurde. Die neuen Metriken können in der Admin Console für jeden einzelnen Bericht über die Einrichtung der Medienberichte (Einstellungen bearbeiten > Medienverwaltung > Medienberichte) aktiviert werden.
In Analytics Workspace befinden sich alle neuen Eigenschaften im Metrikbedienfeld. Sie können beispielsweise nach full screen
suchen, um die Vollbilddaten im Metrikbedienfeld anzuzeigen.
Importieren der vom Player angegebenen Metriken in Adobe Experience Platform
In Analytics gespeicherte Daten können für jeden Zweck verwendet werden. Die Player-Statusmetriken können mithilfe von XDM in Adobe Experience Platform importiert und mit Customer Journey Analytics verwendet werden. Die Standardstatuseigenschaften haben bestimmte Eigenschaften, während die benutzerdefinierten Statuseigenschaften über die benutzerdefinierten Ereignisse verfügbar sind. Zusätzliche Informationen zu den Standardstatuseigenschaften finden Sie im Abschnitt mit der Eigenschaftenliste für XDM-Identitäten auf der Seite Player-Statusparameter.