Tidslinje 2 – Användaren avbryter sessionen timeline--2-user-abandons-session
VOD, Pre-roll-ad-annons, midroll-ads-annonser, användare överger innehåll tidigt
I följande diagram visas spelhuvudets tidslinje och motsvarande tidslinje för en användares åtgärder. Nedan presenteras närmare uppgifter om varje åtgärd och de tillhörande ansökningarna.
Åtgärdsinformation
Åtgärd 1 - Starta session Action-1
/api/v1/sessions
Dessa samtalssignaler användarens avsikt att spela en video. Det returnerar ett sessions-ID ( {sid}
) till klienten som används för att identifiera alla efterföljande spårningsanrop i sessionen. Spelarläget är inte"uppspelning" än, utan är i stället"start". Obligatoriska sessionsparametrar måste inkluderas i params
karta i begärandetexten. I bakgrunden genererar det här samtalet ett Adobe Analytics-initieringssamtal. Mer information om sessioner finns i dokumentationen för Media Collection API.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "sessionStart",
"params": {
"media.playerName": "sample-html5-api-player",
"analytics.trackingServer": "[ _YOUR-TS_ ]",
"analytics.reportSuite": "[ _YOUR-RSID_ ]",
"analytics.visitorId": "[ _YOUR-VISITOR-ID_ ]",
"media.contentType": "VOD",
"media.length": 60.3333333333333,
"media.id": "VA API Sample Player",
"visitor.marketingCloudOrgId": "[YOUR-MCID]",
"media.name": "ClickMe",
"media.channel": "sample-channel",
"media.sdkVersion": "va-api-0.0.0",
"analytics.enableSSL": false
}
}
Åtgärd 2 - Ping-timerstart Action-2
Starta appens ping-timer. Den första ping-händelsen ska sedan utlösas 1 sekund om det finns annonser före rullning, annars 10 sekunder.
Åtgärd 3 - annonsradbrytning - start Action-3
/api/v1/sessions/{sid}/events
Annonser före rullning måste spåras. Annonserna kan bara spåras inom en annonsbrytning.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.podIndex": 0,
"media.ad.podSecond": 0
}
}
Åtgärd 4 - annonsstart Action-4
/api/v1/sessions/{sid}/events
En 12-sekunders annons börjar.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.name": "Ad 1",
"media.ad.id": "002",
"media.ad.length": 7,
"media.ad.podPosition": 1,
"media.ad.playerName": "Sample Player",
"media.ad.advertiser": "Ad Guys",
"media.ad.campaignId": "1",
"media.ad.creativeId": "42",
"media.ad.siteId": "XYZ",
"media.ad.creativeURL": "https://xyz-creative.com",
"media.ad.placementId": "sample-placement2"
},
}
Åtgärd 5 - annonsmaterial Action-5
/api/v1/sessions/{sid}/events
Rita serverdelen var 1 sekund. (Efterföljande reklamskyltar visas inte av utrymmesskäl.)
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Åtgärd 6 - annonsen är klar Action-6
/api/v1/sessions/{sid}/events
Den första pre-roll-annonsen är över.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Åtgärd 7 - Ad break complete Action-7
/api/v1/sessions/{sid}/events
Annonsbrytningen är över. Under reklampausen har spelaren förblivit"uppspelad".
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakComplete"
}
Åtgärd 8 - Spela upp innehåll Action-8
/api/v1/sessions/{sid}/events
Flytta spelaren till uppspelningsläget. börja spåra uppspelningens början.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "play",
"qoeData": {
"bitrate": 10000
}
}
Åtgärd 9 - Ping Action-9
/api/v1/sessions/{sid}/events
Ringa backend var 10:e sekund.
{
"playerTime": {
"playhead": 8,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Åtgärd 10 - Ping Action-10
/api/v1/sessions/{sid}/events
Ringa backend var 10:e sekund.
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Åtgärd 11 - Fel Action-11
/api/v1/sessions/{sid}/events
{
"playerTime": {
"playhead": 20,
"ts": "<timestamp>"
},
"eventType": "error"
}
Åtgärd 12 - Spela upp innehåll Action-12
/api/v1/sessions/{sid}/events
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType":"play",
"qoeData": {
"bitrate": 10000
}
}
Åtgärd 13 - Ping Action-13
/api/v1/sessions/{sid}/events
Ringa backend var 10:e sekund.
{
"playerTime": {
"playhead": 28,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Åtgärd 14 - Annonsuppspelning - start Action-14
/api/v1/sessions/{sid}/events
Adress mellan rullar med 8 sekunders varaktighet: skicka adBreakStart
.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType":"adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod2",
"media.ad.podIndex": 1,
"media.ad.podSecond": 33
}
}
Åtgärd 15 - annonsstart Action-15
/api/v1/sessions/{sid}/events
Spåra annonsen i mellanrullen.
{
"playerTime": { "playhead": 33, "ts": "<timestamp>"
},
"eventType": "adStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.name": "Ad 1",
"media.ad.id": "002",
"media.ad.length": 8,
"media.ad.podPosition": 1,
"media.ad.playerName": "Sample Player",
"media.ad.advertiser": "Ad Guys",
"media.ad.campaignId": "7",
"media.ad.creativeId": "40",
"media.ad.siteId": "XYZ",
"media.ad.creativeURL": "https://example.com",
"media.ad.placementId": "sample_placement2"
},
}
Åtgärd 16 - Stäng app Action-16
/api/v1/sessions/{sid}/events
Skicka sessionEnd
till VA-servern för att ange att sessionen ska avslutas omedelbart, utan någon ytterligare behandling.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType": "sessionEnd"
}