Cronología 1: ver hasta el final del contenido

VOD, anuncios pre-roll, pausar, almacenar en búfer, ver contenido hasta el final

Los siguientes diagramas ilustran la línea de tiempo del cursor de reproducción y la línea de tiempo 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

Detalles de implementación

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.

Cuerpo de la solicitud de muestra

{
    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

Detalles de implementación

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

Detalles de implementación

Los anuncios solo se pueden rastrear durante una pausa publicitaria.

Cuerpo de la solicitud de muestra

{
    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

Detalles de implementación

Comience a rastrear el primer anuncio pre-roll, que dura 15 segundos. Incluir metadatos personalizados con adStart .

Cuerpo de la solicitud de muestra

{
    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://xyz_creative.com",
        "media.ad.placementId": "sample_placement"
    },
    customMetadata: {
        "myCustomData1": "CustomData1",
        "myCustomData2": "CustomData2"
    }
}

NOTA: Entre los eventos AdBreakStart y AdStart no debería haber ningún evento de reproducción adicional.

Acción 5: pings de anuncios

Acción 5.1: ping de anuncio 1

Detalles de implementación

Mande un ping al servidor cada segundo mientras se encuentra dentro de un anuncio.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Acción 5.2: ping de anuncio 2

Detalles de implementación

Mande un ping al servidor cada segundo mientras se encuentra dentro de un anuncio.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Acción 5.3: ping de anuncio 3

Detalles de implementación

Mande un ping al servidor cada segundo mientras se encuentra dentro de un anuncio.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Acción 6: anuncio completo

Detalles de implementación

Rastrear el final del primer anuncio pre-roll.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adComplete
}

Acción 7: inicio del anuncio

Detalles de implementación

Realice un seguimiento del inicio del segundo anuncio pre-roll, que dura 7 segundos.

Cuerpo de la solicitud de muestra

{
    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://xyz_creative.com",
        "media.ad.placementId": "sample_placement2"
    },
}

Acción 8: pings de anuncios

Detalles de implementación

Mandar un ping al servidor cada segundo.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:ping
}

Acción 9: anuncio completo

Detalles de implementación

Rastrear el final del segundo anuncio pre-roll.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adComplete
}

Acción 10: pausa publicitaria completa

Detalles de implementación

Terminó la pausa publicitaria. Durante la pausa publicitaria, el estado de reproducción ha permanecido en "jugando".

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:adBreakComplete
}

Acción 11: reproducir contenido

Detalles de implementación

Tras el evento adBreakComplete, ponga el reproductor en el estado “reproduciendo” utilizando el evento play.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 0,
        ts: <timestamp>
    },
    eventType:play
}

Acción 12: ping

Detalles de implementación

Mandar un ping al servidor cada 10 segundos.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 8,
        ts: <timestamp>
    },
    eventType:ping
}

Acción 13: inicio del búfer

Detalles de implementación

Rastree el movimiento del reproductor al estado "almacenamiento en búfer".

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 11,
        ts: <timestamp>
    }, eventType:bufferStart
}

Acción 14: fin del búfer

Detalles de implementación

El almacenamiento en búfer finaliza después de 3 segundos, por lo que el reproductor vuelve al estado "reproduciendo". Debe enviar otro evento de seguimiento de reproducción cuando termine el almacenamiento en búfer. La llamada play después de bufferStart infiere una llamada “bufferEnd” al back end, por lo que no es necesario un evento bufferEnd.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 11,
        ts: <timestamp>
    },
    eventType:play
}

Acción 15: ping

Detalles de implementación

Mandar un ping al servidor cada 10 segundos.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 15,
        ts: <timestamp>
    }, eventType:ping
}

Acción 16: inicio de la pausa publicitaria

Detalles de implementación

Anuncio mid-roll de 8 segundos: enviar adBreakStart .

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adBreakStart,
    params: {
        "media.ad.podFriendlyName": "ad_pod2",
        "media.ad.podIndex": 1,
        "media.ad.podSecond": 21
    }
}

Acción 17: inicio del anuncio

Detalles de implementación

Seguimiento del anuncio mid-roll.

Cuerpo de la solicitud de muestra

{
    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://xyz_creative.com",
        "media.ad.placementId": "sample_placement2"
    },
}

Acción 18: ping de publicidad

Detalles de implementación

Mandar un ping al servidor cada 10 segundos.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    }, eventType:ping
}

Acción 19: anuncio completo

Detalles de implementación

El anuncio mid-roll ha finalizado.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adComplete
}

Acción 20: pausa publicitaria completa

Detalles de implementación

Se ha completado la pausa publicitaria.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 21,
        ts: <timestamp>
    },
    eventType:adBreakComplete
}

Acción 21: ping

Detalles de implementación

Mandar un ping al servidor cada 10 segundos.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 27,
        ts: <timestamp>
    },
    eventType:ping
}

Acción 22: pausa

Detalles de implementación

La acción del usuario cambia el estado de reproducción a "en pausa".

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 31,
        ts: <timestamp>
    },
    eventType:pauseStart
}

Acción 23: ping

Detalles de implementación

Mandar un ping al servidor cada 10 segundos. El reproductor sigue en estado de "almacenamiento en búfer"; el usuario se queda atascado 20 segundos después de la reproducción del contenido. Eliminando…

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 31,
        ts: <timestamp>
    }, eventType:ping
}

Acción 24: reproducir

Detalles de implementación

Cambie el estado de reproducción a "reproduciendo". La llamada play después de pauseStart ya infiere una llamada “continuar” al final, por lo que no hay necesidad de un evento resume.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 31,
        ts: <timestamp>
    }, eventType:play
}

Acción 25: ping

Detalles de implementación

Mandar un ping al servidor cada 10 segundos.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 37,
        ts: <timestamp>
    }, eventType:ping
}

Acción 26: sesión completa

Detalles de implementación

Envíe sessionComplete al servidor para indicar que el usuario ha terminado de ver todo el contenido.

Cuerpo de la solicitud de muestra

{
    playerTime: {
        playhead: 45,
        ts: <timestamp>
    }, eventType:sessionComplete
}