Passando parâmetros para o ADS Uso avançado

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

A ferramenta AWS Elemental MediaTailor uma solicitação ao servidor de decisão de anúncio (ADS) inclui informações sobre a sessão de visualização atual, o que ajuda a ADS escolher os melhores anúncios a serem fornecidos em sua resposta. Ao configurar o ADS modelo 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 que MediaTailor espera doADS.
Variáveis de domínio — Variáveis dinâmicas que podem ser usadas para URL domínios, como a parte my-ads-server.com do URL http://my-ads-server.com. Para obter detalhes, consulte Usando variáveis de domínio para configurar várias fontes de conteúdo e anúncios.
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 o ajudam 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 as informações da sessão e do jogador para o ADS

Trabalhe com o ADS para determinar as informações de que ele precisa para poder responder a uma consulta de anúncio do AWS Elemental MediaTailor.
Crie uma configuração MediaTailor que use uma ADS solicitação de modelo URL que atenda aos ADS requisitos. NoURL, inclua parâmetros estáticos e inclua espaços reservados para parâmetros dinâmicos. Insira seu modelo URL no campo Servidor de decisão de anúncios da configuração.

No modelo de exemplo a seguirURL, correlation fornece dados da sessão e deviceType fornece dados do jogador:
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
No player, configure a solicitação de início da sessão para AWS Elemental MediaTailor para 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 é destinado à ADS e auth_token se destina à origem:
- (Opção) Solicite relatórios de rastreamento de anúncios do lado do servidor — Prefixe os parâmetros que você deseja MediaTailor enviar para o with. ADS ads Deixe o prefixo desativado para os parâmetros que você MediaTailor deseja 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.
  
  HLSexemplo:
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
  DASHexemplo:
```
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 interior de um objeto. adsParams
  
  HLSexemplo:
```
POST master.m3u8
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```
  DASHexemplo:
```
POST manifest.mpd
    {
        "adsParams": {
           "deviceType": "ipad"
       }
    }
```

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

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

MediaTailor chama o ADS com os dados da sessão e o tipo de dispositivo do player:
```
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
```

MediaTailor chama o servidor de origem com o token de autorização do jogador.

HLSexemplo:


https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh

DASHexemplo:


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

Você pode personalizar a ADS solicitação de várias maneiras com os dados do jogador e da sessão. O único requisito é incluir o ADS nome do host.

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