Tijdlijn 1 - Weergeven tot einde van inhoud timeline-view-to-end-of-content
VOD, pre-roll advertenties, pauzeren, bufferen, inhoud weergeven tot het einde
De volgende diagrammen illustreren de tijdlijn van de afspeelkop en de overeenkomstige 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/sessionsDeze vraag signaleert de intentie van de gebruiker om een video te spelen.
Er wordt een sessie-id ( {sid} ) geretourneerd aan de client die wordt gebruikt om alle volgende opvolgende opvolgende aanroepen binnen de sessie te identificeren. De spelerstatus wordt nog niet afgespeeld, maar 'gestart'.
Verplichte sessieparameters moeten in de params -kaart in de aanvraaginstantie worden opgenomen. Zie de documentatie van de API voor mediagroep voor informatie over sessies.
Op de achtergrond, produceert deze vraag Adobe Analytics in werking stelt vraag in werking.
{
"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
/api/v1/sessions/{sid}/eventsStart 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}/eventsAdvertenties 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}/eventsVolg de eerste advertentie voor de rol, die 15 seconden lang is. Aangepaste metagegevens opnemen met deze adStart .
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType":"adStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.name": "Ad 1",
"media.ad.id": "001",
"media.ad.length": 15,
"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://example.com",
"media.ad.placementId": "sample_placement"
},
"customMetadata": {
"myCustomData1": "CustomData1",
"myCustomData2": "CustomData2"
}
}
NOTA: Tussen gebeurtenissen AdBreakStart en AdStart zouden er geen extra playbackgebeurtenissen moeten zijn.
Actie 5 - Advertentiepunten Action-5
Actie 5.1 - Pingel 1 Action-5-1
/api/v1/sessions/{sid}/eventsPingel de steun om de 1 seconde terwijl binnen een advertentie.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 5.2 - Pping 2 Action-5-2
/api/v1/sessions/{sid}/eventsPingel de steun om de 1 seconde terwijl binnen een advertentie.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 5.3 - Pping 3 Action-5-3
/api/v1/sessions/{sid}/eventsPingel de steun om de 1 seconde terwijl binnen een advertentie.
>in het belang van de beknoptheid…
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 6 - Toevoeging voltooid Action-6
/api/v1/sessions/{sid}/eventsVolg het einde van de eerste pre-roll advertentie.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Actie 7 - Ad start Action-7
/api/v1/sessions/{sid}/eventsVolg het begin van de tweede advertentie voor de rol, die 7 seconden lang is.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.name": "Ad 2",
"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": "2",
"media.ad.creativeId": "44",
"media.ad.siteId": "XYZ",
"media.ad.creativeURL": "https://example.com",
"media.ad.placementId": "sample_placement2"
},
}
Actie 8 - Pingelen Action-8
/api/v1/sessions/{sid}/eventsPingel de achterkant om de 1 seconde.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 9 - Toevoegen voltooid Action-9
/api/v1/sessions/{sid}/eventsHet einde van de tweede advertentie vóór de rol bijhouden.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Actie 10 - Einde advertentie Action-10
/api/v1/sessions/{sid}/eventsHet advertentiespoor is voorbij.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakComplete"
}
Actie 11 - Inhoud afspelen Action-11
/api/v1/sessions/{sid}/eventsNa de gebeurtenis adBreakComplete plaatst u de speler in de afspeelstatus met de gebeurtenis play .
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "play"
}
Actie 12 - Ping Action-12
/api/v1/sessions/{sid}/eventsPingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 8,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 13 - Begin buffer Action-13
/api/v1/sessions/{sid}/eventsHoud de beweging van de speler naar de bufferstatus bij.
{
"playerTime": {
"playhead": 11,
"ts": "<timestamp>"
}, "eventType": "bufferStart"
}
Actie 14 - Bufferuiteinde Action-14
/api/v1/sessions/{sid}/eventsBufferbewerkingen worden na 3 seconden beëindigd. Zet de speler dus terug naar de afspeelstatus. U moet een andere gebeurtenis voor het afspelen van tracks verzenden die buiten de buffering valt. de play vraag na a bufferStart leidt tot een "bufferEnd"vraag aan het achtereind, zodat is er geen behoefte aan een bufferEnd gebeurtenis.
{
"playerTime": {
"playhead": 11,
"ts": "<timestamp>"
},
"eventType": "play"
}
Actie 15 - Ping Action-15
/api/v1/sessions/{sid}/eventsPingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 15,
"ts": "<timestamp>"
}, "eventType": "ping"
}
Actie 16 - Ad break start Action-16
/api/v1/sessions/{sid}/eventsMidden rol en duur van 8 seconden: verzenden adBreakStart .
{
"playerTime": {
"playhead": 21,
"ts": "<timestamp>"
},
"eventType": "adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod2",
"media.ad.podIndex": 1,
"media.ad.podSecond": 21
}
}
Actie 17 - Ad start Action-17
/api/v1/sessions/{sid}/eventsHoud de middenrol advertentie bij.
{
"playerTime": {
"playhead": 21,
"ts": "<timestamp>"
},
"eventType": "adStart",
"params": {
"media.ad.podFriendlyName": "ad_pod2",
"media.ad.name": "Ad 3",
"media.ad.id": "003",
"media.ad.length": 8,
"media.ad.podPosition": 2,
"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"
},
}
Actie 18 - Pingel toevoegen Action-18
/api/v1/sessions/{sid}/eventsPingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 21,
"ts": "<timestamp>"
}, "eventType": "ping"
}
Actie 19 - Toevoeging voltooid Action-19
/api/v1/sessions/{sid}/eventsDe mid-roll advertentie is compleet.
{
"playerTime": {
"playhead": 21,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Actie 20 - Einde advertentie Action-20
/api/v1/sessions/{sid}/eventsHet advertentieeinde is voltooid.
{
"playerTime": {
"playhead": 21,
"ts": "<timestamp>"
},
"eventType": "adBreakComplete"
}
Actie 21 - Ping Action-21
/api/v1/sessions/{sid}/eventsPingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 27,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Actie 22 - Pauze Action-22
/api/v1/sessions/{sid}/eventsMet de actie van de gebruiker wordt de afspeelstatus verplaatst naar "gepauzeerd".
{
"playerTime": {
"playhead": 31,
"ts": "<timestamp>"
},
"eventType": "pauseStart"
}
Actie 23 - Ping Action-23
/api/v1/sessions/{sid}/eventsPingel het achterste eind om de 10 seconden. Player bevindt zich nog steeds in de bufferstatus. De gebruiker blijft 20 seconden aan inhoud vastzitten. Fuming…
{
"playerTime": {
"playhead": 31,
"ts": "<timestamp>"
}, "eventType": "ping"
}
Actie 24 - Afspelen Action-24
/api/v1/sessions/{sid}/eventsDe afspeelstatus verplaatsen naar Afspelen. de play vraag na a pauseStart trekt een "hervattingsvraag"aan het achtereind af, zodat is er geen behoefte aan een resume gebeurtenis.
{
"playerTime": {
"playhead": 31,
"ts": "<timestamp>"
}, "eventType": "play"
}
Actie 25 - Ping Action-25
/api/v1/sessions/{sid}/eventsPingel het achterste eind om de 10 seconden.
{
"playerTime": {
"playhead": 37,
"ts": "<timestamp>"
}, "eventType": "ping"
}
Actie 26 - Sessie voltooid Action-26
/api/v1/sessions/{sid}/eventsVerzend sessionComplete naar de achtergrond om aan te geven dat de gebruiker klaar is met het bekijken van de volledige inhoud.
{
"playerTime": {
"playhead": 45,
"ts": "<timestamp>"
}, "eventType": "sessionComplete"
}
seekStart - of seekComplete -gebeurtenissen in de Media Collection API. Dit is omdat bepaalde spelers een zeer groot aantal dergelijke gebeurtenissen produceren wanneer de eindgebruiker schrobt, en verscheidene honderden gebruikers de netwerkbandbreedte van een backenddienst gemakkelijk konden knelpen. Adobe biedt expliciete ondersteuning voor zoekgebeurtenissen door de hartslagduur te berekenen op basis van de tijdstempel van het apparaat in plaats van de positie van de afspeelkop.