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 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 Sie das Adobe Analytics-Beacon als benutzerdefinierten Linktracking-Aufruf und geben Sie einen Wert für „Link-Name“ an.
- 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 um 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“.
Erstellen Sie zum Verketten von Videoinformationswerten ein neues Datenelement mit dem Namen "Meta-Videodaten“ und programmieren Sie es so, dass alle oben aufgeführten Videodatenelemente abgerufen und zusammengestellt werden. 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('|');
Weitere Informationen zur effektiven Erstellung und Verwendung von Datenelementen in Experience Platform finden Sie in der Dokumentation Datenelemente.