Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Usando variáveis dinâmicas de anúncios em MediaTailor

Modo de foco
Usando variáveis dinâmicas de anúncios em MediaTailor - AWS Elemental MediaTailor

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

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

A AWS Elemental MediaTailor solicitação ao servidor de decisão de anúncios (ADS) inclui informações sobre a sessão de visualização atual, o que ajuda o ADS a escolher os melhores anúncios para fornecer em sua resposta. Ao configurar o modelo ADS em sua MediaTailor configuração, você pode incluir variáveis dinâmicas, também conhecidas como macros. Variáveis dinâmicas são cadeias de caracteres substituíveis.

As variáveis dinâmicas podem assumir as seguintes formas:

  • Valores estáticos — Valores que não mudam de uma sessão para outra. Por exemplo, o tipo de resposta esperado pelo MediaTailor do ADS.

  • Variáveis de domínio — Variáveis dinâmicas que podem ser usadas para domínios de URL, como a parte my-ads-server.com da URL http://my-ads-server.com. Para obter detalhes, consulte Usando variáveis de domínio.

  • Dados da sessão — valores dinâmicos fornecidos por MediaTailor para cada sessão, por exemplo, o ID da sessão. Para obter detalhes, consulte Usando variáveis de sessão.

  • Dados do jogador — Valores dinâmicos fornecidos pelo jogador em cada sessão. Eles descrevem o visualizador do conteúdo e ajudam o ADS a determinar quais anúncios MediaTailor devem ser incluídos no stream. Para obter detalhes, consulte Usando variáveis do jogador.

Passando parâmetros para o ADS

As etapas a seguir descrevem como configurar variáveis dinâmicas em MediaTailor solicitações ao ADS.

Para passar informações de sessão e player ao ADS
  1. Trabalhe com o ADS para determinar as informações de que ele precisa para poder responder a uma consulta de anúncio AWS Elemental MediaTailor.

  2. Crie uma configuração MediaTailor que use um modelo de URL de solicitação do ADS que atenda aos requisitos do ADS. No URL, inclua parâmetros estáticos e espaços reservados para parâmetros dinâmicos. Digite o URL do modelo no campo Ad decision server (Servidor de decisões de anúncios) da configuração.

    No seguinte URL do modelo de exemplo, correlation fornece dados da sessão e deviceType fornece dados do player:

    https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
  3. No player, configure a solicitação de iniciação da sessão para o AWS Elemental MediaTailor fornecer parâmetros para os dados do player. Inclua os parâmetros na solicitação de iniciação da sessão e os omita de solicitações subsequentes da sessão.

    O tipo de chamada que o jogador faz para inicializar a sessão determina se o jogador (cliente) ou MediaTailor (servidor) fornece relatórios de rastreamento de anúncios para a sessão. Para obter informações sobre essas duas opções, consulte Dados de relatórios e rastreamento .

    Faça um dos tipos de chamadas a seguir, dependendo do desejo de relatórios para o rastreamento de anúncios no lado do servidor ou do cliente. Em ambas as chamadas de exemplo, userID é desejado para o ADS e auth_token é desejado para a origem:

    • (Opção) Solicite relatórios de rastreamento de anúncios do lado do servidor — Prefixe os parâmetros com os quais você deseja enviar MediaTailor ao ADS. ads Deixe o prefixo desativado para parâmetros para os quais o MediaTailor deve enviar ao servidor de origem:

      Os exemplos a seguir mostram as solicitações recebidas de HLS e DASH para. AWS Elemental MediaTailor MediaTailor usa o deviceType em sua solicitação para o ADS e o auth_token em sua solicitação para o servidor de origem.

      Exemplo de HLS:

      GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh

      Exemplo de DASH:

      GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
    • (Opção) Solicite relatórios de rastreamento de anúncios do lado do cliente — Forneça parâmetros para o ADS dentro de um objeto. adsParams

      Exemplo de HLS:

      POST master.m3u8 { "adsParams": { "deviceType": "ipad" } }

      Exemplo de DASH:

      POST manifest.mpd { "adsParams": { "deviceType": "ipad" } }

Quando o jogador inicia uma sessão, AWS Elemental MediaTailor substitui as variáveis no URL de solicitação do ADS modelo pelos dados da sessão e pelos parâmetros do ads jogador. Ele passa os parâmetros restantes do player para o servidor de origem.

exemplo MediaTailor solicitações com variáveis de anúncio

Os exemplos a seguir mostram as chamadas para o ADS e o servidor de origem do AWS Elemental MediaTailor que correspondem aos exemplos de chamada de inicialização de sessão do player anterior:

  • MediaTailor chama o ADS com os dados da sessão e o tipo de dispositivo do jogador:

    https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
  • MediaTailor chama o servidor de origem com o token de autorização do jogador.

    • Exemplo de HLS:

      https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh
    • Exemplo de DASH:

      https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh

Caracteres e limitações suportados pelo parâmetro de consulta manifesto

Você pode usar os seguintes caracteres nos parâmetros de consulta usados nas solicitações de manifesto:

  • Alfanumérico (A-Z, a-z, 0-9)

  • Períodos (.)

  • Hífens (-)

  • Sublinha (_)

  • Barras invertidas (\)

Limitações de comprimento

O tamanho total de todos os parâmetros de consulta do manifesto (a chave e o valor combinados) não deve exceder 2.000 caracteres.

Caracteres não suportados

Você não pode usar os seguintes caracteres nos parâmetros de consulta do manifesto: : ? & = % / (barra invertida)

Limitações de tamanho dos parâmetros de consulta ADS

As seguintes limitações de comprimento se aplicam aos parâmetros de consulta usados em solicitações ao ADS:

  • Nome do parâmetro ADS: 10000 caracteres

  • Valor do parâmetro ADS: 25000 caracteres

  • URL do ADS: 25000 caracteres

Uso avançado

Personalize a solicitação ADS de muitas maneiras com dados do player e da sessão. O único requisito é incluir o nome do host do ADS.

Os exemplos a seguir mostram algumas das maneiras de personalizar a solicitação:

  • Concatene os parâmetros do player e da sessão para criar novos parâmetros. Exemplo: .

    https://my.ads.com?key1=[player_params.value1][session.id]
  • Use um parâmetro de player como parte de um elemento do caminho. Exemplo: .

    https://my.ads.com/[player_params.path]?key=value
  • Use os parâmetros do player para passar ambos os elementos de caminho e as chaves propriamente ditas, e não apenas valores. Exemplo: .

    https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]

Para obter mais informações sobre o uso de variáveis dinâmicas de domínio, sessão e jogador, selecione o tópico aplicável.

Nesta página

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.