Localize um ID da sessão DAI (Inserção de anúncios dinâmicos) ou uma chave de depuração

É atribuído um ID da sessão a cada stream de utilizador, que é guardado durante 48 horas após um evento. As sessões monitorizadas são guardadas durante 60 dias. Pode introduzir o ID da sessão no campo "Identificador de sessões" do monitorizador de atividade de stream (MAS). Os resultados da pesquisa permitem-lhe ver detalhes sobre os pedidos de anúncios do utilizador para resolver problemas de stream de vídeo.

Vamos abordar as seguintes formas de encontrar um ID da sessão:

• Encontre um ID da sessão numa app que use o SDK para IMA (Anúncios Multimédia Interativos)
• Encontre um ID da sessão ao inspecionar o tráfego HTTP
• Encontre um ID da sessão a partir de um pedido HTTP emulado
• Encontre um ID da sessão num pedido de stream de SSB (beacon do lado do servidor)

Utilize uma chave de depuração para ver a atividade ou resolver problemas de stream de vídeo ^(Beta) 

Em alternativa, pode utilizar uma chave de depuração para ver a atividade ou resolver problemas de stream de vídeo.

Pode definir ou transmitir uma chave única para qualquer stream ou sessão de modo a poder depurar a stream através do MAS. Se usar a mesma chave entre sessões, apenas a sessão mais recente é pesquisável e está disponível para depuração.

• Streams pedidas com o SDK para IMA: consulte a documentação do SDK para saber mais sobre a chamada API para definir a chave.
• Streams pedidas sem o SDK para IMA (SSB): transmita uma chave de depuração através do parâmetro dai-sam-id.

  _{Por exemplo: https://dai.google.com/linear/hls/event/.../master.m3u8?dai-sam-id=abcdef-0a1b-12a3}

As chaves não podem incluir informações de identificação pessoal.

Encontre um ID da sessão numa app que use o SDK para IMA

Quando usar o SDK para IMA para criar uma stream de vídeo, pode chamar um método para obter o ID da sessão. Veja detalhes sobre como obter o ID no SDK de cada plataforma:

• Android SDK
• iOS SDK
• tvOS SDK
• HTML5 SDK
• Chromecast SDK
• Roku SDK

Muitos programadores de aplicações optam por captar o ID da sessão e registá-lo para que fique disponível para a resolução de problemas de stream.

Uma vez que o ID da sessão é essencial para rever detalhes sobre o fornecimento de anúncios na stream de um utilizador, é útil implementar um método ou uma funcionalidade oculta na sua aplicação para apresentar facilmente o ID.

Encontre um ID da sessão ao inspecionar o tráfego HTTP

Pode monitorizar os pedidos HTTP numa ferramenta de proxy a partir de uma aplicação que utilize o SDK para IMA.

Quando usar o SDK para IMA para pedir uma stream de vídeo de Inserção de anúncios dinâmicos (DAI), existem dois pedidos HTTP:

• O pedido HTTP POST, que deve ser devolvido com um estado 201 a indicar que foi criada a nova stream.
• O pedido HTTP GET para o URL no campo stream_manifest. *.

São devolvidas informações adicionais numa estrutura JSON, incluindo o stream_id. Trata-se do ID da sessão que deve introduzir no campo "Identificador de sessões".

Encontre um ID da sessão a partir de um pedido HTTP emulado

Pode emular uma sequência de pedidos HTTP do SDK com curl a partir de uma linha de comandos, com o ID do conteúdo e o ID do vídeo de um URL de stream de vídeo a pedido.

Por exemplo, com um ID do conteúdo 12345 e um ID do vídeo sample-video:

1. Escreva o seguinte numa linha de comandos:

   curl --data "" "http://dai.google.com/ondemand/hls/content/12345/vid/sample-vide/streams"

2. (Opcional) Encaminhe para  python -mjson.tool para ver com estilos de formatação.

Exemplo de saída *

{
"duration": 784,
"stream_id": "19b40be0-7942-44ca-97e0-fc7b27f14029",
"stream_manifest": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/master.m3u8",
"stream_type": "on_demand",
"subtitles": [ ... ],
"time_events_url": "https://dai.google.com/ondemand/hls/content/12345/vid/sample-video/CHS/streams/19b40be0-7942-44ca-97e0-fc7b27f14029/time-events.json"
}

^{* Pode usar o URL stream_manifest para testar a reprodução num leitor HLS (HTTP Live Streaming) (por exemplo, o navegador de Internet Safari).}

Encontre um ID da sessão num pedido de stream de SSB

Quando usar o SSB para pedir uma stream de vídeo de Inserção de anúncios dinâmicos (DAI), existem dois pedidos HTTP:

1. O pedido HTTP GET, que deve ser devolvido com um estado 302 a indicar um redirecionamento.
2. O pedido HTTP GET para o URL redirecionado. Este URL contém o "ID da sessão" que deve introduzir no campo "Identificador de sessões".

Também pode encontrar um ID da sessão ao monitorizar pedidos HTTP numa ferramenta de proxy a partir de uma aplicação para dispositivos móveis ou OTT (over-the-top).

Encontre um ID da sessão para um pedido de stream de SSB através do Chrome

1. Carregue o URL de stream de conteúdo num navegador.

   Por exemplo, com um ID do conteúdo 12345 e um ID do vídeo sample-video, carregue:
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. No Chrome, carregue as Ferramentas para programadores.
3. Navegue para o separador Rede das Ferramentas para programadores.
4. Filtre para obter os pedidos que incluem dai.google.com.

5. Os dois primeiros pedidos ao domínio "dai.google.com" devem ser para um ficheiro com o nome "master.m3u8":

   Primeiro pedido: a resposta 302.

   

   Segundo pedido: o URL com o ID da sessão.

   
6. Copie o ID da sessão e introduza-o no campo Identificador de sessões.

Para problemas relacionados com as indisponibilidades ou a resolução de problemas da DAI, contacte o apoio técnico para publicadores.