View a markdown version of this page

Server-side seguimiento 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.

Server-side seguimiento con inserción de anuncios guiada por el servidor (SGAI)

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

Cómo funcionan las balizas sin sesión en el lado del servidor

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

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

  2. Manifiesto almacenable en caché: MediaTailor devuelve un manifiesto que se puede almacenar en caché 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 baliza: cuando el jugador encuentra una pausa publicitaria, busca la lista de activos. MediaTailordevuelve una respuesta JSON en la que cada URI de anuncio incluye metadatos cifrados de la baliza:

    { "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 Los URI de los anuncios contienen todos los datos de las balizas.

  4. Sustitución de variables HLS: el reproductor busca la lista de reproducción multivariante del anuncio. El manifiesto del anuncio utiliza #EXT-X-DEFINE:QUERYPARAM directivas para transferir los parámetros de la baliza de la cadena de consulta del URI a las URL de los segmentos 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 {$awsBeaconData}{$awsBeaconDomain}, y utilizando los valores de la cadena de consulta URI del manifiesto publicitario y, a continuación, solicita el acceso a cada segmento de anuncio. MediaTailor

  5. Activación de balizas al solicitar un segmento: a medida que el jugador solicita cada segmento de anuncios, la solicitud se canaliza MediaTailor. El servicio descifra los datos de la baliza, determina la posición del segmento en el 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 propiamente dicho.

Requisitos de los jugadores para la balización SGAI desde el servidor

Para utilizar las balizas del lado del servidor con SGAI, el reproductor debe cumplir los siguientes requisitos:

  • HLS versión 11 o posterior

  • Compatibilidad EXT-X-DATERANGE con CLASS atributos para HLS Interstitials

  • Soporte para la sustitución de #EXT-X-DEFINE:QUERYPARAM variables (RFC 8216bis). El jugador debe decodificar de forma porcentual los valores de los parámetros de consulta antes de sustituirlos por las URL de los segmentos.

nota

Actualmente, las balizas SGAI del lado del servidor solo son compatibles con HLS. DASH aún no es compatible con las balizas SGAI del lado del servidor.

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

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

Aspecto Stitched (SSAI) Server-guided (SGAI)
Capacidad de almacenamiento en caché manifiesta Per-session, no se puede almacenar en caché Se puede almacenar en caché, se comparte entre los espectadores
Enrutamiento por segmentos de anuncios Mediante el /v1/segment/ uso del ID de sesión Mediante el /v1/segment/ uso de un blob de datos de baliza encriptado
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 están incrustados en los URI de los anuncios de cada respuesta de la lista de activos
Compatibilidad con DASH compatible No se admite todavía
nota

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