View a markdown version of this page

MediaTailor passando parâmetros para o ADS - AWS Elemental MediaTailor
Uso avançado

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

MediaTailor passando parâmetros para o ADS

AWS Elemental MediaTailor suporta a configuração de variáveis dinâmicas em MediaTailor solicitações ao ADS usando as etapas a seguir.

Métodos de inicialização de sessão

MediaTailor suporta vários métodos para inicialização de sessão e passagem de parâmetros:

  1. POST com corpo da solicitação: 

    POST <master>.m3u8
{
    "adsParams": {"param1": "value1", "param2": "value2"},
    "playerParams": {"param3": "value3"}
}

  2. Parâmetros de consulta no URL: 

    GET <master>.m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
Importante

Você só pode especificar parâmetros uma vez, no momento da inicialização. Os aliases de configuração resolvem os valores reais antes do encaminhamento.

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 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 player faz para inicializar a sessão determina se o player (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 Relatórios e dados de 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 que você deseja enviar MediaTailor para o 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 solicitações recebidas de HLS e DASH para. AWS Elemental MediaTailor MediaTailor usa o deviceType em sua solicitação ao ADS e o auth_token em sua solicitação ao 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 modelo de URL de solicitação do ADS 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

Uso avançado

Personalize a solicitação ADS de muitas maneiras com dados do player e da sessão. Você só precisa 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]