Implementierung und Reporting

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 Streams
  • a.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.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb