Вы находитесь на странице: 1из 9

Версия4.1.Датаизменений:17.09.2014.

Техническаяспецификациянаподключениек

AdSniperDSP

Оглавление

1Введение

2ЗапросыкDSP

2.1ПримерзапросакDSP

2.2ОтветыDSP

3Матчингюзеров

3.1.ОдностороннийматчингпоинициативеDSP

3.2.ОдностороннийматчингпоинициативеSSP

3.3.Двухстороннийматчинг

1 Введение

ДокументописываетподключениеSSP(SellSidePlatform)кAdSniperDSP(Demand Side Platform). Интерфейс DSP разработан в соответствии со спецификацией

протоколаOpenRTBv.2.0.

2 Запросы к DSP

ЗапроскDSPпредставляетсобойнаборинформации:

● орекламнойплощадке,

● опосетителеэтойрекламнойплощадки,

● обустройстве,скоторогопосетительзашел,

● оспискерекламныхместподрекламу.

ЗапроскDSPдолженбытьпредставленвjson­форматеисодержать

HTTP­заголовокContent­Type:application/json.

HTTP­заголовок Content­Type:application/json . 1

2.1 Пример запроса к DSP

{

"site":

{

"id":"1178",

"domain":"example.com",

"cat":["IAB19­18"],

"pagecat":["IAB19­18"],

"page":"http://example.com/example.html",

"ref":"http://example2.com/"

},

"user":

{

 

"id":"b4a31fd031833f6a0039ae9ec327bb97",

"buyeruid":"eef0235d35eef023a1eef02325c45d35",

"geo":

{

"country":"UKR",

"city":"Kiev"

}

},

"device":

{

"ua":"Opera/9.80(WindowsNT6.1;Win64;x64)Presto/2.12.388

Version/12.14",

"ip":"85.159.0.67",

"devicetype":2,

"language":"ru", "make":"", "model":"", "os":"WindowsNT",

"osv":"6.1",

"ext":

{

"screen":

{

"width":1600,

"height":900,

"colorDepth":32,

"pixelDepth":32

},

"navigator":

{

"language":"ru",

"colorDepth":32, "pixelDepth":32 }, "navigator": { "language":"ru", 2

"browserLanguage":"ru", "systemLanguage":"", "userLanguage":"ru",

"platform":"Win64",

"vendor":"",

"timeZone":2,

"date":"2013­03­15T14:22:23.898Z",

"width":1567,

"height":616,

"plugins":["JavaDeploymentToolkit

7.0.50.6","Java(TM)PlatformSE7U5","Shockwave

Flash","JavaDeploymentToolkit7.0.170.2","Java(TM)

PlatformSE7U17","SilverlightPlug­In","Google

Update","AdobeAcrobat"],

"flashVersion":"11.6.602"

}

}

},

"cur":["RUB","USD"],

"ext":{"ssp_id":"smaclick"},

"id":"DSP­SC­1­b4a31fd031833f6a0039ae9ec327bb97­136335734371499179.21589

221805",

"imp":

[

{

"id":"IMP­SC­1­2442­136335734371370956.76348544657",

"banner":

{

"btype":[], "battr":[], "mimes":["text/html","text/javascript"],

"topframe":0,

"w":240,

"h":400

},

"instl":0,

"bidfloor":0,

"bidfloorcur":"RUB",

"ext":

{

"teasersCount":4,

"w":70,

"h":70,

"ad_settings":

{

"show_animation":1,

{ "teasersCount":4, "w":70, "h":70, "ad_settings": { "show_animation":1, 3

}

"show_brutal":1,

"show_sex":1

},

"formatid":102400400

}

}

],

"at":2,

"allimps":0

Полный список категорий площадок (поле cat объекта site), а так же список

обязательныхполейсмотритевRTBProjectOpenRTBAPISpecificationVersion2.0.

ВдополнениекспискуобязательныхполейдляAdSniperDSPтакжеобязательными

являютсяследующие:

site.domain

device.ip

● device.ua(обязателенвзависимостиоттекущихнастроектаргетинга). Поле imp.ext.formatid отвечает за формат объявления. Список допустимых форматовследующий:

102400400 ­ ДСП на свое усмотрение вернет либо 4 тизера, либо баннер

размером240х400

1102400400­ДСПвернетбаннерразмером240х400

● если значение поля formatid совпадает со значением поля teasersCount (imp.ext.teasersCount),тоДСПвернеттолькотизеры.Причемколичество тизеров­этозначениеполяteasersCount. Для запроса баннерабезполя formatidдостаточноуказатьразмерыбаннераи "types":["2"].Где types:[],­типрекламы(1­тизерная(вернутсяилитизеры,или

баннер),2­баннерная,3­кликандер).

2.2 Ответы DSP

ПримервалидногоответаDSPпризапросебаннера:

{

"cur":"RUB",

"id":"DSP­SC­1­b4a31fd031833f6a0039ae9ec327bb97­136368036197012766.25816

244632",

"seatbid":

"id":"DSP­SC­1­b4a31fd031833f6a0039ae9ec327bb97­136368036197012766.25816 244632", "seatbid": 4

[

{

"bid":[

{

"adm":"<imgwidth='0'height='0'border='0'

src='http://example­dsp.com/click'><tablecellpadding=\"0\"

cellspacing=\"0\"border=\"0\"align=\"center\"

width=\"240px\"height=\"400px\"><tr><td>\n<object

classid=\"clsid:d27cdb6e­ae6d­11cf­96b8­444553540000\"

width=\"240\"height=\"400\"id=\"240x400\"

align=\"middle\"><paramname=FlashVars value=\"href=http://example­dsp.com/click\"/><param name=\"movie\"

value=\"http://example­dsp.com/240x400/Banner.swf\"/><param

name=\"quality\"value=\"high\"/><paramname=\"bgcolor\" value=\"#ffffff\"/><paramname=\"play\"value=\"true\" /><paramname=\"loop\"value=\"true\"/><param name=\"wmode\"value=\"window\"/><paramname=\"scale\" value=\"showall\"/><paramname=\"menu\"value=\"true\" /><paramname=\"devicefont\"value=\"false\"/><param name=\"salign\"value=\"\"/><param name=\"allowScriptAccess\"value=\"sameDomain\"/>\n<!­­[if !IE]>­­>\n<objecttype=\"application/x­shockwave­flash\"

data=\"http://example­dsp.com/240x400/Banner.swf\"

width=\"240\"height=\"400\"><paramname=FlashVars

value=\"href=http://example­dsp.com/click\"/><param name=\"movie\"

value=\"http://example­dsp.com/240x400/Banner.swf\"/><param

name=\"quality\"value=\"high\"/><paramname=\"bgcolor\" value=\"#ffffff\"/><paramname=\"play\"value=\"true\" /><paramname=\"loop\"value=\"true\"/><param name=\"wmode\"value=\"window\"/><paramname=\"scale\" value=\"showall\"/><paramname=\"menu\"value=\"true\" /><paramname=\"devicefont\"value=\"false\"/><param name=\"salign\"value=\"\"/><param name=\"allowScriptAccess\"value=\"sameDomain\" />\n<!­­<![endif]­­>\n<a href=\"http://www.adobe.com/go/getflash\"><img src=\"http://www.adobe.com/images/shared/download_buttons/ge t_flash_player.gif\"alt=\"GetAdobeFlashplayer\" /></a>\n<!­­[if !IE]>­­>\n</object>\n<!­­<![endif]­­>\n</object></td></tr></ table>",

"id":"1727",

"impid":"IMP­SC­1­2455­136368036197037025.277968496084",

"nurl":"",

"impid":"IMP­SC­1­2455­136368036197037025.277968496084", "nurl":"", 5

"price":0.3625152666106872

}

}

]

}]

ПримервалидногоответаDSPпризапросетизера:

{

 

"cur":"RUB",

"id":

"DSP­SC­1­b4a31fd031833f6a0039ae9ec327bb97­136335734371499179.2158922180

5",

"seatbid":[

{

"bid":[

{

"ext":

{

 

"ad_html":"<imgwidth='0'height='0'border='0'

src='http://example­dsp.com/track'>",

"teasers":[

 

{

 

"ad_html":"",

"lb_click_url":

"http://example­dsp.com/click1",

"lb_img_url":

"http://example­dsp.com/img/1.jpg",

"lb_title":"ЕшьКИВИиХудейна7кгзанеделю!

Надотолько

"

 

}]

},

"id":"0",

 

"impid":"IMP­SC­1­2442­136335734371370956.76348544657",

"nurl":"",

 

"price":0.0010

}]

}]

}

Вполеpriceуказываетсястоимостьбида,тоестьценаза1000показов.

В поле nurlуказывается URL, который необходимо вызвать для оповещения о победеданногобида.Например,

"nurl":

вызвать для оповещения о победеданногобида.Например, "nurl": 6

"http://dsp­nurl.adsniper.ru/?ssp_bid=${AUCTION_BID_ID}&price=${AUCTION_PRICE}

&ssp_imp=${AUCTION_IMP_ID}&bid=DSP­SC­1­0c89db94f6e024c9a51b9bf7298b0a5e­13584

9943476097686.50149926543&dsp_price=4.3811612612741078&imp=IMP­SC­1­2431­13584

9943476040360.74106115848&ssp=smaclick"

где:

Параметр

Значение

 

Описание

 

ssp_bid

${AUCTION_BID_ID}

идентификатор бида, данное значение подставляетсяпривызовеnurlмакросом насторонеSSP.

price

${AUCTION_PRICE}

поле

со значением

win

price

­

окончательнойценойвыигравшегобида,

тоестьитоговаясуммадлясписанияза

данный

бид

(1000

показов).

Подставляетсяпривызовеnurlмакросом

насторонеSSP.

 

ssp_imp

${AUCTION_IMP_ID}

ID рекламного места, данное значение подставляетсяпривызовеnurlмакросом насторонеSSP.

bid

DSP­SC­1­0c89db94f6

bid ID, значение подставляется на сторонеDSP.

e024c9a51b9bf7298b0

a5e­135849943476097

686.50149926543

 

dsp_price

4.3811612612741078

цена

за

бид, предложенная DSP.

Значение подставляется на стороне DSP.

imp

IMP­SC­1­2431­13584

ID

рекламного показа,

значение

9943476040360.74106

подставляетсянасторонеDSP.

 

115848

ssp

smaclick

идентификатор

SSP,

значение

подставляетсянасторонеDSP.

 

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

ssp_bidдолженбытьравенbid,

ssp_impдолженбытьравенimp.

● ssp_bid долженбытьравен bid , ● ssp_imp долженбытьравен imp . 7

3 Матчинг юзеров

СуществуеттривариантасинхронизацииюзеровмеждуDSPиSSP:

1. одностороннийпоинициативеDSP,

2. одностороннийпоинициативеSSP,

3. двухсторонний.

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

3.1. Односторонний матчинг по инициативе DSP

ВслучаеодностороннегоматчингапоинициативеDSP,DSPразмещаеткодвызова URL на странице, которую открывает посетитель, куку которого необходимо синхронизировать:

http://this_ssp.ru/dspuid?dsp=${DSP_ID},

гдеDSP_ID­идентификаторDSP,которыйонаполучаетприрегистрациивSSP.

SSPотвечаетнаданныйвызовредиректомна

http://yourdsp.com?ID=${SSP_UID},

подставляясвойIDюзеравместо${SSP_UID}.

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

SSPпараметромвURL.ДалееDSPсохраняетусебясоответствие.

3.2. Односторонний матчинг по инициативе SSP

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

http://yourdsp.com?ID=${SSP_UID},

приэтомподставляясвойIDпользователявместо${SSP_UID}. DSP получает свой ID юзера при вызове данного URL и ID пользователя SSP параметромвURL.ДалееDSPсохраняетусебясоответствие.

SSP параметромвURL.ДалееDSPсохраняетусебясоответствие. 8

3.3. Двухсторонний матчинг

В случаедвухстороннегоматчингавначалеDSPвстраиваеткодвызоваURLна

странице,

синхронизировать:

которую открывает посетитель, куку которого необходимо

http://this_ssp.ru/dspuid?dsp=${DSP_ID},

SSPсосвоейстороныотвечаетнаданныйвызовредиректомна

http://yourdsp.com?ID=${SSP_UID},

подставляясвойIDюзеравместо ${SSP_UID},атакжевстраиваякодвызоваURL DSP. ПривызоведанногоURLDSPполучаетсвойIDюзера(куку)иIDпользователяSSP параметром в URL, после чегоDSPсохраняетусебясоответствие.ДалееDSP делаетредиректнаSSPприэтомподставляявURLсвойIDюзера(дляустановки аналогичногосоответствиянасторонеSSP).

аналогичногосоответствиянасторонеSSP). 9