Konfigurieren von Videotracking für Adobe Analytics

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.

HINWEIS

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.

HINWEIS

Bei neuen Implementierung empfehlen wir, nicht die Legacy-Optionen für das Videotracking zu verwenden. Nutzen Sie stattdessen die Milestones-Methode.

Allgemeine Schritte

  1. 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.

  2. Erstellen Sie eine Adobe Analytics-Konfiguration und ein Framework.

    • Die folgenden Beispiele in den folgenden Abschnitten verwenden den Namen my-sc-configuration für die Konfiguration und videofw für das Framework.
  3. Wählen Sie auf der Seite "Framework"eine RSID aus und legen Sie die Nutzung auf "all"fest. (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. Ziehen Sie die Videokomponente aus der Komponentenkategorie „Allgemein“ im Sidekick in das Framework.

  5. Wählen Sie eine Tracking-Methode aus:

  6. 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.

Milestones

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 erreicht, ruft die Seite Adobe Analytics auf, um das Ereignis zu verfolgen. Für jeden von Ihnen definierten Meilenstein 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 einen Verfolgungsoffset 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 dieser Variablen zugeordnet sind, enthalten den benutzerfreundlichen -Namen (Title) 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 dieser Datei zugeordnet sind, enthalten den Namen der Datei. Wird nur zusammen mit eventData.Ereignisses.a.media.Ansicht gesendet
eventdata.videoFilePath Variablen, die dieser Datei zugeordnet sind, enthalten den Pfad der Datei auf dem Server. Wird nur zusammen mit eventData.Ereignisses.a.media.Ansicht 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 dem Anzeigen des angegebenen Segments verbracht hat, zusammen mit diesem Ereignis gesendet. z. B. eventX=21
eventdata.events.a.media.view Wird bei der Initialisierung der Video-Ansicht gesendet
eventdata.events.a.media.complete Wird gesendet, wenn die Wiedergabe des Videos beendet 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 an jedem Meilenstein gesendet; wird im Adobe Analytics-Aufruf als pev3 angezeigt, normalerweise als "video"
gesendet
eventdata.a.media.name Stimmt genau mit eventData.videoName überein
eventdata.a.media.segment Enthält Informationen zum angezeigten Segment, z. B. 2:O:4-8
HINWEIS

Sie können den benutzerfreundlichen Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung im DAM öffnen und das Metadatenfeld Titel auf den gewünschten Namen setzen.

  1. 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.

  2. Um die CQ-Variablen den Adobe Analytics-Eigenschaften zuzuordnen, ziehen Sie die Adobe Analytics-Eigenschaften aus ContentFinder neben der CQ-Variablen auf der Komponente.

    Informationen zum Optimieren der Zuordnungen finden Sie im Handbuch Videomessung in Adobe Analytics.

  3. hinzufügen Sie das Framework auf die Seite.

  4. Um das Setup im Vorschau-Modus zu testen, spielen Sie das Video ab, um Adobe Analytics-Aufrufe an Trigger zu erhalten.

Die folgenden Adobe Analytics-Verfolgungsdatenbeispiele gelten für die Meilensteinverfolgung mit Verfolgungsoffset 4,8,16,20 und 24 und den 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 ereignis4
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:

video1

HINWEIS

Um die Aufrufe an Adobe Analytics anzuzeigen, verwenden Sie ein geeignetes Tool wie DigitalPulse Debugger oder Fiddler.

Aufrufe an Adobe Analytics mit dem bereitgestellten Beispiel sollten wie folgt aussehen, wenn sie mit dem DigitalPulse Debugger angezeigt werden:

chlimage_1-156

Dies ist der erste​Aufruf an Adobe Analytics, der die folgenden Werte enthält:

  • prop1 und eVar1 für eventdata.a.media.name,
  • props2–4 zusammen mit eVar2 und eVar3, wobei contentType (video) und segment (1:O:1-4) enthalten sind
  • event3, das eventdata.events.a.media.view zugeordnet wurde

chlimage_1-157

Dies ist der dritte Aufruf​an Adobe Analytics:

  • prop1 und eVar1 enthaltena.media.name;
  • event1, da ein Segment angesehen wurde
  • event2, gesendet mit der wiedergegebenen Zeit = 4
  • event11 gesendet, weil eventdata.events.milestone8 erreicht wurde
  • prop2 bis 4 wurden nicht gesendet (da eventdata.events.a.media.view nicht ausgelöst wurde)

Non-Legacy Milestones

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:

  • Wenn eine Videowiedergabe einen Meilenstein erreicht, ruft die Seite Adobe Analytics auf, um das Ereignis zu verfolgen.
  • Der statische Satz von CQ-Variablen, die für die Zuordnung zu Adobe Analytics-Eigenschaften definiert sind.
  • Für jeden von Ihnen definierten Meilenstein erstellt die Komponente eine CQ-Variable, die Sie einer Adobe Analytics-Eigenschaft zuordnen können.

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
  1. 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.

  2. Um die CQ-Variablen den Adobe Analytics-Eigenschaften zuzuordnen, ziehen Sie die Adobe Analytics-Eigenschaften aus ContentFinder neben der CQ-Variablen auf der Komponente.

    Informationen zum Optimieren der Zuordnungen finden Sie im Handbuch Videomessung in Adobe Analytics.

  3. hinzufügen Sie das Framework auf die Seite.

  4. Um das Setup im Vorschau-Modus zu testen, spielen Sie das Video ab, um Adobe Analytics-Aufrufe an Trigger zu erhalten.

Legacy Milestones

Diese Methode ähnelt der Milestones-Methode, mit dem Unterschied, dass die im Feld Versatz nachverfolgen festgelegten Milestones Prozentwerte sind statt fester Punkte im Video.

HINWEIS

Das Feld „Versatz nachverfolgen“ akzeptiert nur eine kommagetrennte Liste mit Ganzzahlen zwischen 1 und 100.

  1. Legen Sie die Tracking-Versatzwerte fest.

    • Beispiel: 10, 50, 75, 100

    Außerdem sind die an Adobe Analytics gesendeten Informationen weniger anpassbar. Es sind nur drei Variablen für die Zuordnung verfügbar:

eventData.videoName
Variablen, die dieser Variablen zugeordnet sind, enthalten den benutzerfreundlichen -Namen (Title) 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 dieser Datei 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.
HINWEIS

Sie können den benutzerfreundlichen Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung im DAM öffnen und das Metadatenfeld Titel auf den gewünschten Namen setzen. Wenn Sie fertig sind, müssen Sie die Änderungen speichern.

  1. Ordnen Sie diese Variablen zu props 1 bis 3 zu.

    Die übrigen relevanten Informationen des Aufrufs werden zusammenhängend in einer Variablen namens pev3 gesendet.

    Beispiel- Aufrufe an Adobe Analytics mit dem bereitgestellten Beispiel sollten wie folgt aussehen, wenn sie mit dem DigitalPulse-Debugger angezeigt werden:

    lmilestones1

    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)
    • Playername - Der Videoplayer, mit dem die Videodatei wiedergegeben wird (HTML5-Video)
    • Abgespielte Sekunden gesamt - Die Gesamtdauer der Sekunden, in denen das Video abgespielt wurde (25)
    • Beginn-Zeitstempel - Zeitstempel, der angibt, wann die Videowiedergabe gestartet wurde (1331035567)
    • Sitzung abspielen - Die Details der Wiedergabesitzung. Dieses Feld gibt an, wie der Benutzer mit dem Video interagiert hat. Dazu zählen Daten wie der Beginn der Videowiedergabe, die Verwendung des Videoreglers zum Vorspulen des Videos und die Einstellung der Videowiedergabe (L10E24S58L58 - Video wurde um Sekunden gestoppt. 25 von Abschnitt L10 angehalten, dann sprang der Benutzer zu Sekunde  48)

