Аутентификация запросов потокового видео при динамической вставке объявлений

Ключи аутентификации для динамической вставки объявлений используются для доказательства того, что запросы исходят от вас. Это обеспечивает более безопасный показ рекламы. Ключ представляет собой непрерывную строку из 64 символов и цифр. Некоторые устаревшие ключи состоят из 25 символов и цифр.

Пример

0L94DEA6C87B0F3D2407018ACF88ECDE77DK38AD1DX01957311A50E9D1O3F15B

Статические ключи API. Имеют приоритет над ключами HMAC, если используются оба этих метода. При этом они менее надежны, поэтому рекомендуется использовать ключи HMAC.

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

Совет. Перед аутентификацией запросов видеопотока убедитесь, что у вас есть следующее:

• Ключ аутентификации с типом HMAC для динамической вставки объявлений.
• Трансляция, настроенная для динамической вставки объявлений.

Как добавить новый ключ аутентификации HMAC для динамической вставки объявлений

Выполните следующие действия:

1. Войдите в Google Менеджер рекламы.
2. Нажмите Администрирование > Аудио и видео.
3. Выберите "Ключи аутентификации для динамической вставки объявлений".
4. Нажмите Новый ключ аутентификации для динамической вставки объявлений.
5. Укажите название нового ключа. Выберите тип HMAC.
6. Нажмите Сохранить.

Ключ будет связан с трансляцией, когда вы включите аутентификацию.

Как включить аутентификацию API для динамической вставки объявлений

Чтобы связать ключ HMAC с видеопотоком:

1. Войдите в Google Менеджер рекламы.
2. Нажмите Видео > События прямой трансляции.
3. Выберите трансляцию из списка или нажмите Новое событие прямой трансляции. Подробнее о создании трансляции…
4. В разделе "Общие настройки":
   1. Выберите "Включено" для параметра "Ключи аутентификации от ресурсов пакетов", чтобы аутентифицировать запросы пакетов объявлений, и (или)
   2. выберите "Включено" для параметра "Ключи аутентификации для создания трансляции", чтобы аутентифицировать запросы сеансов потокового видео.
5. Выберите сгенерированный ключ HMAC.
6. Нажмите Сохранить.

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

Совет. Для каждой клиентской платформы (например, iOS, Android и сайта) рекомендуем генерировать отдельные ключи.

При сохранении каждому ключу автоматически назначается статус "Активно". Для проверки запросов подходят только корректно реализованные ключи со статусом "Активно".

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

Как деактивировать ключ аутентификации

Выполните следующие действия:

1. Войдите в Google Менеджер рекламы.
2. Нажмите Администрирование > Аудио и видео > "Ключи аутентификации для динамической вставки объявлений".
3. Выберите из списка ключ, который нужно деактивировать.
4. Выберите статус "Неактивно".
5. Нажмите Сохранить.

Аутентификация с помощью ключа

Ключи HMAC

Подробнее о том, как выполнять аутентификацию HMAC…

Ключи API

Чтобы задать атрибут apiKey объекта IMAStreamRequest, следует использовать IMA SDK. Подробные сведения можно найти в документации для разработчиков iOS, Android, Chromecastи tvOS.

При работе с маяками на сервере (SSB) рекомендуем использовать параметр запроса api-key:

curl "https://dai.google.com/ondemand/hls/content/CMS_ID/vid/VIDEO_ID/master.m3u8?api-key=<api-authentication-key>"

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