View a markdown version of this page

MediaTailor variáveis de player para solicitações de ADS - 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á.

MediaTailor variáveis de player para solicitações de ADS

AWS Elemental MediaTailor envia dados recebidos do player para o ADS quando você configura AWS Elemental MediaTailor para especificar player_params.<query_parameter_name> variáveis no URL do ADS do modelo. Por exemplo, se o player enviar um parâmetro de consulta nomeado user_id em sua solicitação para MediaTailor, para passar esses dados na solicitação do ADS, inclua-o [player_params.user_id] na configuração do URL do ADS.

Isso permite controlar os parâmetros de consulta incluídos na solicitação ADS. Normalmente, você adiciona um parâmetro de consulta especial reconhecido pelo ADS ao URL da solicitação ADS e fornece pares de chave/valor, como o valor do parâmetro.

Os exemplos usados no seguinte procedimento usam os seguintes pares de chave/valor:

  • param1 com um valor value1:

  • param2 com um valor value2:

Para adicionar parâmetros de consulta como pares de chave/valor

  1. Em AWS Elemental MediaTailor, configure a URL do modelo de solicitação do ADS para referenciar os parâmetros. O seguinte URL mostra a inclusão dos parâmetros de exemplo: 

    https://my.ads.com/path?param1=[player_params.param1]&param2=[player_params.param2]

  2. (Opcional) Para relatórios de rastreamento de anúncios do lado do servidor, os pares de valores-chave URL-encode no player. Quando MediaTailor recebe a solicitação de inicialização da sessão, insere URL-decodes os valores uma vez antes de substituí-los na URL de solicitação do ADS.

    nota

    Se seu ADS exigir um URL-encoded valor, URL-encode o valor é duas vezes no player. Dessa forma, a decodificação feita pelo MediaTailor resulta em um valor codificado uma vez para o ADS.

    Por exemplo, se a representação decodificada dos valores enviados ao ADS forparam1=value1:&param2=value2:, então a URL-encoded representação éparam1=value1%3A&param2=value2%3A.

  3. Na chamada de inicialização da sessão do player, passe os pares de valores-chave para MediaTailor como o valor de um único parâmetro de consulta. As chamadas de exemplo a seguir fornecem os pares de chave/valor de exemplo para relatórios de rastreamento de anúncios nos lados do servidor e do cliente.

    • Exemplos de solicitações de relatórios de rastreamento de anúncios do lado do servidor - usando pares URL-encoded

      HLS:

      <master>.m3u8?ads.param1=value1%3A&ads.param2=value2%3A

      DASH:

      <manifest>.mpd?ads.param1=value1%3A&ads.param2=value2%3A

    • Exemplo de solicitação de relatório de rastreamento de anúncios do lado do cliente - sem URL-encoding

      HLS:

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

      DASH:

      POST <manifest>.mpd
    {
        "adsParams": {
           "param1": "value1:",
           "param2": "value2:"
       }
    }

Para relatórios do lado do servidor, MediaTailor decodifica os parâmetros quando a solicitação do jogador é recebida. Para relatórios do lado do cliente, isso não altera os parâmetros recebidos na carga JSON. MediaTailor envia a seguinte solicitação ao ADS:

https://my.ads.com/<path>?param1=value1:&param2=value2:

Dessa maneira, o param1 e os pares de chave/valor param2 são incluídos como parâmetros de consulta de primeira classe na solicitação ADS.