Video Custom Cue Tracker: Dokumentation zur YouTube-Erweiterung

Voraussetzungen

Für jede Adobe Experience Platform Launch-Eigenschaft müssen die folgenden Erweiterungen über den Bildschirm „Erweiterungen“ installiert und konfiguriert werden:

• Adobe Analytics
• Experience Cloud-Besucher-ID-Service
• Haupterweiterung

Verwenden Sie gemäß https://developers.google.com/youtube/player_parameters das Code-Fragment „Player mit einem Tag einbetten“ im HTML-Code jeder Web-Seite, auf der ein Video-Player wiedergegeben werden soll.

Diese Erweiterungsversion 1.0.1 unterstützt das Einbetten eines oder mehrerer YouTube-Videos auf einer einzelnen Web-Seite, indem ein Attribut id mit einem eindeutigen Wert im iframe-Tag eingefügt und ?enablejsapi=1 an das Ende des src-Attributwerts angehängt wird. Beispiel:

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Da die Erweiterung das Feld id und den Parameter der Abfragezeichenfolge enablejsapi=1 dynamisch zum iFrame hinzufügt, sollten Sie diese nicht manuell zum iFrame hinzufügen.

Beachten Sie bei Seiten mit mehreren Videos, dass jedes Video die gleiche Konfiguration verwendet, die in der auf dieser Seite ausgeführten Platform Launch-Regel festgelegt ist. Wenn Sie beispielsweise eine Regel mit einem Ereignis erstellen, das beim Ansehen von 50 % eines Videos ausgelöst wird, löst jedes Video auf der Seite am 50-%-Cue-Punkt diese Regel aus.

Die Erweiterung nutzt die folgende Logik zum Umschreiben der iFrames:

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

Daher wird nach dem Laden der Seite ein leichtes Flackern auftreten. Dieses Verhalten ist zu erwarten.

Datenelemente

Innerhalb der Erweiterung sind fünf Datenelemente verfügbar, von denen keines konfiguriert werden muss.

• Abspielposition: Zeichnet die Abspielposition auf der Video-Timeline in Sekunden auf, wenn es in einer Launch-Regel aufgerufen wird.
• Video-ID: Gibt die mit dem Video verknüpfte YouTube-ID an.
• Videoname: Gibt den beschreibenden oder Anzeigenamen des Videos an.
• Video-URL: Gibt die URL von YouTube.com für das derzeit geladene/wiedergegebene Video zurück.
• Videodauer: Zeichnet die Gesamtdauer des Videos in Sekunden auf.

Ereignisse

In der Erweiterung sind acht Ereignisse verfügbar, von denen nur das benutzerdefinierte Cue-Punkt-Tracking konfiguriert werden muss.

• Video bereit: Wird ausgelöst, wenn das Video angezeigt wird und zur Wiedergabe bereit ist.
• Videobeginn: Wird ausgelöst, wenn das Video zum ersten Mal gestartet wird und player.getCurrentTime() === 0
• Erneute Videowiedergabe: Wird ausgelöst, wenn das Video angezeigt und nach dem ersten Beginn erneut abgespielt wird. Dieser Trigger wird bei jeder erneuten Wiedergabe ausgelöst.
• Video-Pause: Wird ausgelöst, wenn das Video angehalten wird.
• Videofortsetzung: Wird ausgelöst, wenn das Video fortgesetzt wird und wenn player.getCurrentTime() !== 0
• Benutzerspezifisches Cue-Punkt-Tracking: Wird ausgelöst, wenn das Video den vorgegebenen Video-Schwellenwert erreicht.
  Wenn ein Video beispielsweise 60 Sekunden dauert und der vorgegebene Cue-Punkt bei 50 % liegt, wird das Ereignis ausgelöst, sobald die Abspielposition 30 Sekunden beträgt. Das Cue-Punkt-Tracking gilt sowohl für die Erstwiedergabe als auch für eine Wiederholung. Beachten Sie, dass das Ereignis nicht ausgelöst wird, wenn ein User ein Video durchsucht und dabei an einem Cue-Punkt vorbeikommt. Cue-Punkt-Ereignisse werden nur ausgelöst, wenn die Abspielposition die berechnete Position des Cue-Punkts auf der Timeline passiert, während der Video-Player läuft.
• Videopuffer: Wird ausgelöst, wenn der Player eine bestimmte Datenmenge herunterlädt, bevor die Wiedergabe des Videos beginnt.
• Video beendet: Wird ausgelöst, wenn ein Video abgeschlossen ist.

Nutzung

Für jedes Videoereignis gibt es eine Platform Launch-Regel (siehe oben). Daher müssen Sie für jedes Ereignis, das Sie verfolgen möchten, eine bestimmte Regel erstellen. Wenn Sie also keine Videopause verfolgen möchten, müssen Sie keine Regel dafür erstellen.

Die Regeln umfassen drei Aktionen:

• Variablen festlegen: Festlegen der Adobe Analytics-Variablen (Zuordnen zu allen oder einigen enthaltenen Datenelementen).
• Beacon senden: Senden des Adobe Analytics-Beacons als benutzerspezifischer Linktracking-Aufruf und Angeben eines Wertes „Linkname“.
• Variablen löschen: Löschen der Adobe Analytics-Variablen.

Beispiel für eine Platform Launch-Regel für „Videostart“

Die folgenden Video Extension-Objekte sind einzuschließen.

Ereignisse:

„Videostart“ (dieses Ereignis löst die Regel aus, wenn der Visitor die Wiedergabe eines YouTube-Videos beginnt.)

Bedingung: Keine

Aktionen: Verwenden Sie die Analytics-Erweiterung für:

Aktion „Variablen festlegen“ zum Zuordnen der folgenden Elemente:

• Das Ereignis für Video Star,
• Eine prop/eVar für das Datenelement „Videodauer“
• Eine prop/eVar für das Datenelement „Video-ID“
• Eine prop/eVar für das Datenelement „Videoname“
• Ein prop/eVar für das Datenelement „Video-URL“

Schließen Sie dann die Aktion „Beacon senden“(s.tl) mit dem Link-Namen „Videobeginn“ ein, gefolgt von der Aktion „Variablen löschen“.

Um Videoinformationswerte zu verketten, erstellen Sie ein neues Datenelement mit dem Namen „Videometadaten“ und programmieren es so, dass es alle Videodatenelemente (oben aufgeführt) abruft und zusammenfügt. Beispiel:

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));

return r.join('|');