Chronologie 2 : L’utilisateur abandonne la session timeline--2-user-abandons-session
VOD, publicité preroll, publicités mid-roll, utilisateur abandonne le contenu tôt
Les diagrammes suivants illustrent la chronologie du curseur de lecture et la chronologie correspondante des actions d’un utilisateur. Les détails de chaque action et des demandes qui l’accompagnent sont présentés ci-dessous.
Détails de l’action
Action 1 - Démarrage de la session Action-1
/api/v1/sessionsCet appel signale l’intention de l’utilisateur de lire une vidéo. Il renvoie un ID de session ({sid}) au client, utilisé pour identifier tous les appels de suivi suivants dans la session. L’état du lecteur n’est pas encore « en cours de lecture », mais à la place, « en cours de démarrage ». Les paramètres de session obligatoires doivent être inclus dans la carte params du corps de la requête. Sur le serveur principal, cet appel génère un appel de lancement d’Adobe Analytics. Pour plus d’informations sur les sessions, consultez la documentation de l’API Media Collection.
{
"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
}
}
Action 2 - Démarrage du minuteur de ping Action-2
Démarrez le minuteur de ping de votre application. Le premier événement ping doit alors se déclencher après 1 seconde en cas de publicités preroll ou après 10 secondes dans le cas contraire.
Action 3 - Début de la coupure publicitaire Action-3
/api/v1/sessions/{sid}/eventsLes publicités preroll doivent être suivies. Les annonces publicitaires ne peuvent être suivies que dans une coupure publicitaire.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.podIndex": 0,
"media.ad.podSecond": 0
}
}
Action 4 - Démarrage de la publicité Action-4
/api/v1/sessions/{sid}/eventsUne publicité de 12 secondes commence.
{
"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"
},
}
Action 5 - Pings de publicité Action-5
/api/v1/sessions/{sid}/eventsEnvoyez un ping au serveur principal toutes les secondes. (Les pings de publicité suivants ne se pas montrés, dans un souci de concision.)
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Action 6 - Fin de la publicité Action-6
/api/v1/sessions/{sid}/eventsLa première publicité preroll est terminée.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Action 7 - Fin de la coupure publicitaire Action-7
/api/v1/sessions/{sid}/eventsLa coupure publicitaire est terminée. Tout au long de la coupure publicitaire, le lecteur est resté à l’état « lecture ».
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakComplete"
}
Action 8 - Lecture du contenu Action-8
/api/v1/sessions/{sid}/eventsDéplacez le lecteur vers l’état « en cours de lecture » ; commencez le suivi du début de la lecture du contenu.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "play",
"qoeData": {
"bitrate": 10000
}
}
Action 9 - Ping Action-9
/api/v1/sessions/{sid}/eventsEnvoyez un ping au serveur principal toutes les 10 secondes.
{
"playerTime": {
"playhead": 8,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Action 10 - Ping Action-10
/api/v1/sessions/{sid}/eventsEnvoyez un ping au serveur principal toutes les 10 secondes.
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Action 11 - Erreur Action-11
/api/v1/sessions/{sid}/events{
"playerTime": {
"playhead": 20,
"ts": "<timestamp>"
},
"eventType": "error"
}
Action 12 - Lecture du contenu Action-12
/api/v1/sessions/{sid}/events{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType":"play",
"qoeData": {
"bitrate": 10000
}
}
Action 13 - Ping Action-13
/api/v1/sessions/{sid}/eventsEnvoyez un ping au serveur principal toutes les 10 secondes.
{
"playerTime": {
"playhead": 28,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Action 14 - Début de la coupure publicitaire Action-14
/api/v1/sessions/{sid}/eventsAnnonce publicitaire mid-roll d’une durée de 8 secondes : envoyez adBreakStart.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType":"adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod2",
"media.ad.podIndex": 1,
"media.ad.podSecond": 33
}
}
Action 15 - Démarrage de la publicité Action-15
/api/v1/sessions/{sid}/eventsSuivez l’annonce publicitaire mid-roll.
{
"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"
},
}
Action 16 - Fermeture de l’application Action-16
/api/v1/sessions/{sid}/eventsEnvoyez sessionEnd au serveur principal VA pour indiquer que la session doit être fermée immédiatement, sans autre traitement.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType": "sessionEnd"
}