Direktuppspelande mediahändelser

Direktuppspelning av mediespårning fungerar genom att skicka en sekvens med händelseanrop till en slutpunkt för Adobe datainsamling, där var och en representerar en övergång i spelarens tillstånd. Alla händelser tillhör en aktiv session som har öppnats av ett sessionsstart -anrop. Sessioner stängs automatiskt tills de upphör eller kan stängas omedelbart med ett sessionsslut -anrop.

Händelser grupperas i sex kategorier (session, uppspelning, annonser, kapitel, spelartillstånd och kvalitet), som alla täcker en viss aspekt av medieupplevelsen.

Sessionshändelser

Sessionshändelser gäller för alla typer av mediespårning, inklusive: on demand-video, liveströmmar, poddsändningar och ljudböcker. De definierar gränserna för själva spårningssessionen. Den viktigaste sessionshändelsen är Sessionsstart, eftersom nästan alla andra händelsetyper beror på det sessions-ID som genereras. Skicka det som den allra första händelsen när en användare startar en session, t.ex. när de trycker på uppspelning eller när spelaren börjar spela upp automatiskt.

När en session är öppen använder du Sessionen slutförd eller Sessionsslut för att ange hur visningsupplevelsen avslutades. Sändningssessionen är slutförd när tittaren når den naturliga änden av innehållet - videon är klar, poddsändningsavsnittet avslutas eller det sista kapitlet i en ljudbok avslutas. Sessionen slutförd stänger inte sessionen. den förblir öppen tills den förfaller naturligt, så alla efterföljande händelser, som till exempel en sista pinga, fångas fortfarande.

Om visningsprogrammet avslutas innan slutet nås skickar du sessionsslutet för att stänga sessionen omedelbart. Skicka bara sessionen avslutas när inga ytterligare händelser följer, till exempel när spelaren förstörs eller sidan tas bort. Sessionsslutet är hårt: När sessionen har skickats avslutas den och inga fler händelser kan spåras under den. I de flesta fall är det säkrare att låta sessionen förfalla naturligt. Exempel är till exempel att visningsprogrammet pausar oändligt, att appen går till bakgrunden eller att innehållet inte kan läsas in.

En session förfaller automatiskt om inga händelser tas emot under 10 minuter, eller om ingen spelhuvudrörelse upptäcks under 30 minuter. Om något av villkoren uppfylls och användaren återgår till innehållet, måste du anropa Sessionsstart igen för att öppna en ny session innan du skickar fler händelser.

Uppspelningshändelser

Med uppspelningshändelser spåras övergångar i mediespelaren under en session. De utgör kärnan i händelseströmmen och gäller alla innehållstyper.

Den primära uppspelningshändelsen är Play. När du har anropat Sessionsstart signalerar Spela upp att innehållet har börjat spelas upp, oavsett om det är den inledande starten, en automatisk utlösare eller en återgång till uppspelningsläget. Pausa start signalerar att användaren har pausat uppspelningen. Det finns ingen särskild CV-händelse. Skicka Spela upp igen när visningsprogrammet återupptas. Spela upp fungerar på samma sätt efter en buffringshög - skicka Buffertstart när spelaren slutar vänta på data och följ sedan med Spela upp när buffringen löses.

Skicka Ping var 10:e sekund under uppspelning av huvudinnehåll och var 1:e sekund under annonsuppspelning. Ping håller sessionen aktiv och registrerar spelhuvudets rörelse. På mobila SDK:er skickas ping automatiskt; på alla andra plattformar måste de skickas manuellt.

Skicka bithastighetsändring när spelarens adaptiva bithastighetsalgoritm växlar till en annan kvalitetsnivå. Om du tar med det nya bithastighetsvärdet i QoE-data blir rapportering för genomsnittlig bithastighet möjlig.

Annonshändelser

Annonshändelser spårar annonsering i en mediesession. Vanliga scenarier är bl.a. pre-roll-annonser innan en video börjar, annonser i mellanrum som infogats i intervaller under en video i lång form eller live-ström samt postroll-annonser när innehållet slutar. En annonsbrytning kan innehålla en eller flera enskilda annonser.

Varje annonsbrytning följer samma struktur. Annonsbrytningens början öppnar brytningen och Annonsbrytningen är klar stänger den. Dessa två händelser fungerar som bokstöd som omsluter alla enskilda annonshändelser. Inom pausen skickar du annonsstart när varje enskild annons börjar spelas upp. Följ den med Ad complete om annonsen spelas upp till sin fulla längd, eller Ad skip om visningsprogrammet väljer knappen Hoppa över. Om du utelämnar något av bokstöden ignoreras alla annonshändelser i brytningen, och annonsens varaktighet tilldelas felaktigt till huvudinnehållet.

I följande exempel visas rätt händelsesekvens för en enskild annonsbrytning som innehåller tre annonser, där visningsprogrammet hoppade över den tredje:

Kapitelevent

Kapitelhändelser är valfria och spårar namngivna innehållssegment i en session. De passar väl för innehåll som är naturligt uppdelat i diskreta delar. Vanliga exempel är kapitel i en ljudbok, handlingar i en dokumentär, lektioner i en videokurs eller segment i ett poddsändningsavsnitt. Använd kapitelhändelser när du vill förstå hur tittarna interagerar på segmentnivå, till exempel identifiera vilka kapitel som målgrupperna tenderar att hoppa över.

Skicka Kapitelstart när ett kapitel börjar. Om visningsprogrammet tittar igenom till slutet av kapitlet skickar du Kapitel fullständigt. Om visningsprogrammet söker utanför kapitelgränsen utan att se det som färdigt skickar du Överför kapitel i stället. Ett kapitel måste stängas med antingen kapitel fullständigt eller kapitel hoppas över innan ett nytt kan öppnas. kapitel får inte överlappa.

Händelser för spelartillstånd

Med spelarlägeshändelser spåras hur tittarna interagerar med spelarkontroller under en session. De är användbara för att förstå hur hjälpmedelsfunktioner används, till exempel hur ofta visningsprogram aktiverar undertexter eller stänger av ljudet. De visar också visningsbeteendemönster som helskärmsvisning och infogad visning och bild-i-bild-multitasking.

De fem spårbara lägena är: fullscreen, mute, closedCaptioning, pictureInPicture och inFocus. Skicka Lägesstart när spelaren kommer in i något av dessa lägen och Lägesslut när den avslutas. Flera lägen kan vara aktiva samtidigt. ett visningsprogram kan vara i helskärmsläge och stängas av samtidigt, och flera lägen kan avslutas inom samma händelsenamtal.

Felhändelser

Händelsen Error registrerar ett uppspelningsfel under en session - en misslyckad strömbegäran, ett kodekfel eller ett externt leveransfel. Skicka det när ett meningsfullt fel inträffar. En felhändelse stänger inte sessionen; uppspelningen kan fortsätta och efterföljande händelser spåras under samma session. Om felet inte kan återställas följer du det med sessionsslutet för att explicit stänga sessionen.