Dokumentation AEM 6.4 Användarhandbok om administration

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Administering

Skapat för:

Admin

CAUTION

AEM 6.4 har nått slutet på den utökade supporten och denna dokumentation är inte längre uppdaterad. Mer information finns i teknisk supportperiod. Hitta de versioner som stöds här.

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

NOTE

Innan du fortsätter bör du kontrollera att du har en spelbar video överförd inom AEM.

Om du vill vara säker på att dina videor spelas upp på sidan läser du den här självstudiekursen om du vill ha 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 använd inte de äldre alternativen för videospårning. Använd Milstolpar i stället.

Vanliga steg common-steps

Konfigurera en webbsida genom att dra en videokomponent från sidosparken och lägga till en spelningsbar video som en resurs för komponenten
Skapa en Adobe Analytics-konfiguration och ett ramverk.
- Exemplen i följande avsnitt använder namnet my-sc-configuration för konfiguration och videofärg för ramverket.
På ramverkssidan väljer du ett RSID och anger användningen till alla. (http://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 användarvänlig namn (Titel) av videon om den är inställd i DAM, om detta inte är inställt visas videons filnamn skickas istället. Skickas endast en gång, i början av uppspelningen av en video.

eventdata.videoFileName

Variabler som mappas till detta kommer att innehålla 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. t.ex. eventX=21

eventdata.events.a.media.view

Skickat när videovyn initieras

eventdata.events.a.media.complete

Skickas när videon har spelats upp

eventdata.events.milestoneX

Skickas när den angivna milstolpen passeras, X står för den sekund som milstolpen utlöses vid

eventdata.a.contentType

Sänds på varje milstolpe. visas som föregående3 i Adobe Analytics-samtalet, vanligen som "video"

eventdata.a.media.name

Matchar exakt eventdata.videoName

eventdata.a.media.segment

Innehåller information om det segment som har visats, t.ex. 24-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  Titel** metadatafält till det önskade namnet.

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.

Information om hur du optimerar mappningarna finns i Mäta video i Adobe Analytics guide.
Lägg till ramverket till sidan.
Testa inställningarna i Förhandsgranskningsläge, spelar upp videon för att få 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-156

Det här är första samtal som gjorts i 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 (1)1-4)
event3 som mappades till eventdata.events.a.media.view.

chlimage_1-157

Det här är tredje samtal till Adobe Analytics:

prop1 och eVar1 innehållera.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.
The statisk uppsättning CQ-variabler som definieras 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.

Information om hur du optimerar mappningarna finns i Mäta video i Adobe Analytics guide.
Lägg till ramverket till sidan.
Testa inställningarna i Förhandsgranskningsläge, spelar upp videon för att få 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 Spårningsförskjutning -fältet är procenttal 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.
- e.g.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 användarvänlig namn (Titel) av videon om den är inställd i DAM, om titeln inte är inställd visas videons filnamn skickas istället. Skickas endast en gång, i början av uppspelningen av en video.

eventdata.videoFileName

Variabler 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 en videos användarvänliga  namn genom att öppna videon för redigering i DAM och ange Title  metadata-fältet till önskat namn. Du måste också spara ändringarna som gjorts när du är klar.

Mappa dessa variabler till steg 1 till 3

The Övriga relevanta uppgifter i samtalet skickas en variabel namngiven pev3.

Exempelsamtal till Adobe Analytics som använder exemplet ska se ut så här när du tittar på DigitalPulse Debugger:

The pev3 variabeln som skickades i anropet innehåller följande information:
- Namn - namnet på videofilen (film.avi)
- Längd - Videofilens längd i sekunder (100)
- Spelarnamn - Den videospelare som användes för att spela upp videofilen (HTML5-video)
- Totalt antal uppspelade sekunder - Det totala antalet sekunder som videon spelades upp (25)
- Starta tidsstä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 skjutreglaget 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,

t.ex. 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

Du kan ange ett användarvänligt namn för en video genom att öppna videon för redigering i DAM och ange  Titel** metadatafält till det önskade namnet. Du måste också spara ändringarna som gjorts när du är klar.

Mappa dessa variabler till prop1, prop2 och prop3

The Övriga relevanta uppgifter i samtalet skickas en variabel namngiven pev3.

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

Anropet liknar samtalet i det tidigare milstolparna. Se informationen om föregående3 tillhandahålls där.

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

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

recommendation-more-help

5ce3024a-cbea-458b-8b2f-f9b8dda516e8