Seguimiento del lado del cliente - AWS Elemental MediaTailor
Habilitar el seguimiento del lado del clienteParámetros del servidor de anunciosParámetros de consulta de interacción de origenFunciones configuradas por sesiónMejores prácticas para el seguimiento del lado del cliente

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Seguimiento del lado del cliente

Con la API de seguimiento del AWS Elemental MediaTailor lado del cliente, puedes incorporar controles de reproducción durante las pausas publicitarias en los flujos de trabajo de streaming. En el seguimiento por parte del cliente, el reproductor o el cliente emiten eventos de seguimiento, como las impresiones y las balizas publicitarias por cuartiles, al Ad Decision Server (ADS) y a otras entidades de verificación de anuncios. Para obtener más información sobre la baliza de anuncios por impresiones y cuartiles, consulte. Balizamiento del lado del cliente Para obtener más información sobre ADS y otras entidades de verificación de anuncios, consulte. Integraciones de seguimiento de anuncios del lado del cliente

El seguimiento por parte del cliente permite funciones como las siguientes:

Con la API de seguimiento MediaTailor del lado del cliente, puedes enviar metadatos al dispositivo de reproducción que habilitan otras funciones además del seguimiento del lado del cliente:

Temas

Habilitar el seguimiento por parte del cliente

Habilitas el seguimiento por parte del cliente para cada sesión. El reproductor crea un HTTP en el punto final del POST prefijo de inicialización de la sesión de la MediaTailor configuración. Si lo desea, el reproductor puede enviar metadatos adicionales MediaTailor para utilizarlos cuando realice anuncios publicitarios, llame al origen de un manifiesto e invoque o MediaTailor deshabilite funciones a nivel de sesión.

En el siguiente ejemplo, se muestra la estructura de los metadatos de JSON:

{
  "adsParams": {                  # 'adsParams' is case sensitive
    "param1": "value1",           # key is not case sensitive
    "param2": "value2",           # Values can contain spaces. For example, 'value 2' is an allowed value. 
    },
  "origin_access_token":"abc123", # this is an example of a query parameter designated for the origin
  "overlayAvails":"on"            # 'overlayAvails' is case sensitive. This is an example of a feature that is enabled at the session level.
}

Use la MediaTailor consola o la API para configurar la URL de la plantilla de solicitud de ADS para hacer referencia a estos parámetros. En el siguiente ejemplo, player_params.param1 son los parámetros del reproductor para param1 y player_params.param2 son los parámetros del reproductor paraparam2.

https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

Parámetros del servidor de anuncios

En el nivel superior de la estructura JSON hay un objeto JSON. adsParams Dentro de este objeto hay pares clave/valor que se MediaTailor pueden leer y enviar al servidor de anuncios en todas las solicitudes de sesión. MediaTailor admite los siguientes servidores de anuncios:

  • Administrador de anuncios de Google

  • SpringServe

  • FreeWheel

  • Publica

Parámetros de consulta de interacción de Origin

Los pares clave/valor reservados que se encuentren en el nivel superior de la estructura JSON, por ejemplo, y adParams availSuppressionoverlayAvails, no se añaden a la URL de la solicitud de origen en forma de parámetros de consulta. Cada solicitud de manifiesto de sesión que se MediaTailor envía al origen contiene estos parámetros de consulta. El origen ignora los parámetros de consulta ajenos. Por ejemplo, MediaTailor puede usar los pares clave/valor para enviar los tokens de acceso al origen.

Funciones configuradas por sesión

Utilice la estructura JSON de inicialización de sesión para habilitar, deshabilitar o anular funciones como, y. MediaTailor overlayAvails availSuppression adSignaling Cualquier configuración de funciones que se apruebe durante la inicialización de la sesión anula la configuración a nivel de configuración. MediaTailor

nota

Los metadatos enviados MediaTailor al inicializar la sesión son inmutables y no se pueden agregar metadatos adicionales mientras dure la sesión. Utilice los marcadores SCTE-35 para almacenar los datos que cambien durante la sesión. Para obtener más información, consulte Uso de variables de sesión.

ejemplo : Realizar un seguimiento de anuncios del lado del cliente para HLS
POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.m3u8

        {
            "adsParams": {
               "deviceType": "ipad"   # This value does not change during the session.
               "uid": "abdgfdyei-2283004-ueu"                     
           }
        }
ejemplo : Realizar un seguimiento de anuncios del lado del cliente para DASH
POST mediatailorURL/v1/session/hashed-account-id/origin-id/asset-id.mpd

        {
            "adsParams": {
               "deviceType": "androidmobile",
               "uid": "xjhhddli-9189901-uic" 
           }
        }

Una respuesta correcta es un HTTP 200 con un cuerpo de respuesta. El cuerpo contiene un objeto JSON con una manifestUrl y una trackingUrl clave. Los valores son direcciones URL relativas que el reproductor puede utilizar tanto para la reproducción como para el seguimiento de eventos publicitarios.

{
  "manifestUrl": "/v1/dashmaster/hashed-account-id/origin-id/asset-id.m3u8?aws.sessionId=session-id",
  "trackingUrl": "/v1/tracking/hashed-account-id/origin-id/session-id"
}

Para obtener más información sobre el esquema de seguimiento del lado del cliente, consulte. Esquema de seguimiento de anuncios del lado del cliente

Prácticas recomendadas para el seguimiento del lado del cliente

En esta sección se describen las mejores prácticas para el seguimiento del lado del cliente, tanto para los flujos de trabajo en directo como MediaTailor para los de vídeo a la carta.

Flujos de trabajo activos

Sondea el punto final de seguimiento en un intervalo que coincida con la duración objetivo de HLS o el período mínimo de actualización en el caso de DASH, a fin de disponer siempre de los metadatos de seguimiento de anuncios más recientes. Hacer coincidir este intervalo es especialmente importante en los flujos de trabajo en los que las creatividades pueden tener un componente interactivo o superpuesto.

nota

Algunos reproductores apoyan a los oyentes de los eventos, lo que podría utilizarse como alternativa a las votaciones. Por ejemplo, la función de decoración de los identificadores de MediaTailor anuncios tendría que estar habilitada para cada sesión. Para obtener más información, consulte Decoración de ID de anuncio. Al usar esta función, se coloca un identificador de intervalo de fechas (HLS) o elemento de evento (DASH) sobre cada anuncio disponible. Los jugadores pueden usar estas etiquetas de manifiesto como mensaje para llamar al punto final MediaTailor de seguimiento de la sesión.

Flujos de trabajo de VOD

Una vez inicializada correctamente la sesión y tras MediaTailor recibir el primer manifiesto que contenga contenido multimedia, solo tendrá que llamar al punto final de seguimiento una vez.

Flujo de llamadas para flujos de trabajo de VOD. Llame al punto final de seguimiento del lado del cliente una vez inicializada la sesión y MediaTailor reciba el primer manifiesto que contiene contenido multimedia.