YouTube Video Tracking-Erweiterung – Übersicht

Voraussetzungen

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

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

Verwenden Sie das Code-Fragment Embed a player using an <iframe> tag aus den Google-Entwicklerdokumenten im HTML-Code jeder Web-Seite, auf der ein Video-Player gerendert werden soll.

Die Erweiterungsversion 2.0.1 unterstützt das Einbetten eines oder mehrerer YouTube-Videos auf einer einzelnen Website, indem ein id-Attribut mit einem eindeutigen Wert im iframe-Skript-Tag eingefügt und enablejsapi=1 und rel=0 an das Ende des src-Attributwerts angehängt werden, falls dies noch nicht der Fall ist. 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>

Beachten Sie, dass diese Erweiterung auch dazu konzipiert ist, dynamisch nach einem eindeutigen ID-Attributwert wie player1 zu suchen und zu prüfen, ob die Abfragezeichenfolgenparameter enablejsapi und rel vorhanden sind und ob die erwarteten Werte korrekt sind. Daher kann das YouTube-Skript-Tag zu einer Web-Seite mit oder ohne das id-Attribut hinzugefügt werden und unabhängig davon, ob die Abfragezeichenfolgenparameter enablejsapi und rel enthalten sind oder nicht.

Die Erweiterung nutzt die folgende Logik zum Umschreiben der iFrames:

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

Daher tritt nach dem Laden der Seite ein leichtes Flackern auf. Dieses Verhalten ist zu erwarten.

Datenelemente

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

• Abspielposition: Zeichnet die Abspielposition auf der Video-Timeline in Sekunden auf, wenn es in einer Tag-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.
• Erweiterungsversion: Dieses Datenelement zeichnet die YouTube-Tracking-Erweiterungsversion auf, z. B. „Video Tracking_YouTube_2.0.0“.

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 Benutzer über einen Cue-Punkt hinweg sucht. Cue-Punkt-Ereignisse werden nur ausgelöst, wenn die Abspielposition die berechnete Position des Cue-Punkts in 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 (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 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 Tag-Regel für „Videostart“

Die folgenden Video-Erweiterungsobjekte sind einzuschließen.

• Ereignisse: „Videostart“ (Dieses Ereignis löst die Regel aus, wenn der Besucher die Wiedergabe eines YouTube-Videos beginnt.)

• Bedingung: Keine

• Aktionen: Verwenden Sie die Analytics-Erweiterung für die Aktion „Variablen festlegen“, um Folgendes zuzuordnen:

  • Das Ereignis für Videostart,
  • 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 „Videostart“ mit 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'));
r.push(_satellite.getVar('Extension Version'));

return r.join('|');