Создание конфигураций СДК

Создав конфигурацию CDN, вы сможете задавать как настройки загрузки и показа контента в видео по запросу и прямых трансляциях, так и настройки видеорекламы в середине ролика. Создав конфигурации СДК, свяжите их с источником контента.

Разделы этой статьи: Видео по запросу | Прямая трансляция | Видеореклама в середине ролика

Отдельному источнику контента можно назначить несколько конфигураций СДК, но источнику видеорекламы в середине ролика – только одну.

Как создать конфигурацию СДК для контента в видео по запросу

В настоящее время Менеджер рекламы при работе с аутентификацией по токену поддерживает только модель Akamai.

1. Войдите в Google Менеджер рекламы.

2. Нажмите Видео Источники контента Конфигурации СДК Новая конфигурация.

3. Введите информативное название. Оно видно только в Менеджере рекламы.
4. В качестве типа конфигурации выберите вариант Контент в видео по запросу.

5. Добавьте описание сети доставки контента, из которой будет поступать содержание.

   Префикс URL извлечения. Префикс URL сети доставки контента. Определяет, какие настройки сети доставки контента следует использовать для вашего фрагмента контента.

   Аутентификация сети доставки контента

   • Если сеть доставки контента не требует аутентификации, то выберите в раскрывающемся меню вариант Нет. Если аутентификация необходима, то выберите название сети доставки контента и укажите ее учетные данные.
   • Выберите Akamai или Cloud Media^бета.
     • Настройки для СДК Akamai:
       • Аутентификация по токену. Установите переключатель в положение "включено" или "выключено".

       • Шифрование медиаконтента. Выберите "включено" или "выключено".

     • Настройки для сети доставки контента Cloud Media^бета:
       • Название набора ключей в Media CDN в Google Cloud. Название набора ключей сети доставки контента Media в Google Cloud, который используется при проверке запросов контента. Рекомендуем ознакомиться с дополнительной информацией об EdgeCacheKeyset.

       • Срок действия Media CDN в Google Cloud (сек.). Необязательная настройка, определяющая период времени в секундах, в течение которого контент доступен по первичному подписанному запросу. Это поле заполняется только в том случае, если в нужной конфигурации сети доставки контента Media в Google Cloud указано значение signedRequestMaximumExpirationTtl. Подробнее об EdgeCacheService…

   URL шифрования мультимедиа поддерживается только для формата HLS, но не для DASH. Если URL шифрования указан для формата DASH, он игнорируется.

   При работе с форматом HLS такой URL объекта должен быть версией URL главного плейлиста из того же домена, где показываются сегменты видео. Мы проверяем, есть ли параметры aka_me_session_id и id в каждом варианте из главного плейлиста. Первое совпадающее значение из первого URL кешируется и при размещении рекламы в рамках пользовательских сеансов повторно используется во всех сегментах из всех потоков, которые показываются в выбранном местоположении.

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

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

   Префикс URL выполнения. Префикс URL СДК, используемой для хранения контента.

   Настройки безопасности. В режиме "Использование настроек безопасности для получения данных" применяются те же самые настройки, что и при извлечении данных.

   Если вы хотите передавать контент с помощью СДК Akamai, то для аутентификации по токену необходимо включить защиту файлов cookie.

   Аутентификация СДК. Если СДК не требует аутентификации, то выберите в раскрывающемся меню вариант Нет. Если необходима аутентификация, то выберите название сети и укажите учетные данные для нее.

   • Настройки для сети доставки контента Akamai:
     • Аутентификация по токену. Установите переключатель в положение "включено" или "выключено".
     • Ключ аутентификации по токену. Задайте эту настройку, если сеть доставки контента требует ключ аутентификации.

     • Отключить подпись URL на стороне сервера. Выберите этот вариант, если нужно, чтобы подпись генерировалась на стороне клиента.

       Перейдите к шагу 7.
        
   • Настройки для СДК Cloud Media^бета:
     • Название набора ключей в Media CDN в Google Cloud. Название набора ключей в сети доставки контента Media в Google Cloud, который используется при проверке запросов контента.
     • Срок действия Media CDN в Google Cloud (сек.). Необязательная настройка, определяющая период времени в секундах, в течение которого контент доступен по первичному подписанному запросу. Это поле заполняется только в том случае, если в соответствующей конфигурации сети доставки контента Media в Google Cloud указано значение signedRequestExpirationTtl.
     • Префикс пути к источнику главного плейлиста. Это необязательная функция, которая определяет префикс пути к источнику (например, издатель не сможет выбирать тип переадресации (7) к источнику главного плейлиста в сети доставки контента Media в Google Cloud). Для нее всегда задано значение "Путь к источнику".