Legacy Seconds

Bei Verwendung der​-Methode aus älteren Sekunden werden alle N Sekunden Adobe Analytics-Aufrufe ausgelöst, wobei N im Feld für den Versatz der Verfolgung angegeben ist.

  1. Setzen Sie den Versatz für die Verfolgung auf eine beliebige Anzahl Sekunden,

    • Beispiel: 6
    HINWEIS

    Das Feld „Vesatz nachverfolgen“ akzeptiert nur Ganzzahlen, die größer als 0 sind.

    Die an Adobe Analytics gesendeten Informationen können weniger angepasst werden. Für die Zuordnung stehen nur drei Variablen zur Verfügung:

eventData.videoName
Variablen, die dieser Variablen zugeordnet sind, enthalten den benutzerfreundlichen -Namen (Title) 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 Dateinamen. 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.
HINWEIS

Sie können den benutzerfreundlichen Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung im DAM öffnen und das Metadatenfeld Titel auf den gewünschten Namen setzen. Wenn Sie fertig sind, müssen Sie die Änderungen speichern.

  1. 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 bereitgestellten Beispiel sollten wie folgt aussehen, wenn sie mit dem DigitalPulse Debugger angezeigt werden:

    lseconds

    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/sdk-implement/setup/setup-overview.html

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free