Passando parâmetros para o ADS Uso avançado

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

A solicitação do AWS Elemental MediaTailor para o Ad Decision Server (ADS – Servidor de decisões de anúncios) inclui informações sobre a sessão de exibição atual, o que ajuda o ADS a escolher os melhores anúncios a serem fornecidos como 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.

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.

Tópicos

Passando parâmetros para o ADS

Para passar informações de sessão e player ao ADS

Trabalhe com o ADS para determinar as informações necessárias, de maneira que ele possa responder a uma consulta de anúncio do 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 e deviceType 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 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 player inicia uma sessão, o AWS Elemental MediaTailor substitui as variáveis no URL de solicitação ADS do modelo pelos dados da sessão e pelos parâmetros ads do player. Ele passa os parâmetros restantes do player para o servidor de origem.

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

As seções a seguir dão detalhes de como configurar dados da sessão e do player.

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 de host 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]
```

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Integrações de rastreamento de anúncios

Usando variáveis de domínio