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á.
Funções: ganchos de ciclo de vida
Um gancho de ciclo de vida define quando MediaTailor executa sua função 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 trabalhos de configuração únicos, como buscar segmentos de público. Neste momento, nenhum intervalo de anúncio ocorreu, então 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úncios (ADS) — uma vez por intervalo de anúncio no stream. 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, mas são PRE_ADS_REQUEST executados repetidamente e podem adaptar cada solicitação do ADS ao intervalo publicitário específico.
Referência do campo de entrada
| Campo | Tipo | INICIALIZAÇÃO_PRÉ-SESSÃO | PRÉ-SOLICITAÇÃO_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 | ✗ | ✓ |
asset.* |
String | ✗ | ✓ |
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.
