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

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Administratör

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

Konfigurera en webbsida genom att dra en videokomponent från sidosparken och lägga till en uppspelningsbar video som en resurs för komponenten
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.
På ramverkssidan väljer du ett RSID och anger användningen till alla. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
Dra videokomponenten från kategorin Allmänt i Sidekick till ramverket.
Välj en spårningsmetod:
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 .

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.

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.
Lägg till ramverket på sidan.
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

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.

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.
Lägg till ramverket på sidan.
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.

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.

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:

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.

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

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

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:

Anropet liknar anropet för äldre milstolpar ovan. Se informationen om föregående3 som finns där.

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