As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Ganchos de ciclo de vida de funções
Um gancho de ciclo de vida define quando sua função MediaTailor é executada durante a reprodução. Esta página é uma referência completa para campos de entrada, namespaces de saída e as regras que governam o fluxo de dados em cada gancho.
Visão geral do
MediaTailor suporta dois ganchos de ciclo de vida:
-
PRE_SESSION_INITIALIZATIONé acionado uma vez quando um espectador inicia uma nova sessão. Use-o para um trabalho de configuração único, como buscar segmentos de público. Neste momento, nenhum intervalo de anúncio ocorreu, portanto, o contexto do intervalo de anúncio não está disponível. -
PRE_ADS_REQUESTé acionado antes de cada solicitação do servidor de decisão de anúncio (ADS) — uma vez por intervalo de anúncio na transmissão. Use-o para personalizar a solicitação do ADS com dados de segmentação, modificar o URL do ADS ou adicionar cabeçalhos.
A principal diferença é o tempo: é PRE_SESSION_INITIALIZATION executado uma vez e configura dados que persistem durante toda a sessão, ao mesmo tempo em que PRE_ADS_REQUEST é executado repetidamente e pode adaptar cada solicitação do ADS ao intervalo de anúncio específico.
Referência do campo de entrada
| Campo | Tipo | INICIALIZAÇÃO DA PRÉ-SESSÃO | SOLICITAÇÃO PRÉVIA DE ANÚNCIOS |
|---|---|---|---|
session.id |
Longo | ✓ | ✓ |
session.uuid |
String | ✓ | ✓ |
session.client_ip |
String | ✓ | ✓ |
session.user_agent |
String | ✓ | ✓ |
session.referer* |
String | ✓ | ✓ |
session.avail_duration_secs |
Longo | ✗ | ✓ |
session.avail_duration_ms |
Longo | ✗ | ✓ |
player_params.* |
String | ✓ | ✓ |
event.id |
String | ✓ | ✓ |
event.hook |
String | ✓ | ✓ |
event.timestamp |
String | ✓ | ✓ |
avail.index |
Int | ✗ | ✓ |
avail.random |
Longo | ✗ | ✓ |
avail.source_content_time_epoch_ms |
Longo | ✗ | ✓ |
scte.event_id |
Int | ✗ | ✓ |
scte.avail_num |
Int | ✗ | ✓ |
scte.segmentation_event_id |
Int | ✗ | ✓ |
scte.segmentation_type_id |
Int | ✗ | ✓ |
scte.segmentation_upid |
String | ✗ | ✓ |
scte.segmentation_upid.assetId |
String | ✗ | ✓ |
scte.segmentation_upid.cueData.key |
String | ✗ | ✓ |
scte.segmentation_upid.cueData.value |
String | ✗ | ✓ |
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 |
Longo | ✗ | ✓ |
adsRequest.url |
String | ✗ | ✓ |
adsRequest.method |
String | ✗ | ✓ |
adsRequest.headers.<key> |
String | ✗ | ✓ |
adsRequest.body |
String | ✗ | ✓ |
* só session.referer está presente quando um cabeçalho Referer é incluído na solicitação de inicialização da sessão. Use $exists(session.referer) para verificar antes de acessar.
