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á.
Pre-ads solicitação
Quando dispara
MediaTailor executa a função mapeada para PRE_ADS_REQUEST uma vez por intervalo de anúncio, imediatamente antes de enviar a solicitação ao ADS. A função é executada sempre que uma oportunidade de anúncio é encontrada durante o processamento do manifesto.
Input
Todos os campos dePRE_SESSION_INITIALIZATION, plusavail.*, scte.*asset.*, e adsRequest.* (url, método, cabeçalhos, corpo). Para ver todos os campos disponíveis, consulteReferência do campo de entrada.
Namespace de saída permitido
| Namespace | Tipos aceitos | Como a saída é usada |
|---|---|---|
player_params.* |
Cadeias de caracteres, números, booleanos | Substitui os parâmetros do player da sessão para esse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio deMediaTailor variáveis de anúncios dinâmicos para solicitações de ADS. |
session.* |
Cadeias de caracteres, números, booleanos | Substitui as variáveis da sessão para esse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. |
avail.* |
Cadeias de caracteres, números, booleanos | Substitui as variáveis disponíveis para esse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. |
scte.* |
Cadeias de caracteres, números, booleanos | Substitui as variáveis SCTE para esse intervalo de anúncio. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. |
asset.* |
Cadeias de caracteres, números, booleanos | Substitui as variáveis de metadados do ativo (das EXT-X-ASSET tags) para esse intervalo publicitário. Disponível para o URL de solicitação do ADS por meio da substituição dinâmica de variáveis. Para obter mais informações sobre marcadores de anúncios HLS, consulte Marcadores de anúncios HLS. |
adsRequest.* |
String | Substitui a solicitação do ADS somente para esse intervalo publicitário. Campos suportados:url,method,headers.<name>,body. O url valor é tratado como um modelo e é suportado MediaTailor variáveis de anúncios dinâmicos para solicitações de ADS após a execução da função. Não persistiu. |
nota
Todas as saídas do PRE_ADS_REQUEST gancho são substituições transitórias — elas se aplicam somente à solicitação de ADS do intervalo publicitário atual e não persistem na sessão.
Exemplo — reescrever a solicitação do ADS:
{ "Output": { "adsRequest.url": "{%'https://ads.example.com/v1/vast?sid=' & session.id & '&genre=' & player_params.genre%}", "adsRequest.headers.X-Custom-Token": "{%player_params.auth_token%}" } }
Isso substitui o URL do ADS e adiciona um cabeçalho personalizado para o intervalo de anúncio atual.
Caso de uso típico
-
Reescreva o URL da solicitação do ADS para direcionar o tráfego entre diferentes servidores de anúncios para A/B teste.
-
Anexe dados de enriquecimento (segmentos de público, tokens de identidade) ao URL ou aos cabeçalhos da solicitação do ADS.
-
Modifique condicionalmente os parâmetros de solicitação do ADS com base nos dados SCTE-35 do sinal ou no índice de disponibilidade.
Comportamento com falha
Se uma função anexada PRE_ADS_REQUEST falhar por qualquer motivo, MediaTailor descarta a saída da função e procede como se nenhuma função estivesse anexada. A solicitação do ADS é enviada usando os parâmetros originais da sessão e da solicitação sem modificação.
