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 obter informações sobre a formatação compatível com parâmetros de consulta, consulte Caracteres e limitações suportados pelo parâmetro de consulta manifesto e. Limitações de tamanho dos parâmetros de consulta ADS
-
Para obter personalizações adicionais na solicitação do ADS, consulte. Uso avançado
Para passar informações de sessão e player ao ADS
-
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.
-
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 edeviceType
fornece dados do player:https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
-
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 eauth_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 oauth_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.