Konfigurera videospårning för Adobe Analytics configuring-video-tracking-for-adobe-analytics

Det finns flera metoder för att spåra videohändelser, varav två är äldre alternativ för äldre versioner av Adobe Analytics. De här äldre alternativen är: Äldre milstolpar och Äldre sekunder.

NOTE
Innan du fortsätter bör du kontrollera att du har överfört en uppspelningsbar video i AEM.
Om du vill vara säker på att dina videofilmer spelas upp på sidan kan du läsa den här självstudiekursen för mer information om hur du kodar om videofiler i AEM.

Använd följande procedur för att konfigurera ett ramverk för videospårning med hjälp av varje metod.

NOTE
För nya implementeringar rekommenderar vi att du inte använder de äldre alternativen för videospårning. Använd metoden Milstolpar i stället.

Vanliga steg common-steps

  1. Konfigurera en webbsida genom att dra en videokomponent från sidosparken och lägga till en uppspelningsbar video som en resurs för komponenten

  2. Skapa en Adobe Analytics-konfiguration och ett ramverk.

    • Exemplen i de efterföljande avsnitten använder namnet my-sc-configuration för konfigurationen och videofunktionen för ramverket.
  3. På ramverkssidan väljer du ett RSID och anger användningen till alla. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. Dra videokomponenten från kategorin Allmänt i Sidekick till ramverket.

  5. Välj en spårningsmetod:

  6. När du väljer en spårningsmetod ändras listan med CQ-variabler därefter. Använd följande avsnitt för information om hur du konfigurerar komponenten ytterligare och mappar CQ-variablerna med Adobe Analytics-egenskaper.

Milstolpar milestones

Metoden milstolpar håller reda på den mesta informationen om videon, är mycket anpassningsbar och enkel att konfigurera.

Om du vill använda metoden milstolpar anger du tidsbaserade spårförskjutningar för att definiera milstolparna. När en videouppspelning passerar en milstolpe anropar sidan Adobe Analytics för att spåra händelsen. För varje milstolpe som du definierar skapar komponenten en CQ-variabel som du kan mappa till en Adobe Analytics-egenskap. Namnet på CQ-variablerna har följande format:

eventdata.events.milestoneXX

Suffixet XX är den spårförskjutning som definierar milstolpen. Om du till exempel anger spårförskjutningar på 4, 8, 16, 20 och 28 sekunder genereras följande CQ-variabler:

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

I följande tabell beskrivs CQ-standardvariablerna som anges för metoden Milestone:

CQ-variabler
Adobe Analytics-egenskaper
eventdata.videoName
Variabler som mappas till detta kommer att innehålla det användarvänliga namnet (Title) för videon om det anges i DAM. Om detta inte anges skickas videons filnamn i stället. Skickas endast en gång, i början av uppspelningen av en video.
eventdata.videoFileName
Variabler som mappas till detta innehåller filens namn. Endast skickat tillsammans med eventdata.events.a.media.view
eventdata.videoFilePath
Variabler som mappas till detta innehåller filens sökväg på servern. Endast skickat tillsammans med eventdata.events.a.media.view
eventdata.events.a.media.segmentView
Skickas varje gång en milstolpe för ett segment passeras
eventdata.events.a.media.timePlayed
Skickas varje gång en milstolpe aktiveras, skickas även antalet sekunder som användaren har ägnat åt att titta på det aktuella segmentet tillsammans med den här händelsen. eventX=21
eventdata.events.a.media.view
Skickat när videovyn initieras
eventdata.events.a.media.complete
Skickat när videon har spelats upp
eventdata.events.milestoneX
Skickas när den angivna milstolpen skickas, X står för den sekund som milstolpen utlöses vid
eventdata.a.contentType
Skickat på varje milstolpe. Visas som pev3 i Adobe Analytics-anropet, skickas vanligtvis som video
eventdata.a.media.name
Matchar exakt eventdata.videoName
eventdata.a.media.segment
Innehåller information om segmentet som har visats, till exempel 2:O:4-8
NOTE
Du kan ange ett användarvänligt-namn för en video genom att öppna videon för redigering i DAM och ange det önskade namnet i metadatafältet Titel .
  1. När du har valt milstolpar som spårningsmetod anger du en kommaseparerad lista med spårningsförskjutningar i sekunder i rutan Spåra förskjutning. Följande värde definierar till exempel milstolpar vid 4, 8, 16, 20 och 28 sekunder efter videostarten:

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

    Förskjutningsvärdena måste vara heltal som är större än 0. Standardvärdet är 10,25,50,75.

  2. Om du vill mappa CQ-variablerna till Adobe Analytics-egenskaper drar du Adobe Analytics-egenskaperna från ContentFinder bredvid CQ-variabeln för komponenten.

    Mer information om hur du optimerar mappningarna finns i guiden Mäta video i Adobe Analytics.

  3. Lägg till ramverket på sidan.

  4. Om du vill testa konfigurationen i förhandsgranskningsläget spelar du upp videon och får Adobe Analytics-anrop att utlösa.

