Как узнать ключ отладки или идентификатор сеанса потоковой передачи

Каждому потоку, относящемуся к определенному пользователю, назначается идентификатор сеанса, который сохраняется в течение 48 часов после показа видео. Отслеживаемые сеансы сохраняются в течение 60 дней. Указать идентификатор сеанса можно в поле "Идентификатор сеанса", которое используется монитором действий в потоке. Получать сведения о запросах объявлений и устранять неполадки, связанные с видеопотоком, можно с помощью поиска.

Узнать идентификаторы сеанса вы можете описанными ниже способами.

• Как узнать идентификатор сеанса, относящийся к приложению, в котором используется IMA SDK
• Как узнать идентификатор сеанса с помощью проверки HTTP-трафика
• Как узнать идентификатор сеанса с помощью эмулированного HTTP-запроса
• Как узнать идентификатор сеанса с помощью запроса потока при добавлении маяков на сервере (SSB)

Используйте ключ отладки для просмотра действий и устранения неполадок в видеопотоке ^(бета) 

Получить информацию о нужном действии или решить проблемы с видеопотоком можно с помощью ключа отладки.

Для того чтобы у вас была возможность отладки с помощью монитора действий в потоке, вы можете установить или передать уникальный ключ для любой потоковой передачи или сеанса. Если вы используете один и тот же ключ для различных сеансов, отлаживать можно только последний сеанс.

• Запрос потоков с использованием 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

Если видеопоток создан при помощи IMA SDK, вы можете получить идентификатор сеанса, вызвав нужный метод. Ниже описано, как выполнить это при работе с SDK для различных платформ.

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

Многие разработчики приложений получают идентификатор сеанса и записывают его, чтобы в дальнейшем использовать для устранения неполадок с потоком.

Поскольку идентификатор сеанса позволяет получать сведения о показе рекламы в потоке, предназначенном для определенного пользователя, попробуйте создать в приложении специальный метод или скрытую функцию для получения этого идентификатора.

Как узнать идентификатор сеанса с помощью проверки HTTP-трафика

Вы можете отслеживать HTTP-запросы на прокси-сервере при помощи приложения, использующего IMA SDK.

Когда вы с помощью IMA SDK запрашиваете видеопоток для динамической вставки объявлений, отправляются следующие HTTP-запросы:

• HTTP-запрос POST, в ответ на который должен поступить статус 201, уведомляющий о создании потока.
• HTTP-запрос GET для URL в поле stream_manifest*.

Дополнительные сведения возвращаются в формате JSON, включая параметр stream_id. Он и является идентификатором сеанса, который следует указывать в соответствующем поле.

Как узнать идентификатор сеанса с помощью эмулированного HTTP-запроса

Вы можете выполнить эмуляцию HTTP-запроса SDK с помощью инструмента curl из командной строки, указав идентификаторы контента и видео из URL потока видео по запросу.

Ниже представлен пример, в котором идентификатором контента является 12345, а идентификатором видео – sample-video.

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

^{*Для проверки воспроизведения в проигрывателе HLS (например, в браузере Safari) можно использовать URL stream_manifest.}

Как узнать идентификатор сеанса с помощью запроса потока при добавлении маяков на сервере (SSB)

Когда вы запрашиваете видеопоток для динамической вставки объявлений, используя добавление маяков на сервере, отправляются следующие HTTP-запросы:

1. HTTP-запрос GET, в ответ на который должен поступить статус 302, уведомляющий о выполнении переадресации.
2. HTTP-запрос GET для URL с переадресацией. Этот URL содержит идентификатор сеанса, который необходимо указать в поле для такого идентификатора.

Идентификатор сеанса также можно получить при отслеживании HTTP-запросов, отправляемых мобильным или OTT-приложением, с помощью прокси-сервера.

Как узнать идентификатор сеанса для запроса потока при добавлении маяков на сервере с помощью браузера Chrome

1. Укажите URL потока в адресной строке браузера.

   Ниже представлен пример, в котором идентификатором контента является 12345, а идентификатором видео – sample-video. Нужный вам URL будет следующим:
   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.

   

   Второй запрос: URL с идентификатором сеанса.

   
6. Скопируйте идентификатор сеанса и вставьте его в поле Идентификатор сеанса.

Если у вас возникли вопросы, связанные с устранением неполадок при динамической вставке объявлений или со сбоями, обратитесь в службу поддержки издателей.