BrightCove Video Tracking-Erweiterung – Übersicht
Voraussetzungen
Für jede Tag-Eigenschaft in Adobe Experience Platform müssen die folgenden Erweiterungen im Erweiterungsbildschirm installiert und konfiguriert werden:
- Adobe Analytics
- Experience Cloud-Besucher-ID-Service
- Installierte Core-Erweiterungen
Verwenden Sie das Code-Fragment „In-Page embed code (Advanced)“ im HTML-Code jeder Web-Seite, auf der ein Video-Player gerendert werden soll. Das HTML-Fragment „In-Page Embed code (Advanced)“ finden Sie in der Brightcove-Dokumentation. Der folgende Link enthält weitere Informationen zum Generieren von eingebettetem Code für Vorschau und veröffentlichte Video-Player.
Diese Erweiterungsversion 1.1.0 unterstützt das Einbetten mehrerer BrightCove-Videos auf einer einzelnen Web-Seite. Wenn es innerhalb der erweiterten Einbettungs-Tags mehrere id
-Eigenschaften gibt, stellen Sie sicher, dass sie jeweils über eindeutige Werte verfügen. Beispielsweise player1
, player2
und so weiter.
Wenn die Web-Seite, die diese Erweiterung verwendet, mit dem Video interagiert, bevor das entsprechende Skript vollständig geladen wurde, gibt es zwei Aktionen, mit denen Sie dsa Problem beheben können. Zum einen kann die Tag-Bibliothek synchron geladen werden und zum anderen kann das Element <script type="text/javascript">\_satellite.pageBottom();\</script\>
vor der Videoeinbettung auf der Seite platziert werden.
Weitere Informationen zu den in dieser Erweiterung verwendeten Komponentenmethoden und -ereignissen finden Sie in der Dokumentation zur BrightCove-API.
Datenelemente
Es sind sieben Datenelemente innerhalb der Erweiterung verfügbar, von denen keines konfiguriert werden muss.
- Abspielposition: Wenn dieses Datenelement in einer Tag-Regel aufgerufen wird, wird in Sekunden der Ort der Abspielposition auf der Video-Timeline aufgezeichnet.
- Video-Account-ID: Dieses Datenelement zeichnet die ID des Brightcove-Accounts auf, der das Video veröffentlicht hat.
- Videodauer: Dieses Datenelement zeichnet die Gesamtdauer des Videoinhalts in Sekunden auf. Darüber hinaus kann in Analytics eine berechnete Metrik erstellt werden, um die Sekundenanzahl in Minuten oder Stunden umzurechnen.
- Unterstützung für Videoanzeigen: Dieses Datenelement gibt an, ob Anzeigen innerhalb des Videos unterstützt werden oder nicht.
- Video-ID: Dieses Datenelement zeigt die BrightCove-ID an, die mit dem Video verknüpft ist.
- Videoname: Dieses Datenelement gibt den beschreibenden oder Klarnamen des Videos an.
- Video-Tags: Dieses Datenelement gibt die speziellen Skripte an, die dem Video zugeordnet sind.
Ereignisse
In der Erweiterung sind sieben Ereignisse verfügbar. Nur das benutzerdefinierte Cue-Punkt-Tracking muss konfiguriert werden.
- Benutzerdefiniertes Cue-Punkt-Tracking: Dieses Ereignis wird ausgelöst, wenn das Video den angegebenen Videoschwellenprozentsatz erreicht. Wenn ein Video beispielsweise 60 Sekunden dauert und der vorgegebene Cue-Punkt bei 50 % liegt, wird das Ereignis an der 30-Sekunden-Markierung ausgelöst.
- Video abgeschlossen: Dieses Ereignis wird ausgelöst, wenn ein Video vollständig abgeschlossen ist.
- Geladene Videometadaten: Dieses Ereignis wird ausgelöst, wenn der Player anfängliche Informationen zu Dauer und Abmessungen erhalten hat.
- Videopause: Dieses Ereignis wird ausgelöst, wenn das Video angehalten wird.
- Videowiederaufnahme: Dieses Ereignis wird ausgelöst, wenn das Video nach einer Pause wieder aufgenommen wird.
- Änderung des Videobildschirms: Das Ereignis wird ausgelöst, wenn das Video in den oder aus dem Vollbildmodus wechselt.
- Videostart: Dieses Ereignis wird ausgelöst, wenn das Video zum ersten Mal startet.
Nutzung
Für jedes Videoereignis (die sieben oben aufgelisteten Ereignisse) kann eine Tag-Regel festgelegt werden. Erstellen Sie für jedes Ereignis, das Sie verfolgen möchten, eine spezifische Tag-Regel. Wenn Sie ein Ereignis nicht verfolgen möchten, verzichten Sie einfach darauf, eine Regel dafür zu erstellen.
Die Regeln beinhalten drei Aktionen:
- Legen Sie die Adobe Analytics-Variablen fest. (Erstellen Sie Datenelemente für alle oder einige der oben aufgeführten Datenelemente.)
- Senden Sie das Adobe Analytics-Beacon.
- Löschen Sie die Adobe Analytics-Variablen.
Beispiel für eine Tag-Regel für „Videostart“
Die folgenden Video-Erweiterungsobjekte sind einzuschließen:
-
Ereignisse
- „Videostart“: Dieses Ereignis löst die Regel aus, wenn der Besucher ein BrightCove-Video abspielt.
-
Bedingung
- Keine
-
Aktionen
-
Legen Sie in der Analytics-Aktion „Variablen festlegen“ Folgendes fest:
- Das Ereignis für Videostart (Beispiel: Ereignis17)
- Eine Prop/eVar für das Datenelement Videoname (Beispiel: eVar10)
- Eine Prop/eVar für das Datenelement Videodauer (Beispiel: eVar11)
- Eine Prop/eVar für das Datenelement Aktuelle Videoposition (Beispiel: eVar12)
-
Die Analytics-Aktion „Beacon senden“ (
s.tl
) -
Die Analytics-Aktion „Variablen löschen“
-
var r = [];
r.push( \_satellite.getVar( 'Video ID' ) );
r.push( \_satellite.getVar( 'Video Name' ) );
r.push( \_satellite.getVar( 'Video Duraction' ) );
return r.join('|');