De följande exemplen på spårningsdata för Adobe Analytics gäller för spårning av milstolpar med hjälp av spårförskjutningar på 4,8,16,20 och 24, och följande mappningar för CQ-variablerna:

CQ-variabel
Adobe Analytics, egenskap
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

I det här exemplet visas videokomponenten på följande sätt på ramverkssidan:

video1

NOTE
Om du vill se anropen till Adobe Analytics använder du ett lämpligt verktyg, som DigitalPulse Debugger eller Fiddler.

Anrop till Adobe Analytics som använder exemplet ska se ut så här när de visas med DigitalPulse Debugger:

chlimage_1-128

Detta är det första anropet ​som gjorts till Adobe Analytics och som innehåller följande värden:

  • prop1 och eVar1 för eventdata.a.media.name,
  • props2-4, tillsammans med eVar2 och eVar3 som innehåller contentType (video) och segment (11-4)
  • event3 som har mappats till eventdata.events.a.media.view.

chlimage_1-129

Detta är det tredje anropet ​som gjorts till Adobe Analytics:

  • prop1 och eVar1 innehåller a.media.name;
  • event1 eftersom ett segment har visats
  • event2 skickad med uppspelad tid = 4
  • event11 har skickats eftersom eventdata.events.milestone8 har nåtts
  • prop2 till 4 skickas inte (eftersom eventdata.events.a.media.view inte utlöstes)

Icke-äldre milstolpar non-legacy-milestones

Metoden Icke-äldre milstolpar liknar metoden milstolpar, förutom att milstolpar definieras med procentvärden av spårlängden. Följande är gemensamma:

  • När en videouppspelning passerar en milstolpe anropar sidan Adobe Analytics för att spåra händelsen.
  • Den statiska uppsättningen CQ-variabler som har definierats för mappning med Adobe Analytics-egenskaper.
  • För varje milstolpe som du definierar skapar komponenten en CQ-variabel som du kan mappa till en Adobe Analytics-egenskap.

Namnet på CQ-variablerna har följande format:

Suffixet XX är den procentandel av spårlängden som definierar milstolpen. Om du till exempel anger procenttal på 10, 25, 50 och 75 genereras följande CQ-variabler:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. När du har valt Icke-äldre milstolpar som spårningsmetod anger du en kommaseparerad lista med procentvärden för spårlängd i rutan Spårförskjutning. Följande standardvärde definierar till exempel milstolpar vid 10, 25, 50 och 75 procent av spårlängden:

    code language-xml
    10,25,50,75
    

    Förskjutningsvärdena måste vara heltal som är större än 0.

  2. Om du vill mappa CQ-variablerna till Adobe Analytics-egenskaper drar du Adobe Analytics-egenskaperna från ContentFinder bredvid CQ-variabeln för komponenten.

    Mer information om hur du optimerar mappningarna finns i guiden Mäta video i Adobe Analytics.

  3. Lägg till ramverket på sidan.

  4. Om du vill testa konfigurationen i förhandsgranskningsläget spelar du upp videon och får Adobe Analytics-anrop att utlösa.

Äldre milstolpar legacy-milestones

Den här metoden liknar metoden milstolpar med skillnaden att de milstolpar som anges i fältet Spårningsförskjutning är procentvärden i stället för att ange punkter i videon.

