查找 DAI 会话 ID 或调试密钥

每个用户视频流都会被指定一个会话 ID，它会在相应事件结束后保存 48 小时。受到监控的会话会保存 60 天。您可以将会话 ID 输入到视频流活动监控工具 (SAM) 的“会话标识符”字段中。从获得的搜索结果中，您可以查看用户广告请求的详细信息，以便排查视频流问题。

我们将介绍以下几种查找会话 ID 的方法：

• 在使用 IMA SDK 的应用中查找会话 ID
• 在检查 HTTP 流量时查找会话 ID
• 从模拟的 HTTP 请求中查找会话 ID
• 在 SSB 视频流请求中查找会话 ID

使用调试密钥查看活动或排查视频流问题 ^{（Beta 版）} 

此外，您还可以使用调试密钥查看活动或排查视频流问题。

您可以设置或传递任何视频流或会话的专属密钥，以便能够使用 SAM 调试视频流。如果您在不同的会话中使用相同的密钥，则只有最近的会话可供搜索和调试。

• 使用 IMA SDK 请求的视频流：请参阅有关 API 调用的 SDK 文档来设置相应密钥。
• 未使用 IMA SDK (SSB) 请求的视频流：使用 dai-sam-id 参数传递调试密钥。

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

密钥中不能包含任何个人身份信息。

在使用 IMA SDK 的应用中查找会话 ID

使用 IMA SDK 创建视频流时，您可以调用相应方法来获取会话 ID。请参阅以下关于如何在各个平台的 SDK 上获取该 ID 的详细信息：

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

许多应用开发者都会选择获取会话 ID 并将其记录下来，以用于排查视频流问题。

要想查看与用户视频流中的广告投放活动有关的详情，必然得使用会话 ID，因此您不妨在应用中实现一种方法或一项隐藏功能以轻松显示该 ID，这样做会很有用处。

在检查 HTTP 流量时查找会话 ID

您可以从使用 IMA SDK 的应用中监控代理工具内的 HTTP 请求。

使用 IMA SDK 请求动态广告插播 (DAI) 视频流时，会有以下两个 HTTP 请求：

• 应返回 201 状态（表明已创建新的视频流）的 HTTP POST 请求。
• 向 stream_manifest 字段中的网址发出的 HTTP GET 请求。*

其他信息会以 JSON 结构返回，包括 stream_id。这是您应在“会话标识符”字段中输入的会话 ID。

从模拟的 HTTP 请求中查找会话 ID

您可以从命令行提示符处使用 curl（需要提供视频点播视频流网址中的内容 ID 和视频 ID）来模拟 SDK HTTP 请求序列。

例如，使用 12345（内容 ID）和 sample-video（视频 ID）：

1. 从命令行提示符处输入以下内容：

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

2. （可选）传送至 python -mjson.tool，以便以美观输出排版方式查看。

示例输出 *

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

^{*您或许能够使用 stream_manifest 网址在 HLS 播放器（例如，Safari 网络浏览器）中测试播放。}

在 SSB 视频流请求中查找会话 ID

使用 SSB 请求动态广告插播 (DAI) 视频流时，会有以下两个 HTTP 请求：

1. 应返回 302 状态（表明重定向）的 HTTP GET 请求。
2. 向重定向网址发出的 HTTP GET 请求。这个网址包含您应在“会话标识符”字段中输入的“会话 ID”。

从移动应用或 OTT 应用中监控代理工具内的 HTTP 请求时，您也可以查找会话 ID。

使用 Chrome 查找 SSB 视频流请求的会话 ID

1. 在浏览器中加载内容流网址。

   例如，使用 12345（内容 ID）和 sample-video（视频 ID），加载：
   http://dai.google.com/ondemand/hls/content/12345/vid/sample-video/master.m3u8

2. 在 Chrome 中，打开“开发者工具”。
3. 进入开发者工具的网络标签页。
4. 过滤出包括 dai.google.com 的请求。

5. 前两个向“dai.google.com”网域发出的请求应该是请求名为“master.m3u8”的文件：

   第一个请求：302 响应

   

   第二个请求：包含会话 ID 的网址

   
6. 复制会话 ID，然后输入到会话标识符字段中。

对于与 DAI 问题排查或服务中断相关的任何问题，请与发布商支持团队联系。