Show Menu
TOPICS×

Seguimiento del contenido descargado

Información general

La función Contenido descargado proporciona la capacidad de realizar un seguimiento del consumo de contenido cuando un usuario está sin conexión. Por ejemplo, un usuario descarga e instala una aplicación en un dispositivo móvil. A continuación, el usuario descarga contenido mediante la aplicación en el almacenamiento local del dispositivo. Para realizar un seguimiento de los datos descargados, Adobe ha desarrollado la función Contenido descargado. Con esta función, cuando el usuario reproduce contenido desde el almacenamiento de un dispositivo, los datos de seguimiento se almacenan en el dispositivo, independientemente de la conectividad de este. Cuando el usuario termina la sesión de reproducción y el dispositivo vuelve a estar en línea, la información de seguimiento almacenada se envía al back-end de la API de recopilación de contenido en una única carga. A partir de ahí, el procesamiento y los informes se realizan de la forma normal en la API de recopilación de contenido.
Contrastar los dos enfoques:
  • En línea
    Con este enfoque en tiempo real, el reproductor de contenido envía los datos de seguimiento con cada evento del reproductor, y envía pings de red cada diez segundos (cada segundo en el caso de los anuncios), uno a uno al back-end.
  • Sin conexión (función Contenido descargado)
    Con este método de procesamiento por lotes, es necesario que se generen los mismos eventos de sesión, pero estos se almacenan en el dispositivo hasta que se envían al back-end como una sola sesión (ver ejemplo a continuación).
Cada enfoque tiene sus ventajas y desventajas:
  • El seguimiento del escenario en línea se realiza en tiempo real; esto requiere una comprobación de conectividad antes de cada llamada de red.
  • El escenario sin conexión (función Contenido descargado) solo necesita una comprobación de conectividad de red, pero también requiere un espacio de memoria mayor en el dispositivo.

Implementación

Esquemas de eventos

La función Contenido descargado es simplemente la versión sin conexión de la API (estándar) de recopilación de contenido en línea, por lo que los datos del evento que el reproductor envía al back-end deben utilizar los mismos esquemas de eventos que utiliza al realizar llamadas en línea. Para obtener más información sobre estos esquemas, consulte:

Orden de los eventos

  • El primer evento de la carga útil por lotes debe ser
    sessionStart
    , como es habitual con la API de recopilación de contenido.
  • Debe incluir
    media.downloaded: true
     en los parámetros de metadatos estándar (clave
    params
    ) del evento
    sessionStart
    para indicar al back-end que está enviando contenido descargado. Si este parámetro no está presente o se establece como falso, la API de Contenido descargado devolverá un código de respuesta 400 (solicitud no válida). Este parámetro distingue entre el contenido descargado y el contenido en directo en el back-end. (Tenga en cuenta que si
    media.downloaded: true
    se establece en una sesión activa, la API de emitirá igualmente una respuesta 400).
  • Es responsabilidad de la implementación almacenar correctamente los eventos del reproductor por orden de aparición.

Códigos de respuesta

  • 201: Creado, la solicitud correcta; los datos son válidos y la sesión se creó y se procesará.
  • 400: Solicitud incorrecta, error en la validación del esquema, se descartan todos los datos y no se procesan los datos de las sesiones.

Integración con Adobe Analtyics

Al calcular las llamadas de inicio y cierre de Analytics para el escenario de contenido descargado, el back-end establece un campo adicional de Analytics llamado
ts.
Estas son marcas de hora para el primer y último evento recibido (inicio y finalización). Este mecanismo permite colocar una sesión de contenido finalizada en el momento correcto (es decir, incluso si el usuario no vuelve a estar en línea durante varios días, la sesión de contenido se registra como si hubiera tenido lugar en el momento en el que el contenido se visualizó). Debe habilitar este mecanismo en Adobe Analytics. Para ello, cree un
grupo de informes con marca de hora opcional.
Para habilitar un grupo de informes con marca de hora opcional, consulte Marcas de hora opcionales.

Comparación de sesión de muestra

[url]/api/v1/sessions

Contenido en línea

{ eventType: "sessionStart", playerTime: { playhead: 0, ts: 1529997923478}, params: { /* Standard metadata parameters as documented */ }, customMetadata: { /* Custom metadata parameters as documented */ }, qoeData: { /* QoE parameters as documented */ } }

Contenido descargado

[{ eventType: "sessionStart", playerTime:{ playhead: 0, ts: 1529997923478}, params:{ "media.downloaded": true ... }, customMetadata:{}, qoeData:{} }, {eventType: "play", playerTime: {playhead: 0, ts: 1529997928174}}, {eventType: "ping", playerTime: {playhead: 10, ts: 1529997937503}}, {eventType: "ping", playerTime: {playhead: 20, ts: 1529997947533}}, {eventType: "ping", playerTime: {playhead: 30, ts: 1529997957545},}, {eventType: "sessionComplete", playerTime: {playhead: 35, ts: 1529997960559} }]