NOTE
I fältet Spårningsförskjutning accepteras bara en kommaseparerad lista som innehåller heltal mellan 1 och 100.
  1. Ange spårförskjutning.

    • till exempel 10,50,75,100

    Dessutom är informationen som skickas till Adobe Analytics mindre anpassningsbar. Det finns bara tre variabler för mappning:

eventdata.videoName
Variabler som mappas till detta kommer att innehålla det användarvänliga namnet (Title) för videon om det anges i DAM. Om titeln inte anges skickas videons filnamn i stället. Skickas endast en gång, i början av uppspelningen av en video.
eventdata.videoFileName
Variabler som mappas till detta innehåller filens namn. Skickas endast en gång, i början av uppspelningen av en video.
eventdata.videoFilePath
Variabeln som mappas till detta kommer att innehålla filens sökväg på servern. Skickas endast en gång, i början av uppspelningen av en video.
NOTE
Du kan ange ett användarvänligt-namn för en video genom att öppna videon för redigering i DAM och ange det önskade namnet i metadatafältet Titel . Du måste också spara ändringarna som gjorts när du är klar.
  1. Mappa dessa variabler till steg 1 till 3

    Resten av den relevanta informationen i anropet skickas sammanfogat till variabeln one med namnet pev3.

    Exempelanrop till Adobe Analytics med det angivna exemplet ska se ut så här när det visas med DigitalPulse Debugger:

    milstolpar1

    Variabeln pev3 ​som skickades i anropet innehåller följande information:

    • Namn - Namnet på videofilen (film.avi)

    • Längd - längden på videofilen, i sekunder (100)

    • Spelarnamn - Den videospelare som används för att spela upp videofilen (HTML5-video)

    • Totalt antal sekunder som spelats upp - Totalt antal sekunder som videon spelades upp (25)

    • Starttidsstämpel - Tidsstämpel som identifierar när videouppspelningen startade (1331035567)

    • Spela upp session - Information om uppspelningssessionen. I det här fältet visas hur användaren interagerade med videon. Detta kan omfatta data som var de började spela upp videon, om de använde videoläget för att gå vidare med videon och var de slutade spela upp videon (L10E24S58L58 - videon stoppades på sek. 25 i avsnitt L10, som sedan hoppas över till sek. 48)

Äldre sekunder legacy-seconds

När du använder metoden** för tidigare sekunder* aktiveras Adobe Analytics-anrop var N:e sekund, där N anges i fältet för spårförskjutning.

  1. Ställ in spårförskjutningen till valfritt antal sekunder,

    • till exempel 6
    note note
    NOTE
    Fältet Spårningsförskjutning accepterar endast heltal som är högre än 0

    Informationen som skickas till Adobe Analytics är mindre anpassningsbar. Det finns bara tre variabler för mappning:

eventdata.videoName
Variabler som mappas till detta kommer att innehålla det användarvänliga namnet (Title) för videon om det anges i DAM. Om titeln inte anges skickas videons filnamn i stället. Skickas endast en gång, i början av uppspelningen av en video.
eventdata.videoFileName
Variabeln som mappas till detta kommer att innehålla filens namn. Skickas endast en gång, i början av uppspelningen av en video.
eventdata.videoFilePath
Variabeln som mappas till detta kommer att innehålla filens sökväg på servern. Skickas endast en gång, i början av uppspelningen av en video.
NOTE
Du kan ange ett användarvänligt-namn för en video genom att öppna videon för redigering i DAM och ange det önskade namnet i metadatafältet Titel . Du måste också spara ändringarna som gjorts när du är klar.
  1. Mappa dessa variabler till prop1, prop2 och prop3

    Resten av den relevanta informationen i anropet skickas sammanfogat till variabeln one med namnet pev3.

    Anrop till Adobe Analytics som använder exemplet ska se ut så här när de visas med DigitalPulse Debugger:

    lseconds

    Anropet liknar anropet för äldre milstolpar ovan. Se informationen om föregående3 under Integrera med Adobe Analytics..

Referenser som används i den här självstudiekursen:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=sv-SE

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2