View a markdown version of this page

SOLICITAÇÃO PRÉVIA DE ANÚNCIOS - AWS Elemental MediaTailor
Quando disparaInputNamespace de saída permitidoCaso de uso típicoComportamento com falha

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á.

SOLICITAÇÃO PRÉVIA DE ANÚNCIOS

Quando dispara

MediaTailor executa a função mapeada 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, maisavail.*,scte.*, 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 dinâmicas de anúncios para solicitações de ADS.
session.* Cadeias de caracteres, números, booleanos Substitui as variáveis de sessão desse 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.
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 dinâmicas de anúncios 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 publicitário atual.

Caso de uso típico

  • Reescreva o URL de solicitação do ADS para rotear o tráfego entre diferentes servidores de anúncios para A/B testes.

  • 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.