View a markdown version of this page

Seguimiento del lado del servidor con inserción de anuncios guiada por el servidor (SGAI) - AWS Elemental MediaTailor

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 servidor con inserción de anuncios guiada por el servidor (SGAI)

Cuando utilizas la inserción de anuncios guiada por el servidor (SGAI), el seguimiento por parte del servidor utiliza un mecanismo de baliza sin sesión que difiere del enfoque basado en el modo cosido descrito anteriormente. En lugar de incluir segmentos de MediaTailor anuncios en el manifiesto de contenido (donde realiza un seguimiento de las /v1/segment solicitudes), SGAI devuelve las referencias a los anuncios como listas de reproducción independientes en una respuesta a la lista de activos, con los metadatos de las balizas integrados en el anuncio. URIs

Cómo funciona la baliza del lado del servidor sin sesión

Los siguientes pasos describen cómo funciona la baliza del lado del servidor para las sesiones de SGAI:

  1. Inicialización de la sesión: el reproductor solicita la lista de reproducción multivariante HLS con. aws.insertionMode=GUIDED Los informes del lado del servidor son los predeterminados (no se necesita ningún parámetro). aws.reportingMode A diferencia del modo cosido, la respuesta de inicialización de la sesión no incluye un. trackingUrl

  2. Manifiesto que se puede almacenar en caché: MediaTailor devuelve un manifiesto que se puede almacenar en caché y que contiene EXT-X-DATERANGE etiquetas CLASS="com.apple.hls.interstitial" y X-ASSET-LIST atributos que apuntan al punto final de la lista de activos intersticiales. MediaTailor

  3. Lista de activos con metadatos de balizas: cuando el jugador encuentra una pausa publicitaria, busca la lista de activos. MediaTailordevuelve una respuesta en JSON en la que cada URI de anuncio incluye metadatos de balizas cifrados:

    { "ASSETS": [ { "DURATION": 30.0, "URI": "https://cdn.example.com/ad/master.m3u8?awsBeaconData=<encrypted>&awsBeaconDomain=<MediaTailor-endpoint>&awsConfigurationName=<config-name>" } ] }

    Cuando los informes del lado del servidor están activos, la respuesta no incluye ninguna sección. TRACKING El anuncio contiene todos los URIs datos de las balizas.

  4. Sustitución de variables HLS: el reproductor busca la lista de reproducción multivariante del anuncio. El manifiesto publicitario utiliza #EXT-X-DEFINE:QUERYPARAM directivas para pasar los parámetros de baliza de la cadena de consulta URI al segmento URLs mediante la sustitución de variables HLS:

    #EXTM3U #EXT-X-DEFINE:QUERYPARAM="awsBeaconData" #EXT-X-DEFINE:QUERYPARAM="awsBeaconDomain" #EXT-X-DEFINE:QUERYPARAM="awsConfigurationName" #EXTINF:5.0, {$awsBeaconDomain}/segment/hash/{$awsConfigurationName}/{$awsBeaconData}/0/0?aws.segmentRelativePath=asset_00001.ts

    El reproductor resuelve las {$awsConfigurationName} variables y {$awsBeaconData}{$awsBeaconDomain}, utilizando los valores de la cadena de consulta del URI del manifiesto publicitario y, a continuación, solicita cada segmento de anuncio a través MediaTailor de él.

  5. La baliza se activa cuando se solicita un segmento de anuncio: a medida que el jugador solicita cada segmento de anuncio, se envía la solicitud MediaTailor. El servicio descifra los datos de la baliza, determina la posición del segmento dentro del anuncio (impresión, primer cuartil, punto medio, tercer cuartil o completo) y envía la baliza de seguimiento VAST adecuada al servidor de anuncios. MediaTailor a continuación, redirige al reproductor al segmento de contenido publicitario real.

Requisitos del reproductor para la baliza SGAI del lado del servidor

Para utilizar la baliza del lado del servidor con SGAI, tu jugador debe cumplir los siguientes requisitos:

  • HLS versión 11 o posterior

  • Support for EXT-X-DATERANGE with CLASS attribute for HLS Interstitials

  • Support for #EXT-X-DEFINE:QUERYPARAM variable substitution (RFC 8216bis). El jugador debe decodificar porcentualmente los valores de los parámetros de consulta antes de sustituirlos en el segmento. URLs

nota

Actualmente, la baliza SGAI del lado del servidor solo se admite para HLS. La baliza SGAI del lado del servidor aún no es compatible con DASH.

Comparación con el seguimiento del lado del servidor en modo cosido

En la siguiente tabla se resume en qué se diferencia el seguimiento del lado del servidor entre la inserción de anuncios unificada y la guiada por el servidor:

Aspecto Cosido (SSAI) Guiado por servidor (SGAI)
Capacidad de almacenamiento en caché manifiesta Por sesión, no se puede almacenar en caché Se puede almacenar en caché y se comparte entre los espectadores
Enrutamiento de segmentos de anuncios Mediante el /v1/segment/ uso del ID de sesión Mediante /v1/segment/ el uso de un blob de datos de baliza cifrado
Estado de sesión para balizas Almacenado por sesión en MediaTailor Sin sesión: todo el estado se incluye en el parámetro cifrado awsBeaconData
URL de seguimiento al inicio de la sesión Se devuelve en la respuesta de inicialización de la sesión No se proporciona: los datos de la baliza se incluyen en el anuncio de cada URIs respuesta a la lista de activos
Compatibilidad con DASH compatible No se admite todavía
nota

Para las sesiones de SGAI en directo, puedes habilitar la búsqueda previa de anuncios basada en manifiestos mediante. aws.guidedPrefetchMode=MANIFEST Esto es independiente de la API de captura previa basada en horarios que se utiliza en las sesiones agrupadas (SSAI). Para obtener más información, consulte Búsqueda previa guiada con palpitaciones manifiestas.