Es gibt mehrere Methoden für das Tracking von Video-Ereignissen. Zwei von ihnen sind Legacy-Optionen für ältere Versionen von Adobe Analytics. Diese Legacy-Optionen sind: Legacy Milestones und Legacy Seconds.
Bevor Sie fortfahren, stellen Sie sicher, dass Sie ein abspielbares Video in AEM hochgeladen haben.
Um sicherzustellen, dass Ihre Videos auf der Seite wiedergegeben werden können, informieren Sie sich in diesem Tutorial, wie Sie Videodateien in AEM umkodieren.
Mit der folgenden Vorgehensweise können Sie ein Framework für das Videotracking mit jeder dieser Methoden einrichten.
Bei neuen Implementierung empfehlen wir, nicht die Legacy-Optionen für das Videotracking zu verwenden. Nutzen Sie stattdessen die Milestones-Methode.
Richten Sie eine Webseite ein, indem Sie eine Videokomponente aus dem Sidekick ziehen und ein abspielbares Video als Asset für die Komponente hinzufügen.
Erstellen Sie eine Adobe Analytics-Konfiguration und ein Framework.
Wählen Sie auf der Framework-Seite eine RSID aus und setzen Sie die Verwendung auf "all". (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
Ziehen Sie die Videokomponente aus der Komponentenkategorie „Allgemein“ im Sidekick in das Framework.
Wählen Sie eine Tracking-Methode aus:
Abhängig von der ausgewählten Tracking-Methode ändert sich auch die Liste der CQ-Variablen. In den folgenden Abschnitten erfahren Sie, wie Sie die Komponente weiter konfigurieren und die CQ-Variablen den Adobe Analytics-Eigenschaften zuordnen können.
Die Milestones-Methode verfolgt die meisten Informationen zum Video nach, ist hochgradig anpassbar und leicht zu konfigurieren.
Um die Milestones-Methode zu nutzen, legen Sie den zeitbasierten Tracking-Versatz fest, um die Milestones zu definieren. Wenn eine Videowiedergabe einen Meilenstein übergibt, ruft die Seite Adobe Analytics auf, um das Ereignis zu verfolgen. Für jeden Meilenstein, den Sie definieren, erstellt die Komponente eine CQ-Variable, die Sie einer Adobe Analytics-Eigenschaft zuordnen können. Der Name dieser CQ-Variablen verwendet das folgende Format:
eventdata.events.milestoneXX
Das XX-Suffix ist der Tracking-Versatz, der den Milestone definiert. Wenn Sie beispielsweise die Tracking-Versatzwerte von 4, 8, 16, 20 und 28 Sekunden festlegen, werden die folgenden CQ-Variablen generiert:
eventdata.events.milestone4
eventdata.events.milestone8
eventdata.events.milestone16
eventdata.events.milestone20
eventdata.events.milestone28
In der folgenden Tabelle sind die standardmäßigen CQ-Variablen beschrieben, die für die Milestones-Methode bereitgestellt werden:
CQ-Variablen | Adobe Analytics-Eigenschaften |
---|---|
eventdata.videoName | Variablen, die diesem zugeordnet sind, enthalten den benutzerfreundlichen-Namen (Titel) des Videos, falls im DAM festgelegt; Wenn dies nicht festgelegt ist, wird stattdessen der Dateiname des Videos gesendet. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
eventdata.videoFileName | Variablen, die diesem zugeordnet sind, enthalten den Namen der Datei. Wird nur zusammen mit eventdata.events.a.media.view gesendet |
eventdata.videoFilePath | Variablen, die diesem zugeordnet sind, enthalten den Pfad der Datei auf dem Server. Wird nur zusammen mit eventdata.events.a.media.view gesendet |
eventdata.events.a.media.segmentView | Wird jedes Mal gesendet, wenn ein Segment-Meilenstein übergeben wird |
eventdata.events.a.media.timePlayed | Wird jedes Mal gesendet, wenn ein Meilenstein ausgelöst wird, wird die Anzahl der Sekunden, die der Benutzer mit der Wiedergabe des angegebenen Segments verbracht hat, ebenfalls zusammen mit diesem Ereignis gesendet. z. B. eventX=21 |
eventdata.events.a.media.view | Wird beim Initialisieren der Videoansicht gesendet |
eventdata.events.a.media.complete | Wird gesendet, wenn die Videowiedergabe abgeschlossen ist |
eventdata.events.milestoneX | Wird gesendet, wenn der angegebene Meilenstein übergeben wird, steht X für die Sekunde, in der der Meilenstein bei ausgelöst wird. |
eventdata.a.contentType | Wird auf jedem Meilenstein gesendet; wird im Adobe Analytics-Aufruf als pev3 angezeigt, normalerweise als "video" gesendet |
eventdata.a.media.name | Sucht genau nach eventdata.videoName |
eventdata.a.media.segment | Enthält Informationen zum angezeigten Segment, z. B. 2:O:4-8 |
Sie können den benutzerfreundlichen-Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung in DAM öffnen und das Metadatenfeld Titel auf den gewünschten Namen setzen.
Nachdem Sie Milestones als Tracking-Methode ausgewählt haben, geben Sie im Kasten „Versatz nachverfolgen“ eine kommagetrennte Liste der Tracking-Versätzen in Sekunden ein. Beispielsweise definieren die folgenden Werte Milestones bei 4, 8, 16, 20 und 28 Sekunden nach Start des Videos:
4,8,16,20,24
Die Versatzwerte müssen Ganzzahlen größer als 0 sein. Der Standardwert ist 10,25,50,75
.
Um die CQ-Variablen den Adobe Analytics-Eigenschaften zuzuordnen, ziehen Sie die Adobe Analytics-Eigenschaften aus ContentFinder neben die CQ-Variable auf die Komponente.
Weitere Informationen zum Optimieren der Zuordnungen finden Sie im Handbuch Videomessung in Adobe Analytics .
Fügen Sie das Framework zur Seite hinzu.
Um das Setup in Vorschaumodus zu testen, spielen Sie das Video ab, um Adobe Analytics-Aufrufe an Trigger zu erhalten.
Die folgenden Beispiele für Adobe Analytics-Tracking-Daten gelten für das Meilensteintracking mit Tracking-Versatzwerten von 4,8,16,20 und 24 sowie die folgenden Zuordnungen für die CQ-Variablen:
CQ-Variable | Adobe Analytics-Eigenschaft |
---|---|
eventdata.videoName | prop2 |
eventdata.videoFileName | prop3 |
eventdata.videoFilePath | prop4 |
eventdata.events.a.media.segmentView | event1 |
eventdata.events.a.media.timePlayed | event2 |
eventdata.events.a.media.view | event3 |
eventdata.events.a.media.complete | event4 |
eventdata.events.milestone4 | event10 |
eventdata.events.milestone8 | event11 |
eventdata.events.milestone16 | event12 |
eventdata.events.milestone20 | event13 |
eventdata.events.milestone24 | event14 |
eventdata.a.contentType | eVar3 |
eventdata.a.media.name | eVar1, prop1 |
eventdata.a.media.segment | eVar2 |
Bei diesem Beispiel wird die Videokomponente wie folgt auf der Framework-Seite angezeigt:
Um die Aufrufe an Adobe Analytics anzuzeigen, verwenden Sie ein geeignetes Tool wie DigitalPulse Debugger oder Fiddler.
Aufrufe an Adobe Analytics mit dem angegebenen Beispiel sollten wie folgt aussehen, wenn sie mit DigitalPulse Debugger angezeigt werden:
Dies ist der ersteAufruf an Adobe Analytics mit den folgenden Werten:
Dies ist der dritte Aufrufan Adobe Analytics:
Die Methode „Non-Legacy Milestones“ ähnelt der Milestones-Methode, mit dem Unterschied, dass Milestones mit Prozentwerten der Titellänge definiert werden. Folgende Gemeinsamkeiten liegen vor:
Der Name dieser CQ-Variablen verwendet das folgende Format:
Das XX-Suffix ist der Prozentwert der Titellänge, der den Milestone definiert. Wenn Sie z. B. die Prozentwerte 10, 25, 50 und 75 festlegen, werden die folgenden CQ-Variablen erzeugt:
eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75
eventdata.events.milestoneXX
Nachdem Sie Non-Legacy Milestones als Tracking-Methode ausgewählt haben, geben Sie im Kasten „Versatz nachverfolgen“ eine kommagetrennte Liste der Prozentwerte der Titellänge ein. Beispielsweise definiert der folgende Standardwert Milestones bei 10, 25, 50 und 75 Prozent der Titellänge:
10,25,50,75
Die Versatzwerte müssen Ganzzahlen größer als 0 sein.
Um die CQ-Variablen den Adobe Analytics-Eigenschaften zuzuordnen, ziehen Sie die Adobe Analytics-Eigenschaften aus ContentFinder neben die CQ-Variable auf die Komponente.
Weitere Informationen zum Optimieren der Zuordnungen finden Sie im Handbuch Videomessung in Adobe Analytics .
Fügen Sie das Framework zur Seite hinzu.
Um das Setup in Vorschaumodus zu testen, spielen Sie das Video ab, um Adobe Analytics-Aufrufe an Trigger zu erhalten.
Diese Methode ähnelt der Milestones-Methode, mit dem Unterschied, dass die im Feld Versatz nachverfolgen festgelegten Milestones Prozentwerte sind statt fester Punkte im Video.
Das Feld „Versatz nachverfolgen“ akzeptiert nur eine kommagetrennte Liste mit Ganzzahlen zwischen 1 und 100.
Legen Sie die Tracking-Versatzwerte fest.
Außerdem können die an Adobe Analytics gesendeten Informationen weniger angepasst werden. Es sind nur drei Variablen für die Zuordnung verfügbar:
eventdata.videoName |
Variablen, die diesem zugeordnet sind, enthalten den benutzerfreundlichen-Namen (Titel) des Videos, falls im DAM festgelegt; Wenn der Titel nicht festgelegt ist, wird stattdessen der Dateiname des Videos gesendet. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
eventdata.videoFileName | Variablen, die diesem zugeordnet sind, enthalten den Namen der Datei. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
eventdata.videoFilePath | Die dieser Variablen zugeordnete Variable enthält den Pfad der Datei auf dem Server. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
Sie können den benutzerfreundlichen-Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung in DAM öffnen und das Metadatenfeld Titel auf den gewünschten Namen setzen. Wenn Sie fertig sind, müssen Sie die Änderungen speichern.
Ordnen Sie diese Variablen zu props 1 bis 3 zu.
Der Rest der relevanten Informationen im Aufruf wird verkettet in eine-Variable namens pev3 gesendet.
Beispielaufrufe an Adobe Analytics mit dem angegebenen Beispiel sollten wie folgt aussehen, wenn sie mit DigitalPulse Debugger angezeigt werden:
Die pev3-Variable, die bei dem Aufruf gesendet wird, enthält die folgenden Informationen:
Name - Der Name der Videodatei (film.avi)
Länge - Die Länge der Videodatei in Sekunden (100)
Player Name - Der Videoplayer, mit dem die Videodatei wiedergegeben wird (HTML5-Video)
Gesamtzahl der wiedergegebenen Sekunden - Die Gesamtanzahl der Sekunden, in denen das Video wiedergegeben wurde (25)
Start-Zeitstempel - Zeitstempel, der angibt, wann die Videowiedergabe gestartet wurde (1331035567)
Wiedergabesitzung - Die Details der Wiedergabesitzung. Dieses Feld gibt an, wie der Benutzer mit dem Video interagiert hat. Dazu können Daten gehören, wie z. B. wo sie mit der Wiedergabe des Videos begonnen haben, ob sie den Videoregler zum Voranbringen des Videos verwendet haben und wo sie die Wiedergabe des Videos angehalten haben (L10E24S58L58 - Video wurde bei Sekunde angehalten. 25 von Abschnitt L10 angehalten, dann sprang der Benutzer zu Sekunde 48)
Bei Verwendung der Methode "Alte Sekunden**"werden alle N Sekunden Adobe Analytics-Aufrufe ausgelöst, wobei N im Feld Versatz verfolgen angegeben ist.
Setzen Sie den Versatz "Verfolgen"auf eine beliebige Anzahl von Sekunden.
Das Feld „Vesatz nachverfolgen“ akzeptiert nur Ganzzahlen, die größer als 0 sind.
Die Informationen, die an Adobe Analytics gesendet werden, sind weniger anpassbar. Für die Zuordnung stehen nur drei Variablen zur Verfügung:
eventdata.videoName |
Variablen, die diesem zugeordnet sind, enthalten den benutzerfreundlichen-Namen (Titel) des Videos, falls im DAM festgelegt; Wenn der Titel nicht festgelegt ist, wird stattdessen der Dateiname des Videos gesendet. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
eventdata.videoFileName | Die dieser Variablen zugeordnete Variable enthält den Namen der Datei. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
eventdata.videoFilePath | Die dieser Variablen zugeordnete Variable enthält den Pfad der Datei auf dem Server. Nur einmal gesendet, zu Beginn der Videowiedergabe. |
Sie können den benutzerfreundlichen-Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung in DAM öffnen und das Metadatenfeld Titel auf den gewünschten Namen setzen. Wenn Sie fertig sind, müssen Sie die Änderungen speichern.
Ordnen Sie diese Variablen zu prop1, prop2 und prop3 zu.
Die übrigen relevanten Informationen des Aufrufs werden zusammenhängend in einer Variablen namens pev3 gesendet.
Aufrufe an Adobe Analytics mit dem angegebenen Beispiel sollten wie folgt aussehen, wenn sie mit DigitalPulse Debugger angezeigt werden:
Der Aufruf ähnelt dem o. g. Legacy Milestones-Aufruf. Informationen zu pev3 finden Sie dort.
In diesem Tutorial verwendete Referenzen:
[0] https://docs.adobe.com/content/help/de-DE/media-analytics/using/media-overview.html