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 para enviar dados recebidos do player para oADS, no modelo ADSURL, especifique player_params.<query_parameter_name> as variáveis. 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 ADS solicitação, inclua [player_params.user_id] na ADS URL configuração.

Isso permite que você controle os parâmetros de consulta incluídos na ADS solicitação. Normalmente, você adiciona um parâmetro de consulta especial que ADS reconhece à ADS solicitação URL e fornece pares de valores-chave 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 o modelo de ADS solicitação URL para referenciar os parâmetros. Veja a URL seguir 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, URL codifique os pares de valores-chave no player. Quando MediaTailor recebe a solicitação de inicialização da sessão, ela URL decodifica os valores uma vez antes de substituí-los na solicitação. ADS URL

    nota

    Se você ADS precisar de um valor URL codificado em URL -, codifique 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, se a representação decodificada dos valores enviados para o ADS éparam1=value1:&param2=value2:, a representação URL codificada em -é. 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 para relatórios de rastreamento de anúncios do lado do servidor - usando 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

    • Exemplo de solicitação para relatórios de rastreamento de anúncios do lado do cliente - sem codificação 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 JSON carga útil. MediaTailor envia a seguinte solicitação paraADS:

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

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