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.
Funciones: ciclos de vida
Un enlace de ciclo de vida define cuándo se MediaTailor ejecuta la función durante la reproducción. Esta página es una referencia completa para los campos de entrada, los espacios de nombres de salida y las reglas que rigen el flujo de datos en cada enlace.
Descripción general de
MediaTailor admite cuatro ganchos de ciclo de vida:
-
PRE_SESSION_INITIALIZATIONse activa una vez cuando un espectador inicia una nueva sesión. Utilízalo para tareas de configuración únicas, como buscar segmentos de audiencia. En este momento, no se ha producido ninguna pausa publicitaria, por lo que el contexto de la pausa publicitaria no está disponible. -
PRE_ADS_REQUESTse activa antes de cada solicitud del servidor de decisiones publicitarias (ADS), una vez por cada pausa publicitaria de la transmisión. Utilízala para personalizar la solicitud de ADS con datos de segmentación, modificar la URL de ADS o añadir encabezados. -
POST_ADS_RESPONSEse activa después de MediaTailor recibir y analizar la respuesta del ADS, incluida la resolución de los redireccionamientos del contenedor de la plantilla de publicación de anuncios de vídeo (VAST). Utilízala para filtrar, reordenar, modificar o complementar los anuncios devueltos por la ADS antes MediaTailor de seleccionar los anuncios que quieres insertar. -
PRE_MANIFEST_INSERTIONse activa al final de la política de personalización de las pausas publicitarias, tras la selección del anuncio, las comprobaciones de transcodificación y la política de llenado, inmediatamente antes de incluir los anuncios MediaTailor en el manifiesto. Utilízala para inspeccionar o modificar el conjunto final de anuncios, por ejemplo, para añadir anuncios adicionales en pausas publicitarias que no estén bien rellenadas.
Los ganchos difieren en cuanto a tiempo y alcance. PRE_SESSION_INITIALIZATIONse ejecuta una vez y configura los datos que persisten durante toda la sesión. PRE_ADS_REQUESTy POST_ADS_RESPONSE evita cada interacción de ADS. PRE_ADS_REQUESTda forma a la solicitud saliente y POST_ADS_RESPONSE actúa en función de la respuesta analizada antes de seleccionar el anuncio. PRE_MANIFEST_INSERTIONse ejecuta una vez finalizada la selección y muestra el anuncio definitivo para todas las pausas publicitarias recién personalizadas en una sola invocación.
importante
Los enlaces PRE_ADS_REQUESTPOST_ADS_RESPONSE, y PRE_MANIFEST_INSERTION comparten un presupuesto de ejecución combinado de 2000 ms para una sola solicitud. Este presupuesto se suma al tiempo de espera de 2000 ms propio de cada enlace. El tiempo de espera efectivo de un gancho es el menor entre su propio tiempo de espera y el presupuesto restante. El tiempo empleado por un enlace anterior reduce el tiempo disponible para los ganchos posteriores en la misma solicitud. Si el presupuesto restante se agota antes de que comience un enlace, MediaTailor lo omite y continúa procesando la solicitud sin él. PRE_SESSION_INITIALIZATIONse ejecuta durante la inicialización de la sesión y no forma parte del presupuesto combinado. Para obtener más información, consulte Límites.
nota
En esta documentación, una pausa publicitaria también se denomina avail. Los nombres de los campos de entrada (como avail.availId yavails.avails) y CloudWatch las métricas utilizan el avail formulario.
Referencia del campo de entrada
En la siguiente tabla se enumeran los campos de entrada disponibles en cada enlace del ciclo de vida. En la columna Campo, la parent[].child notación indica un campo de cada elemento de la parent matriz.
nota
PRE_MANIFEST_INSERTIONLos ganchos POST_ADS_RESPONSE y muestran los campos de sesión en CamelCase (por ejemplo,session.clientIp), mientras que los dos primeros ganchos usan snake_case (por ejemplo,). session.client_ip Los parámetros del jugador están disponibles en el espacio de player_params nombres de los dos primeros ganchos y como objeto en los session.playerParams otros dos.
| Campo | Tipo | PRE_SESSION_INITIALIZATION | PRE_ADS_REQUEST | POST_ADS_RESPONSE | INSERCIÓN PREVIA A LA MANIFESTACIÓN |
|---|---|---|---|---|---|
session.id | Largo | ✓ | ✓ | ✓ | ✓ |
session.uuid | Cadena | ✓ | ✓ | ✓ | ✓ |
session.client_ip | Cadena | ✓ | ✓ | ✗ | ✗ |
session.clientIp | Cadena | ✗ | ✗ | ✓ | ✓ |
session.user_agent | Cadena | ✓ | ✓ | ✗ | ✗ |
session.userAgent | Cadena | ✗ | ✗ | ✓ | ✓ |
session.referer* | Cadena | ✓ | ✓ | ✗ | ✗ |
session.avail_duration_secs | Largo | ✗ | ✓ | ✗ | ✗ |
session.avail_duration_ms | Largo | ✗ | ✓ | ✗ | ✗ |
session.streamingProtocol | Cadena | ✗ | ✗ | ✓ | ✓ |
session.playerParams | Objeto | ✗ | ✗ | ✓ | ✓ |
player_params.* | Cadena | ✓ | ✓ | ✗ | ✗ |
event.id | Cadena | ✓ | ✓ | ✓ | ✓ |
event.hook | Cadena | ✓ | ✓ | ✓ | ✓ |
event.timestamp | Cadena | ✓ | ✓ | ✓ | ✓ |
avail.index | Int | ✗ | ✓ | ✗ | ✗ |
avail.random | Largo | ✗ | ✓ | ✗ | ✗ |
avail.source_content_time_epoch_ms | Largo | ✗ | ✓ | ✗ | ✗ |
avail.availId† | Cadena | ✗ | ✗ | ✓ | ✗ |
avail.durationSeconds† | Número | ✗ | ✗ | ✓ | ✗ |
avail.startTime† | Cadena | ✗ | ✗ | ✓ | ✗ |
scte.event_id | Int | ✗ | ✓ | ✗ | ✗ |
scte.avail_num | Int | ✗ | ✓ | ✗ | ✗ |
scte.segmentation_event_id | Int | ✗ | ✓ | ✗ | ✗ |
scte.segmentation_type_id | Int | ✗ | ✓ | ✗ | ✗ |
scte.segmentation_upid | Cadena | ✗ | ✓ | ✗ | ✗ |
scte.segmentation_upid.assetId | Cadena | ✗ | ✓ | ✗ | ✗ |
scte.segmentation_upid.cueData.key | Cadena | ✗ | ✓ | ✗ | ✗ |
scte.segmentation_upid.cueData.value | Cadena | ✗ | ✓ | ✗ | ✗ |
scte.unique_program_id | Int | ✗ | ✓ | ✗ | ✗ |
scte.archive_allowed_flag | Booleano | ✗ | ✓ | ✗ | ✗ |
scte.delivery_not_restricted_flag | Booleano | ✗ | ✓ | ✗ | ✗ |
scte.device_restrictions | Int | ✗ | ✓ | ✗ | ✗ |
scte.no_regional_blackout_flag | Booleano | ✗ | ✓ | ✗ | ✗ |
scte.segment_num | Int | ✗ | ✓ | ✗ | ✗ |
scte.segments_expected | Int | ✗ | ✓ | ✗ | ✗ |
scte.sub_segment_num | Int | ✗ | ✓ | ✗ | ✗ |
scte.sub_segments_expected | Int | ✗ | ✓ | ✗ | ✗ |
scte.avails_expected | Largo | ✗ | ✓ | ✗ | ✗ |
asset.* | Cadena | ✗ | ✓ | ✗ | ✗ |
inference.enriched | Booleano | ✗ | ✓ | ✗ | ✗ |
inference.feedId | Cadena | ✗ | ✓ | ✗ | ✗ |
inference.dataEndpoint | Cadena | ✗ | ✓ | ✗ | ✗ |
inference.pts | Largo | ✗ | ✓ | ✗ | ✗ |
inference.timescale | Largo | ✗ | ✓ | ✗ | ✗ |
inference.region | Cadena | ✗ | ✓ | ✗ | ✗ |
inference.previousBreakEndPts | Largo | ✗ | ✓ | ✗ | ✗ |
inference.parseError | Booleano | ✗ | ✓ | ✗ | ✗ |
adsRequest.url | Cadena | ✗ | ✓ | ✓ | ✗ |
adsRequest.method | Cadena | ✗ | ✓ | ✓ | ✗ |
adsRequest.headers.<key> | Cadena | ✗ | ✓ | ✓ | ✗ |
adsRequest.body | Cadena | ✗ | ✓ | ✗ | ✗ |
adsResponse.responseType | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads | Matriz | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].adId‡ | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].durationSeconds | Número | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].adSystem | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].adTitle | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].creativeId | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].sequence | Int | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].mediaFiles | Matriz | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].mediaFiles[].url | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].mediaFiles[].mimeType | Cadena | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].mediaFiles[].width | Int | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].mediaFiles[].height | Int | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].mediaFiles[].bitrate | Int | ✗ | ✗ | ✓ | ✗ |
adsResponse.ads[].trackingEvents.<eventType> | Matriz de cadena | ✗ | ✗ | ✓ | ✗ |
avails.avails | Matriz | ✗ | ✗ | ✗ | ✓ |
avails.avails[].availId | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].durationSeconds | Número | ✗ | ✗ | ✗ | ✓ |
avails.avails[].startTime | Número | ✗ | ✗ | ✗ | ✓ |
avails.avails[].mediaProtocol | Cadena (|) HLS DASH | ✗ | ✗ | ✗ | ✓ |
avails.avails[].streamingMode | Cadena (LIVE|VOD) | ✗ | ✗ | ✗ | ✓ |
avails.avails[].fillDurationSeconds | Número | ✗ | ✗ | ✗ | ✓ |
avails.avails[].fillRate | Número (0—1) | ✗ | ✗ | ✗ | ✓ |
avails.avails[].mutable | Booleano | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads | Matriz | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].adId§ | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].vastAdId | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].creativeId | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].insertionUuid | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].sequenceInAvail | Int | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].durationSeconds | Número | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].adSystem¶ | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].adTitle¶ | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].mediaUrl | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].trackingEvents.<eventType> | Matriz de cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].ads[].mediaFiles | Matriz | ✗ | ✗ | ✗ | ✓ |
avails.avails[].skippedAds | Matriz | ✗ | ✗ | ✗ | ✓ |
avails.avails[].skippedAds[].adId | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].skippedAds[].vastAdId | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].skippedAds[].durationSeconds | Número | ✗ | ✗ | ✗ | ✓ |
avails.avails[].skippedAds[].creativeUrl | Cadena | ✗ | ✗ | ✗ | ✓ |
avails.avails[].skippedAds[].reason | Cadena | ✗ | ✗ | ✗ | ✓ |
* solo session.referer está presente cuando se incluye un encabezado de referencia en la solicitud de inicialización de la sesión. $exists(session.referer)Utilícelo para comprobar antes de acceder.
† El espacio de avail nombres solo está presente cuando la respuesta del ADS se aplica a una única pausa publicitaria. No está presente en las respuestas con interrupciones múltiples (VMAP) ni en las respuestas capturadas previamente. Úselo para comprobar antes $exists(avail) de acceder.
‡ AtPOST_ADS_RESPONSE, adId es el id atributo del <Ad> elemento VAST.
§ AtPRE_MANIFEST_INSERTION, adId es un identificador de ubicación interno. Es estable para un anuncio durante su pausa publicitaria, pero no es el ID de anuncio VAST y no es comparable entre pausas publicitarias o ganchos. Para comprobar la identidad que abarque pausas o enganches publicitarios, utiliza vastAdId (el id atributo del <Ad> elemento VAST) ocreativeId.
¶ En las transmisiones de VOD de DASH, adTitle y adSystem estamos null en este enlace. Usa vastAdId o creativeId en los predicados allí.