7. Сервис аутентификации СДК Akamai
   
   Тип переадресации к источнику главного плейлиста. Выберите тип "Путь к источнику" или "Обычная".
   
   Выполните настройку в соответствии с примером ниже.

   Пример

   Ниже представлен пример для пути https://cdn.com/path/to/content.m3u8.

   • Путь к источнику. Содержит параметр строки запроса originpath и определяет путь, по которому Akamai будет передавать запрос основного плейлиста: https://cdn.com/path/to/content.m3u8?originpath=/linear/hls/event/some-event/stream/some-stream/master.m3u8.
   • Обычная. Заменяет путь URL на другой, по которому Akamai будет передавать запрос основного плейлиста: https://cdn.com/linear/hls/event/some-event/stream/some-stream/master.m3u8.
     
     Выбрав "Обычная", вы можете также установить префикс пути: https://cdn.com/pathprefix/linear/hls/event/some-event/stream/some-stream/master.m3u8.

8. Если вы собираетесь показывать контент из нескольких СДК, то нажмите Добавить настройку показа^БЕТА и задайте настройки дополнительных СДК, следуя инструкциям, которые относятся к шагу 6. Подробнее о том, как передавать видео по запросу из нескольких сетей доставки контента…
9. Нажмите Сохранить.

Как создать конфигурацию СДК для контента в прямой трансляции

В настоящее время Менеджер рекламы при работе с аутентификацией по токену поддерживает только модель Akamai.

1. Войдите в Google Менеджер рекламы.

2. Нажмите Видео События прямой трансляции Конфигурации СДК Новая конфигурация.

3. Введите информативное название. Оно видно только в Менеджере рекламы.
4. Убедитесь, что в качестве типа конфигурации выбран вариант Контент в прямой трансляции.

5. Добавьте описание СДК, из которой будет поступать контент.

   Префикс URL извлечения. Префикс URL сети доставки контента. Определяет, какие настройки СДК следует использовать для контента.

   Аутентификация СДК. Если СДК не требует аутентификации, то выберите в раскрывающемся меню вариант Нет. Если необходима аутентификация, то выберите название сети и укажите учетные данные для нее.

Аутентификация по токену. Выберите ее в настройках, если СДК требует ключ аутентификации. При необходимости активируйте переключатель "Защита файлов cookie".

6. Добавьте описание СДК, из которой будет поступать контент.

   Префикс URL выполнения. Префикс URL СДК, используемой для хранения показываемого контента.

   Настройки безопасности. В режиме "Использование настроек безопасности для получения данных" применяются те же самые настройки, что и при извлечении данных.

   Если вы хотите передавать контент с помощью СДК Akamai, то для аутентификации по токену необходимо включить защиту файлов cookie.

7. Аутентификация СДК. Если СДК не требует аутентификации, то выберите в раскрывающемся меню вариант Нет. Если необходима аутентификация, то выберите название сети и укажите учетные данные для нее.

   • Аутентификация по токену. Выберите ее в настройках, если СДК требует ключ аутентификации. Вы также можете отключить подпись URL на стороне сервера и включить защиту файлов cookie.
   • Если вы используете CDN Akamai с аутентификацией по токену, то нажмите Отключить подпись URL на стороне сервера, чтобы заставить клиента сгенерировать подпись.

   • Тип переадресации к источнику. Если указать Akamai в качестве сервиса аутентификации сети доставки контента, то вам понадобится выбрать тип "Путь к источнику" или "Обычная".

     Пример для Akamai

     Ниже представлен пример для пути https://cdn.com/path/to/content.m3u8.

     • Путь к источнику. Содержит параметр строки запроса originpath и определяет путь, по которому Akamai передаст запрос основному плейлисту: https://cdn.com/path/to/content.m3u8?originpath=/linear/hls/event/some-event/stream/some-stream/master.m3u8.

     • Обычная. Заменяет путь URL на другой, в котором Akamai передает запрос основному плейлисту: https://cdn.com/linear/hls/event/some-event/stream/some-stream/master.m3u8.

       Выбрав "Обычная", вы можете также установить префикс пути: https://cdn.com/pathprefix/linear/hls/event/some-event/stream/some-stream/master.m3u8.

