Spåra uppspelning av innehåll
Spårning av huvuduppspelning omfattar mediainläsning, start, paus, återupptagning, slutförande och sessionsslut. Även om det inte är obligatoriskt är buffring och sökspårning också viktiga komponenter i en fullständig uppspelningsimplementering.
Spelarhändelser
Implementeringssteg
- Identifiera när användaren utlöser uppspelning (användarklickningar spelar upp eller startar automatiskt). Skapa ett mediaobjekt med innehållsnamn, ID, längd, strömtyp och medietyp. Se Innehållsnamn, Innehålls-ID, Innehållslängd, Strömtyp och Innehållstyp för fältdefinitioner.
- Lägg till metadata om du vill: standardmetadata (show, säsong, avsnitt osv.) och anpassade kontextdatavariabler. Se Visa, Säsong, Episod, Genre och Nätverk för standardreferenser för metadatanycklar.
- Anropa Session start för att börja spåra sessionen. Detta läser in data och metadata och startar QoS-mätningen från tid till start. SessionStart spårar den intent som ska spelas upp, inte den första bildrutan.
- Anropa Spela upp när den första innehållsramen återges på skärmen.
- Anropa Pausa start när spelaren pausas. Anropa Spela upp igen när uppspelningen återupptas. Det finns ingen separat CV-händelse.
- Anropa sessionen slutförd när visningsprogrammet når slutet av innehållet.
- Anropa sessionsslut när spelaren är inläst eller när läsaren avbryter innehållet utan att nå slutet. SessionEnd stänger sessionen omedelbart. inga fler händelser kan spåras efter det.
SessionEnd markerar slutet på en spårningssession. Om sessionen har övervakats och slutförts ringer du SessionComplete före SessionEnd. Alla andra spårningsanrop ignoreras efter SessionEnd, förutom SessionStart för en ny session.Kärnuppspelning
I följande exempel visas ett fullständigt sessionsflöde från sessionsstart till slutfört innehåll och sessionsslut.
Implementeringsinformation per plattform finns i Sessionsstart, Spela upp, Pausa start, Sessionen klar och Sessionsslut.
Buffring
Buffertens startsignal signalerar att spelaren väntar på data. Buffertslut härleds när du skickar en Play-händelse efter BufferStart (XDM-baserade API:er). På Mobile SDK kan du även anropa BufferComplete explicit.
Implementeringsinformation finns i Buffertstart.
Söker
Sök efter startsignaler om att visningsprogrammet snabbspolar. Sökningen avslutas med Spela upp för att återuppta uppspelningen av innehållet.
Implementeringsinformation finns i Pausa start (sökstart) och Spela upp (sökslut).
Hantera appavbrott
Uppspelning i ett medieprogram kan avbrytas på flera olika sätt. Exempel är när användaren trycker på paus, programmet placeras i bakgrunden eller ett telefonsamtal tas emot. Oavsett orsak är spårningsinstruktionerna desamma:
- Anropa PauseStart när programmet avbryts (går till bakgrunden, mediepaus osv.).
- Anropa Spela upp när programmet återgår till förgrunden och/eller mediet återupptar uppspelningen.
När ska en pausad session sluta? Om programmet inte tillåter uppspelning i bakgrunden anropar du PauseStart omedelbart och sedan SessionEnd efter ungefär en minut i bakgrunden. Programmet kan inte fortsätta skicka pausa paus från bakgrunden, och att hålla sessionen öppen i all oändlighet ger en dålig upplevelse. Om programmet har stöd för uppspelning i bakgrunden (ljudprogram, poddsändningsprogram för video) kan du fortsätta skicka pingar i bakgrunden.
Startar om efter en lång bakgrundsperiod: Om appen har bakgrundsinlagrats tillräckligt länge för att sessionen har gått ut (30-minuters inaktivitet) anropar du SessionEnd för att stänga en kvarvarande session och anropar sedan SessionStart för att påbörja en ny när visningsprogrammet återkommer.
Återuppta inaktiva sessioner
En session förfaller automatiskt om inga händelser tas emot under 10 minuter eller om det inte finns någon spelhuvudrörelse under 30 minuter. Om användaren återgår efter att en session har gått ut, anropar du SessionStart igen för att öppna en ny session.
Återuppta mellan enheter (överlämning mellan olika enheter): När ett visningsprogram överför uppspelning mellan olika enheter (till exempel vid sändning från en telefon till en tv) använder du resume-flaggan för att sammanfoga sessionerna i Analytics-rapporter:
- Anropa SessionEnd när visningsprogrammet initierar sändningen på källenheten. Anropa inte SessionComplete - innehållet är inte färdigt.
- Anropa SessionStart på målenheten med resume-flaggan inställd på
trueoch skicka samma innehålls- och spelhuvudsposition från källenheten.
Om du ställer in cv-flaggan ökar Analytics Innehållet återupptas i stället för Media startar för den andra delen av överföringen.
Återuppta en tidigare stängd session manuellt: Om programmet lagrar användardata och kan återuppta en tidigare stängd session anger du cv-flaggan när sessionen startar. Se Sessionsstart för implementeringsinformation på alla plattformar.