Cronología 2: El usuario abandona la sesión timeline--2-user-abandons-session
VOD, anuncios pre-roll, anuncios mid-roll, el usuario deja el contenido antes de terminarlo
Los siguientes diagramas ilustran la cronología del cabezal de reproducción y la cronología correspondiente de las acciones de un usuario. A continuación se presentan los detalles de cada acción y sus solicitudes correspondientes.
Detalles de la acción
Acción 1: inicio de la sesión Action-1
/api/v1/sessions
Esta llamada indica la intención del usuario de reproducir un vídeo. Devuelve un ID de sesión ({sid}
) al cliente que se utiliza para identificar todas las llamadas de seguimiento subsiguientes dentro de la sesión. El estado del reproductor no es "reproduciendo", sino "comenzando". Los parámetros de sesión obligatorios deben incluirse en el mapa de params
en la solicitud. En el servidor, esta llamada genera una llamada de inicio a Adobe Analytics. Para obtener información sobre las sesiones, consulte la documentación de la API de recopilación de medios.
{
"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
}
}
Acción 2: inicio del temporizador de ping Action-2
Inicie el temporizador de ping de su aplicación. El primer evento de ping debe activarse en el primer segundo si hay anuncios previos a la emisión y en los 10 primeros segundos en caso contrario.
Acción 3: inicio de la pausa publicitaria Action-3
/api/v1/sessions/{sid}/events
Se debe hacer un seguimiento de los anuncios previos a la emisión. Los anuncios solo se pueden rastrear durante una pausa publicitaria.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod1",
"media.ad.podIndex": 0,
"media.ad.podSecond": 0
}
}
Acción 4: inicio del anuncio Action-4
/api/v1/sessions/{sid}/events
Se inicia una publicidad de 12 segundos.
{
"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"
},
}
Acción 5: pings de anuncios Action-5
/api/v1/sessions/{sid}/events
Mandar un ping al servidor cada segundo. (No se muestran los pings de anuncios posteriores en interés de la brevedad).
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Acción 6: anuncio completo Action-6
/api/v1/sessions/{sid}/events
El primer anuncio previo a la emisión ha finalizado.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adComplete"
}
Acción 7: pausa publicitaria completa Action-7
/api/v1/sessions/{sid}/events
Terminó la pausa publicitaria. Durante la pausa publicitaria, el reproductor ha permanecido en el estado de "reproducción".
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "adBreakComplete"
}
Acción 8: reproducir contenido Action-8
/api/v1/sessions/{sid}/events
Cambie el reproductor al estado "reproducir"; comience a rastrear el inicio de la reproducción del contenido.
{
"playerTime": {
"playhead": 0,
"ts": "<timestamp>"
},
"eventType": "play",
"qoeData": {
"bitrate": 10000
}
}
Acción 9: ping Action-9
/api/v1/sessions/{sid}/events
Mandar un ping al servidor cada 10 segundos.
{
"playerTime": {
"playhead": 8,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Acción 10: ping Action-10
/api/v1/sessions/{sid}/events
Mandar un ping al servidor cada 10 segundos.
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Acción 11: error Action-11
/api/v1/sessions/{sid}/events
{
"playerTime": {
"playhead": 20,
"ts": "<timestamp>"
},
"eventType": "error"
}
Acción 12: reproducir contenido Action-12
/api/v1/sessions/{sid}/events
{
"playerTime": {
"playhead": 18,
"ts": "<timestamp>"
},
"eventType":"play",
"qoeData": {
"bitrate": 10000
}
}
Acción 13: ping Action-13
/api/v1/sessions/{sid}/events
Mandar un ping al servidor cada 10 segundos.
{
"playerTime": {
"playhead": 28,
"ts": "<timestamp>"
},
"eventType": "ping"
}
Acción 14: inicio de la pausa publicitaria Action-14
/api/v1/sessions/{sid}/events
Anuncio durante la emisión de 8 segundos: enviar adBreakStart
.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType":"adBreakStart",
"params": {
"media.ad.podFriendlyName": "ad_pod2",
"media.ad.podIndex": 1,
"media.ad.podSecond": 33
}
}
Acción 15: inicio del anuncio Action-15
/api/v1/sessions/{sid}/events
Seguimiento del anuncio durante la emisión.
{
"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"
},
}
Acción 16: cerrar aplicación Action-16
/api/v1/sessions/{sid}/events
Envíe sessionEnd
al servidor de VA para indicar que la sesión debe cerrarse inmediatamente, sin procesar más.
{
"playerTime": {
"playhead": 33,
"ts": "<timestamp>"
},
"eventType": "sessionEnd"
}