8. Нажмите Сохранить.

Как создать конфигурацию СДК для видеорекламы в середине ролика

Если вы собираетесь показывать видеорекламу в середине ролика и хотите использовать Менеджер рекламы для подготовки контента, то вам необходимо обеспечить доступ к СДК через SFTP. Тогда Менеджер рекламы сможет загружать сегменты видео в моменты рекламных пауз. Создайте конфигурацию СДК для видеорекламы в середине ролика, чтобы у Менеджера рекламы был доступ к вашему контенту.

1. Войдите в Google Менеджер рекламы.
2. Нажмите Видео Источники контента Конфигурации СДК Новая конфигурация.
3. Введите информативное название. Оно видно только в Менеджере рекламы.
4. В меню "Тип конфигурации" выберите Видеореклама в середине ролика.

5. Задайте следующие настройки:

   Протокол загрузки. Протокол доступа к подготовленному загруженному контенту.

   Имя пользователя, Закрытый ключ и Пароль. Менеджер рекламы поддерживает только такие учетные данные SFTP, в которых есть закрытый ключ (RSA или DSA). При желании можно указать закрытый ключ, использующий пароль.

   Прежде чем вводить закрытый ключ, протестируйте его, используя независимый клиент SSH или SFTP, например PuTTy или CyberDuck.

   Убедитесь, что у пользователя есть все разрешения (на чтение, запись, изменение и удаление) как для корневого каталога, так и для подкаталогов.

   Менеджер рекламы не поддерживает небезопасный протокол FTP и аутентификацию SFTP с использованием имени пользователя и пароля.

   Инструкции по вводу ключей SSH

   • В зависимости от типа закрытого ключа он должен начинаться со следующего текста:

     -----BEGIN RSA PRIVATE KEY----- или -----BEGIN DSA PRIVATE KEY-----

   • В зависимости от типа закрытого ключа он должен заканчиваться следующим текстом:

     -----END RSA PRIVATE KEY----- или -----END DSA PRIVATE KEY-----

   • В местах переноса строк должны быть символы \n.

   Пример ключа

   -----BEGIN DSA PRIVATE KEY-----\nProc-Type: 4,ENCRYPTED\nDEK-Info: DES-EDE3-CBC,BFF8B97CEFE81031\n\n\nZcYWZ5Sq12m8bFxCGc1f3GYjcJSmrwyLMUzqryPGnbmnURULC19+WVddHzzcJ2D5\ncc/wYKzE5eRO2ZupeGRcaMwG1UYx171ucwfvoE5VfbD6fBAn7bkW+Qik0QdL3/M4\nN2l0LlqiZxBLEQ8bwZvfN9aeOfbpgFufbQw8X9jVk5gNzOucRC2B0Ul9DxfLSvWU\nvgnrlrqijvpLMRDtuGt7X8X1vb/gSIIsdWYl5kny0ULL1sK+ZLUHT6YCLPNxjJsE\nrgPxKRV6Z8TrygbfipZckd0LSEAJltwoIM/1iSeZt9mn4lrz1GF/jO5XeUcFwQWr\nu8emTMvXFbeTXOKmsjhhUsZgNxvMfUd+S2Bus66jb1jTm2jMGbKAtWola98e8C0h\nh4hh8OJU4ZhFyb2/xOqR7P7DKjWIYDTlb1t0EZv4xUE1UFTo4MwCZaOFBJs172ax\nFBWZLYoYF3gBDy2C6/dP5IJfa4G27NHeqU9WYPq5wTct0mqHhzrR2cj6pmRwwjq9\nmME3mDH8X0oMz5I6XHbJ0n5pc49YRXCrq4tP/GXevXh0z/wfzwt3x94oQuH9JwoD\npOT5xNOngA2pKJLuMc+D/g==\n-----END DSA PRIVATE KEY-----\n

   Имя хоста. Хост, на котором находится подготовленный контент.

   Префикс пути. Каталог, в который загружается подготовленный контент. Этот каталог должен разрешать SFTP-доступ к СДК. Убедитесь, что у пользователя есть все разрешения (на чтение, запись, изменение и удаление) для этого каталога и что на сервере достаточно места для принимаемого контента.

   Префикс URL выполнения. Префикс URL СДК, используемой для хранения показываемого контента. Чтобы избежать проблем с использованием протокола https при воспроизведении контента, префикс всегда должен начинаться с https://.

6. Нажмите Сохранить.

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