Konfigurieren von Video-Tracking für Adobe Analytics configuring-video-tracking-for-adobe-analytics

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

Es gibt verschiedene Methoden zum Verfolgen von Videoereignissen. Zwei davon sind veraltete Optionen für ältere Versionen von Adobe Analytics. Diese Legacy-Option ist: Legacy-Meilensteine und Legacy Seconds.

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

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

Allgemeine Schritte common-steps

  1. Richten Sie eine Web-Seite 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 Konfiguration und ein Framework für Adobe Analytics.

    • Bei den Beispielen in den folgenden Abschnitten wird my-sc-configuration für die Konfiguration genutzt und videofw für das Framework.
  3. Wählen Sie auf der Framework-Seite eine RSID aus und legen Sie die Nutzung auf „alle“ 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.

Milestones milestones

Die Meilensteinmethode verfolgt die meisten Informationen über das Video, ist stark anpassbar und leicht zu konfigurieren.

Um die Meilensteinmethode zu verwenden, geben Sie zeitbasierte Tracking-Offsets an, um die Meilensteine zu definieren. Wenn eine Videowiedergabe einen Milestone erreicht, ruft die Seite Adobe Analytics auf, um das Ereignis nachzuverfolgen. Für jeden Milestone, 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-Offset, der den Meilenstein definiert. So erzeugt die Festlegung der Tracking-Versatzwerte auf 4, 8, 16, 20 und 28 Sekunden die folgenden CQ-Variablen:

  • 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 Eigenschaft zugeordnet sind, enthalten den Anzeigenamen (Titel) des Videos, sofern dieser im DAM festgelegt ist. Wenn dieser nicht festgelegt ist, wird stattdessen der Dateiname gesendet. Nur einmal gesendet, zu Beginn der Videowiedergabe.
eventdata.videoFileName
Variablen, die dieser Eigenschaft zugeordnet sind, enthalten den Namen der Datei. Wird nur zusammen mit eventdata.events.a.media.view gesendet
eventdata.videoFilePath
Variablen, die dieser Eigenschaft 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-Milestone übergeben wird
eventdata.events.a.media.timePlayed
Wird jedes Mal gesendet, wenn ein Milestone ausgelöst wird. Die Anzahl der Sekunden, die Benutzende mit der Wiedergabe des angegebenen Segments verbracht haben, wird 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 Milestone übergeben wird. X steht für die Sekunde, bei der der Milestone ausgelöst wird.
eventdata.a.contentType
Wird bei jedem Milestone gesendet. Wird im Adobe Analytics-Aufruf als „pev3“ angezeigt und 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. 24-8
NOTE
Sie können den benutzerfreundlichen Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung in DAM öffnen und die Titel Metadatenfeld zum gewünschten Namen.
  1. Nachdem Sie Meilensteine als Tracking-Methode ausgewählt haben, geben Sie im Feld "Versatz verfolgen"eine kommagetrennte Liste der Tracking-Versätze in Sekunden ein. Beispielsweise definiert der folgende Wert Meilensteine bei 4, 8, 16, 20 und 28 Sekunden nach dem Anfang des Videos:

    code language-xml
    4,8,16,20,24
    

    Die Offset-Werte müssen Ganzzahlen größer als 0 sein. Der Standardwert ist 10,25,50,75.

  2. Um die CQ-Variablen zu Adobe Analytics-Eigenschaften zuzuordnen, ziehen Sie die Adobe Analytics-Eigenschaften vom Content Finder neben der CQ-Variablen auf die Komponente.

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

  3. Fügen Sie das Framework zur Seite hinzu.

  4. Um die Einrichtung im Vorschaumodus zu testen, geben Sie das Video wieder, damit die Adobe Analytics-Aufrufe ausgelöst werden.

Die folgenden Beispiele für Adobe Analytics-Tracking-Daten gelten für die Milestones-Nachverfolgung mit Tracking-Versätzen von 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
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:

video1

NOTE
Um die Aufrufe an Adobe Analytics zu sehen, verwenden Sie ein entsprechendes Tool wie DigitalPulse Debugger oder Fiddler.

Aufrufe an Adobe Analytics mit dem gezeigten Beispiel sollten wie folgt aussehen, wenn Sie sie mit DigitalPulse Debugger anzeigen:

chlimage_1-156

Dies ist der erste Aufruf ​an Adobe Analytics mit den folgenden Werten:

  • prop1 und eVar1 für eventdata.a.media.name,
  • props2–4 zusammen mit eVar2 und eVar3, wobei contentType (video) und segment (11–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)

Nicht veraltete Meilensteine non-legacy-milestones

Die Nicht-Legacy-Meilensteinmethode ähnelt der Meilensteinmethode, mit der Ausnahme, dass Meilensteine mit Prozentsätzen der Verfolgungslänge definiert werden. Folgende Gemeinsamkeiten treten auf:

  • Wenn eine Videowiedergabe einen Milestone erreicht, ruft die Seite Adobe Analytics auf, um das Ereignis nachzuverfolgen.
  • Der statische Satz an CQ-Variablen, die für die Zuordnung zu Adobe Analytics-Eigenschaften definiert sind.
  • Für jeden Milestone, 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:

