Usando variáveis do jogador - 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á.

Usando variáveis do jogador

Para configurar AWS Elemental MediaTailor a fim de enviar dados recebidos do player para o ADS, no URL ADS do modelo ADS, especifique variáveis player_params.<query_parameter_name>. Por exemplo, se o player enviar um parâmetro de consulta nomeado user_id em sua solicitação para MediaTailor, para transmitir 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. No AWS Elemental MediaTailor, configure o URL do modelo de solicitação 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 no lado do servidor, codifique o URL dos pares de chave/valor no player. Quando MediaTailor recebe a solicitação de inicialização da sessão, ele decodifica os valores por URL uma vez antes de substituí-los na URL da solicitação do ADS.

    nota

    Caso o ADS exija um valor codificado por URL, o URL codifica o valor duas vezes no player. Dessa forma, a decodificação feita por MediaTailor resulta em um valor codificado uma vez para o ADS.

    Por exemplo, caso a representação decodificada dos valores enviados ao ADS seja param1=value1:&param2=value2:, a representação codificada por URL é 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.

    • Solicitações de exemplo para relatórios de rastreamento de anúncios no lado do servidor – usar pares codificados em URL

      HLS:

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

      DASH:

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

    • Solicitação de exemplo para relatórios de rastreamento de anúncios no lado do cliente – sem codificação por URL

      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 para o 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.