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 en spelbar video överförd inom AEM.
Om du vill vara säker på att dina videor spelas upp på sidan läser du denna självstudiekurs för 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

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

  2. 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.
  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 innehåller användarvänlig namn (Titel) av videon om den är inställd i DAM. Om den 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 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. till exempel 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
Skickat vid 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, till exempel 2:O:4-8
NOTE
Du kan ställa in videons användarvänlig genom att öppna videon för redigering i DAM och ange Titel metadatafält till det önskade namnet.
  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.

    Information om hur du optimerar mappningarna finns i Mäta video i Adobe Analytics guide.

  3. Lägg till ramverket till sidan.

  4. 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-128

Det här är första samtalet ​till Adobe Analytics 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-129

Det här är tredje samtal ​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.
  • 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
  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.

    Information om hur du optimerar mappningarna finns i Mäta video i Adobe Analytics guide.

  3. Lägg till ramverket till sidan.

  4. 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.
  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 innehåller 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 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 ställa in videons användarvänlig 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.
  1. Mappa dessa variabler till steg 1 till 3

    The Övriga relevanta uppgifter i samtalet skickas till 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:

    milstolpar1

    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.

  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 innehåller 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
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 ställa in videons användarvänlig 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.
  1. 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:

    lseconds

    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/media-overview.html?lang=sv-SE

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