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