Помощь
Перевод
Перейти к:
навигация
,
поиск
Параметры
Группа
Недавние переводы
Недавние дополнения
Sandbox messages
API
Kadam Smart Ads
MediaWiki:Sidebar
RTB
Автобиддер
Видео реклама
Динамический ретаргетинг
Динамический ретаргетинг по коду
Для рекламодателя
Добавление ClickUnder
Добавление Push-уведомлений
Добавление баннера
Добавление тизера
Загрузка HTML5 баннеров
Загрузка тизеров через RSS
Как настроить ретаргетинг при помощи кода
Как настроить ретаргетинг при помощи матчинга
Как тестировать оффер
Кликабельность материала
Конвертация видео
Модерация рекламных объявлений
Настройка postback для СРА
Настройка макросов
Настройки аудитории
Общая статистика
Передача макроса категории
Передача макроса региона
Пополнение баланса
Правила создания CTR-стого рекламного материала
Прием конверсий от партнерских сетей
Проверка подозрительных конверсий
Работа с ретаргетинговыми кампаниями
Работа со статистикой по кампаниям
Рабочая среда пользователя
Реклама товаров для взрослых
Систематизация рекламных кампаний
Создание xml-фида для динамического ретаргетинга
Создание СРМ кампании
Создание СРС кампании
Создание кампании для динамического ретаргетинга
Создание рекламной кампании
Список материалов кампаний
Список рекламных кампаний
Справочник сервиса Kadam.net
Статистика по кампаниям
Статистика по кликам
Статистика по конверсиям
Статистика по лидам
Статистика по площадкам кампании
Тестовая конверсия
Увеличение CTR
Увеличение количества трафика
Управление объявлениями
Условия сотрудничества
Форматы рекламы
ЧаВО
Что такое ретаргетинг
Шок-объявления
Я создал кампанию. Почему нет показов?
Язык
aa - афар
ab - абхазский
ace - ачехский
aeb - Tunisian Arabic
af - африкаанс
ak - акан
aln - Gheg Albanian
am - амхарский
an - арагонский
ang - староанглийский
anp - ангика
ar - арабский
arc - арамейский
arn - арауканский
arq - Algerian Arabic
ary - Moroccan Arabic
arz - Egyptian Arabic
as - ассамский
ast - астурийский
av - аварский
avk - Kotava
awa - авадхи
ay - аймара
az - азербайджанский
azb - تورکجه
ba - башкирский
bar - Bavarian
bbc - Batak Toba
bbc-latn - Batak Toba
bcc - Southern Balochi
bcl - Bikol Central
be - белорусский
be-tarask - Belarusian (Taraškievica orthography)
bg - болгарский
bgn - западно-белуджский
bho - бходжпури
bi - бислама
bjn - Banjar
bm - бамбарийский
bn - бенгальский
bo - тибетский
bpy - Bishnupriya
bqi - Bakhtiari
br - бретонский
brh - Brahui
bs - боснийский
bto - Iriga Bicolano
bug - бугийский
bxr - буряад
ca - каталанский
cbk-zam - Chavacano de Zamboanga
cdo - Min Dong Chinese
ce - чеченский
ceb - кебуано
ch - чаморро
cho - чоктав
chr - чероки
chy - чейенн
ckb - сорани курдский
co - корсиканский
cps - Capiznon
cr - криийский
crh - крымско-татарский
crh-cyrl - Crimean Turkish (Cyrillic script)
crh-latn - Crimean Turkish (Latin script)
cs - чешский
csb - кашубианский
cu - церковнославянский
cv - чувашский
cy - валлийский
da - датский
de - немецкий
de-at - австрийский немецкий
de-ch - швейцарский верхненемецкий
de-formal - German (formal address)
diq - Zazaki
dsb - нижнелужицкий
dtp - Central Dusun
dv - мальдивский
dz - дзонг-кэ
ee - эве
egl - Emilian
el - греческий
eml - Emiliano-Romagnolo
en - английский
en-ca - канадский английский
en-gb - британский английский
eo - эсперанто
es - испанский
et - эстонский
eu - баскский
ext - Extremaduran
fa - персидский
ff - фулах
fi - финский
fit - Tornedalen Finnish
fj - фиджи
fo - фарерский
fr - французский
frc - Cajun French
frp - Arpitan
frr - фризский северный
fur - фриульский
fy - западно-фризский
ga - ирландский
gag - гагаузский
gan - Gan Chinese
gan-hans - Simplified Gan script
gan-hant - Traditional Gan script
gd - гэльский
gl - галисийский
glk - Gilaki
gn - гуарани
gom-latn - Goan Konkani (Latin script)
got - готский
grc - древнегреческий
gsw - швейцарский немецкий
gu - гуджарати
gv - мэнский
ha - хауса
hak - Hakka Chinese
haw - гавайский
he - иврит
hi - хинди
hif - Fiji Hindi
hif-latn - Fiji Hindi (Latin script)
hil - хилигайнон
ho - хиримоту
hr - хорватский
hrx - Hunsrik
hsb - верхнелужицкий
ht - гаитянский
hu - венгерский
hy - армянский
hz - гереро
ia - интерлингва
id - индонезийский
ie - интерлингве
ig - игбо
ii - сычуань
ik - инупиак
ike-cans - Eastern Canadian (Aboriginal syllabics)
ike-latn - Eastern Canadian (Latin script)
ilo - илоко
inh - ингушский
io - идо
is - исландский
it - итальянский
iu - инуктитут
ja - японский
jam - Jamaican Creole English
jbo - ложбан
jut - Jutish
jv - яванский
ka - грузинский
kaa - каракалпакский
kab - кабильский
kbd - кабардинский
kbd-cyrl - Адыгэбзэ
kg - конго
khw - Khowar
ki - кикуйю
kiu - Kirmanjki
kj - кунама
kk - казахский
kk-arab - Kazakh (Arabic script)
kk-cn - Kazakh (China)
kk-cyrl - Kazakh (Cyrillic script)
kk-kz - Kazakh (Kazakhstan)
kk-latn - Kazakh (Latin script)
kk-tr - Kazakh (Turkey)
kl - гренландский
km - кхмерский
kn - каннада
ko - корейский
ko-kp - 한국어 (조선)
koi - коми-пермяцкий
kr - канури
krc - карачаево-балкарский
kri - Krio
krj - Kinaray-a
ks - кашмири
ks-arab - Kashmiri (Arabic script)
ks-deva - Kashmiri (Devanagari script)
ksh - кёльш
ku - курдский
ku-arab - كوردي (عەرەبی)
ku-latn - Kurdish (Latin script)
kv - коми
kw - корнийский
ky - киргизский
la - латинский
lad - ладино
lb - люксембургский
lbe - лакку
lez - лезгинский
lfn - Lingua Franca Nova
lg - ганда
li - лимбургский
lij - Ligurian
liv - Livonian
lmo - Lombard
ln - лингала
lo - лаосский
loz - лози
lrc - северно-лурийский
lt - литовский
ltg - Latgalian
lus - лушай
lv - латышский
lzh - Literary Chinese
lzz - Laz
mai - майтхили
map-bms - Basa Banyumasan
mdf - мокшанский
mg - малагасийский
mh - маршалльский
mhr - Eastern Mari
mi - маори
min - минангкабау
mk - македонский
ml - малаялам
mn - монгольский
mo - молдовеняскэ
mr - маратхи
mrj - Western Mari
ms - малайский
mt - мальтийский
mus - крик
mwl - мирандийский
my - бирманский
myv - эрзя
mzn - мазендеранский
na - науру
nah - Nāhuatl
nan - Min Nan Chinese
nap - неаполитанский
nb - норвежский букмол
nds - нижнегерманский
nds-nl - нижнесаксонский
ne - непальский
new - неварский
ng - ндонга
niu - ниуэ
nl - нидерландский
nl-informal - Nederlands (informeel)
nn - норвежский нюнорск
nov - Novial
nrm - Nouormand
nso - сото северный
nv - навахо
ny - ньянджа
oc - окситанский
om - оромо
or - ория
os - осетинский
pa - панджаби
pag - пангасинан
pam - пампанга
pap - папьяменто
pcd - Picard
pdc - Pennsylvania German
pdt - Plautdietsch
pfl - Palatine German
pi - пали
pih - Norfuk / Pitkern
pl - польский
pms - Piedmontese
pnb - Western Punjabi
pnt - Pontic
prg - Prussian
ps - пушту
pt - португальский
pt-br - бразильский португальский
qqq - Документация сообщения
qu - кечуа
qug - Chimborazo Highland Quichua
rgn - Romagnol
rif - Riffian
rm - романшский
rmy - Romani
rn - рунди
ro - румынский
roa-tara - tarandíne
ru - русский
rue - Rusyn
rup - арумынский
ruq - Megleno-Romanian
ruq-cyrl - Megleno-Romanian (Cyrillic script)
ruq-latn - Megleno-Romanian (Latin script)
rw - киньяруанда
sa - санскрит
sah - якутский
sat - сантали
sc - сардинский
scn - сицилийский
sco - шотландский
sd - синдхи
sdc - Sassarese Sardinian
se - северносаамский
sei - Seri
ses - койраборо сенни
sg - санго
sgs - Samogitian
sh - сербскохорватский
shi - ташельхит
shi-latn - Tašlḥiyt
shi-tfng - ⵜⴰⵛⵍⵃⵉⵜ
si - сингальский
sk - словацкий
sl - словенский
sli - Lower Silesian
sm - самоанский
sma - южно-саамский
sn - шона
so - сомали
sq - албанский
sr - сербский
sr-ec - Serbian (Cyrillic script)
sr-el - Serbian (Latin script)
srn - сранан тонго
ss - свази
st - сото южный
stq - Saterland Frisian
su - сунданский
sv - шведский
sw - суахили
szl - Silesian
ta - тамильский
tcy - Tulu
te - телугу
tet - тетум
tg - таджикский
tg-cyrl - Tajik (Cyrillic script)
tg-latn - Tajik (Latin script)
th - тайский
ti - тигринья
tk - туркменский
tl - тагалог
tly - Talysh
tn - тсвана
to - тонганский
tokipona - Toki Pona
tpi - ток-писин
tr - турецкий
tru - туройо
ts - тсонга
tt - татарский
tt-cyrl - Tatar (Cyrillic script)
tt-latn - Tatar (Latin script)
tum - тумбука
tw - тви
ty - таитянский
tyv - тувинский
tzm - среднеатласский тамазигхтский
udm - удмуртский
ug - уйгурский
ug-arab - Uyghur (Arabic script)
ug-latn - Uyghur (Latin script)
uk - украинский
ur - урду
uz - узбекский
uz-cyrl - ўзбекча
uz-latn - oʻzbekcha
ve - венда
vec - Venetian
vep - Veps
vi - вьетнамский
vls - West Flemish
vmf - Main-Franconian
vo - волапюк
vot - водский
vro - Võro
wa - валлонский
war - варай
wo - волоф
wuu - Wu Chinese
xal - калмыцкий
xh - коса
xmf - Mingrelian
yi - идиш
yo - йоруба
yue - кантонский
za - чжуань
zea - Zeelandic
zh - китайский
zh-cn - Chinese (China)
zh-hans - упрощенный китайский
zh-hant - традиционный китайский
zh-hk - Chinese (Hong Kong)
zh-mo - 中文(澳門)
zh-my - 中文(马来西亚)
zh-sg - Chinese (Singapore)
zh-tw - Chinese (Taiwan)
zu - зулу
Экспорт для оффлайнового перевод
Экспорт в родном формате
{{DISPLAYTITLE:RTB setting}}<languages/> == Introduction == RTB auction (SSP) provides advertising space owners with the opportunity to conduct real-time bidding by selecting the best deals offered by advertisers. == How RTB works (real-time bidding) == Real-time bidding (real-time bidding) is the interaction of the level of the server between the advertising inventory at the SSP (sell-side platform) auction and the sellers (advertising platforms) using the '' http post '' protocol. All advertising inventory that meets the requirements is available to site owners through RTB infrastructure. <br /> The following principle describes how the auction works gives a brief overview of the process (for a more detailed description, see the section “Description of the workflow”): <br /> <ul> 1. RTB SSP (Real-time bidding sell-side platform) receives an advertising request from the seller and selects a list of buyers for the auction <br /> 2. RTB SSP sends a request to customers from the selected list <br /> 3. Each buyer from the list receives a request and evaluates its ability to participate in the auction, responds to the request 4. RTB SSP holds an auction based on bids received from buyers <br /> 5. RTB SSP "delivers" the announcement of the bidding winner among advertisers to the seller of advertising space on the site <br /> 6. RTB SSP sends auction results to auction participants <br /> </ul> == About the document == The document describes the connection of a DSP (demand-side platform) or advertiser to an RTB SSP (sell-side platform). The SSP interface is designed according to the OpenRTB v.2.3 protocol specification <br /> http://www.iab.net/media/file/OpenRTB-API-Specification-Version-2-3.pdf <br /> == Terms and definitions == '''Bid request''' - request from RTB SSP sent to buyers (advertisers) to bargain their promotional offers <br /> '''Bid response''' - buyer's response to RTB SSP as bidding bid <br /> '''CPM''' (Cost per mille) - price per one thousand ad impressions <br /> '''RTB''' (Real-time bidding) - real-time bidding, the principle of the delivery of advertising to the seller of real-time advertising space <br /> '''SSP''' (sell-side platform) - real-time bidding system representing the interests of sellers (owners of sites) <br /> '''DSP''' (demand-side platform) - an advertising system representing the interests of buyers (advertisers) <br /> '''Impression''' - teaser, banner, separate advertisement <br /> == Workflow description == Each request to the buyer (advertiser) is accompanied by the following steps: <br /> '''1. Selection of the buyer in real time '''<br /> After receiving a request to display advertising from the seller (platform), the RTB auction selects a list of buyers for setting advertising rates. The bids that have the highest chances to win the auction are chosen. <br /> '''2. Bid request from RTB SSP '''<br /> RTB auction sends requests to selected buyers (advertisers). The request contains technical information necessary for the “delivery” of the advertisement, as well as a set of targeting for this request. If the same buyer (advertiser) has several ads that match the targeting of the request from the seller of advertising space, then the RTB auction includes in bidding all incoming bidding that match the request. <br /> '''3. Buyer’s response (bid response) '''<br /> The buyer receives a request from the RTB auction and assesses the possibility of participation in the auction. As a response, the buyer sends an offer with a bid price or does not respond to the request if he does not have any offers for the request. The buyer must respond to the request within the allotted time interval, otherwise he will lose the opportunity to participate in the auction. In the case of several offers for bidding, the buyer must respond to a request for answers with the price of each of his proposals, which he is ready to bargain. <br /> '''4. Auction '''<br /> When all bids are received (in the allotted time to accept responses from buyers), an auction takes place. Sellers have the opportunity to specify the minimum price for the site on which they sell the place. In this regard, each winning bid must be higher than the minimum price that the seller places on the site. All materials are subject to mandatory moderation in the RTB SSP system. <br /> '''five. Notification of the results''' <br /> RTB SSP sends notification of results to each participant in each individual auction. <br /> == Requests to DSP == A request to a DSP (or customer) is a collection of information: <br /> <ul> - about the advertising platform; <br /> - about the visitor of this advertising platform; <br /> - about the device from which the visitor logged in; <br /> - about the list of advertising spaces for advertising; <br /> </ul> The DSP request is in json format, that is, [content_type] => application /json. <br /> == Example DSP /Buyer Request == '''Object definition''' <br /> Below are the definitions of the various objects involved in the request. <br /> '''Request Request Object' '<br /> The highest bid bid item object contains a globally unique bid bid or auction ID. This mandatory “ID” attribute requires at least one “imp” (for example, impression) object. Other attributes are optional, since the exchange can set default values. The default column defines how additional parameters should be interpreted if explicit values are not provided. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 100 align = left> Default </th> <th width = 350 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> id </td> <td> string </td> <td> - </td> <td> The unique identifier of the request rate, provided by the exchange </td> </tr> <tr bgcolor = #F5F5F5> <td> imp </td> <td> array of objects </td> <td> - </td> <td> Array of impression objects. Multiple impression auctions can be listed in a single bid bid. At least one bid is required for the correct bid. </Td> </tr> <tr bgcolor = #F5F5F5> <td> site </td> <td> object </td> <td> - </td> <td> see site object </td> </tr> <tr bgcolor = #F5F5F5> <td> device </td> <td> object </td> <td> - </td> <td> see device object </td> </tr> <tr bgcolor = #F5F5F5> <td> user </td> <td> object </td> <td> - </td> <td> see user object </td> </tr> <tr bgcolor = #F5F5F5> <td> ext </td> <td> object </td> <td> - </td> <td> This object is a prototype that can contain custom JSON agreed by the parties to an OpenRTB transaction that supports the flexibility of the standards defined in this specification. '''Described in the example request to the DSP /customer''' </td> </tr> <tr bgcolor = #F5F5F5> <td> at </td> <td> int </td> <td> 2 </td> <td> Auction principle. If "1", then the first auction. If "2", then the second auction. Additional types of auctions can be determined in accordance with the business rules of the exchange. </Td> </tr> </table> '''Impression object''' <br /> The “imp” object describes the position of an ad or impression at an auction. The “Default” column defines how additional parameters should be interpreted if explicit values are not provided. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 100 align = left> Default </th> <th width = 350 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> id </td> <td> string </td> <td> - </td> <td> The unique identifier for this impression in the context of the bid rate (as a rule, the cost starts from 1, and increases to n values per n number of impressions). </td> </tr> <tr bgcolor = #F5F5F5> <td> banner </td> <td> Object </td> <td> - </td> <td> Link to the banner object. Any banner or video object (or both, if the impression allows) should be included in the presentation of the object; both objects do not have to be included. See Banner Object </td> </tr> <tr bgcolor = #F5F5F5> <td> ext </td> <td> object </td> <td> - </td> <td> This object is a prototype that can contain custom JSON agreed by the parties in an OpenRTB transaction </td> </tr> <tr bgcolor = #F5F5F5> <td> bidfloor </td> <td> float </td> <td> 0 </td> <td> The minimum bid for each material that will be transmitted in response to a request. </td> </tr> <tr bgcolor = #F5F5F5> <td> bidfloorcur </td> <td> string </td> <td> RUB </td> <td> The currency in which the minimum bid is specified. </td> </tr> </table> '''Banner object''' <br /> The banner object must be included directly in the presentation of the object if the impression is put up for auction and is displayed or multimedia. The “Default” column shows how additional parameters should be interpreted if explicit values are not provided. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 100 align = left> Default </th> <th width = 350 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> w </td> <td> int32 </td> <td> - </td> <td> The width of the impression in pixels. Some types of ads that are not limited by the size of this area are not required, but it is strongly recommended to include this information when possible. </Td> </tr> <tr bgcolor = #F5F5F5> <td> h </td> <td> int32 </td> <td> - </td> <td> The height of the impression in pixels. Some types of ads that are not limited by the size of this area are not required, but it is strongly recommended to include this information when possible. </Td> </tr> </table> '''Site Object''' <br /> The site object must be included if the ad supports content as part of the website. The bid request must not contain both the site object and the application object. If the parameter is not specified, it should be considered as unknown. At a minimum, it is useful to provide the URL of the page or the site ID, but this is not mandatory. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 120 align = left> Field </th> <th width = 180 align = left> Type </th> <th width = 100 align = left> Default </th> <th width = 350 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> id </td> <td> string </td> <td> - </td> <td> Exchange Site ID </td> </tr> <tr bgcolor = #F5F5F5> <td> page </td> <td> string </td> <td> - </td> <td> URL of the page where impressions will be displayed. </td> </tr> <tr bgcolor = #F5F5F5> <td> domain </td> <td> string </td> <td> - </td> <td> The domain of the site used to block the side of the advertiser. For example, "foo.com". </Td> </tr> <tr bgcolor = #F5F5F5> <td> cat </td> <td> Array of strings </td> <td> - </td> <td> An array of IAB content categories for a common site. '''Cm. Table 6.1 "Content Categories" of the OpenRTB 2.1 specification '''</td> </tr> <tr bgcolor = #F5F5F5> <td> pagecat </td> <td> Array of strings </td> <td> - </td> <td> The IAB array of content categories for the current page. '''Cm. Table 6.1 "Content Categories" of the OpenRTB 2.1 specification '''</td> </tr> <tr bgcolor = #F5F5F5> <td> content </td> <td> object </td> <td> - </td> <td> See Content object </td> </tr> </table> '''Content object''' <br /> The content object itself and all its parameters are optional, therefore no default value is provided. If the parameter is not specified, it should be considered as unknown. This object describes the content in which the impression appears. This object can be useful in a situation where the syndicated content contains impressions that do not necessarily coincide with the publisher’s general content. Sharing may or may not give a complete understanding of the page where the content works as a result of the syndication method. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 120 align = left> Field </th> <th width = 120 align = left> Required? </th> <th width = 120 align = left> Type </th> <th width = 150 align = left> Default </th> <th width = 600 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> keywords </td> <td> Optional </td> <td> string </td> <td> - </td> <td> Comma-delimited list of keywords describing the content. </td> </tr> </table> '''Device Object''' <br /> The device object provides information related to the device, including its equipment, platforms, location. This device may apply to mobile phones, computers, set-top boxes or other digital devices. <br /> The device object itself and all its parameters are optional, so no default value is provided. If the parameter is not specified, it should be considered as unknown. <br /> In general, the most important field is the IP address (to perform a geo-search for the applicant). <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 150 align = left> Default </th> <th width = 350 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> ua </td> <td> String </td> <td> - </td> <td> User Agent Browser String </td> </tr> <tr bgcolor = #F5F5F5> <td> ip </td> <td> String </td> <td> - </td> <td> IPv4 address closest to device </td> </tr> </table> '''User object''' <br /> The “User” object contains information known or received about a person, a device user. The user object itself and all its parameters are optional, so the default value is not provided. If the optional parameter is not specified, it should be considered as unknown. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 120 align = left> Field </th> <th width = 120 align = left> Required? </th> <th width = 120 align = left> Type </th> <th width = 150 align = left> Default </th> <th width = 600 align = left> Description </th> </tr> <tr bgcolor = #F5F5F5> <td> id </td> <td> Required </td> <td> string </td> <td> - </td> <td> The unique consumer ID of this user in the auction. </td> </tr> <tr bgcolor = #F5F5F5> <td> buyeruid </td> <td> Optional </td> <td> string </td> <td> - </td> <td> DSP user ID </td> </tr> <tr bgcolor = #F5F5F5> <td> yob </td> <td> Optional </td> <td> int32 </td> <td> - </td> <td> Year of birth as a 4 digit number. </td> </tr> <tr bgcolor = #F5F5F5> <td> gender </td> <td> Optional </td> <td> string </td> <td> - </td> <td> Paul, as "M" men, "F" women, "O" Other. (Zero indicates unknown). </Td> </tr> </table> <b> DSP request example /advertiser (buyer) </b> <br /> <code> <pre> { "id": "140835804423031", "imp": [ { "id": "1", "banner": { "w": 120, "h": 120 }, "ext": { "ad_type": 10, //10 - teaser, 20 - banner, 40 - clickunder, 70 - video "limit": 1 //number of teasers for teaser block }, "bidfloor": 1.2, "bidfloorcur": "RUB" } ], "site": { "id": "34524253", "page": "http://testdomain.ru/bolezni-u-vzrosluh.html", "domain": "testdomain.ru", "cat": [ "IAB7" ], "pagecat": [ "IAB7" ], "content": { "keywords": "treatment, children, disease, osteoporosis" } }, "device": { "ua": "Mozilla /5.0 (Macintosh; Intel Mac OS X 10_9_4) AppleWebKit /537.36 (KHTML, like Gecko) Chrome /36.0.1985.143 Safari /537.36", "ip": "95.31.8.193" }, "user": { "id": "ssp140533010201346370" }, "at": 2 } </pre> </code> == Example of a valid DSP response == '''Object definition''' <br /> Below are the definitions of the various objects involved in responding to a request. <br /> '''Answer rate object''' <br /> The top level of the response rate object is defined below. The "ID" attribute is a reflection of the request rate ID to write to the database. At least one “seatbid” object is required, which includes at least one impression. Other attributes are optional, since the exchange can set the default values. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 350 align = left> Definition </th> </tr> <tr bgcolor = #F5F5F5> <td> id </td> <td> String </td> <td> Request Bid ID </td> </tr> <tr bgcolor = #F5F5F5> <td> cur </td> <td> String </td> <td> The currency in which the bet is made. In the current version, only “RUB” is available. </Td> </tr> <tr bgcolor = #F5F5F5> <td> seatbid </td> <td> Array of objects </td> <td> array of seatbid objects </td> </tr> </table> '''Seat Bid Object''' <br /> Since a request rate may include several offers, each "seatbid" object may contain several rates relating to different offers. Thus, each “bid” object must include the ID of the offer to which it refers, as well as the price of the offer. <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 250 align = left> Definition </th> </tr> <tr bgcolor = #F5F5F5> <td> Bid </td> <td> Array of objects </td> <td> Array of object rates; each object rate refers to an imp object in the request rate. One imp object can have many object stakes. </Td> </tr> </table> '''Bid Object (Bid)''' <br /> <table> <tr bgcolor = #DCDCDC> <th width = 130 align = left> Field </th> <th width = 200 align = left> Type </th> <th width = 350 align = left> Definition </th> </tr> <tr bgcolor = #F5F5F5> <td> id </td> <td> String </td> <td> Bid object ID is selected by the bidder for tracking and debugging. Useful when multiple bets per show are shown for a given place. </Td> </tr> <tr bgcolor = #F5F5F5> <td> impid </td> <td> String </td> <td> ID of the impression object to which this rate applies. </td> </tr> <tr bgcolor = #F5F5F5> <td> adid </td> <td> String </td> <td> ID that refers to an ad to use in case the bet wins. </td> </tr> <tr bgcolor = #F5F5F5> <td> ext </td> <td> Object </td> <td> For teaser format. Additional object rate extensions. </Td> </tr> <tr bgcolor = #F5F5F5> <td> price </td> <td> Float </td> <td> Bid price per thousand impressions. </td> </tr> <tr bgcolor = #F5F5F5> <td> nurl </td> <td> String </td> <td> Win URL notification. Please note that the ad is usually tagged, but this is not necessary for returning via URLs </td> </tr> <tr bgcolor = #F5F5F5> <td> adm </td> <td> String </td> <td> A part representing an advertising banner in the '''HTML''' format or an advertising video or a link for a clicker </td> </tr> <tr bgcolor = #F5F5F5> <td> iurl </td> <td> String </td> <td> Only for DSP response when requesting video. Link to advertising video. </Td> </tr> </table> '''An example of a valid DSP response when requesting a banner (with html-part):''' <br /> <code> <pre> { "id": "6", "seatbid": [ { "bid": [ { "id": 1, "impid": "1", "adid": 1085932, "adm": "<a target='_blank'href='http://test_url.com/test'> <img src = 'http: //test/test.gif' width = '300' height = '300 '> </a> ", "price": 2.6269636, "nurl": "http://domain.ru/?dsp_win&bid=${AUCTION_PRICE}&ads=$ {AUCTION_AD_ID} & auctionID = $ {AUCTION_ID}" } ] } ] } </pre> </code> '''An example of a valid DSP response when requesting a teaser:''' <br /> <code> <pre> { "id": "5", "seatbid": [ { "bid": [ { "id": 1, "adid": 0, "impid": "1", "ext": { "ads": [ { "id": 1061077, "title": "The bone will disappear in a week!", "text": "Found a simple way to cure \" bones \ "! Write down ...", "image": "http://domain.ru/1406733540_16197_phpi61ewn.jpg", "cpm": 6.0, "url": "http://domain.ru/test/test_url" }, { "id": 1083442, "title": "How to wash the car 3-4 times a year", "text": "This is a penny tool carefully concealed car washes!", "image": "http://domain.ru/1407217586_9686_phpgqddlm.jpg", "cpm": 2.6, "url": "http://domain.ru/test/test_url" }, { "id": 1087092, "title": "Wash your car 2 times a year!", "text": "Employees of car washes hide this cheap tool!", "image": "http://domain.ru/1407310654_12085_phpm6spfp.jpg", "cpm": 2.5, "url": "http://domain.ru/test/test_url" } ] }, "price": 11.1, "nurl": "http://domain.ru/?dsp_win&bid=${AUCTION_PRICE}&ads=$ {AUCTION_AD_ID} & auctionID = $ {AUCTION_ID}" } ] } ] } </pre> </code> '''An example of a valid DSP response when requesting a clicker:''' <br /> <code> <pre> { "id": "6", "seatbid": [ { "bid": [ { "id": 1, "impid": "1", "adid": 1085932, "adm": "http://test_url.com/test", "price": 2.6269636, "nurl": "http://domain.ru/?dsp_win&bid=${AUCTION_PRICE}&ads=$ {AUCTION_AD_ID} & auctionID = $ {AUCTION_ID}" } ] } ] } </pre> </code> '''An example of a valid DSP response when requesting a video:''' <br /> <code> <pre> { "id": "6", "seatbid": [ { "bid": [ { "id": 1, "impid": "1", "adid": 30641 "iurl": "http://videotest.ru/video.flv" "adm": "% 3CVAST + version% 3D% 223.0% 22% 3E +% 0D% 0A% 3Cad- id% 3D% 2230641% 22% 3E +% 0D% 0A% 3CInLine% 3E +% 0D% 0A% 3CAdSystem% 3EAdSystem + Name% 3C% 2FAdSystem% 3E% 0D% 0A% 3CAdTitle% 3ETitle% 3C% 2FAdTitle% 3E% 0D% 0A% 3CImpression% 3E% 0D% 0A% 21% 5BCDATA% 5Bhttp% 3A% 2F% 2Fmyimpression.ru% 2F% 3Fc ommand% 3Dtrack_view% 26skip% 3Dtrue% 5D% 5D% 0D% 0A% 3C% 2FImpression% 3E% 0D% 0 A% 3CCreatives% 3E +% 0D% 0A% 3CCreative% 3E +% 0D% 0A% 3CLinear% 3E +% 0D% 0A% 3CDu ration% 3E00% 3A00% 3A21% 3C% 2FDuration% 3E +% 0D% 0A% 3CTrackingEvents% 3E +% 0D% 0A% 3CTracking + event% 3D% 22firstQuartile% 22% 3E% 21% 5BCDATA% 5B% 24% 7BTRACK_U RL% 7D% 5D% 5D +% 0D% 0A% 3C% 2FTracking% 3E% 0D% 0A% 3C% 2FTrackingEvents% 3E +% 0 D% 0A% 3CMediaFiles% 3E +% 0D% 0A% 3CMediaFile + delivery% 3D% 22streaming% 22 + bitrate% 3D% 22600% 22 + width% 3D% 22640% 22 + height% 3D% 22480% 22 + type% 3D% 22video% 2Fx- flv% 22% 3E% 0D% 0A% 3C% 21% 5BCDATA% 5Bhttp% 3A% 2F% 2Fvideotest.ru% 2Fvideo.flv% 5D % 5D% 3E% 0D% 0A% 3C% 2FMediaFile% 3E% 0D% 0A% 3C% 2FMediaFiles% 3E +% 0D% 0A% 3C % 2FLinear% 3E +% 0D% 0A% 3C% 2FCreative% 3E +% 0D% 0A% 3C% 2FCreatives% 3E +% 0D% 0A % 3C% 2FInLine% 3E +% 0D% 0A% 3C% 2FAd% 3E +% 0D% 0A% 3C% 2FVAST% 3E + " "price": 2.6269636, "nurl": "http://domain.ru/?dsp_win&bid=${AUCTION_PRICE}&ads=$ {AUCTION_AD_ID} & auctionID = $ {AUCTION_ID}" } ] } ] } </pre> </code> '''The adm field format of the bid object when requesting a video:''' <br /> Promotional video must be submitted in accordance with the Video Ad Serving Template (VAST) 3.0 protocol specification (http://www.iab.net/media/file/VASTv3.0.pdf) with the embedded $ {TRACK_URL} macro in the < Tracking event = "firstQuartile"> ... </Tracking> and is encoded in a URL format. If desired, the DSP can also add tracks for 1⁄2, 3⁄4 and full video viewing. <br /> '''Attention!''' Only Linear type of advertising video is supported and only with one media file for up to 30 seconds. Acceptable types of media files are mp4, webm, ogg, and flv. <br /> An example of the presentation of video material in XML format and embedded macro: <br /> <code> <pre> <VAST version = "3.0"> <Ad id = "30641"> <InLine> <AdSystem> AdSystem Name </AdSystem> //advertiser name <AdTitle> Title </AdTitle> //general name of the material <Impression> <! [CDATA [http://myimpression.ru/?command=track_view&skip=true]]> </Impression> //link that is called when viewing the first frame of video <Creatives> <Creative> <Linear> <Duration> 00:00:21 </Duration> //video length <TrackingEvents> <Tracking event = "firstQuartile"> <! [CDATA [$ {TRACK_URL} & furl = xxx]]> </Tracking> //contains a link that is called when playing a quarter of a video, where xxx is a similar link from DSP </TrackingEvents> <Mediafiles> <MediaFile delivery = "streaming" bitrate = "600" width = "640" height = "480" type = "video /x-flv"> <! [CDATA [http://videotest.ru/video.flv]]> //link to the advertising video </MediaFile> </Mediafiles> </Linear> </Creative> </Creatives> </InLine> </Ad> </Vast> </pre> </code> After that, the XML structure is encoded in the URL format and placed in the bid.adm field. Reading the display and sending win notice occurs after viewing 25% of the video. <br /> Teaser materials should be represented by separate objects in the response code. The ext.ads field contains an array of material objects, where: <br /> * id - material identifier <br /> * title - material title <br /> * text - text material <br /> * url - link to transition <br /> * image - image link <br /> * cpm - personal cpm of the material (price per 1000 impressions) <br /> If it is not possible to specify the material's individual CPM, then the rate must be indicated in the price field. This rate will be distributed evenly among the materials in the DSP response. <br /> RTB SSP supports the standard set of macros for nurl. <br /> Exceptions are the $ {AUCTION_AD_ID} and $ {AUCTION_PRICE} macros. <br /> The auction takes place at the level of individual materials, not at the block level, so the value of $ {AUCTION_AD_ID} will consist of a list of materials separated by a comma, which won the auction. <br /> The macro $ {AUCTION_PRICE} contains the bid of the winning material, in fact the bid of the second of the materials in the auction, taking into account the mechanism of the “auction of the second price”. <br /> And the macro $ {AUCTION_PRICE_TTL} will contain the sum of the bids of materials from the macro $ {AUCTION_AD_ID}, that is, the total amount of the write-off for these bids. <br /> == User Synchronization == For DSP, a user synchronization service with KadamSSP is also available under the SSP initiator scheme. The principle of operation is as follows: <br /> <ul> 1. KadamSSP calls the match link provided by the DSP with the user id in the SSP system. <br /> 2. DSP recognizes \ creates a user cookie and redirects it to the match link provided by the SSP with its user id or if the user is not interested or the DSP wants to store a matching table on its side - responds to the request with code 204. <br /> 3. KadamSSP contributes to the table. <br /> 4. In the following auctions with this user, the DSP will receive a request with the user.buyeruid field and the user id value in the DSP system. <br /> </ul> Also, with the cookie service running and the format of storing the match table on the SSP side, the option “Send only matched” is possible, in which only requests are sent to the DSP with the participation of the user for whom an entry has been created in the match table.
Навигация
Персональные инструменты
русский
Войти
Пространства имён
Перевод
Варианты
Просмотры
Статистика языка
Статистика группы сообщений
Экспорт
Ещё
Поиск
Навигация
KADAM.NET
EN
Для рекламодателя
Для паблишера
OpenRTB/Feed
Условия сотрудничества
ЧаВО
Инструменты
Спецстраницы
Версия для печати