Localizar um código de sessão da DAI ou chave de depuração

Cada stream de usuário recebe um código de sessão que é salvo por 48 horas após um evento. As sessões monitoradas permanecem salvas por 60 dias. Insira o ID da sessão no campo "Identificador de sessões" do Monitoramento da atividade de streaming (SAM, na sigla em inglês). Nos resultados da pesquisa, é possível ver detalhes sobre solicitações de anúncios de usuários para resolver problemas de stream de vídeo.

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

• Encontrar um código de sessão em um aplicativo que usa o SDK do IMA
• Encontrar um ID de sessão ao inspecionar a programação HTTP
• Encontrar um ID de sessão em uma solicitação HTTP emulada
• Encontrar um ID de sessão em uma solicitação de stream SSB

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

Também é possível usar uma chave de depuração para ver a atividade ou resolver problemas de um stream de vídeo.

Você pode definir ou transmitir uma chave exclusiva para qualquer stream ou sessão para poder depurar o stream com o SAM. Se você usar a mesma chave entre sessões, somente a sessão mais recente será pesquisável e disponível para depuração.

• Streams solicitados com o SDK do IMA: consulte a documentação do SDK para chamadas de API para definir a chave.
• Streams solicitados sem o SDK do IMA (SSB): transmita uma chave de depuração com o 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 ter informações de identificação pessoal.

Encontrar um código de sessão em um aplicativo que usa o SDK do IMA

Ao usar o SDK do IMA para criar um stream de vídeo, é possível chamar um método para extrair o código da sessão. Veja detalhes de como extrair o código no SDK de cada plataforma:

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

Muitos desenvolvedores de aplicativos capturam e registram o ID da sessão para que ele esteja disponível ao resolver problemas com o stream.

Como o ID da sessão é essencial para revisar detalhes sobre a exibição de anúncios no stream de um usuário, é recomendável implementar um método ou recurso oculto no aplicativo para exibir facilmente o ID.

Encontrar um ID de sessão ao inspecionar a programação HTTP

É possível monitorar solicitações HTTP em ferramentas de proxy de aplicativos que usam o SDK do IMA.

Ao usar o SDK do IMA para solicitar um stream de vídeo com Inserção de anúncios dinâmicos (DAI, na sigla em inglês), há duas solicitações HTTP:

• O HTTP POST, que deve retornar com um status 201 indicando a criação de um novo fluxo.
• A solicitação HTTP GET para o URL no campo stream_manifest. *

As informações adicionais são retornadas em uma estrutura JSON, incluindo o stream_id. Esse é o código de sessão que precisa ser inserido no campo "Identificador de sessões".

Encontrar um ID de sessão em uma solicitação HTTP emulada

É possível emular uma sequência de solicitação HTTP do SDK usando curl de um prompt de linha de comando, com os IDs de conteúdo e de vídeo do URL de um stream de vídeo on demand.

Veja o exemplo com o ID de conteúdo 12345 e o ID de vídeo sample-video:

1. Digite o seguinte a partir de um prompt de linha de comando:

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

2. (Opcional) Transmita para python -mjson.tool a fim de ver o conteúdo com as letras estilizadas.

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

^{* Você pode usar o URL stream_manifest para testar a reprodução em um player HLS, por exemplo, no navegador da Web Safari.}

Encontrar um ID de sessão em uma solicitação de stream SSB

Ao usar SSB para solicitar um stream de vídeo com Inserção de anúncios dinâmicos (DAI), há duas solicitações HTTP:

1. Uma solicitação HTTP GET deve retornar com um status 302 indicando um redirecionamento.
2. A outra solicitação HTTP GET é relativa ao URL redirecionado. Esse URL contém o "ID da sessão" que você vai precisar usar no campo "Identificador de sessões".

Também é possível encontrar um ID de sessão ao monitorar solicitações HTTP em uma ferramenta de proxy de um app para dispositivos móveis ou OTT.

Encontrar um código de sessão em uma solicitação de stream SSB usando o Chrome

1. Carregue o URL do stream de conteúdo em um navegador.

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

2. Abra as Ferramentas para desenvolvedores do Chrome.
3. Acesse a guia Rede das Ferramentas para desenvolvedores.
4. Filtre as solicitações que incluem dai.google.com.

5. As duas primeiras solicitações para o domínio "dai.google.com" precisam ser referentes a um arquivo chamado "master.m3u8":

   Primeira solicitação: a resposta 302

   

   Segunda solicitação: o URL com o ID da sessão

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

No caso de problemas relacionados à solução de problemas ou interrupções da DAI, entre em contato com o suporte ao editor.