Das XX-Suffix ist der Prozentsatz der Verfolgungslänge, der den Meilenstein definiert. Wenn Sie beispielsweise die Prozentsätze 10, 25, 50 und 75 angeben, werden die folgenden CQ-Variablen generiert:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. Nachdem Sie als Tracking-Methode Nicht-Legacy-Meilensteine ausgewählt haben, geben Sie im Feld "Versatz verfolgen"eine kommagetrennte Liste mit Prozentsätzen der Verfolgungslänge ein. Der folgende Standardwert definiert beispielsweise Meilensteine bei 10, 25, 50 und 75 Prozent der Verfolgungslänge:

    code language-xml
    10,25,50,75
    

    Die Offset-Werte müssen Ganzzahlen größer als 0 sein.

  2. Um die CQ-Variablen zu Adobe Analytics-Eigenschaften zuzuordnen, ziehen Sie die Adobe Analytics-Eigenschaften vom Content Finder neben der CQ-Variablen auf die Komponente.

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

  3. Fügen Sie das Framework zur Seite hinzu.

  4. Um die Einrichtung im Vorschaumodus zu testen, geben Sie das Video wieder, damit die Adobe Analytics-Aufrufe ausgelöst werden.

Legacy Milestones legacy-milestones

Diese Methode ähnelt der Milestones-Methode mit dem Unterschied, dass die in der Tracking-Offset -Feld sind Prozentsätze anstelle von festgelegten Punkten im Video.

NOTE
Das Feld Tracking Offset akzeptiert nur eine kommagetrennte Liste mit Ganzzahlen zwischen 1 und 100.
  1. Legen Sie den Versatz "Verfolgen"fest.

    • e.g.10,50,75,100

    Die Informationen, die an Adobe Analytics gesendet werden, sind nur begrenzt anpassbar. Für die Zuordnung stehen nur drei Variablen zur Verfügung:

eventdata.videoName
Variablen, die dieser Eigenschaft zugeordnet sind, enthalten den Anzeigenamen (Titel) des Videos, sofern dieser im DAM festgelegt ist. Wenn dieser nicht festgelegt ist, wird stattdessen der Dateiname gesendet. Nur einmal gesendet, zu Beginn der Videowiedergabe.
eventdata.videoFileName
Variablen, die dieser Eigenschaft zugeordnet sind, enthalten den Namen der Datei. Nur einmal gesendet, zu Beginn der Videowiedergabe.
eventdata.videoFilePath
Hier zugeordnete Variablen enthalten den Dateipfad auf dem Server. Nur einmal gesendet, zu Beginn der Videowiedergabe.
NOTE
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.
  1. Ordnen Sie diese Variablen zu props 1 bis 3 zu.

    Die der übrigen einschlägigen Informationen im Aufruf wird mit one Variable namens pev3.

    Beispielaufrufe an Adobe Analytics mit dem gezeigten Beispiel sollten wie folgt aussehen, wenn Sie sie mit DigitalPulse Debugger anzeigen:

    lmilestones1

    Die pev3-Variable, die bei dem Aufruf gesendet wird, enthält die folgenden Informationen:

    • Name: der Name der Videodatei (film.avi)
    • Length: die Länge der Videodatei in Sekunden (100)
    • Player Name: der Video-Player für die Wiedergabe der Videodatei (HTML5 video)
    • Total Seconds Played: die Gesamtzahl an Sekunden, wie lange das Video wiedergegeben wurde (25)
    • Start Timestamp: Zeitstempel, der angibt, wann die Videowiedergabe gestartet ist (1331035567)
    • Play Session: die Details der Wiedergabesitzung. Dieses Feld gibt an, wie Benutzende mit dem Video interagiert haben. Dazu gehören Daten wie: wo haben sie die Wiedergabe des Videos gestartet, haben sie mit dem Videoregler das Video vorgespult, wo haben sie die Wiedergabe angehalten (L10E24S58L58 – Video wurde bei Sekunde 25 von Abschnitt L10, dann übersprungen auf Sek. 48)

Ältere Sekunden legacy-seconds

Bei Nutzung der Legacy Seconds-Methode werden Adobe Analytics-Aufrufe alle N Sekunden ausgelöst, wobei N im Feld „Versatz nachverfolgen“ festgelegt ist.

  1. Legen Sie den Tracking-Versatz auf eine beliebige Anzahl an Sekunden fest.

    • z. B. 6
    note note
    NOTE
    Das Feld „Versatz 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 dieser Eigenschaft zugeordnet sind, enthalten den Anzeigenamen (Titel) des Videos, sofern dieser im DAM festgelegt ist. Wenn dieser nicht festgelegt ist, wird stattdessen der Dateiname gesendet. Nur einmal gesendet, zu Beginn der Videowiedergabe.
eventdata.videoFileName
Die dieser Eigenschaft zugeordnete Variable enthält den Namen der Datei. Nur einmal gesendet, zu Beginn der Videowiedergabe.
eventdata.videoFilePath
Hier zugeordnete Variablen enthalten den Dateipfad auf dem Server. Nur einmal gesendet, zu Beginn der Videowiedergabe.
NOTE
Sie können den benutzerfreundlichen Namen eines Videos festlegen, indem Sie das Video zur Bearbeitung in DAM öffnen und die Titel Metadatenfeld zum gewünschten Namen. Wenn Sie fertig sind, müssen Sie die Änderungen speichern.
  1. Ordnen Sie diese Variablen prop1, prop2 und prop3 zu

    Die der übrigen einschlägigen Informationen im Aufruf wird mit one Variable namens pev3.

    Aufrufe an Adobe Analytics mit dem gezeigten Beispiel sollten wie folgt aussehen, wenn Sie sie mit DigitalPulse Debugger anzeigen:

    lseconds

    Der Aufruf ähnelt dem obigen Legacy Milestones-Aufruf. Weitere Informationen finden Sie unter pev3 .sofern vorhanden.

In diesem Tutorial verwendete Referenzen:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/sdk-implement/setup/setup-overview.html?lang=de?lang=de

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8