Данный документ описывает схему интеграции AdLabs Media Network (далее - AMN) и партнёра - покупателя трафика (далее - Партнёр).

0. Базовые настройки

1. Cookie Matching

2. Запрос данных для показа пользователю

3. Ответ партнёра с деталями объявлений, доступных к показу

3.1. id объявлений передаются отдельно от деталей по каждому объявлению

3.2. Детали по каждому объявлению передаются вместе с id объявления

Контакты

0. Базовые настройки

Перед началом работы необходимо согласовать следующие параметры:

- длительность кеширования данных о заметченном пользователе

- для схемы 3.1. -- длительность кеширования данных об объявлении

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

        %%домен рекламодателя%%        %%уникальный id рекламодателя%%

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

        http://partner-site.ru/stats/?user_id={ID пользователя}&ad_id={adId},{adId},{adId},{adId}

        все доступные для передачи данные:

        - adId -- id показанного объявления. Должна быть возможность передать информацию о нескольких отображённых объявлениях на одной странице

- ID пользователя -- id пользователя в системе партнёра, полученный при куки-метчинге

- ID сайта -- id сайта в системе AMN, на котором осуществляется показ

- IP пользователя -- ip-адрес пользователя

- страна пользователя -- страна пользователя по данным AMN

- город пользователя -- город пользователя по данным AMN на английском языке

1. Cookie Matching

Всем пользователям, которым Партнёр планирует показывать рекламу, Партнёр показывает пиксель AMN с указанием своего внутреннего user_id данного пользователя.

Вид пикселя:

http://stat.adlabs.ru/get_gpsid/?adl_partner_id={ID партнера}&p_uid={ID пользователя}&extra1=x&extra2=x2 

где:

ID партнера -- уникальный id партнёра, выдаваемый системой AMN

ID пользователя -- уникальный id пользователя в БД партнёра

AMN хранит ID пользователя партнёра на своей стороне, выделение ресурсов на хранение соответствия id пользователей в разных системах от партнёра не требуется.

В запрос cookie matching можно передать дополнительные параметры, которые будут возвращены партнеру. Например:

http://stat.adlabs.ru/get_gpsid/?adl_partner_id={ID партнера}&p_uid={ID пользователя}&extra1=x&extra2=x2 

В данном случае параметры extra1=x и extra2=x2 будут возвращены на URL партнера.

Партнер предоставляет URL, на который будет осуществляться редирект, например:

http://dsp.ru/matching/?system_id=8

С cookie matching URL будет произведен редирект на URL партнера с параметрами:

http://dsp.ru/matching/?system_id=8&adl_psid={ID_пользователя}

Если партнер передавал в cookie matching URL дополнительные параметры, они будут возвращены на URL партнера, например:

http://dsp.ru/matching/?system_id=8&adl_psid={ID_пользователя}&extra1=x&extra2=x2

2. Запрос данных для показа пользователю

Когда пользователь появляется на площадке AMN, партнёру отправляется запрос на показ данных пользователю.

Вид запроса:

http://partner-site.ru/ad_request_url/?user_id={ID пользователя}&site_id={ID сайта}&ip={IP пользователя}&country_id={страна пользователя}&city_id={город пользователя}

где:

ID пользователя -- id пользователя в системе партнёра, полученный при куки-метчинге

ID сайта -- id сайта в системе AMN, на котором осуществляется показ

IP пользователя -- ip-адрес пользователя

страна пользователя -- страна пользователя по данным AMN

город пользователя -- город пользователя по данным AMN на английском языке

В ответ партнёр может отдавать два типа данных:

- id всех объявлений, доступных к показу пользователю, при этом подробности по каждому объявлению передаются системе AMN и кешируются отдельно

- все объявления, доступные к показу пользователю вместе с данными по каждому объявлению

3. Ответ партнёра с деталями объявлений, доступных к показу

3.1. Детали по каждому объявлению передаются вместе с id объявления

В ответ на запрос из п.2 партнёр передаёт полные данные по всем доступным к показу объявлениям в json, пример ответа:

[

{

"adId":"39202601",

"advertiserId":"8134402",

"image":"http:\/\/site.ru\/images\/image1.jpg"

"wImage":"200",

"hImage":"200",

"url":"http:\/\/site.ru\/click\/?id=2432432",

"title":"Название товара",

"price":"475 руб.",

"domain":"advertiser.ru",

"cpc":"2.78”

}

]

где:

adId -- уникальный id объявления

advertiserId -- уникальный id рекламодателя

image -- url картинки для вставки в тизер

wImage -- ширина картинки

hImage -- высота картинки

url -- url для перехода при клике на объявление

title -- название товара

price -- цена товара; строки “название товара” и “цена товара” в сумме должны быть менее 75 символов в длину

domain -- конечный домен рекламодателя, куда попадёт пользователь при клике

cpc -- стоимость клика по данному объявлению