Инструкция для отгрузки таксономии online

Содержание:

1. Общая информация

Сервис dmp2.cgi предоставляет по каждому пользователю посетившему сайт/ресурс Заказчика идентификатор сегмента/сегментов, к которому пользователь относится по используемой таксономии.

Таксономию сегментов можно скачать на странице DMP в пункте “Использование 3rd party данных Soloway в AdRiver DMP”
Скачать таксономию

В файле вы найдете:

  • идентификаторы сегментов (ID),
  • категории и подкатегории сегментов,
  • наименование сегментов / наименования сегментов типа ВЦД (вероятность целевого действия),
  • описание сегментов.

Для подключения сервиса dmp2.cgi отправьте заявку на  мейл dmp@adriver.ru
В заявке на подключение перечислите домены Заказчика, с которых будут отправляться вызовы к сервису dmp2.cgi.
В ответ специалисты сервиса предоставляют вам уникальный ID сервиса dmp2.cgi.
Этот код с ID сервиса dmp2.cgi необходимо  разместить сайте/ресурсе Заказчика.

2. Описание запроса к сервису dmp2.cgi

Идентификаторы (ID) сегментов предоставляются Заказчику в ответ на запрос к сервису dmp2.cgi
по ссылке вида  ssp.adriver.ru/cgi-bin/dmp2.cgi

Возможны два варианта обращения к сервису:

  • Клиент-Сервер —  инициатором запроса является браузер посетителя (т.е. ссылка вызова к

dmp2.cgi вставляется на страницы сайта).

  • Сервер-Сервер — инициатором запроса является сервер клиента.

В обоих случаях от dmp2.cgi приходит ответ в виде объекта JSON.
В ответе будет перечислены ID найденных аудиторных сегментов пользователя.
В случае если аудиторных сегментов пользователя не было найдено, придет ответ 204 NoContent.

3. Отправка запроса на получение аудиторных сегментов пользователя

3.1. Запрос клиент-сервер

Для обращения к сервису dmp2.cgi Вам необходимо вызвать ссылку вида
http://ssp.adriver.ru/cgi-bin/dmp2.cgi?pub_id=10
где  pub_id – Ваш уникальный ID, а выделенное красным значение  необходимо заменить на идентификатор предоставленный вам специалистом Сервиса.

3.2. Запрос сервер-сервер

Обращение к dmp2.cgi  будет происходить с Вашего сервера. Вам необходимо вызвать ссылку вида:
http://ssp.adriver.ru/cgi-bin/dmp2.cgi?pub_id=10&user_id="КукаПосетителя"

где  pub_id – Ваш уникальный ID предоставленный вам специалистом Сервиса,
user_id – кука посетителя,
Значения, выделенные красным, необходимо заменить на Ваши собственные.

Важно! Чтобы DMP смогла распознать куку пользователя, необходима предварительная синхронизация кук.
Для этого необходимо вызвать следующую ссылку с указанием ID Вашей системы и ID пользователя в Вашей системе.

Пример запроса:

http://ssp.adriver.ru/cgi-bin/sync.cgi?pub_id=10&external_id=ID_Пользователя_В_Вашей_Системе
где pub_id – Ваш уникальный ID,
external_id – Ваш уникальный ID, соответствующий данному пользователю,
значения, выделенные красным, необходимо заменить на Ваши собственные.

Данный запрос необходимо отправлять для всех новых кук.
Для старых кук рекомендуется обновлять вызов раз в 14 дней. В ответ на запрос синхронизации кук придет 204 NoContent.

Для каждого клиента можно сделать дополнительные настройки:

  • Разрешить или запретить запросы от определенных доменов;
  • Разрешить или запретить запросы от определенных сегментов;
  • Разрешить или запретить запросы от определенных ip адресов;
  • Разрешить или запретить запросы от определенной аудитории.

4. Ответ сервиса, содержащий ID аудиторных сегментов пользователя.

В ответ на запрос, отправленный любым из указанных способом, придет вызов функции
my_callback с объектом JSON в качестве параметра, содержащим перечень ID аудиторных
сегментов посетителя.
В случае если соответствующих куке посетителя сегментов найдено не было, в ответ Вы
получите 204 NoContent.

Пример ответа:

dmp2.cgi:my_callback(
{"segments": [576, 3, 539, 42, 460, 13, 270, 335, 387, 409, 26, 15, 253, 94]}
);

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

<script type="text/javascript">
var adriver_segments;
var my_callback = function (a){adriver_segments = a.segments.join();};
</script>
<script type="text/javascript" src="//ssp.adriver.ru/cgi-bin/dmp2.cgi?pub_id=202910"></script>

Данный обработчик записывает значения из segments в переменную adriver_segments на
странице сайта в одну строку, через запятую. Если ответа не пришло, то переменная
adriver_segments остается пустой.