Tijdlijn 2 - Gebruiker verlaat sessie timeline--2-user-abandons-session
VOD, Pre-roll en, mid-roll advertenties, gebruikers laten de inhoud vroeg achter
De volgende diagrammen illustreren de tijdlijn van de afspeelkop en de bijbehorende tijdlijn van de handelingen van een gebruiker. De bijzonderheden van elke actie en de bijbehorende verzoeken worden hieronder weergegeven.
Handelingsdetails
Actie 1 - Starten van sessie Action-1
/api/v1/sessions
Deze vraagsignalen het voornemen van de gebruiker om te spelen een video. Er wordt een sessie-id geretourneerd ( {sid}
) aan de cliënt die wordt gebruikt om alle volgende het volgen vraag binnen de zitting te identificeren. De spelerstatus wordt nog niet afgespeeld, maar 'gestart'. De verplichte sessieparameters moeten in de params
kaart in de aanvraaginstantie. Op de achtergrond, produceert deze vraag Adobe Analytics in werking stelt vraag in werking. Zie de documentatie van de API voor mediagroep voor informatie over sessies.
{
"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
}
}
Handeling 2 - Start timer pingelen Action-2
Start de pingtimer van uw app. De eerste pingel gebeurtenis zou dan 1 seconde binnen moeten in brand steken als er pre-roladvertenties zijn, anders 10 seconden.
Actie 3 - Ad-break-start Action-3
/api/v1/sessions/{sid}/events
Pre-roll advertenties moeten worden gevolgd. Advertenties kunnen alleen worden bijgehouden binnen een advertentie-einde.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.podIndex": 0,
"media.ad.podSecond": 0
}
}
Actie 4 - Ad start Action-4
/api/v1/sessions/{sid}/events
Een advertentie van 12 seconden begint.
{
"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"
},
}
Actie 5 - Advertentiepunten Action-5
/api/v1/sessions/{sid}/events
Pingel de achterkant om de 1 seconde. (Opeenvolgende pingels en pingels worden niet getoond om de korst te houden.)
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 6 - Toevoeging voltooid Action-6
/api/v1/sessions/{sid}/events
De eerste pre-roll advertentie is voorbij.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Actie 7: Ad-einde voltooid Action-7
/api/v1/sessions/{sid}/events
Het advertentiespoor is voorbij. Tijdens de hele advertentiesessie is de speler in de afspeelstatus gebleven.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakComplete"
}
Actie 8 - Inhoud afspelen Action-8
/api/v1/sessions/{sid}/events
Verplaats de speler naar de afspeelstatus. begin het volgen van het begin van inhoudsplayback.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "play",
"qoeData": {
"bitrate": 10000
}
}
Actie 9 - Pingel Action-9
/api/v1/sessions/{sid}/events
Pingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 8,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 10 - Ping Action-10
/api/v1/sessions/{sid}/events
Pingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 11 - Fout Action-11
/api/v1/sessions/{sid}/events
{
"playerTime": {
"playhead": 20,
"ts": "<timestamp>"
},
"eventType": "error"
}
Actie 12 - Inhoud afspelen Action-12
/api/v1/sessions/{sid}/events
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType":"play",
"qoeData": {
"bitrate": 10000
}
}
Actie 13 - Ping Action-13
/api/v1/sessions/{sid}/events
Pingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 28,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 14 - Ad break start Action-14
/api/v1/sessions/{sid}/events
Midden rol en duur van 8 seconden: send adBreakStart
.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType":"adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod2",
"media.ad.podIndex": 1,
"media.ad.podSecond": 33
}
}
Actie 15 - Ad start Action-15
/api/v1/sessions/{sid}/events
Houd de middenrol advertentie bij.
{
"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"
},
}
Handeling 16 - Toepassing sluiten Action-16
/api/v1/sessions/{sid}/events
Verzenden sessionEnd
op de VA-achtergrond om aan te geven dat de sessie onmiddellijk moet worden gesloten, zonder verdere verwerking.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType": "sessionEnd"
}