Подключение источника спроса

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

Эта страница — последовательность. В разделе Управление источниками спроса описаны все поля и подробности того, что делает каждая настройка; здесь сказано, что делать в каком порядке и что проверить потом.

Шаг 1 — работа администратора платформы. Шаги 2 и 3 принадлежат владельцу, администратору или менеджеру организации. Шаг 4 — разговор с партнёром.

Четыре шага

Шаг	Кто	Результат
1. Зарегистрировать партнёра	Администратор платформы	Одна строка в реестре, общем для всей инсталляции
2. Включить его для организации	Владелец, администратор или менеджер	Эта организация будет продавать ему, используя собственные параметры подключения
3. Допустить его в прайс-листе	Владелец, администратор или менеджер	Его опрашивают, когда у рекламной поверхности, которую покрывает этот прайс-лист, есть слот для заполнения
4. Дать ему всё необходимое для обращения к платформе	Тот, кто общается с партнёром	Он может читать ваш каталог и присылать креативы

Шаг

Кто

Результат

1. Зарегистрировать партнёра

Администратор платформы

Одна строка в реестре, общем для всей инсталляции

2. Включить его для организации

Владелец, администратор или менеджер

Эта организация будет продавать ему, используя собственные параметры подключения

3. Допустить его в прайс-листе

Владелец, администратор или менеджер

Его опрашивают, когда у рекламной поверхности, которую покрывает этот прайс-лист, есть слот для заполнения

4. Дать ему всё необходимое для обращения к платформе

Тот, кто общается с партнёром

Он может читать ваш каталог и присылать креативы

Каждый шаг необходим, и ни один не достаточен. Зарегистрированный партнёр, которого никто не включил, ничего не покупает. Включённого партнёра, которого не допускает ни один прайс-лист, не опрашивают, когда появляется слот. У партнёра без вашего токена нечем проходить аутентификацию, поэтому он не может добиться одобрения креатива, а ставка чего-то стоит только тогда, когда за ней стоит одобренный креатив.

1. Зарегистрируйте партнёра

Регистрация партнёра — работа администратора платформы. Она добавляет одну строку в реестр, общий для всей инсталляции. Вид покупателя, закреплённый в этой строке при регистрации, определяет, делает ли партнёр ставки вообще, может ли существовать вторая строка такого вида и на каком протоколе платформа с ним общается, поэтому до регистрации стоит согласовать с партнёром, каким он должен быть.

В разделе Интеграции объяснено, что это определяет, а в разделе Управление источниками спроса перечислены все поля с ограничениями.

2. Включите его для организации

В клиентском кабинете, в разделе Настройки → Интеграции с агентствами (/settings/agencies). Каждая активная строка реестра появляется там отдельным блоком.

Включите параметр Включён, укажите URL партнёра и токен, который партнёр выдал вам. Это тот токен, который платформа предъявляет, когда обращается к партнёру. Токен, который партнёр предъявляет, когда обращается к вам, — это токен доступа вашей организации, о нём в шаге 4. Оставьте URL automated guaranteed пустым, если партнёр не будет бронировать кампании automated guaranteed (AG-кампании), и заполните дополнительные поля, которые показывает блок: они определяются типом системы, а не вашим выбором.

3. Допустите его в прайс-листе

Партнёру, который включён, но не назван ни в одном прайс-листе, слот не предлагается.

Откройте /prices, откройте прайс-лист, покрывающий рекламные поверхности, которые должен покупать этот партнёр, и либо назовите его в группе приоритета, либо убедитесь, что группа, заданная как список исключений, его не исключает. В разделе Минимально жизнеспособные цены это делается с нуля; в разделе Прайс-листы описаны оба варианта.

4. Дайте ему всё необходимое для обращения к платформе

Прежде чем партнёр сможет читать ваш инвентарь или присылать креативы, ему нужны от вас четыре сведения:

его Id провайдера, как он зарегистрирован в шаге 1;
идентификатор вашей организации, он показан в разделе Настройки → Интеграции с агентствами;
токен доступа вашей организации, он показан на том же экране — см. Токены доступа;
версия протокола, под которую нужно строить интеграцию, если партнёр работает по протоколу самой платформы.

Партнёрам на собственных протоколах — для каждого платформа реализует адаптер — нужны только первые три; в разделе Поддерживаемые партнёры сказано, кто к какой группе относится.

Прежде чем передавать токен доступа, убедитесь, кто просит и что просьба исходит от партнёра, которого вы зарегистрировали.

Проверка, что всё работает

В том же порядке, в каком партнёр будет этим пользоваться.

Партнёр может читать ваш каталог. Он читает ваш каталог под своим Id провайдера и получает в ответ ваши активные рекламные поверхности. Ошибка аутентификации здесь указывает на токен, идентификатор организации или включение в шаге 2; ошибка прав доступа указывает на тип системы, выбранный в шаге 1, или на отключённую организацию.
Приходит креатив. Партнёр присылает его, и он появляется в разделе Запросы (/requests) для проверки вашими модераторами. Ничто из того, на что партнёр делает ставки, не может выйти в эфир, пока его креатив не одобрен и не доставлен в CMS, — см. Одобрение креативов.
До него доходят запросы ставки (bid request). Как только у рекламной поверхности, которую покрывает прайс-лист, появляется слот для заполнения, партнёра опрашивают. На ответ у него чуть больше полутора секунд, а ответ, пришедший позже, не используется. См. Лимит времени: с него стоит начать, если партнёр настаивает, что делает ставки, а ваши отчёты говорят другое.
Выигрыш записывается. Выигравшая ставка создаёт строку для ответа на этот рекламный запрос, а подтверждённый показ превращает её в выручку. См. Отчётность.

Если партнёр не делает ставки, раздел Управление источниками спроса завершается чек-листом, который нужно пройти по порядку: так быстрее всего отсекается больше причин.

Полезно знать

Партнёров опрашивают одновременно: Всех партнёров, которых допускает прайс-лист, опрашивают в один и тот же момент. В режиме waterfall прайс-листа побеждает первый подходящий ответ. См. Режим waterfall.
Партнёры и CMS настраиваются отдельно: Регистрация покупателя ничего не говорит о том, что управляет экранами, а подключение CMS ничего не говорит о том, кто может покупать. См. Интеграции.

Как это отменить

У каждого из первых трёх шагов есть свой выключатель, и действуют они не одинаково далеко: администратор платформы может остановить партнёра на всей инсталляции, отключение параметра Включён останавливает его только для вашей организации, а исключение из прайс-листа останавливает его только для рекламных поверхностей, которые покрывает этот прайс-лист, и его входящий доступ при этом продолжает работать.

Какой из них выбрать и что замечает партнёр в каждом случае, сведено в таблицу в разделе Управление источниками спроса.