OpenRTB/Feed документация по интеграции SSP — различия между версиями

Материал из Справочник сервиса Kadam.net
Перейти к: навигация, поиск
(Feed Bid Response)
(не показано 16 промежуточных версий этого же участника)
Строка 10: Строка 10:
 
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#OpenRTB_.D0.B8.D0.BD.D1.82.D0.B5.D0.B3.D1.80.D0.B0.D1.86.D0.B8.D1.8F  Интеграция по OpenRTB]
 
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#OpenRTB_.D0.B8.D0.BD.D1.82.D0.B5.D0.B3.D1.80.D0.B0.D1.86.D0.B8.D1.8F  Интеграция по OpenRTB]
  
 +
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#XML_.D0.B8.D0.BD.D1.82.D0.B5.D0.B3.D1.80.D0.B0.D1.86.D0.B8.D1.8F  Интеграция по XML]
  
 
'''Bid Request/Response'''
 
'''Bid Request/Response'''
Строка 22: Строка 23:
  
 
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#OpenRTB_Bid_Response  OpenRTB Bid Response]
 
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#OpenRTB_Bid_Response  OpenRTB Bid Response]
 +
 +
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#XML_Bid_Request  XML Bid Request]
 +
 +
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#XML_Bid_Response  XML Bid Response]
  
  
Строка 39: Строка 44:
 
'''Ключевые моменты'''
 
'''Ключевые моменты'''
  
* Kadam поддерживает протоколы Feed, [https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf OpenRTB 2.5], [https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf Native 1.1], [https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf Native 1.2];
+
* Kadam поддерживает протоколы Feed, [https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-API-Specification-Version-2-5-FINAL.pdf OpenRTB 2.5], [https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf Native 1.1], [https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf Native 1.2], XML;
  
 
* Чтобы подключить новую SSP, необходимо убедиться, что вы поддерживаете передачу необходимых параметров и готовы отправлять запросы и получать от нас ответы;
 
* Чтобы подключить новую SSP, необходимо убедиться, что вы поддерживаете передачу необходимых параметров и готовы отправлять запросы и получать от нас ответы;
Строка 50: Строка 55:
 
'''Cookie Matching'''
 
'''Cookie Matching'''
  
Каждому пользователю рекламные сети устанавливают third-party cookies на домен своей DMP, чтобы при повторном взаимодействии узнать его. Настройка Cookie Matching позволит избегать повторного показа рекламы пользователю, может быть использована в предикте его интересов, а так же ретаргетинге.
+
Для чего необходим Cookie Matching:
 
+
* позволяет избегать повторного показа рекламы пользователю;
Cookie Matching необходим, чтобы сопоставить ваш файл cookie (id пользователя по вашей версии, который просматривал ваш веб-сайт), с соответствующим id пользователя по версии Kadam. Чтобы это сопоставление произошло, SSP или DSP необходимо проявить инициативу и показать DMP пиксель партнеру. Цель показа пикселя партнера заключается в том, чтобы передать ему id пользователя по своей версии и сохранить связь в таблице матчинга. Хранителями могут выступать: SSP, DSP, оба.
+
* может быть использована в предикте его интересов;
 +
* ретаргетинга.  
 +
С помощью Cookie Matching можно сопоставить id пользователя (по вашей версии), который просматривал ваш веб-сайт, с соответствующим id пользователя по версии Kadam.
  
 
Ознакомиться подробнее с возможными вариантами интеграции можно [https://wiki.kadam.net/index.php?title=Cookie_matching здесь]. Для настройки Cookie Matching необходимо обратиться к менеджеру Kadam.  
 
Ознакомиться подробнее с возможными вариантами интеграции можно [https://wiki.kadam.net/index.php?title=Cookie_matching здесь]. Для настройки Cookie Matching необходимо обратиться к менеджеру Kadam.  
Строка 134: Строка 141:
 
|  
 
|  
 
|-
 
|-
|subage / subage_dt / subage0 / subage_ts
+
|subage / subage_dt / subage0 / subage_ts/ subage_ts_ms
 
|Возраст подписки пользователя
 
|Возраст подписки пользователя
|Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (unixtime)
+
|Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (секунды в unixtime), subage_ts_ms - фактическая дата подписки (миллисекунды в unixtime)
|Обязательный
+
|Обязательный для Push
 
|-
 
|-
 
|pid
 
|pid
Строка 320: Строка 327:
 
|  
 
|  
 
|-
 
|-
|crid
+
|crid (adid)
 
|ID креатива
 
|ID креатива
 
|  
 
|  
Строка 426: Строка 433:
 
:{
 
:{
 
::"id": "5555555",
 
::"id": "5555555",
 +
::"impid": "5",
 +
::"crid": "555555",
 
::"click_url": <nowiki>"https://example.com/h/np7hsxgf7znhtwwp372gm4eqzxbippulrjkgossribafyeqhafvgf56srptfmebrzi4563e2k6z442paphs5yoxrncznnt6l4hg7xjrf6bedf2sxw5uyculsxrj4drfsqkv3bne6v542iu6byszifk5qwspk66oukd23j24wkxpusyhqpjgpqoslhnt6mtkv3fjhtgkqhbeys4vgjvpzsutj3ri7prci6jk7dluasj7ymuj3jvvdhdsm5236vgsqwi56a262kvhmwzpr4wknkpwznuzuimkd62z5yvsczc2xiksxn5kscujilyfdeknrha7ddy3ar7lfhyrzwxwdvpsosthvpasvofnsohyggqvxquzsjjwgeajll5idilbnauyrwzrxlmwfcc3gozzve2i6mpjdushbgda2z33d5v5i7efiocwdavzkhrpjq6udllwuxmxqyz3k4y5judmw7sclxp727i7k4l2jr4cteiowgftdpvzvqy2ogeybkkqkbizge72wneoxs2s3pfnr6zl5picdgtjsmygxaucui2jkp37qr725biwqnannnymi6rntuuobhos6idagtcc2rm32btjlvzj3klxlt7fdv2d2xlohjbftmxrrpmpxq6te6osyt3runrjugyciu75fkgfv5q5g6t2lmfihqvc67aekvr36cpckgury?u=https%3A%2F%2Fexample.com%2Fgo%2F78602c30-54b0-4db5-bd07-3b2e3a804955%3Fcost%3D3.5%26clickid%3Dcnv4bd32b2809b6bbcfdac2ece8909839f7%26campaign_id%3D555120%26creative_id%3D4796823%26site_id%3D1375589855029800%26category_id%3D126%26country%3DRU%55browser%3DCHROME%26language%3Dru%26platform%3DANDROID%26subage%3D7%26feed%3D550279"</nowiki>,
 
::"click_url": <nowiki>"https://example.com/h/np7hsxgf7znhtwwp372gm4eqzxbippulrjkgossribafyeqhafvgf56srptfmebrzi4563e2k6z442paphs5yoxrncznnt6l4hg7xjrf6bedf2sxw5uyculsxrj4drfsqkv3bne6v542iu6byszifk5qwspk66oukd23j24wkxpusyhqpjgpqoslhnt6mtkv3fjhtgkqhbeys4vgjvpzsutj3ri7prci6jk7dluasj7ymuj3jvvdhdsm5236vgsqwi56a262kvhmwzpr4wknkpwznuzuimkd62z5yvsczc2xiksxn5kscujilyfdeknrha7ddy3ar7lfhyrzwxwdvpsosthvpasvofnsohyggqvxquzsjjwgeajll5idilbnauyrwzrxlmwfcc3gozzve2i6mpjdushbgda2z33d5v5i7efiocwdavzkhrpjq6udllwuxmxqyz3k4y5judmw7sclxp727i7k4l2jr4cteiowgftdpvzvqy2ogeybkkqkbizge72wneoxs2s3pfnr6zl5picdgtjsmygxaucui2jkp37qr725biwqnannnymi6rntuuobhos6idagtcc2rm32btjlvzj3klxlt7fdv2d2xlohjbftmxrrpmpxq6te6osyt3runrjugyciu75fkgfv5q5g6t2lmfihqvc67aekvr36cpckgury?u=https%3A%2F%2Fexample.com%2Fgo%2F78602c30-54b0-4db5-bd07-3b2e3a804955%3Fcost%3D3.5%26clickid%3Dcnv4bd32b2809b6bbcfdac2ece8909839f7%26campaign_id%3D555120%26creative_id%3D4796823%26site_id%3D1375589855029800%26category_id%3D126%26country%3DRU%55browser%3DCHROME%26language%3Dru%26platform%3DANDROID%26subage%3D7%26feed%3D550279"</nowiki>,
 
::"campaign_id": 555555,
 
::"campaign_id": 555555,
Строка 444: Строка 453:
 
:{
 
:{
 
::"id": "5555555",
 
::"id": "5555555",
 +
::"impid": "5",
 +
::"crid": "555555",
 
::"click_url": <nowiki>"https://example.com/h/np7hsxgf7znhtwwp372gm4eqzxbippulrjkgossribafyeqhafvgf56srptfmebrzi4563e2k6z442paphs5yoxrncznnt6l4hg7xjrf6bedf2sxw5uyculsxrj4drfsqkv3bne6v542iu6byszifk5qwspk66oukd23j24wkxpusyhqpjgpqoslhnt6mtkv3fjhtgkqhbeys4vgjvpzsutj3ri7prci6jk7dluasj7ymuj3jvvdhdsm5236vgsqwi56a262kvhmwzpr4wknkpwznuzuimkd62z5yvsczc2xiksxn5kscujilyfdeknrha7ddy3ar7lfhyrzwxwdvpsosthvpasvofnsohyggqvxquzsjjwgeajll5idilbnauyrwzrxlmwfcc3gozzve2i6mpjdushbgda2z33d5v5i7efiocwdavzkhrpjq6udllwuxmxqyz3k4y5judmw7sclxp727i7k4l2jr4cteiowgftdpvzvqy2ogeybkkqkbizge72wneoxs2s3pfnr6zl5picdgtjsmygxaucui2jkp37qr725biwqnannnymi6rntuuobhos6idagtcc2rm32btjlvzj3klxlt7fdv2d2xlohjbftmxrrpmpxq6te6osyt3runrjugyciu75fkgfv5q5g6t2lmfihqvc67aekvr36cpckgury?u=https%3A%2F%2Fexample.com%2Fgo%2F78602c30-54b0-4db5-bd07-3b2e3a804955%3Fcost%3D3.5%26clickid%3Dcnv4bd32b2809b6bbcfdac2ece8909839f7%26campaign_id%3D555120%26creative_id%3D4796823%26site_id%3D1375589855029800%26category_id%3D126%26country%3DRU%55browser%3DCHROME%26language%3Dru%26platform%3DANDROID%26subage%3D7%26feed%3D550279"</nowiki>,
 
::"click_url": <nowiki>"https://example.com/h/np7hsxgf7znhtwwp372gm4eqzxbippulrjkgossribafyeqhafvgf56srptfmebrzi4563e2k6z442paphs5yoxrncznnt6l4hg7xjrf6bedf2sxw5uyculsxrj4drfsqkv3bne6v542iu6byszifk5qwspk66oukd23j24wkxpusyhqpjgpqoslhnt6mtkv3fjhtgkqhbeys4vgjvpzsutj3ri7prci6jk7dluasj7ymuj3jvvdhdsm5236vgsqwi56a262kvhmwzpr4wknkpwznuzuimkd62z5yvsczc2xiksxn5kscujilyfdeknrha7ddy3ar7lfhyrzwxwdvpsosthvpasvofnsohyggqvxquzsjjwgeajll5idilbnauyrwzrxlmwfcc3gozzve2i6mpjdushbgda2z33d5v5i7efiocwdavzkhrpjq6udllwuxmxqyz3k4y5judmw7sclxp727i7k4l2jr4cteiowgftdpvzvqy2ogeybkkqkbizge72wneoxs2s3pfnr6zl5picdgtjsmygxaucui2jkp37qr725biwqnannnymi6rntuuobhos6idagtcc2rm32btjlvzj3klxlt7fdv2d2xlohjbftmxrrpmpxq6te6osyt3runrjugyciu75fkgfv5q5g6t2lmfihqvc67aekvr36cpckgury?u=https%3A%2F%2Fexample.com%2Fgo%2F78602c30-54b0-4db5-bd07-3b2e3a804955%3Fcost%3D3.5%26clickid%3Dcnv4bd32b2809b6bbcfdac2ece8909839f7%26campaign_id%3D555120%26creative_id%3D4796823%26site_id%3D1375589855029800%26category_id%3D126%26country%3DRU%55browser%3DCHROME%26language%3Dru%26platform%3DANDROID%26subage%3D7%26feed%3D550279"</nowiki>,
 
::"campaign_id": 555555,
 
::"campaign_id": 555555,
Строка 1968: Строка 1979:
 
:::::"impid": "555555555",
 
:::::"impid": "555555555",
 
:::::"price": 1.9711000061035155,
 
:::::"price": 1.9711000061035155,
:::::"burl": <nowiki>"https://example.com/nurl/863/nn2eqnzrlevvuarsmivfimkopfta27s5d5xcu7krpumtkzs2pufqkybnp4agg2stmyaxwxqkmr5vh34bnn2nfo6pyu2gmx3tneakouqkhmuz77eiuhdopvpirbjvbzom5xiuso7bstc22v2aubxlqvyqioy3fvcwjiihq2jsk2h34sm4i4kfg4fanzbfynslmfihqvcszb3osm2xy5fgxqdz5dyt76liqddfb43azzyziu7ivpctbg2oltlicqebknqhbxiorzhkqznvph5bkwlxqezx5msko3t2s3g7hkf2q3dn45ff5ydzk7vdsevbgoxg3g3alkqflreh5o543knqwspfdgcvthzn2fw2k5hlsyctfudrnmkldahvzghicg2uprcqhhrwwmiddqh5cuwlq3g2nnewzwu3asvdkjof2uryjgu4o7udoryfa6cuqi4jpkync7aitfdy3do22byynezfmt2lmgqephcqlwnwwmuojvficuxi6tt7ut4zgbl4ksdjm5fwonqapafaj5smujtpq62e4i5vrujrqx3wdiktxgsxrscktsdotl2m4nkhuucrvbgzenwojnfmcvgu6gg36t6bgzl76t7b2p7prnfj6nvyuux4th7m5bnlvxd3m2a=?1=1&data[]=16268540604187916861458595&v[]=5550347983&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}"</nowiki>,
+
:::::"nurl": <nowiki>"https://example.com/nurl/863/nn2eqnzrlevvuarsmivfimkopfta27s5d5xcu7krpumtkzs2pufqkybnp4agg2stmyaxwxqkmr5vh34bnn2nfo6pyu2gmx3tneakouqkhmuz77eiuhdopvpirbjvbzom5xiuso7bstc22v2aubxlqvyqioy3fvcwjiihq2jsk2h34sm4i4kfg4fanzbfynslmfihqvcszb3osm2xy5fgxqdz5dyt76liqddfb43azzyziu7ivpctbg2oltlicqebknqhbxiorzhkqznvph5bkwlxqezx5msko3t2s3g7hkf2q3dn45ff5ydzk7vdsevbgoxg3g3alkqflreh5o543knqwspfdgcvthzn2fw2k5hlsyctfudrnmkldahvzghicg2uprcqhhrwwmiddqh5cuwlq3g2nnewzwu3asvdkjof2uryjgu4o7udoryfa6cuqi4jpkync7aitfdy3do22byynezfmt2lmgqephcqlwnwwmuojvficuxi6tt7ut4zgbl4ksdjm5fwonqapafaj5smujtpq62e4i5vrujrqx3wdiktxgsxrscktsdotl2m4nkhuucrvbgzenwojnfmcvgu6gg36t6bgzl76t7b2p7prnfj6nvyuux4th7m5bnlvxd3m2a=?1=1&data[]=16268540604187916861458595&v[]=5550347983&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}"</nowiki>,
 
:::::"lurl": <nowiki>"https://example.com/lurl/863/nn2eqnzrlevvuarsmivfimkopfta27s5d5xcu7krpumtkzs2pufqkybnp4agg2stmyaxwxqkmr5vh34bnn2nfo6pyu2gmx3tneakouqkhmuz77eiuhdopvpirbjvbzom5xiuso7bstc22v2aubxlqvyqioy3fvcwjiihq2jsk2h34sm4i4kfg4fanzbfynslmfihqvcszb3osm2xy5fgxqdz5dyt76liqddfb43azzyziu7ivpctbg2oltlicqebknqhbxiorzhkqznvph5bkwlxqezx5msko3t2s3g7hkf2q3dn45ff5ydzk7vdsevbgoxg3g3alkqflreh5o543knqwspfdgcvthzn2fw2k5hlsyctfudrnmkldahvzghicg2uprcqhhrwwmiddqh5cuwlq3g2nnewzwu3asvdkjof2uryjgu4o7udoryfa6cuqi4jpkync7aitfdy3do22byynezfmt2lmgqephcqlwnwwmuojvficuxi6tt7ut4zgbl4ksdjm5fwonqapafaj5smujtpq62e4i5vrujrqx3wdiktxgsxrscktsdotl2m4nkhuucrvbgzenwojnfmcvgu6gg36t6bgzl76t7b2p7prnfj6nvyuux4th7m5bnlvxd3m2a=?1=1&data[]=16268540604187916861458595&v[]=5550347983&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>,
 
:::::"lurl": <nowiki>"https://example.com/lurl/863/nn2eqnzrlevvuarsmivfimkopfta27s5d5xcu7krpumtkzs2pufqkybnp4agg2stmyaxwxqkmr5vh34bnn2nfo6pyu2gmx3tneakouqkhmuz77eiuhdopvpirbjvbzom5xiuso7bstc22v2aubxlqvyqioy3fvcwjiihq2jsk2h34sm4i4kfg4fanzbfynslmfihqvcszb3osm2xy5fgxqdz5dyt76liqddfb43azzyziu7ivpctbg2oltlicqebknqhbxiorzhkqznvph5bkwlxqezx5msko3t2s3g7hkf2q3dn45ff5ydzk7vdsevbgoxg3g3alkqflreh5o543knqwspfdgcvthzn2fw2k5hlsyctfudrnmkldahvzghicg2uprcqhhrwwmiddqh5cuwlq3g2nnewzwu3asvdkjof2uryjgu4o7udoryfa6cuqi4jpkync7aitfdy3do22byynezfmt2lmgqephcqlwnwwmuojvficuxi6tt7ut4zgbl4ksdjm5fwonqapafaj5smujtpq62e4i5vrujrqx3wdiktxgsxrscktsdotl2m4nkhuucrvbgzenwojnfmcvgu6gg36t6bgzl76t7b2p7prnfj6nvyuux4th7m5bnlvxd3m2a=?1=1&data[]=16268540604187916861458595&v[]=5550347983&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>,
 
:::::"adomain": [
 
:::::"adomain": [
Строка 2237: Строка 2248:
 
:]
 
:]
 
}
 
}
 +
|}
 +
 +
== XML интеграция ==
 +
 +
'''XML интеграция'''
 +
 +
Эта документация объясняет, как рекламодатели могут интегрировать свои платформы с Kadam, используя XML.
 +
 +
 +
'''Bid Request/Response'''
 +
 +
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#XML_Bid_Request  XML Bid Request]
 +
 +
* [https://wiki.kadam.net/index.php?title=OpenRTB/Feed_%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F_%D0%BF%D0%BE_%D0%B8%D0%BD%D1%82%D0%B5%D0%B3%D1%80%D0%B0%D1%86%D0%B8%D0%B8_SSP#XML_Bid_Response  XML Bid Response]
 +
 +
 +
'''Поддерживаемые типы рекламы:'''
 +
 +
* Native;
 +
 +
* Push;
 +
 +
* On site push (inpage);
 +
 +
* iOS calendar push;
 +
 +
* Clickunder.
 +
 +
== XML Bid Request ==
 +
 +
 +
'''XML Bid Request'''
 +
 +
Описание поддерживаемых параметров
 +
 +
'''Следующие объекты следует отправлять в GET параметрах запроса:'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|-
 +
| style="width: 10%"|'''Параметр'''
 +
| style="width: 20%"|'''Описание'''
 +
| style="width: 50%"|'''Использование'''
 +
| style="width: 20%"|'''Обязательный'''
 +
|-
 +
|sid
 +
|endpoint ID
 +
|Уникализация потока в Kadam. Выдается Kadam
 +
|Обязательный
 +
|-
 +
|skey
 +
|Ключ API
 +
|Выдается Kadam
 +
|
 +
|-
 +
|ua
 +
|user agent
 +
|Для определения ос, устройства, браузера пользователя на стороне Kadam
 +
|Обязательный
 +
|-
 +
|ip
 +
|IP-адрес пользователя
 +
|Для определения геолокации устройства пользователя на стороне Kadam
 +
|Обязательный либо IP, либо IPv6
 +
|-
 +
|uid
 +
|ID пользователя в системе SSP
 +
|Для уникализации пользователя
 +
|Обязательный
 +
|-
 +
|limit
 +
|Ограничение количества креативов в ответе
 +
|Если лимит отсутствует в запросе и на блоке, считается как 1 по умолчанию
 +
|
 +
|-
 +
|language
 +
|Основной язык браузера, кодировка ISO 3166-1 alpha-2
 +
|Для определения языка браузера. Пример передачи: &language=ru-RU или &language=ru. Если параметр language не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп
 +
|
 +
|-
 +
|subage / subage_dt / subage0 / subage_ts/ subage_ts_ms
 +
|Возраст подписки пользователя
 +
|Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (секунды в unixtime), subage_ts_ms - фактическая дата подписки (миллисекунды в unixtime)
 +
|Обязательный для Push
 +
|-
 +
|pid
 +
|ID паблишера
 +
|В параметре ожидается ID паблишера (сайта, вебмастера) на стороне SSP
 +
|Обязательный
 +
|-
 +
|cat
 +
|IAB-категория домена
 +
|По умолчанию на меинстриме - IAB24, на адалте - IAB25-3
 +
|Необязательный
 +
|-
 +
|page
 +
|Домен страницы
 +
|Ожидается страница
 +
|Желательный
 +
|-
 +
|format
 +
|Формат трафика
 +
|Cu, pops - для кликандера;
 +
Native, teaser - для тизера;
 +
 +
По умолчанию - push
 +
|Необязательный
 +
|}
 +
 +
'''Примеры Bid Request'''
 +
 +
'''PUSH'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
 +
|/feed
 +
 +
?sid=5
 +
 +
&skey=5azqxvgap5yNsm5X5rg5PMsgDD
 +
 +
&ua=Mozilla%2F5.0+%28Linux%3B+Android+9%3B+SAMSUNG+SM-A105FN%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+SamsungBrowser%2F12.1+Chrome%2F79.0.3945.136+Mobile+Safari%2F537.36
 +
 +
&ip=127.1.0.0
 +
 +
&uid=Xef5LfyUte-tzwpV5-fMV
 +
 +
&limit=1
 +
 +
&language=en
 +
 +
&pid=1
 +
 +
&subage=2
 +
 +
&cat=126
 +
 +
&page=example.com
 +
 +
|}
 +
 +
'''CLICKUNDER'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
 +
|/feed
 +
 +
?sid=555
 +
 +
&format=cu
 +
 +
&ua=Mozilla%2F5.0+%28Linux%3B+Android+10%3B+SM-J600F%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F91.0.4472.88+Mobile+Safari%2F537.36
 +
 +
&ip=127.1.0.0
 +
 +
&uid=555555555
 +
 +
&limit=5
 +
 +
&language=fa-IR
 +
 +
&pid=5555555
 +
 +
&page=example.com
 +
|}
 +
 +
'''ON SITE PUSH (INPAGE)'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
 +
|/feed
 +
 +
?sid=5
 +
 +
&skey=5azqxvgap5yNsm5X5rg5PMsgDD
 +
 +
&ua=Mozilla%2F5.0+%28Linux%3B+Android+9%3B+SAMSUNG+SM-A105FN%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+SamsungBrowser%2F12.1+Chrome%2F79.0.3945.136+Mobile+Safari%2F537.36
 +
 +
&ip=127.1.0.0
 +
 +
&uid=Xef5LfyUte-tzwpV5-fMV
 +
 +
&limit=1
 +
 +
&language=en
 +
 +
&pid=1
 +
 +
&cat=126
 +
 +
&page=example.com
 +
|}
 +
 +
'''IOS CALENDAR PUSH'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
 +
|/feed
 +
 +
?sid=555
 +
 +
&skey=ca555555f555ec5a5a5ff55cc5b5fb5c
 +
 +
&ua=iOS%2F14.4+%5558D52%29+dataaccessd%2F1.0
 +
 +
&ip=127.1.0.0
 +
 +
&uid=0.00695555.5515680055292
 +
 +
&language=en
 +
 +
&subage_dt=2021-07-10
 +
 +
&pid=5555555555
 +
 +
&limit=1
 +
|}
 +
 +
'''NATIVE'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
 +
|/feed
 +
 +
?sid=555
 +
 +
&skey=b5cb555d5efcd555ade5555a5eaa5f55
 +
 +
&ua=Mozilla%2F5.0+%28Linux%3B+Android+11%3B+SM-T500%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F91.0.4472.120+Safari%2F537.36
 +
 +
&ip=127.1.0.0
 +
 +
&uid=5b5aa555-bd55-555b-a5d5-55f55f5c55df
 +
 +
&language=de
 +
 +
&pid=55
 +
 +
&page=example.com
 +
 +
&format=native
 +
|}
 +
 +
== XML Bid Response ==
 +
 +
'''XML Bid Response'''
 +
 +
Описание поддерживаемых параметров (формат Bid Response может быть изменен по вашим требованиям, для этого обратитесь к нашему менеджеру)
 +
 +
'''result.listing'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|-
 +
| style="width: 10%"|'''Параметр'''
 +
| style="width: 20%"|'''Описание'''
 +
| style="width: 50%"|'''Использование'''
 +
| style="width: 20%"|'''Обязательный'''
 +
|-
 +
|url
 +
|Ссылка для перехода по объявлению
 +
|
 +
|
 +
|-
 +
|bid
 +
|Ставка
 +
|
 +
|
 +
|-
 +
|pixel
 +
|Nurl
 +
|
 +
|
 +
|-
 +
|image
 +
|Ссылка на изображение материала
 +
|
 +
|
 +
|-
 +
|title
 +
|Заголовок объявления
 +
|
 +
|
 +
|-
 +
|descr
 +
|Текст объявления
 +
|
 +
|
 +
|-
 +
|site
 +
|URL сайта
 +
|
 +
|
 +
|-
 +
|icon
 +
|Ссылка на иконку
 +
|
 +
|
 +
|}
 +
 +
'''Примеры Bid Response:'''
 +
 +
'''PUSH'''
 +
 +
'''1. Icon содержит в себе nurl и icon, отдельный вызов pixel (nurl) не требуется'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
<result>
 +
::<listing
 +
::::title="Looking for test?"
 +
::::url=<nowiki>"http://example.com/click"</nowiki>
 +
::::descr="Find test here!"
 +
::::bid="0.003"
 +
::::image=<nowiki>"http://example.com/5454.png"</nowiki>
 +
::::icon=<nowiki>"http://example.com/32434.png"</nowiki>
 +
::/>
 +
<result>
 +
|}
 +
 +
 +
'''2. С отдельным полем “pixel”'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
<result>
 +
::<listing
 +
::::title="Looking for test?"
 +
::::url=<nowiki>"http://example.com/click"</nowiki>
 +
::::descr="Find test here!"
 +
::::bid="0.003"
 +
::::pixel=<nowiki>"http://example.com/nurl"</nowiki>
 +
::::image=<nowiki>"http://example.com/5454.png"</nowiki>
 +
::/>
 +
<result>
 +
|}
 +
 +
'''CLICKUNDER'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
<result>
 +
::<listing
 +
::::url=<nowiki>"http://example.com/click"</nowiki>
 +
::::bid="0.003"
 +
::/>
 +
<result>
 +
|}
 +
 +
'''ON SITE PUSH (INPAGE)'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
<result>
 +
::<listing
 +
::::title="Looking for test?"
 +
::::url=<nowiki>"http://example.com/click"</nowiki>
 +
::::descr="Find test here!"
 +
::::bid="0.003"
 +
::::pixel=<nowiki>"http://example.com/nurl"</nowiki>
 +
::::image=<nowiki>"http://example.com/5454.png"</nowiki>
 +
::::icon=<nowiki>"http://example.com/32434.png"</nowiki>
 +
::/>
 +
<result>
 +
|}
 +
 +
'''IOS CALENDAR PUSH'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
<result>
 +
::<listing
 +
::::title="Looking for test?"
 +
::::url=<nowiki>"http://example.com/click"</nowiki>
 +
::::descr="Find test here!"
 +
::::bid="0.003"
 +
::::pixel=<nowiki>"http://example.com/nurl"</nowiki>
 +
::::image=<nowiki>"http://example.com/5454.png"</nowiki>
 +
::::icon=<nowiki>"http://example.com/32434.png"</nowiki>
 +
::/>
 +
<result>
 +
|}
 +
 +
'''NATIVE'''
 +
 +
{| class="wikitable" style="width: 85%;"
 +
|
 +
<result>
 +
::<listing
 +
::::title="Looking for test?"
 +
::::image=<nowiki>"http://example.com/5454.png"</nowiki>
 +
::::site=<nowiki>"http://example.com/click"</nowiki>
 +
::::url=<nowiki>"http://example.com/click"</nowiki>
 +
::::bid="0.003"
 +
::::pixel=<nowiki>"http://example.com/nurl"</nowiki>
 +
::/>
 +
<result>
 
|}
 
|}

Версия 11:03, 20 марта 2023

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

Интеграция

Узнать подробнее об интеграции по протоколам Feed и OpenRTB:

Bid Request/Response

Описание поддерживаемых параметров и примеры Bid Request/Response:


Процесс интеграции

1. Ознакомление с документацией.

2. SSP регистрирует аккаунт вебмастера в системе Kadam.

3. Kadam создает и выдает эндпоинт/фид под соответствующий формат рекламы и тип интеграции (для каждого отдельный).

4. Проводятся тесты на предмет работоспособности интеграции и наличия расхождений между данными системы Kadam и SSP. Тесты проводятся на “живых“ рекламных материалах.

5. Если расхождения в пределах нормы и отсутствуют технические проблемы, запускается интеграция в полноценном рабочем режиме.


Ключевые моменты

  • Чтобы подключить новую SSP, необходимо убедиться, что вы поддерживаете передачу необходимых параметров и готовы отправлять запросы и получать от нас ответы;
  • Клики без nurl не учитываются и попадают в traffic back;
  • В документе указаны параметры, поддерживаемые Kadam, если какие-то параметры не описаны, значит их поддержка не реализована.


Cookie Matching

Для чего необходим Cookie Matching:

  • позволяет избегать повторного показа рекламы пользователю;
  • может быть использована в предикте его интересов;
  • ретаргетинга.

С помощью Cookie Matching можно сопоставить id пользователя (по вашей версии), который просматривал ваш веб-сайт, с соответствующим id пользователя по версии Kadam.

Ознакомиться подробнее с возможными вариантами интеграции можно здесь. Для настройки Cookie Matching необходимо обратиться к менеджеру Kadam.

Feed интеграция

Feed интеграция

Эта документация объясняет, как рекламодатели могут интегрировать свои платформы с Kadam, используя стандарт Feed.


Bid Request/Response


Поддерживаемые типы рекламы:

  • Native;
  • Push;
  • On site push (inpage);
  • iOS calendar push;
  • Clickunder.

Feed Bid Request

Feed Bid Request

Описание поддерживаемых параметров


Следующие объекты следует отправлять в GET параметрах запроса:

Параметр Описание Использование Обязательный
sid endpoint ID Уникализация потока в Kadam. Выдается Kadam Обязательный
skey Ключ API Выдается Kadam
ua user agent Для определения ос, устройства, браузера пользователя на стороне Kadam Обязательный
ip IP-адрес пользователя Для определения геолокации устройства пользователя на стороне Kadam Обязательный либо IP, либо IPv6
uid ID пользователя в системе SSP Для уникализации пользователя Обязательный
limit Ограничение количества креативов в ответе Если лимит отсутствует в запросе и на блоке, считается как 1 по умолчанию
language Основной язык браузера, кодировка ISO 3166-1 alpha-2 Для определения языка браузера. Пример передачи: &language=ru-RU или &language=ru. Если параметр language не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп
subage / subage_dt / subage0 / subage_ts/ subage_ts_ms Возраст подписки пользователя Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (секунды в unixtime), subage_ts_ms - фактическая дата подписки (миллисекунды в unixtime) Обязательный для Push
pid ID паблишера В параметре ожидается ID паблишера (сайта, вебмастера) на стороне SSP Обязательный
cat IAB-категория домена По умолчанию на меинстриме - IAB24, на адалте - IAB25-3 Необязательный
page Домен страницы Ожидается страница Желательный
format Формат трафика Cu, pops - для кликандера;

Native, teaser - для тизера;

По умолчанию - push

Необязательный

Примеры Bid Request

PUSH

/feed

?sid=5

&skey=5azqxvgap5yNsm5X5rg5PMsgDD

&ua=Mozilla%2F5.0+%28Linux%3B+Android+9%3B+SAMSUNG+SM-A105FN%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+SamsungBrowser%2F12.1+Chrome%2F79.0.3945.136+Mobile+Safari%2F537.36

&ip=127.1.0.0

&uid=Xef5LfyUte-tzwpV5-fMV

&limit=1

&language=en

&pid=1

&subage=2

&cat=126

&page=example.com

CLICKUNDER

/feed

?sid=555

&format=cu

&ua=Mozilla%2F5.0+%28Linux%3B+Android+10%3B+SM-J600F%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F91.0.4472.88+Mobile+Safari%2F537.36

&ip=127.1.0.0

&uid=555555555

&limit=5

&language=fa-IR

&pid=5555555

&page=example.com

ON SITE PUSH (INPAGE)

/feed

?sid=5

&skey=5azqxvgap5yNsm5X5rg5PMsgDD

&ua=Mozilla%2F5.0+%28Linux%3B+Android+9%3B+SAMSUNG+SM-A105FN%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+SamsungBrowser%2F12.1+Chrome%2F79.0.3945.136+Mobile+Safari%2F537.36

&ip=127.1.0.0

&uid=Xef5LfyUte-tzwpV5-fMV

&limit=1

&language=en

&pid=1

&cat=126

&page=example.com

IOS CALENDAR PUSH

/feed

?sid=555

&skey=ca555555f555ec5a5a5ff55cc5b5fb5c

&ua=iOS%2F14.4+%5558D52%29+dataaccessd%2F1.0

&ip=127.1.0.0

&uid=0.00695555.5515680055292

&language=en

&subage_dt=2021-07-10

&pid=5555555555

&limit=1

NATIVE

/feed

?sid=555

&skey=b5cb555d5efcd555ade5555a5eaa5f55

&ua=Mozilla%2F5.0+%28Linux%3B+Android+11%3B+SM-T500%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F91.0.4472.120+Safari%2F537.36

&ip=127.1.0.0

&uid=5b5aa555-bd55-555b-a5d5-55f55f5c55df

&language=de

&pid=55

&page=example.com

&format=native

Feed Bid Response

Feed Bid Response

Описание поддерживаемых параметров (для изменения нейминга параметров в Bid Response обращайтесь к нашему менеджеру)

Параметр Описание Использование Обязательный
id ID материала
impid ID импрешна
crid (adid) ID креатива
nurl URL уведомление о выигрыше Возможно высылать:
  • Отдельным полем,
  • В составе icon_url ,
  • В составе image_url.

Переключение режима ответа происходит через менеджера.

link (click_url) Кликовая ссылка
campaing_id (cid) ID кампании
category ID категории (секции) материала
title Заголовок объявления
description (desc) Заголовок объявления
text Текст объявления
image_url Ссылка на изображение материала
icon_url Ссылка на иконку + nurl Используется в push-уведомлениях
cpc (price) Ставка (bid) материала
image Ссылка на картинку + nurl
result Объект ставок Используется в clickunder
listing Массив объектов ставок

result.listing

Параметр Описание Использование Обязательный
url Ссылка для перехода по объявлению
bid Ставка

Примеры Bid Response:

PUSH

1. Icon_url содержит в себе nurl и icon_url

[
{
"id": "5555555",
"impid": "5",
"crid": "555555",
"click_url": "https://example.com/h/np7hsxgf7znhtwwp372gm4eqzxbippulrjkgossribafyeqhafvgf56srptfmebrzi4563e2k6z442paphs5yoxrncznnt6l4hg7xjrf6bedf2sxw5uyculsxrj4drfsqkv3bne6v542iu6byszifk5qwspk66oukd23j24wkxpusyhqpjgpqoslhnt6mtkv3fjhtgkqhbeys4vgjvpzsutj3ri7prci6jk7dluasj7ymuj3jvvdhdsm5236vgsqwi56a262kvhmwzpr4wknkpwznuzuimkd62z5yvsczc2xiksxn5kscujilyfdeknrha7ddy3ar7lfhyrzwxwdvpsosthvpasvofnsohyggqvxquzsjjwgeajll5idilbnauyrwzrxlmwfcc3gozzve2i6mpjdushbgda2z33d5v5i7efiocwdavzkhrpjq6udllwuxmxqyz3k4y5judmw7sclxp727i7k4l2jr4cteiowgftdpvzvqy2ogeybkkqkbizge72wneoxs2s3pfnr6zl5picdgtjsmygxaucui2jkp37qr725biwqnannnymi6rntuuobhos6idagtcc2rm32btjlvzj3klxlt7fdv2d2xlohjbftmxrrpmpxq6te6osyt3runrjugyciu75fkgfv5q5g6t2lmfihqvc67aekvr36cpckgury?u=https%3A%2F%2Fexample.com%2Fgo%2F78602c30-54b0-4db5-bd07-3b2e3a804955%3Fcost%3D3.5%26clickid%3Dcnv4bd32b2809b6bbcfdac2ece8909839f7%26campaign_id%3D555120%26creative_id%3D4796823%26site_id%3D1375589855029800%26category_id%3D126%26country%3DRU%55browser%3DCHROME%26language%3Dru%26platform%3DANDROID%26subage%3D7%26feed%3D550279",
"campaign_id": 555555,
"category": "1368",
"title": "Такого вы еще не видели!",
"text": "Самые милые котята",
"image_url": "https://example.com/auto/492x328/image/vk/6523/855/rect_607c75584b589t1618755776r1279.png",
"icon_url": "https://example.com/nurl/552/nnme4yztlr7aqvzvlvgfkz2bmjvau6truwify55jzhuowviilfitubwzjy4vcgejx23othut2tk5eyby3hezfp2pdgzprdg6niuanxstmza75upsjvjx6ylykrjdqsljhyla6srjfyef4kzyjfutevspxnpna6kv3i4uh6jtrhquzukrrcue7aciwe4jmtw4ql2hvgkt4of7sc4djzfaij2hrrj66qmmgnle6kzbxb4uvlzzskv2e36cjgmir5lj7i4xnwjtkx3uuouypgwhb2cimpvfpnwgxlqilk5ny63grusxw3dlvyefvow4pnti3jlu5olakmwqofvrjmma6xey5ai3kr6eka46s25bkxsusyqffmioeouessypetejmn2hcvcshbewsms2b5nkfjkqbdo7uszjookluy2vcvk7i3ljjfutevspjoiw7mcwg7vew2pkkrhkwy4hw2o3covbnmvkmtkk5njxan3dlzyvqa3aflvwelwqk5diqsty6jkybrsaub56vn6zrnxlausmj5rfd2cq7m5os3mtzoh4yz7yprk6epfb6crotofj3fjmaue7yxf42mi=?1=1&data[]=16263451211203914908929689&v[]=3214290623&f=https%3A%2F%2Fexample.com%2Fauto%2F192%2Fimage%2Fvk%2F6823%2F823%2F607c73884b589t1655568776r1555.png",
"cpc": 0.031595385186374184
}

]

2. С отдельным полем “nurl”

[
{
"id": "5555555",
"impid": "5",
"crid": "555555",
"click_url": "https://example.com/h/np7hsxgf7znhtwwp372gm4eqzxbippulrjkgossribafyeqhafvgf56srptfmebrzi4563e2k6z442paphs5yoxrncznnt6l4hg7xjrf6bedf2sxw5uyculsxrj4drfsqkv3bne6v542iu6byszifk5qwspk66oukd23j24wkxpusyhqpjgpqoslhnt6mtkv3fjhtgkqhbeys4vgjvpzsutj3ri7prci6jk7dluasj7ymuj3jvvdhdsm5236vgsqwi56a262kvhmwzpr4wknkpwznuzuimkd62z5yvsczc2xiksxn5kscujilyfdeknrha7ddy3ar7lfhyrzwxwdvpsosthvpasvofnsohyggqvxquzsjjwgeajll5idilbnauyrwzrxlmwfcc3gozzve2i6mpjdushbgda2z33d5v5i7efiocwdavzkhrpjq6udllwuxmxqyz3k4y5judmw7sclxp727i7k4l2jr4cteiowgftdpvzvqy2ogeybkkqkbizge72wneoxs2s3pfnr6zl5picdgtjsmygxaucui2jkp37qr725biwqnannnymi6rntuuobhos6idagtcc2rm32btjlvzj3klxlt7fdv2d2xlohjbftmxrrpmpxq6te6osyt3runrjugyciu75fkgfv5q5g6t2lmfihqvc67aekvr36cpckgury?u=https%3A%2F%2Fexample.com%2Fgo%2F78602c30-54b0-4db5-bd07-3b2e3a804955%3Fcost%3D3.5%26clickid%3Dcnv4bd32b2809b6bbcfdac2ece8909839f7%26campaign_id%3D555120%26creative_id%3D4796823%26site_id%3D1375589855029800%26category_id%3D126%26country%3DRU%55browser%3DCHROME%26language%3Dru%26platform%3DANDROID%26subage%3D7%26feed%3D550279",
"campaign_id": 555555,
"category": "1368",
"title": "Такого вы еще не видели!",
"text": "Самые милые котята",
"image_url": "https://example.com/auto/492x328/image/vk/6523/855/rect_607c75584b589t1618755776r1279.png",
"icon_url": https://example.com/media/200x200/768cb8a8-f9c8-11eb-9d2b-901b0eb89438.jpg,
"nurl": https://example.com/nurl/552/nnme4yztlr7aqvzvlvgfkz2bmjvau6truwify55jzhuowviilfitubwzjy4vcgejx23othut2tk5eyby3hezfp2pdgzprdg6niuanxstmza75upsjvjx6ylykrjdqsljhyla6srjfyef4kzyjfutevspxnpna6kv3i4uh6jtrhquzukrrcue7aciwe4jmtw4ql2hvgkt4of7sc4djzfaij2hrrj66qmmgnle6kzbxb4uvlzzskv2e36cjgmir5lj7i4xnwjtkx3uuouypgwhb2cimpvfpnwgxlqilk5ny63grusxw3dlvyefvow4pnti3jlu5olakmwqofvrjmma6xey5ai3kr6eka46s25bkxsusyqffmioeouessypetejmn2hcvcshbewsms2b5nkfjkqbdo7uszjookluy2vcvk7i3ljjfutevspjoiw7mcwg7vew2pkkrhkwy4hw2o3covbnmvkmtkk5njxan3dlzyvqa3aflvwelwqk5diqsty6jkybrsaub56vn6zrnxlausmj5rfd2cq7m5os3mtzoh4yz7yprk6epfb6crotofj3fjmaue7yxf42mi=?1=1&data[]=16263451211203914908929689&v[]=3214290623
}

]

CLICKUNDER

{
"result": {
"listing": [
{
"url": "https://example.com/h/np6hsxhj6nnhthfoqdlwm4gwvso2j7w6rnkgoukribafyeqhafvgf3ojsdtfmebrzi42g3e2k6jlizxapgvmcoxrncznnt6lqhkyphjb6bedf2sxw5uyculsxrjyhu6565kl6sw2zlgjcufyjobpn2qp3nrvpuswkb3alwjqp33usyu5pjkffodwxeyfpp2jmsuhurosho55dgsxy5enno67kwjdxvohz7xuhglckn6fgupajk7mnpakvnrmk6v4ke43s2rt2zf7bz4l75jmepciporfor6cvh6xure6uvlhcm3wm4fwagd4armgaqyj6jospitg6v4x2dvxo3ath26ejtivdjnlkxiervfzkg2uuqrtcyrgcczpb5iweklyaayuanlhbmua6bzxoywvezkpgfrvskanbntxw7hbkj45yufrqhcdbr2njnqvawgrxhexnvbqih4juwmvpietxadsueykkse6mnd47blk3vf5mpqqow5wh4nzzwpyzqpy5qnvk4tllfaggzynpjiamzlzlpgktanyy3f2dvpwk5t4xdn3wvpqfyg76sikrmfut2xxsdgsxlstwuxoxh6khluhvow4osabgn2esq4rlnel2viqjnmytueuzrtwuzc4kmqpjyrvo2jliztjpbkffob7xgposdxpcfwze3q4tn3a====?u=https%3A%2F%2example.com%exmpl.php%3Fkey%3Dxg7fkmywgliayki699r7%26cpa%3Dcnv33ffc4f3aa8a53af5a9f357e1aad9147%26COST%3D7.555E-4%26SID%3D1378493167565870%26ID%3D4940809%26CID%3D511692%26CATID%3DIAB25-4",
"bid": 0.5023327916860582
}
]
}

}

ON SITE PUSH (INPAGE)

[
{
"id": "555555",
"impid": "5",
"crid": "555555",
"click_url": "https://example.com/h/npwxsxezwznhtbnm4tngo4gpv342t74aqnkgobcrkranjurzbflhuvi7vgzzb72shjo5c2fjkxtuvwofp7sfhe55ncffpt6l4hiir4xnvuv2cmyns5ficvuykvmnashgqtfy3mu6v6d2wu6ijdtijs4nwkpk7b5lko4ex34lu2lezqksn77faoqzewbfiuptmni3kvsshdevnqsuj2zwgwhyk7vi4z7bghzpu75bkov5bjh4ic5tcwci3kovc642ahmjo2hkauuuvokt5oo27gkprey76tndmji7qufq5ke64nggjnfhgk3q66ezgs3zuwufcu3aobtbiu3iimytqnuhimes5ucvqehps2ekynekgyedj2xfggzka5cgak3zkm2euzjwbeufyctgfqwqozq6nrras7s7avth46ifmupde2vyjnuluvhmsdfffrkwa5btquhxktxsra3lwblikme4nnts2ptsqrjkydc6as4wx5pc77wljjnp6rnse7ddhqrscicmmffwkzqppvnqg33wloaltin63trjnwchp3h7dz52pqcjdnv5rhh2tmfutzisbvgqsqnqtjxcyf4ugvdqfjremyllak2j3c7gkzbe6wrzkg5ai5xx3ztgs6cuklmbrunm5ehokjvrljgmpldw?u=https%3A%2F%2example.com%2F%3Fp%3Dgu3donzxgq5gi3bpgqztqnq%26sub1%3Dcnv6d22d21d1a580cff6f855567012d5ff8",
"campaign_id": 555555,
"category": "1096",
"title": "Такого вы еще не видели!",
"text": "Самые милые котята",
"image_url": "https://example.com/auto/492x328/image/vk/499/499/rect_60daf0b6704d4t1625551206r7408.jpg",
"icon_url": "https://example.com/nurl/411/nnmeay3hlewvaaddlvgfk2kjmrtac4dr7hmfy26wvlj4kvaijvi3fvsodp5fgia3glm2bmgy3ckzjubfcc3ib6gon5bnn5onrnkaakwyhekgdemn4rexstsjkrjdrkjyrlehac3adadciwcbjfutevspjoiw76cvkoyeqy5ck6oh3ukr56vezaciue5jmtxixl5xvgktnuzbqc4dj3vqfmsdrrj66qmmgpmy3ps5xb4uvlzzdqjeg36cjg2qq5di7i4xnwjtkx3uuouypg2fj2cimpvfpqh57sjidk5ny63grusxyd67zeubvow4pnti3jlu5olakmwqofvrjmma6xey5ai3kr6eka46g2zramoa7uks73w2fykovmyherslmfijqbpkuz3hrharvzuxtrpmnmj2duhqtpdpa6s6af4fiuryjfu4e2mhjecie6suwi5ivz6gw2zljhvpq5k3uos6teyfprkinfueqnrqluuawvxwjq24su3z4ritb4lkrlqgdc3c6tgwbir3tlw4jesgzfsv476fvy4uvj3bw2iuvoiddzk4ephanojfflmzuhlx57cwhh4w3bnm4tnnpoojk3vdzt6qykhuq===?1=1&data[]=162635197027883121278693&v[]=1870629555&f=https%3A%2F%2Fexample.com%2Fauto%2F192%2Fimage%2Fvk%2F499%2F499%2F60daf0b6555d4t1624961206r7408.jpg",
"cpc": 0.00027081758307758715
}

]

IOS CALENDAR PUSH

1

[
{
"click_url": "https://example.com/h/np3hsxhw5bnhts4bz3lga4ebqpj2lchnrbkgpfdamd4fm2vyleuq2hsmdpnnbogtkricz4jtt5e6gye67zooeomp7yyo4twl4hiprrfnukmxvusxigrwb77x3x6dvolitxm4nzld2b5n5tncsskm3knqwrqma6sw6i5fdqzqkqpqbuksm2mvaocjdfz2mtkitfjf3vcr3ohc5osvshusned3sl6k4af3gfjewwtckgqfp5pk44h5evpgjgevg6ouk2b4tknvkdpu6yccbroj7k7enmri5qsupfivqsqshemwg2s4f7igwoerkp5dtsofgxte5bphlcifluuuj2jtg5jmeultkhdcgmfhwxydmn6c6ulgdjqdcdl7bqagoljpkftrsmrtlexv4b6wjvfosuvvy77tv5dl6h5r64vekk4vh4ietrv7d6y7okivfefbxgc2twonynbfcjk2mbshycdzl4fwc6l7kz7esytdbv7vcatgpv7fg2kkisc6ttu6ws5jdd76kfinjlum6bvxavg5jayyjp6ivxalnfwnvfhbhyos2qddflh544ahiskdrblurpkvcbfvtcowr7ggo2telrjsbsofgv3idtljnf4fiuuy2dyix2iodhmu4bn5osexm===?u=https%3A%2F%2example.site%2Fexmpl.php%3Fkey%3Dc3ocgvxj64wn27evtfx6%26click_id%3Dcnved6a255553d06b4c56e21bd07afaaf75%26cost%3D0.0013490979%26SID%3D1381141552589817%26ID%3D4934093%26CID%3D509656%26RID%3D223%26CATID%3DIAB25-3%26TGTXT%3D%26SUBAGE%3D6%26BID%3D321572",
"nurl": "https://example.com/nurl/841/nnmb2nzxbyvfybbxlvgfk2klmbrac6trs2dfy24yq744suyizfvqvvs7doufmielknmj5ofvuhe2pp4u45ktva6jvg2vap6ltxsmcvrk2fhogmydi6dpf7l2jrgassljgl3nnuwyn44fkgwrjymtql2pjnqva6cuuid4s2bt3zhed4kr7d4flcciwg7ut52k7jnlqvm7vpsgx72xrttdc2nnkwjt72sv25lyfb5nnwifktgfjcvj6btw4nqg7scvkhueqz7kk7qmj2h6pk2fhf6g4cofjj2kmcrhsvyhnmg6ambhoja3n4yiwfw2qs3isjkn2sglkj5qcal47fv3rsovs2ok7b5lvu4yw2ywl5huwypq4hg6wb2yhofeqmvci7quofmktm4wix6iaj2daudykrjdqsmzbwpe2lvtkj4iyub2vfv6neotwsm27b5lvu42c2zk3rgegateje3dmcjibsjfljsmzfjxxzcrdxywvumrbcfwfdw2cordxd6huqp42t3fkruvou5ijxadb5sl6dqzb72s7i6erwjwv6mmv7er7txfbacn4ow4zevwt2xypk2t?1=1&data[]=16263414351155619727343372&v[]=3620955548",
"title": "Такого вы еще не видели!",
"description": "Самые милые котята",
"price": 0.0009038956149015577
}

]

2

[
{
"id": "5555555",
"click_url": "https://example.com/h/np6hsxgn5fnhts7urcogm4eb62k67px2rbkgovcr2b5gzuribflhuvi7slly772shjo5c2gukdtuvsw5odsfhd6tnoffpt6l4hior65gyaz2cm2ys5fgbmdzlk5dtdvsrpf3hne6v6dvlirzt2g7fjsmznr2jync4y5ns2zz6zgvhs2spidrpcclo77vit2lyeiiqvsrybfuzmsv22u4gupqk7ukb2ti6jk6vtv4wz4ymujzjcytdyxizssvvgcx3u5kc2rt2zfzfv4p75jmepcipn6f5ff7znjgrjveefiwqesib5fdcwralyziaqibjt7e5hh5k7efl6nvigathaotjtqve6o4kdr33qzq5ngre6toicivanmbw4eygtispjxebjcq4dez7tneupsi7c3zjykde2k5kazxw6crmfeg2mabfvoqmzd7pyageslfgegx6uahg57hub3idrcmth6jrshprv6qnj4priuzzjgswmgojqn65px345iwbspltycc7x6v3zfhmvrqg5muy7snpo4onj6tkqbfkyjtj2mnoztq2pmvuakjnezbm7dyulxtsmzulyhtpchpoa======?u=https%3A%2F%2Fexample.info%takogo-vi-eshe-ne-videli",
"campaign_id": 555555,
"category": "1080",
"title": "Такого вы еще не видели!",
"text": "Самые милые котята",
"image_url": "https://example.com/auto/492x328/image/vk/7371/371/rect_60cda4dada569t1655589818r9023.jpg",
"icon_url": "https://example.com/nurl/870/nnmbsntfbawvwc3flvgfk2cbmnqq66drvwdvy24y6k7ygviizfvqvvs7dodvmiclgkr652ox5lq5h6s3ccg6jz6on5bnnomasnkaakwyheowd2nc4vexstsjkrjdqck2agkxac3adadciwcbjfutevspjoiw76cvkoyeqy5ck6mnozxapgtkiiprncff5d2kxksnevu7heiheddotjfgzgfgn63ttu7qfnukost7vv4q2sigohatg2p7jjroq6k2ti4urojtlcluvjulyhe25r5ws3gvpl2kw22lrjcr2begrqcxjqpdefhrkyrqkq56setku5hrkj47iufajlbtavi2das6a6vazphp227qkrvueykqpakgcc4kkyrtckjne4hmf3lnpfomo5phrjito3zjkrjdqsljgkthba3dgwvfmuxajnrnevgauxrog654kaqmg2r2mn7xguruie3ddgckc6nfkth3mj24av6l3lvwr4sv6xj4eumik7333fepgpkewstayb6nwueyjwyijcoijxevi6pek3a6xlxfuhopcy7ipsqmxtx5nm======?1=1&data[]=16268562813881280618918804&v[]=3780696939&f=https%3A%2F%2Fexample.com%2Fauto%2F192%2Fimage%2Fvk%2F7371%2F371%2F60cda4dada569t1624089818r9553.jpg",
"cpc": 0.001349156436044723
}

]

NATIVE

[
{
"id": "5555555",
"url": "https://example.com/h/npvxsxge6nnhtrfmt3ijvl4hvowts2m7zcd5jigt5f5hysqilfituftqanrabyvw5w7u6akxzzhkgzhypge22p7zndhmktptmdiprvgs3dt7nchfj2bwac5akwvbvklihg7e5qegvtvflirzykhm5rcoznryhbhd23d3nfwnvfhnwy2t3blfdeslnn3bh72jnpuhuvm7hjewseqxx5eurkd2i3jdxd67trl4oshi6lgfler3tdnye7m5jbtue7b4gq7uvmjrxgsm55k5tbl4oovbniz2mtck4fkofnxnx5h7snsxlujwt3wkznicrjf3f5he423lcb4qiwdaime5kxrhujtpq6n42e77s2hpvfekgyfy7nj5eosi4eyor7oumpwxv7o45nz2ymbcbdxf7gd2qnno2s4l4wuhlltdaep7u3wijpa776ntygw5ndjkjb7ugtikgr6cuadfjzqh6wrnlucxw6t7kazfknlalr7uiadgff6vmnsig5qq6lipek573u5u2kmodrqomhuzj6nrj4y2jrm5sy7rd2nq7iosxb7m4pgvggspmhkf475cmz4huzgi3l3o4ndmknbwaseq25krrfewgvxu6s3b6dq43g4hba5yusbsujdzcry=?u=https%3A%2F%2Fexample.com%2Ftrack%3Fc%3D724872%26subid%3D1378335325453686%26subid2%3D320918",
"cid": "555555",
"title": "Самые милые котята",
"image": "https://example.com/nurl/744/nnmea3ddbf5vcb3dlvgfkz2inrsa66lrusovy24xvku47kohw2lm2v37lnmvqkf4k5qfcco74tlz5y5qzxagiugtrog5csj34h3npkswicxwdocxcbb57yxhkzfde6djgjlo7uxytfdriu3qubxeexbwjnqva6cuklehn2jtk7duu26apg6ncp7zndpyiuxtmc3xbfctq357mme3j3ro7a2cqfjuydwmbshe5hdjwv4zthtuo6atgxfsjkbypbto345bqdu4nltuuxxapfl6uoisuez243m3mbn2avoz3627wm5wj3ainlhkkw5dsse3gnkrugbf3f5ck3zst3fefm3q3nrvduswkfwrulmcksolpvwuq6v23r5wndyfi22cmfihr5glugafmiye65krzok6svwxteokijnsfvj4n4uviuryjfutfjtqqnrtlkswklqew2wsks57nkeup66fao5znmz5ytcda5tesnzwbb4ftesvuzgmsu2r4risv4lk6tqocsvbkpy7nzrzxfvohzh7mdrvi7sgkzic63rryzf54y6iprk7epgtrog5cspdmvi4qufeykmpfwpe6ze5svflvds3znuwzwu3asq=?1=1&data[]=16263375622729284407226739&v[]=3405945929&f=https%3A%2F%2Fi.example.com%2Fauto%2F492x328%2Fimage%2Ftesr%2F8670%2F670%2Frect_603e5e46360eat1614700102r2091.gif",
"cpc": 0.0018077912298031153
}

]

OpenRTB интеграция

OpenRTB интеграция

Эта документация объясняет, как рекламодатели могут интегрировать свои платформы с Kadam, используя стандарт OpenRTB.

Bid Request/Response

Поддерживаемые типы рекламы:

  • Native;
  • Native (teaser);
  • Banner;
  • Push;
  • On site push (inpage);
  • iOS calendar push;
  • Clickunder;
  • Video.

OpenRTB Bid Request

OpenRTB Bid Request

Описание поддерживаемых параметров

Следующие объекты следует отправлять в кодировке JSON в request body:

Параметр Описание Использование Обязательный
id Уникальный идентификатор аукциона Обязательный
at Тип аукциона. Для SSP, работающих по CPC, всегда проходит аукцион первой цены Для аукциона первой цены at=1.

По умолчанию 2 - Second Price

Необязательный
cur Валюта аукциона. Допустимые значения:

RUB — российский рубль;

USD — американский доллар

По умолчанию используется валюта SSP Необязательный
imp Массив объектов: требования к рекламным материалам для размещения Используется для подбора релевантных требованиям материалов Обязательный
site Данные о сайте в объекте site Обязательный site или app
app Подробная информация о приложении Обязательный site или app
user Данные о пользователе в объекте user Обязательный
badv Список доменов, которые необходимо исключить из аукциона Необязательный
bcat Заблокированные категории рекламодателей, использующие категории контента IAB
device Данные об устройстве пользователя в объекте device Обязательный

imp

Параметр Описание Использование Обязательный
id Уникальный идентификатор показа Обязательный
secure Тип соединения. Возможные варианты:

0 — указывает, что нужно подбирать материалы доступные и по http и https протоколам.

1 — указывает, что нужно подбирать материалы доступные только по https

Значение по умолчанию - “https” Необязательный
bidfloor Минимальная стоимость показа По умолчанию 0 Необязательный
bidfloorcur Валюта стоимости показа По умолчанию USD, валидные значения в ISO-4217 Необязательный
tagid Идентификатор конкретного плейсмента объявления или рекламного тега, который был использован для инициирования аукциона Рекомендуется
ext Дополнительные параметры
native Параметр для Native и Push форматов, где необходимо передавать ассеты (заголовки, описание, картинки, иконки и т.д) Обязательный для Native, Push
banner Параметр для формата Banner Обязательный для Banner Ad
video Параметр для формата Video Обязательный для Video Ad
instl Валидные значения:

1 - полноэкранная реклама (interstitial),

0 - нет

По умолчанию 0 Необязательный
battr Заблокированные параметры Необязательный

imp.ext

Параметр Описание Использование Обязательный
subage / subage_dt / subage0 / subage_ts Возраст подписки пользователя Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (unixtime) Обязательный для Push Ad

imp.native

Параметр Описание Использование Обязательный
request Запрос в кодировке JSON для Push и Native материалов Варианты:

openrtb.native.string - JSON текст запроса;

openrtb.native - запрос является JSON объектом. Он аналогичен openrtb.native.string, только в случае строки запрос кодируется в JSON текст

Обязательный
ver Версия спецификации нативной рекламы, которой соответствует запрос

imp.native.request

Параметр Описание Использование Обязательный
plcmtcnt Количество одинаковых размещений в этом шаблоне

imp.banner

Параметр Описание Использование Обязательный
w Ширина баннера в пикселях Обязательный либо “w” и “h”, либо “format”
h Высота баннера в пикселях Обязательный либо “w” и “h”, либо “format”
format Массив объектов, представляющих допустимые размеры баннера Обязательный либо “w” и “h”, либо “format”

imp.video

Параметр Описание Использование Обязательный
mimes White-лист поддерживаемых типов контента MIME-type Например: "image/jpg", "image/gif" и "application/x-shockwave-flash" Обязательный
minduration Минимальная длина видео в секундах
maxduration Максимальная длина видео в секундах Обязательный
protocols Версии протокола. Допустимые значения:

1 — VAST 1.0;

2 — VAST 2.0;

3 — VAST 3.0;

4 — VAST 1.0 Wrapper;

5 — VAST 2.0 Wrapper;

6 — VAST 3.0 Wrapper

Обязательный
w Ширина видео в пикселях Обязательный
h Высота видео в пикселях Обязательный
startdelay Задержка запуска в секундах для размещения рекламы до, во время или после прокрутки
linearity Указывает, должен ли оттиск быть линейным, нелинейным и т.д. Если ничего не указано, предполагается, что разрешены все Примеры:

LINEAR = 1: Linear/In-stream;

NON_LINEAR = 2: Non-linear/Overlay

api Список поддерживаемых API

site

Параметр Описание Использование Обязательный
id Уникальный идентификатор сайта Для уникализации сайта, создания black- или white-листов партнерами Обязательный
domain Домен страницы Для внутренней классификации доменов в системе Kadam Обязательный
page Полный адрес страницы Для внутренней классификации сайтов в системе Kadam Рекомендуемый
name Название сайта
publisher Данные о владельце сайта
content Подробная информация о содержимом сайта
cat Список IAB категорий сайта. Массив строк Можно не передавать, если заполнен параметр domain, так как Kadam ведется внутренняя классификация доменов Рекомендуемый
ext Дополнительные параметры сайта

site.publisher

Параметр Описание Использование Обязательный
id Уникальный идентификатор сайта

app

Параметр Описание Использование Обязательный
id Уникальный идентификатор приложения Для уникализации приложения, создания black- или white-листов партнерами Обязательный
domain Домен приложения. Например, “Foo.com” Для внутренней классификации доменов в системе Kadam Обязательный
page Полный адрес страницы Для внутренней классификации сайтов в системе Kadam
name Название приложения или псевдоним паблишера
bundle Уникальный ID приложения для конкретной платформы. Примеры:

IOS - 1453331063

Android - com.foo.mygame

storeurl App store URL установленного приложения
cat IAB-категория страницы Можно не передавать, если заполнен параметр domain, так как Kadam ведется внутренняя классификация доменов Рекомендуемый
ver Версия спецификации нативной рекламы, которой соответствует запрос
publisher Данные о владельце приложения
ext Дополнительные параметры приложения

app.publisher

Параметр Описание Использование Обязательный
id Уникальный идентификатор владельца приложения
name Имя владельца приложения

user

Параметр Описание Использование Обязательный
id Уникальный идентификатор пользователя в системе Если не заполнен, то Kadam генерирует самостоятельно
buyeruid Уникальный идентификатор пользователя в системе Kadam Используется, если настроен Cookie Matching. Является приоритетней user.id
yob Год рождения в виде целого 4-значного числа
gender Пол "M" = мужчина;

"F" = женщина;

"O" = неизвестно

ext Дополнительные параметры пользователя

user.ext

Параметр Описание Использование Обязательный
consent Строка согласия IAB Transparency and Consent Framework (TCF) v2, полученная от платформы управления согласием (CMP) паблишера. Структура строки определяется IAB TCF v2 Это поле будет заполнено, если издатель интегрирован с CMP для TCF v2, и эта CMP указывает, что GDPR применяется к данному рекламному запросу и предоставляет действительную строку согласия

device

Параметр Описание Использование Обязательный
ifa Уникальный идентификатор устройства в формате UUID Если имеется в реквесте, используется в качестве user.id Необязательный
geo Геолокация устройства пользователя Необязательный
ip Ближайший к пользователю IPv4 адрес Для определения геолокации устройства пользователя на стороне Kadam Обязательный либо IP, либо IPv6
ipv6 Ближайший к пользователю IPv6 адрес Для определения геолокации устройства пользователя на стороне Kadam Обязательный либо IP, либо IPv6
ua User agent Для определения ос, устройства, браузера пользователя на стороне Kadam Обязательный
js Поддержка JS. 1 - присутствует, 0 - отсутствует
language Основной язык браузера, кодировка ISO-639-1-alpha-2 Для определения языка браузера. Пример передачи: &language=ru-RU или &language=ru. Если параметр language не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп

device.geo

Параметр Описание Использование Обязательный
utcoffset Количество часов, на которое смещен часовой пояс от UTC
country Код страны (по стандарту ISO-3166-1 Alpha-3)

ext

Параметр Описание Использование Обязательный
bsection Используется для указания категорий материалов, которые запрещены в рамках данного реквеста. Целочисленный вид Для получения полного списка категорий необходимо обратиться к менеджеру Необязательный
btags Используется для указания тегов материалов, которые запрещены в рамках данного реквеста. Целочисленный вид Для получения полного списка тегов необходимо обратиться к менеджеру Необязательный

Примеры Bid Request

CLICKUNDER

{
"id": "5ccab55d-a5a5-5555-5e55-aa5b5b55b5a5",
"buyeruid": "htrhr651615616d1h6",
"at": 1,
"imp": [
{
"id": "555555555",
"instl": 1,
"secure": 0
}
],
"site": {
"id": "555555",
"domain": "example.com",
"cat": [
"IAB25-3"
],
"page": "http://example.com",
"ext": {
"exchangecat": 555,
"idzone": "5555335"
}
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 10; M2006C3LG) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.120 Mobile Safari/537.36",
"ipv6": "3b03:1756:ol1e:a100:1571:8bp1:f36:1d8f",
"ifa": "5974d090-4516-4565-933d-69c79c9abf75",
"geo": {
"country": "UKR",
"utcoffset": 7
},
"language": "ru",
"os": "Android",
"js": 1,
"ext": {
"remote_addr": "95.57.58.198",
"x_forwarded_for": ""
}
},
"user": {
"id": "55f7d5acada5b5.555555555555555555",
"yob": 1990,
"gender": "M",
"ext": {
"consent": "1",
}
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

PUSH

{
"id": "5",
"at": 1,
"cur": [
"USD"
],
"tmax": 150,
"imp": [
{
"id": "5-5",
"secure": 1,
"bidfloor": 0.001,
"bidfloorcur": "USD",
"native": {
"ver": "1.1",
"request": "{\"ver\":\"1.1\",\"layout\":1,\"adunit\":2,\"plcmtcnt\":1,\"assets\":[{\"id\":5,\"required\":
1,\"title\":{\"len\":45}},{\"id\":2,\"required\":1,\"img\":{\"type\":1,\"wmin\":192,\"hmin\":
192,\"mimes\":[\"image/jpeg\",\"image/png\"]}},{\"id\":3,\"required\":1,\"data\":{\"type\":
2,\"len\":40}},{\"id\":4,\"required\":0,\"img\":{\"type\":3,\"wmin\":360,\"hmin\":240,
\"mimes\":[\"image/jpeg\",\"image/png\"]}},{\"id\":5,\"required\":0,\"data\":{\"type\":12}},
{\"id\":6,\"required\":0,\"data\":{\"type\":12}}],\"plcmttype\":4}"
}
"ext": {
"subage": 2}
}
],
"site": {
"id": "5",
"domain": "example.com",
"page": "https://example.com/ru/",
"name": "exmp-1",
"publisher": {
"id": "5"
},
"cat": [
"IAB3-1"
]
},
"device": {
"ip": "127.1.0.0",
"ifa": "5974d090-4516-4565-933d-69c79c9abf75",
"ua": "Mozilla/5.0 (Linux; Android 9; Redmi 6A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Mobile Safari/537.36",
"geo": {
"country": "AT",
"utcoffset": 7
}
},
"user": {
"id": "Xef5LfyUte-tzwpV5-fMV",
"yob": 1990,
"gender": "M",
"ext": {
"consent": "1",
}
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

ON SITE PUSH (INPAGE)

{
"id": "5",
"at": 1,
"cur": [
"USD"
],
"tmax": 150,
"imp": [
{
"id": "5-5",
"secure": 1,
"bidfloor": 0.001,
"bidfloorcur": "USD",
"native": {
"ver": "1.1",
"request": "{\"assets\":[{\"title\":{\"len\":50},\"id\":5,\"required\":1},{\"id\":2,\"img\":
{\"w\":200,\"hmin\":200,\"type\":3,\"wmin\":200,\"h\":200},\"required\":1}],\"ver\":1.1}"
}
}
],
"site": {
"id": "5",
"domain": "example.com",
"page": "https://example.com/ru/",
"name": "exmpl-5",
"publisher": {
"id": "5"
},
"cat": [
"IAB3-1"
]
},
"device": {
"ip": "127.1.0.0",
"ifa": "5974d090-4516-4565-933d-69c79c9abf75",
"ua": "Mozilla/5.0 (Linux; Android 9; Redmi 6A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Mobile Safari/537.36",
"geo": {
"country": "AT",
"utcoffset": 7
}
},
"user": {
"id": "Xef5LfyUte-tzwpV5-fMV",
"yob": 1990,
"gender": "M",
"ext": {
"consent": "1",
}
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

NATIVE (TEASER)

{
"id": "5",
"at": 1,
"cur": [
"USD"
],
"tmax": 150,
"imp": [
{
"id": "5-5",
"secure": 1,
"bidfloor": 0.001,
"bidfloorcur": "USD",
"tagid": "123123-123",
"instl": 0,
"native": {
"ver": "1.1",
"request": "{\"assets\":[{\"title\":{\"len\":50},\"id\":5,\"required\":1},{\"id\":2,\"img\":
{\"w\":200,\"hmin\":200,\"type\":3,\"wmin\":200,\"h\":200},\"required\":1}],\"plcmtcnt\":8,\"ver\":1.1}"
}
}
],
"site": {
"id": "5",
"domain": "example.com",
"page": "https://example.com/ru/",
"name": "exmpl-5",
"publisher": {
"id": "5"
},
"cat": [
"IAB3-1"
]
},
"device": {
"ip": "127.1.0.0",
"ifa": "5974d090-4516-4565-933d-69c79c9abf75",
"ua": "Mozilla/5.0 (Linux; Android 9; Redmi 6A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Mobile Safari/537.36",
"geo": {
"country": "AT",
"utcoffset": 7
}
},
"user": {
"id": "Xef5LfyUte-tzwpV5-fMV",
"yob": 1990,
"gender": "M",
"ext": {
"consent": "1",
}
},
"ext": {
"bsection": [
1001
],
"btags": [
16,
14,
4
]
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

NATIVE APP

{
"at": 2,
"cur": [
"USD"
],
"device": {
"devicetype": 4,
"geo": {
"country": "UKR",
"lat": 50.4522,
"lon": 30.5287,
"type": 2
},
"ip": "127.1.0.0",
"js": 1,
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.1 Mobile/15E148 Safari/604.1",
"language": "uk"
},
"id": "e555e555-5bb5-55f5-55ce-555faf555555",
"imp": [
{
"tagid": "5553",
"bidfloor": 0.01,
"bidfloorcur": "USD",
"id": "fec5a5a555",
"native": {
"request": "{\"ver\":\"1.1\",\"plcmttype\":4,\"plcmtcnt\":2,\"assets\":[{\"id\":5,\"required\":1,\"title\":{\"len\":100}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"w\":400,\"h\":400}},{\"id\":3,\"data\":{\"type\":2,\"len\":200}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}]}",
"ver": "1.1"
},
"secure": 1
}
],
"site": {
"cat": [
"IAB12",
"IAB12-1",
"IAB12-2",
"IAB12-3"
],
"domain": "example.com",
"id": "5555",
"name": "example.com",
"page": "https://www.example.com/",
"Content": {}
},
"tmax": 500,
"user": {
"id": "5f5ab5ca-5555-55a5-555f-d5f5f5c55555"
},
"ext": {
"audit": {
"id": 5
},
"shown": null,
"reload_count": 0
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

BANNER

{
"id": "5",
"at": 1,
"cur": [
"USD"
],
"tmax": 150,
"imp": [
{
"id": "5-5",
"secure": 1,
"bidfloor": 0.001,
"bidfloorcur": "USD",
"banner": {
"w": 640,
"h": 360,
"format": [
{
"w": 300,
"h": 50
},
{
"w": 468,
"h": 60
}
]
},
"instl": 0,
"tagid": "123123-123"
}
],
"site": {
"id": "5",
"domain": "example.com,",
"page": "https://example.com,/ru/",
"name": "exmpl-5",
"publisher": {
"id": "5"
},
"cat": [
"IAB3-1"
]
},
"device": {
"ip": "127.1.0.0",
"ifa": "5974d090-4516-4565-933d-69c79c9abf75",
"ua": "Mozilla/5.0 (Linux; Android 9; Redmi 6A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Mobile Safari/537.36",
"geo": {
"country": "AT",
"utcoffset": 7
}
},
"user": {
"id": "Xef5LfyUte-tzwpV5-fMV",
"yob": 1990,
"gender": "M",
"ext": {
"consent": "1",
}
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

BANNER APP

{
"id": "b5b555f555f555a5",
"imp": [
{
"id": "5",
"banner": {
"format": [
{
"w": 320,
"h": 50
}
],
"w": 320,
"h": 50,
"battr": [
6,
7
],
"api": [
3,
5,
7
]
},
"bidfloor": 0.004724,
"bidfloorcur": "USD",
"secure": 1
}
],
"app": {
"id": "555555555",
"name": "Example",
"bundle": "5555555555",
"domain": "example.com",
"storeurl": "https://apps.apple.com/us/app/example/id555555555?uo=4",
"cat": [
"IAB1-6"
],
"ver": "3.1",
"publisher": {
"id": "555555555",
"name": "Ivan Ivanov"
}
},
"device": {
"ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
"geo": {
"type": 2,
"country": "DEU",
"region": "NW",
"city": "Bielefeld",
"zip": "33602"
},
"dnt": 1,
"lmt": 1,
"ip": "127.1.0.0",
"devicetype": 4,
"make": "apple",
"model": "iphone",
"os": "iOS",
"osv": "14",
"js": 1,
"language": "en",
"carrier": "Exfone Pable",
"connectiontype": 2
},
"user": {
"ext": {
"consent": "1"
}
},
"at": 1,
"tmax": 586,
"cur": [
"USD"
],
"regs": {
"coppa": 0,
"ext": {
"gdpr": 1
}
},
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

VIDEO

{
"id": "5",
"at": 1,
"cur": [
"USD"
],
"tmax": 150,
"imp": [
{
"id": "5-5",
"secure": 1,
"bidfloor": 0.001,
"bidfloorcur": "USD",
"video": {
"mimes": [
"video/mp4"
],
"minduration": 1,
"maxduration": 60,
"protocols": [
2,
3,
5,
6
],
"w": 640,
"h": 360,
"startdelay": 0
}
"instl": 0
}
],
"site": {
"id": "5",
"domain": "example.com,",
"page": "https://example.com,/ru/",
"name": "exmpl-5",
"publisher": {
"id": "5"
},
"cat": [
"IAB3-1"
]
},
"device": {
"ip": "127.1.0.0",
"ifa": "5974d090-4516-4565-933d-69c79c9abf75",
"ua": "Mozilla/5.0 (Linux; Android 9; Redmi 6A) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.131 Mobile Safari/537.36",
"geo": {
"country": "AT",
"utcoffset": 7
}
},
"user": {
"id": "Xef5LfyUte-tzwpV5-fMV",
"yob": 1990,
"gender": "M",
"ext": {
"consent": "1",
}
},
"bcat": [
"IAB24",
"IAB25",
"IAB26"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

VIDEO APP

{
"id": "555d5555-d555-5555-a555-5e555555fda5",
"imp": [
{
"id": "i555d5555-d555-5555-a555-5e555555fda5",
"video": {
"mimes": [
"video/mp4"
],
"minduration": 1,
"maxduration": 60,
"protocols": [
2,
3,
5,
6
],
"w": 640,
"h": 360,
"startdelay": 0,
"linearity": 1,
"pos": 1,
"api": [
1,
2
]
},
"instl": 0,
"bidfloor": 0.65,
"bidfloorcur": "USD",
"secure": 1
}
],
"site": {
"id": "555",
"domain": "example.com",
"cat": [
"IAB1-5"
],
"page": "https://example.com/",
"publisher": {
"id": "555"
}
},
"device": {
"ip": "127.1.0.0",
"ua": "Mozilla/5.0 (Linux; Android 9; SAMSUNG SM-A105FN) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/14.2 Chrome/87.0.4280.141 Mobile Safari/537.36",
"language": "ru",
"geo": {
"country": "ESP"
}
},
"user": {
"id": "a555555f-a5d5-55ab-555f-f55c555d555c"
},
"at": 2,
"tmax": 300,
"cur": [
"USD"
],
"badv": [
"example.com",
"example.ru",
"example.net"
]

}

OpenRTB Bid Response

OpenRTB Bid Response

Описание поддерживаемых параметров

Параметр Описание Использование Обязательный
id ID bid request
cur Валюта ставки (с использованием ISO-4217)
seatbid Массив seatbid объектов

seatbid

Параметр Описание Использование Обязательный
bid Массив bid объектов
seat ID покупателя, от имени которого

делается ставка

group 0 = можно выиграть в индивидуальном порядке;

1 = должны быть выиграны или проиграны группой

По умолчанию 0

seatbid.bid

Параметр Описание Использование Обязательный
id ID ставки
adid ID предварительно загруженного объявления Будет использовано, если ставка выиграет
crid Creative ID Помогает в проверке качества рекламы
impid ID объекта Imp в соответствующем запросе ставки
price Цена предложения, выраженная как CPM
nurl URL уведомление о выигрыше Вызывается в случае выигрыша ставки
burl URL биллинг-уведомление Если партнер поддерживает burl, то для его включения необходимо обратиться к менеджеру. По умолчанию отсутствует
lurl URL уведомление о проигрыше Вызывается SSP, когда известно, что ставка была проиграна. Прежде чем включить передачу lurl, необходимо обсудить с менеджером Kadam реакции на коды. Возможные реакции: бан для tagid, site.domain, site.id, целиком для интеграции.
adomain Домен рекламодателя для проверки списка блоков (например, "ford.com") Это может быть массив для случая ротации креативов. Биржи могут установить, что разрешен только один домен
cat IAB категория креатива
adm Средство передачи рекламной разметки в случае выигрыша ставки
w Ширина креатива в независимых от устройства пикселях Используется по умолчанию при ответе баннером
h Высота креатива в независимых от устройства пикселях Используется по умолчанию при ответе баннером

Примеры Bid Response

CLICKUNDER

{
"id": "5ccab55d-a5a5-5555-5e55-aa5b5b55b5a5",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "5555555",
"crid": "5555555",
"impid": "555555555",
"price": 1.9711000061035155,
"nurl": "https://example.com/nurl/863/nn2eqnzrlevvuarsmivfimkopfta27s5d5xcu7krpumtkzs2pufqkybnp4agg2stmyaxwxqkmr5vh34bnn2nfo6pyu2gmx3tneakouqkhmuz77eiuhdopvpirbjvbzom5xiuso7bstc22v2aubxlqvyqioy3fvcwjiihq2jsk2h34sm4i4kfg4fanzbfynslmfihqvcszb3osm2xy5fgxqdz5dyt76liqddfb43azzyziu7ivpctbg2oltlicqebknqhbxiorzhkqznvph5bkwlxqezx5msko3t2s3g7hkf2q3dn45ff5ydzk7vdsevbgoxg3g3alkqflreh5o543knqwspfdgcvthzn2fw2k5hlsyctfudrnmkldahvzghicg2uprcqhhrwwmiddqh5cuwlq3g2nnewzwu3asvdkjof2uryjgu4o7udoryfa6cuqi4jpkync7aitfdy3do22byynezfmt2lmgqephcqlwnwwmuojvficuxi6tt7ut4zgbl4ksdjm5fwonqapafaj5smujtpq62e4i5vrujrqx3wdiktxgsxrscktsdotl2m4nkhuucrvbgzenwojnfmcvgu6gg36t6bgzl76t7b2p7prnfj6nvyuux4th7m5bnlvxd3m2a=?1=1&data[]=16268540604187916861458595&v[]=5550347983&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}",
"lurl": "https://example.com/lurl/863/nn2eqnzrlevvuarsmivfimkopfta27s5d5xcu7krpumtkzs2pufqkybnp4agg2stmyaxwxqkmr5vh34bnn2nfo6pyu2gmx3tneakouqkhmuz77eiuhdopvpirbjvbzom5xiuso7bstc22v2aubxlqvyqioy3fvcwjiihq2jsk2h34sm4i4kfg4fanzbfynslmfihqvcszb3osm2xy5fgxqdz5dyt76liqddfb43azzyziu7ivpctbg2oltlicqebknqhbxiorzhkqznvph5bkwlxqezx5msko3t2s3g7hkf2q3dn45ff5ydzk7vdsevbgoxg3g3alkqflreh5o543knqwspfdgcvthzn2fw2k5hlsyctfudrnmkldahvzghicg2uprcqhhrwwmiddqh5cuwlq3g2nnewzwu3asvdkjof2uryjgu4o7udoryfa6cuqi4jpkync7aitfdy3do22byynezfmt2lmgqephcqlwnwwmuojvficuxi6tt7ut4zgbl4ksdjm5fwonqapafaj5smujtpq62e4i5vrujrqx3wdiktxgsxrscktsdotl2m4nkhuucrvbgzenwojnfmcvgu6gg36t6bgzl76t7b2p7prnfj6nvyuux4th7m5bnlvxd3m2a=?1=1&data[]=16268540604187916861458595&v[]=5550347983&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}",
"adomain": [
"example.com",
"example2.com"
],
"cat": [
"IAB9-7"
],
"adm": "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?><ad><popunderAd><url><![CDATA[https://example.com/h/npqxsxg45fnhtmwvzhtwo4hy27kjjl7yrbkgoscribafyeqhafvgf6xksttfmebrzi4zm342k6hma2papgt4woxrncznnt6l4hqjrfbx6bedf2sxw5uyculsxrj255wl4cu3bne6v542iu7tqp6u3vsn7cz47zvjvxd3nfrtyzguvs2spiarhccligffitugmnihqvdnzbfxtssul3fwfa6ap3ndxceydclezpwv56mfhab3jnwtddsmtki75t25wi53e3o2kvhlwysr7bip5hmw5y2mms2komxxbbfqsrfxtaggkbjwa4cqcrjwqqzrha3ncqqjxf77yu4e5jxiev4oybu3q6pi6e73g2arguqt2wlfje2wecl2bjkg4kl5aiyuayjqln6a2btgp55qk2cngjvfw4cywjke5q3dqcnpquefjn7ilb3xrzrqqqpan3yexcrwqngvzvubicyvb6uig4e2mtpbts3kve6uz7cjkm2mbjauazsigjsvy6yike3swksugjexuzqkpviam333prigcs3gmmhxcxifn5p33l4os3m5jpozwuzx5t4p3sux2bgctd6kwnaoz7e42aqywlxkhudicbiepitgmcivg6r2phczpcoijvnuy4cvjkcou3qss7cegwcqpbkjftlbuwgrot2lmgahrcuqa4======?u=https%3A%2F%2Fexample.com%2Fload%3Fz%3D2138977233%26random%3D%5Brandom%5D%26subID1%3Dcnv851a013cf8f6ca85bc5d4000d85f8c91%26s%3D1381598192828800_321678]]></url></popunderAd></ad>"
}
],
"seat": "1",
"group": 0
}
]

}

PUSH

{
"cur": "USD",
"id": "9af20dd3-6668-41cd-9656-afd85f2bab14",
"seatbid": [
{
"bid": [
{
"id": "1",
"adid": "0",
"crid": "0",
"cid": "0",
"impid": "123456",
"price": 1.2,
"nurl": "https://example.com/nurl/111/nn2e2njubj4q2vtfmj6vozsapftaskqnd5xxs7sxpumtenqapqhqanboffigiyfmyevwty6oxhmesukuiboafckkgeytnywd6tljvlprzipqdk7krxbgoihyzknkarirwjl4ksraldz4n5r2kf3qhmbu5keuq6vznvaus2jskzhuxelp7bkvhkciu2zf572kz7agngktohpz4cedj3umn32ewfjwbjjdb27e4vm4khnjatyd4fua3zsojdmvcje4konwvojtkcluvjx4y5f3eomoywgutj2kurjiuvkrniocxo2uj5fwd4hbzw5qp2llvjk6kslcauvrbyr2wotjr22nrfrxq4mc5bkf7ytp35ygfgkenreq6ew2kybee527ebi2u36kykrzydihj5fwcudyksrapallksce2s5zkj43iueyrgz7hlvqwspk66n4ka54g2r2nz4h6adfdfrglgck5ez74tck2fjx33cr4c7eh4svtc6exid37dv7nl3nwbje2t3cyb6jcvfajvujeuww66r5s7xek2zllbvf2typsy7ipsxj3exunm======?1=1&data[]=16305761533610140283188376&v[]=2558667725&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}",
"lurl": "https://example.com/lurl/111/nn2e2njubj4q2vtfmj6vozsapftaskqnd5xxs7sxpumtenqapqhqanboffigiyfmyevwty6oxhmesukuiboafckkgeytnywd6tljvlprzipqdk7krxbgoihyzknkarirwjl4ksraldz4n5r2kf3qhmbu5keuq6vznvaus2jskzhuxelp7bkvhkciu2zf572kz7agngktohpz4cedj3umn32ewfjwbjjdb27e4vm4khnjatyd4fua3zsojdmvcje4konwvojtkcluvjx4y5f3eomoywgutj2kurjiuvkrniocxo2uj5fwd4hbzw5qp2llvjk6kslcauvrbyr2wotjr22nrfrxq4mc5bkf7ytp35ygfgkenreq6ew2kybee527ebi2u36kykrzydihj5fwcudyksrapallksce2s5zkj43iueyrgz7hlvqwspk66n4ka54g2r2nz4h6adfdfrglgck5ez74tck2fjx33cr4c7eh4svtc6exid37dv7nl3nwbje2t3cyb6jcvfajvujeuww66r5s7xek2zllbvf2typsy7ipsxj3exunm======?1=1&data[]=16305761533610140283188376&v[]=2558667725&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}",
"adm": "{\"native\":{\"ver\":\"1.1\",\"link\":{\"url\":\"https://example.com/h/npzxsxfkvnnhtofkudogg4hsvc627s6wqbkgoscrkrafyeqhafvgft7trhufmebszi47q2u2k7234zxapgekooprncznnt6lygiypklq6bedl2sx5ruicul6xrj77zowfwte5dgn55t5iugcq3by6vg7jfqpa6sx7a5ewpdt4zgvllcspbkneb5znmz24tko4fj2bi3ywbfl5rl4r5em32nwwjloustlgzkzosfp66pimx6yjkwdjpsmjkivg6ouk2q7lk53kboxm2o35lyfakhh7ewe4ttlp74htg6sgd4wrcfdjcrwbh7yltjdvddlr5kanxmwnk6vn4m76zk6ovhnr56gxccw7oxlxlpw5s56642kfzphmclqlmfge7jpab6uymrulnsf2u3coztagyi5m57q6622ae2x2l2zgymwoyji4tq2pufnwlbkelt42ktid4j6crg5gyqa3ckir6nrs3g2tmckhhioffeuhuu2dihgr63j5l4hvnjrut3bwjlx7s3apb5gjs4erpqdi3cyinqern6ulimphhbvn6m7cdkg6me5xbybpvree===?u=https%3A%2F%2Fexample.example.net%2Fv2%2F369%2F07c3a51b-0bd3-11ec-ab05-002590f533ab%2F1%2Fcl\"},\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Такого вы еще не видели!\"}},{\"id\":3,\"required\":1,\"data\":{\"value\":\"Самые милые котята\"}},{\"id\":4,\"required\":0,\"img\":{\"w\":360,\"h\":240,\"url\":\"https://example.net/v2/369/07c3a51b-0bd3-11ec-ab05-002590f533ab/1/im\"}},{\"id\":2,\"required\":1,\"img\":{\"w\":192,\"h\":192,\"url\":\"https://example.net/v2/369/07c3a51b-0bd3-11ec-ab05-002590f533ab/1/ic\"}}]}}"
}
]
"seat": "1",
"group": 0
}
]
}

ON SITE PUSH (INPAGE)

{
"cur": "USD",
"id": "a55f5c55-5f5f-55fb-a5d5-55555555c555",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "5555555",
"crid": "5555555",
"cid": "555555",
"impid": "5555555",
"price": 0.3153782760333318,
"nurl": "https://example.com/nurl/460/nn2bs3ddlz7quademj7aoyq6pftaylyld43x2l2spvggazyipjoagzjmpvlwg2stmyaxuxqln53fhmwmnn2propbtazx537a4waipk5ny63gqasgo5btdhd3brjvrfekr6jmfywy352dzn7irhxdijwptxwn27jm54y4g2dnl3apttcsmbfggocjngjm7vvclyihshg6he4wgs2wj5fwcudyurw3qsdixjlulw3atwovfyrz4hzs33sovfvja6o34ckuxjbtnuw2qwefphvpnclxwezycr5omco3igdn2behpt2xoquye2pvkzxtfhsvtjlxb63akpafkcpqjcirbbsoig4vdwmc2o23pfwnvgyevakr3gbnhnnxs3g2tmckrfixtjsthmnty4g7jvfwcuaygi2nm5wdgbkrugbf4b5jpufnt5vpavcuijqva6huzoq2avttnturapdyk6ag22kjnezfmt2lsfx3avrx5jfwt2suj2vwhlehx7a4lnuwzwuu5i3dioefmu5sjjqqoyd2prmdcqbv6i54k2e2kvepwysbyblzjtrtvey7vdzqsfjz7ghwxja6wnsujnepcvhvk3fdysgjg2zz7c7gk3ifau4ijxb3h7v67kv6g6xmk354x7heku======?1=1&data[]=16263517182058676639420194&v[]=5554186872&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}",
"lurl": "https://example.com/lurl/460/nn2bs3ddlz7quademj7aoyq6pftaylyld43x2l2spvggazyipjoagzjmpvlwg2stmyaxuxqln53fhmwmnn2propbtazx537a4waipk5ny63gqasgo5btdhd3brjvrfekr6jmfywy352dzn7irhxdijwptxwn27jm54y4g2dnl3apttcsmbfggocjngjm7vvclyihshg6he4wgs2wj5fwcudyurw3qsdixjlulw3atwovfyrz4hzs33sovfvja6o34ckuxjbtnuw2qwefphvpnclxwezycr5omco3igdn2behpt2xoquye2pvkzxtfhsvtjlxb63akpafkcpqjcirbbsoig4vdwmc2o23pfwnvgyevakr3gbnhnnxs3g2tmckrfixtjsthmnty4g7jvfwcuaygi2nm5wdgbkrugbf4b5jpufnt5vpavcuijqva6huzoq2avttnturapdyk6ag22kjnezfmt2lsfx3avrx5jfwt2suj2vwhlehx7a4lnuwzwuu5i3dioefmu5sjjqqoyd2prmdcqbv6i54k2e2kvepwysbyblzjtrtvey7vdzqsfjz7ghwxja6wnsujnepcvhvk3fdysgjg2zz7c7gk3ifau4ijxb3h7v67kv6g6xmk354x7heku======?1=1&data[]=16263517182058676639420194&v[]=5554186872&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}",
"adomain": [
"example.com"
],
"cat": [
"IAB2-3"
],
"adm": "{\"native\":{\"ver\":\"1.1\",\"link\":{\"url\":\"https://example.com/h/noihsxeburnhtggx465gasgy77lornuwzwu3assb7l47zi4jqpnda7sopnywq4aunvyeuooxq2h4yzzydxgfh5ckyez6zosm2fiyblktqbemtgost7spjuhnjkndsevrgoxg3k3alkifl47ozdsmzknqwspfdccv6pxmrzgmvgyljhsr7bljdow4x4y4mtkkyfjgx7sqhintzasukhzwgunvkzjdrkjjyjkerm3dih4fpfgogpqtd6upgcqvhh4y625edozrkrfuroktrcw6rh2orey5wtndmjiyqv2txbgyzyuwzbg7cvdziyftbrw3t5kf7y73j5qfk4rgbfugexaxiea3e4z43y46c2h7wne7wyhkrvj3uomerq2nmtkk5fjppzx7hl2gwcjuvrzkiuwg6drqnall4vpjusk2gknw3nz2orr6k2v7jh3mtjfbttw6b6vhk5kqu22ehm4akuqeef4q4fyhlazu2jyrbansq6ytl6lif3n43h5ydrtfdlljtrxmkuukrlot3kkm3knqwrqar6gw7zvctuoe4gg3lhvpq6vvggspmghv676hmb4huzfx5ce64ndmlrbwasfvwfkbr444gvxu6s3b6dq43o4h?u=https%3A%2F%2Fexample.example.ru%2Ftiggo4%2F%3Futm_source%3Dexample-teaser-2%26utm_medium%3Dcp%D1%81%26utm_campaign%3Djn_t_7pro%26utm_term%3DIAB1-1_1352756290519210\",\"directUrl\":\"https://example.com/tiggo4/?utm_source=example-example-2&utm_medium=cpс&utm_campaign=jn_t_7pro&utm_term=IAB1-1_1352756290519210\"},\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"text\":\"Самые милые котята\"}},{\"id\":2,\"required\":1,\"img\":{\"w\":192,\"h\":192,\"url\":\"https://i.example.com/auto/192/image/vk/7999/999/60eedcafca39ft1626266799r8551.png\"}}]}}"
}

NATIVE (TEASER)

{
"cur": "USD",
"id": "55555555-555d-5555-b5cd-b5555d555555",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "5555555",
"crid": "5555555",
"cid": "555555",
"impid": "55555-exmpl",
"price": 0.6162098801136017,
"nurl": "https://example.com/nurl/497/nn2eyzthaf6vqb3pmj7fgzq4pftac623d42h4kafpungoyaooegqayt5ojlwc2stmygx6wagmf6vhdhxnn2lxg5mzazx565ltt7ibk5ny63gqasgo5fddil3bqavr7ho23p4rqftyvntz4perhxdijwpuh4p65jmfszeqnz2s3552y2iojsveocjfeawlpduefitakrcgiygsmswj5fwdich2rjttqlihdde55ghk3efl3xjkpith7sfrnqjbtgckd2uq5pgezzj4yaymtmrbycixy5lgtwr7deuppctgk2gr43azv3oyuurhlpqjylibxte4sgzkf6iiuz7sfuklppsr5t3a6odxgcy2362k5hlsyctfudrnmkldahvzghicg2up7sqhmodu5xgjwz5rr4evkw4pnuwgoke2udikb4fieqlpkna2f6kuayjrbpdwedrq2jskzhuwynai6ofaxm3nmzi4tkkqfjpxl7bzfhicmcpx5ewbwt3lrtf46kyazqhw66bkmdpyuj67fvdz3smwleqzocx6xubhojr4pxorbfmq6v23r2iwqyzumcdl2qhxy6vrhvgnssvjlewkwl6ka4twtqfsweu5w3f7n5myvrz5fwzdcupzrt7q7cv4i6kbswx66plnvksybikvao6sxgktmfutziq====?1=1&data[]=16263531872967219577169276&v[]=5550842573&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}",
"lurl": "https://example.com/lurl/497/nn2eyzthaf6vqb3pmj7fgzq4pftac623d42h4kafpungoyaooegqayt5ojlwc2stmygx6wagmf6vhdhxnn2lxg5mzazx565ltt7ibk5ny63gqasgo5fddil3bqavr7ho23p4rqftyvntz4perhxdijwpuh4p65jmfszeqnz2s3552y2iojsveocjfeawlpduefitakrcgiygsmswj5fwdich2rjttqlihdde55ghk3efl3xjkpith7sfrnqjbtgckd2uq5pgezzj4yaymtmrbycixy5lgtwr7deuppctgk2gr43azv3oyuurhlpqjylibxte4sgzkf6iiuz7sfuklppsr5t3a6odxgcy2362k5hlsyctfudrnmkldahvzghicg2up7sqhmodu5xgjwz5rr4evkw4pnuwgoke2udikb4fieqlpkna2f6kuayjrbpdwedrq2jskzhuwynai6ofaxm3nmzi4tkkqfjpxl7bzfhicmcpx5ewbwt3lrtf46kyazqhw66bkmdpyuj67fvdz3smwleqzocx6xubhojr4pxorbfmq6v23r2iwqyzumcdl2qhxy6vrhvgnssvjlewkwl6ka4twtqfsweu5w3f7n5myvrz5fwzdcupzrt7q7cv4i6kbswx66plnvksybikvao6sxgktmfutziq====?1=1&data[]=16263531872967219577169276&v[]=5550842573&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}",
"adomain": [
"example.com"
],
"cat": [
"IAB14"
],
"adm": "{\"native\":{\"ver\":\"1.1\",\"link\":{\"url\":\"https://example.com/h/nobxsxf7t5nhtw7vvlvgasgmwsxznmmwzwu3assbxhn3d47jwtota7q4pnywq6iunvyeuomrrkh4yzzydxgfhskkyez2v62m2fi65kktqben3uvl4hj5zbheicndstmjgni2osxwxpczavgijd7nt24ljxqvfahnyxclpfwnvgyev4ksph2faipdnmyagfp3mnnmavst6vfwsmxwb65wgvuakzolqsuqtifmosggqarpiumn5dfnpkvqwspk66pzkh2dmyinszgpzzxb3nnzuo2mxmyv6skpbjjx6ohv45elcmpl6szyqumyk74tvilkgoteysxbktnyrev7j74tmv25cnuzbtgckauplobijzhgw2yqpecfqycdbgnfyjzvzfi4p4surbejlbsru5fn55t62ridtqll6lrnsso4kjsiaiqfrrvxuswcbguvfl24q45iqx5qnovetcb66vukeovbrh2m3wgsqcwzuvkiobbusbteo4xqonsbg4yvu623aezxylifgupdam25f5nfimzof4adms3aikg45dn32hcjt5dtkdklripgmrrnlnhysblsbvgqsqnqtm7uuotzxl4hvowts23nhiuh6nkjkjeppdxyzzxqqrkhjj467xssolcp23qlkzhuwildjot62===?u=https%3A%2F%2example.com%2F19603-kotyata.html%3Fsource%3D391%26id%3D4561472%26site_id%3D1358915106853353%26mark3%3D316397%26tid%3D37698\"},\"assets\":[{\"id\":5,\"required\":1,\"title\":{\"text\":\"Таких милых котят вы еще никогда не видели\"}},{\"id\":5,\"required\":1,\"img\":{\"w\":400,\"h\":400,\"url\":\"https://example.com/auto/400/image/tesr/1472/472/5fbc73b0de9b6t1606185904r655.jpg\"}}]}}"
}
],
"seat": "1",
"group": 0
}
]

}

NATIVE APP

{
"cur": "USD",
"id": "55fe5555-eb5a-5d55-55ed-a555e5d555a5",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "5555555",
"crid": "5555555",
"cid": "555555",
"impid": "e55a55ea55",
"price": 0.010579906888306142,
"nurl": "https://example.com/nurl/799/nn2e43julv6vabtamixag2azpftfy4kzd5xx2lqfpumwiziafrpvmz35omagi2stmyaxsxigmv5fhpu6nn2lzg5bzqzx5g7ov2ph6zgshjyw2ywjjejwemej4ho4dovo5wakgsqjqtxi5vj6hhuzfm53jym7g4o6kntedguz7vgvg23bpbkff6efuxbgsd2kfevaqxrlhbewsmswj65v5udzkxndsq7zgpu6storkhdikseajditvfsoxdfpw6uzkpjr57aiqnho2q6ji6gfhw2nrqztakonl24hsxvphhqictdmyjerhb2pnd5ds5wzgnk7ostpsb4vlgrzjc4tgwexjk7olnm2v7d3nfwnk6xuvpxfwwnk7r5ws3gvpj2kmcrhsvyhnmg6ambhoja3n4yiwfwzes3km4cqx63dsdz4zkoaw2lm3kkorfruw4kuki4itjp6uzyau2uh3ncltewmkzrvmt2lmfihrjdn6bfqzycuj6jwgumyk2qphu5rgg7e2surkj454ujqfvpaknlzfjkgjwcxfcieu2uckvvjwyvozxmiip4uni4ic3dxsfj7pdwd2jg6wnsrjprl4uiikni2qtocgdhewswbkswmfcf7j7atmv77j6h7hehrupj7a24kkkh4b6nlqcv23r5wna======?1=1&data[]=16267702601928352117733179&v[]=555249867&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}",
"lurl": "https://example.com/lurl/799/nn2e43julv6vabtamixag2azpftfy4kzd5xx2lqfpumwiziafrpvmz35omagi2stmyaxsxigmv5fhpu6nn2lzg5bzqzx5g7ov2ph6zgshjyw2ywjjejwemej4ho4dovo5wakgsqjqtxi5vj6hhuzfm53jym7g4o6kntedguz7vgvg23bpbkff6efuxbgsd2kfevaqxrlhbewsmswj65v5udzkxndsq7zgpu6storkhdikseajditvfsoxdfpw6uzkpjr57aiqnho2q6ji6gfhw2nrqztakonl24hsxvphhqictdmyjerhb2pnd5ds5wzgnk7ostpsb4vlgrzjc4tgwexjk7olnm2v7d3nfwnk6xuvpxfwwnk7r5ws3gvpj2kmcrhsvyhnmg6ambhoja3n4yiwfwzes3km4cqx63dsdz4zkoaw2lm3kkorfruw4kuki4itjp6uzyau2uh3ncltewmkzrvmt2lmfihrjdn6bfqzycuj6jwgumyk2qphu5rgg7e2surkj454ujqfvpaknlzfjkgjwcxfcieu2uckvvjwyvozxmiip4uni4ic3dxsfj7pdwd2jg6wnsrjprl4uiikni2qtocgdhewswbkswmfcf7j7atmv77j6h7hehrupj7a24kkkh4b6nlqcv23r5wna======?1=1&data[]=16267702601928352117733179&v[]=555249867&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}",
"adomain": [
"example.com"
],
"cat": [
"IAB9"
],
"adm": "{\"native\":{\"ver\":\"1.1\",\"link\":{\"url\":\"https://example.com/h/nonxsxen6znhtxhvu7xgasfm6go7mtsj3t22p3uqxpavm6r3phuta3slbnpbq6yeq2xjh3ruhyvngygpp36fhb6lmgbfpvg5mpuhtahx66dy5d6ssjp2sulwqrjtteligo3e4rmjkgt6dh7wwslm3knqjkivdj7bt73ljfwnvgyevyksxdp4vq5rs3g2tmck6fjht5cqhhrwwmadb35wgwwakzj7ks3jgj3a5o3dkoafm54yjklypwuzjtgfg4udoecis2v5rtpkczmcpnjvnemwnbbfctetmlti5chog6uwvgkuu5egbid3kxjdzhp75diutw3fkfvagwwl4lbdarxrtj5uq6lulb4eqojybzcsxwkycaxpuopwz42omtxu4nmjavpntzh6smcxy5ezf66tk3xtvir6u5wiusoholqwxgr2vjw6ovhgumpwvhkwedxx4vockt37jnu7zsd45hymon7vy23ykuzb23deaexuiabvfixuyzcjme2bkkc5ajswekacgffdkzibpboauzjjloiol55nuh7znp66k5t4xqnvrriqfsuc6pvfkf6l4p6cunhkz37kxtfjwc2j4uk2kfnjwqczjb7e265vy2rngvacljqtgtxq5vtxbr6wliaus2jss2bypepp?u=https%3A%2F%2Fexample.com%2F52995-takih-milih-kotyat-vi-esche-ne-videli.html%3Fsource%3D392%26id%3D4904435%26site_id%3D1380295462490606%26mark3%3D321375%26tid%3D59198\"},\"assets\":[{\"id\":5,\"required\":1,\"title\":{\"text\":\"Таких милых котят вы еще не видели\"}},{\"id\":2,\"required\":1,\"img\":{\"w\":400,\"h\":400,\"url\":\"https://example.com/auto/400/image/tesr/4435/435/60d4448055998t1624523904r3436.jpg\"}}]}}"
}
],
"seat": "1",
"group": 0
}
]

}

BANNER

{
"cur": "USD",
"id": "55c5ce5f-5a5e-5d5b-a55b-dc55c55d5555",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "TPL55_AD4884264",
"crid": "TPL55_AD4884264",
"cid": "555555",
"impid": "1",
"price": 2.1730898173053195,
"nurl": "https://example.com/nurl/396/nn2eazjrbivaybjqmj4qayy5pftfy7ild43xm4ydpuodo2ypfjpqumtwp5igm2stmyahcxiamb5vhcgznn2ll2fqqa3h5d6drwtxuzccabattpsvc5baddpx72p7vo6554wspnucsd7veivyswn2cxjx5zunu6jwlkimpqzqjzcxuykqpbkfeocnffzfobzrcfnacvcshbewsmvgodfwaupqkvmkqsezqnjp6suprrtoyu6zicuth7wb4frz26m5tclxhpbtltmb2imipgbvvxkinezhmd5dmbciqvpqhk2grboycfy6yuxb6upajylibxte4sgzkerzyu6ano4tgx4xjlgz3ygjktmerrp7z3je3ckrpgtfgoy3hryn6tj2lrnk75zc3v3mgmcvdimclyd2zcapdu4rzwu3bndasj5e6wzyjfutevspj4qrd3esk3jdkcztcypewykqpbkffsdwueydhhkjmgehuvnshlq5lmn5jcrwgruikzj3estbae2h27ksnanwnsr3atetclhhjbvoa62e5i53d6quszglz4twvbl6jro4n7xvkptwvnxyqv75vx522ooujnagovgrrnjuqswo5vlshw3f757myvrz5fw47nmpzrt7q7cv4i6k5oolx7n5nucsybim52ua6pfktmfutziq====?1=1&data[]=16263541733087802523950643&v[]=-1830393555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=2.1730898173053195",
"lurl": "https://example.com/nurl/396/nn2eazjrbivaybjqmj4qayy5pftfy7ild43xm4ydpuodo2ypfjpqumtwp5igm2stmyahcxiamb5vhcgznn2ll2fqqa3h5d6drwtxuzccabattpsvc5baddpx72p7vo6554wspnucsd7veivyswn2cxjx5zunu6jwlkimpqzqjzcxuykqpbkfeocnffzfobzrcfnacvcshbewsmvgodfwaupqkvmkqsezqnjp6suprrtoyu6zicuth7wb4frz26m5tclxhpbtltmb2imipgbvvxkinezhmd5dmbciqvpqhk2grboycfy6yuxb6upajylibxte4sgzkerzyu6ano4tgx4xjlgz3ygjktmerrp7z3je3ckrpgtfgoy3hryn6tj2lrnk75zc3v3mgmcvdimclyd2zcapdu4rzwu3bndasj5e6wzyjfutevspj4qrd3esk3jdkcztcypewykqpbkffsdwueydhhkjmgehuvnshlq5lmn5jcrwgruikzj3estbae2h27ksnanwnsr3atetclhhjbvoa62e5i53d6quszglz4twvbl6jro4n7xvkptwvnxyqv75vx522ooujnagovgrrnjuqswo5vlshw3f757myvrz5fw47nmpzrt7q7cv4i6k5oolx7n5nucsybim52ua6pfktmfutziq====?1=1&data[]=16263541733087802523950643&v[]=-1830393555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}",
"adomain": [
"example.com",
"example2.com"
],
"cat": [
"IAB18-1"
],
"w": 336,
"h": 280,
"adm": "<div id=\"fzEzZhreHpxfDveA\"><a href=\"https://example.com/h/nobhsxf3wfnhtvmgw2rgksfy3s7m6s2j2wdlnixvzxevm6rrpf4quxqpoquvgkfjwh4m4322gpluv3kt2bk7jm2b3ez6zpck3fi3rxf6z656lkgjakbwac5akwvbvkliho7e5z5mzdsvfirz4wskvs2jznr4zku5zdalnfwnvfhnwy2r3blejeslnnya772joxuhuvm7hjewteqxv5e4guuqkyp4qs3czjkf7s3cvdvxfwr3x35bj5sm7womk7xzkfexjiynszgoj5hcxrpyao2cn43p7eckcfj57c2tksiwvd7atsawhmd37nknastiyjku5s3fvwnzjvj63fwtgrbripe55uswilljk5zkk5xucikrfbpaumrjra5t4npdmcqmsuhchhx6eov6j255aveckvyvwjy7kyzx46cymrhgazqooboaiztxpmbgmqdbmihxqukqgr5c2u3cjjr5eosi4eyp5qpbmpwxvhmys5z2ymc43aosdgd2qnno2s66xqehlltdzhmrq3wijobnpwpxstiyjchzkmrh4yzgee4suirtd5sts435dnfg6ayceyassyzcfckonge3rw45ldidptjojo72hedop57cxn7qzuv24u5vfmht2d4fcwsrlkouawkipzgxxhftxdjvias2mezu5p72mvyn5x22afewsmswj5fwlea=?u=https%3A%2F%2exmpl.com%2FBht8Y8ry%3Fcost%3D2.5%26currency%3Drub%26external_id%3Dcnvde13946446956080c6850718bb5f2227%26creative_id%3D4884264%26ad_campaign_id%3D503406%26source_id%3D1342406209202279%26category_id%3D1189\" trackerlink=\"https://example.com/c/nobhsxf3wfnhtvmgw2rgksfy3s7m6s2j2wdlnixvzxevm6rrpf4quxqpoquvgkfjwh4m4322gpluv3kt2bk7jm2b3ez6zpck3fi3rxf6z656lkgjakbwac5akwvbvkliho7e5z5mzdsvfirz4wskvs2jznr4zku5zdalnfwnvfhnwy2r3blejeslnnya772joxuhuvm7hjewteqxv5e4guuqkyp4qs3czjkf7s3cvdvxfwr3x35bj5sm7womk7xzkfexjiynszgoj5hcxrpyao2cn43p7eckcfj57c2tksiwvd7atsawhmd37nknastiyjku5s3fvwnzjvj63fwtgrbripe55uswilljk5zkk5xucikrfbpaumrjra5t4npdmcqmsuhchhx6eov6j255aveckvyvwjy7kyzx46cymrhgazqooboaiztxpmbgmqdbmihxqukqgr5c2u3cjjr5eosi4eyp5qpbmpwxvhmys5z2ymc43aosdgd2qnno2s66xqehlltdzhmrq3wijobnpwpxstiyjchzkmrh4yzgee4suirtd5sts435dnfg6ayceyassyzcfckonge3rw45ldidptjojo72hedop57cxn7qzuv24u5vfmht2d4fcwsrlkouawkipzgxxhftxdjvias2mezu5p72mvyn5x22afewsmswj5fwlea=?u=https%3A%2F%example.com%2FBht8Y8ry%3Fcost%3D2.5%26currency%3Drub%26external_id%3Dcnvde13946446956080c6850718bb5f2227%26creative_id%3D4884264%26ad_campaign_id%3D503406%26source_id%3D1342406209202279%26category_id%3D1189\" data-set=\"href\" target=\"_blank\" class=\"k-bloc yMYoyBIvbMhofBbE\"><div class=\"k-bloc__img\" style=\"background-image: url('https://example.com/auto/336x168/image/tesr/4264/264/rect_60c1bfe267527t1623310306r2827.jpg');\"></div><div class=\"k-bloc__wrapper\"><div class=\"k-bloc__title\">Таких милых котиков вы еще не видели</div><div class=\"k-bloc__arrow\"><svg width=\"30\" height=\"18\" viewBox=\"0 0 30 18\" fill=\"none\" xmlns=\"http://example.com/2000/svg\"><path d=\"M3 9L27 9\" stroke=\"#A4A4A4\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><path d=\"M22.5 4.5L27 9L22.5 13.5\" stroke=\"#A4A4A4\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg></div></div></a></div><style>@import url('https://example.com/css2?family=Roboto:wght@700&display=swap');#fzEzZhreHpxfDveA * {box-sizing: border-box;font-family: 'Roboto', sans-serif;}#fzEzZhreHpxfDveA .k-bloc {position: relative;width: 336px;height: 280px;display: block;background-color: #ffffff;text-decoration: none;}#fzEzZhreHpxfDveA .k-bloc:hover .k-bloc__arrow svg path{stroke: #ffffff;}#fzEzZhreHpxfDveA .k-bloc:hover .k-bloc__wrapper {margin-top: -15px;}#fzEzZhreHpxfDveA .k-bloc__img {background-position: center;background-repeat: no-repeat;background-size: cover;width: 336px;height: 168px;}#fzEzZhreHpxfDveA .k-bloc__wrapper {background-color: #4F4F4F;box-shadow: 0px 4px 16px rgba(0, 0, 0, 0.2);border-radius: 5px;padding: 14px 8px 4px;margin: -10px auto 0;width: 100%;max-width: 312px;transition: all 0.2s;}#fzEzZhreHpxfDveA .k-bloc__title {font-weight: bold;font-size: 13px;line-height: 15px;color: #FFFFFF;min-height: 64px;margin-bottom: 10px;}#fzEzZhreHpxfDveA .k-bloc__arrow {width: 30px;height: 18px;margin: 0 0 0 auto;}#fzEzZhreHpxfDveA .k-bloc__arrow svg {width: 100%;height: 100%;transition: all 0.2s;}</style>"
}
],
"seat": "1",
"group": 0
}
]

}

BANNER APP

{
"cur": "USD",
"id": "th5qj5l5tp5sbjg55t5",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "TPL55_AD4921726",
"crid": "TPL55_AD4921726",
"cid": "555555",
"impid": "1",
"price": 0.014145912714302543,
"lurl": "https://example.com/lurl/830/nnbqypdkjerv4xtfhm5viiy2hy2qc4a5avceq72ymjewgyaokho72rlp6dy55d5ivxd3nfrtm3huswkufdvfiycibgaptd4ir7l7vneyheq77i4mzbgrdueixdjtgmpngpoe4kljv3fpqubainmdevspjnqva6auci4qd3jtezcteykqpbkfeofzk2zfotwdmbnoqvpzvba5sm54yvknsuocl6jdtn63tzkiesqys43g5bzzqwd7w2mxjlffnhkvki4esko2k5n3wycjqvksx7yhko7vi7kayjwnavlnrbegvcsxigbwau5ikvooashq5k2irmu6v6d2wu6yjdyovneiwkpk7b5lkpieq2gak5gb4mqu6flcgbkdx2isnktuznjhwaibpt4wxex4y2hztl4hvowttc3lffpu6s3bkb4fiutybbldraimyom5yryfki4es2jsk27xjkksdwdfaoernmz3mtmczguzwuv2hjbzsmcxyvegs2kjmiyfykypkthey2gbkp6fl6r3jlmtc47xjccniweukhtm2spckwf3h65gpoevcmu6jihkmtgvrtup6u6qhrhw2q77sbfgfqd43bikatlisjjntwv3257pyvrz7fwytrwbxsw2nqkw5i6otq53sk33jhvpq5kq====?1=1&data[]=16267695581629189819560392&v[]=1326260555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=1.051696270431351&loss=${AUCTION_LOSS}",
"adomain": [
"example.com"
],
"cat": [
"IAB3-10"
],
"adm": "<div id=\"EpLvPrThwzjHXYMe\"><a href=\"https://example.com/h/nodxsxhg65nhtcogyg6j3l4hvowts2osulmlrb4x5f5hyuyizfvquuqpoquvgkgcyprm4322gpluvx2w2bk2xpkb3ez6nwcj3fi7rvgsxd465ufhqffksulwrrjtxklihs7e5uvzwk723lohw2ldhjso2k43fp5nvxd3nfrt2zg6xs6zxswk3r5wsyz4mtkkyfjhf7sqhintzasulpzwgunvkzjdr2jj2jkfni3dooefmuoajnglevnkz5a5q64k2ymos2xwv3k32yx5pnpikg3vvey4rixt4zl2uv2uhq4mb3kxjsjwfxvczwcddklkxzkkosdaub5vlur4374orukj3nsvc2qnlldpxrjqi2s4c7sipf2fq6cihe4a4rjl3nnrbuctsbemfis675fjrvlqxrjzhwlbwjke5q3dv3fpquefjmipkgdvrzrzzfu5nxyexqruqngtfjq6ikyvacsczihkmtmp4pfkbcuf2comsm2mprawwpqqnuqfg6yflrqsow6t764jppf7zoe7qv3hzoi3z6k7aly6degrkal4xy74fi2nhgvfqxektmfutzivuus2xreftnsxm5evdrxjr3kt4432hjlvpyhrlbmk3vzqobutevspjnqvboa=?u=https%3A%2F%2Fexample.com.ru%2F%3Futm_source%3Dkad_tizer%26utm_campaign%3D509290%26utm_medium%3D1380663657990203%26utm_content%3D4921726\" trackerlink=\"https://example.com/c/nodxsxhg65nhtcogyg6j3l4hvowts2osulmlrb4x5f5hyuyizfvquuqpoquvgkgcyprm4322gpluvx2w2bk2xpkb3ez6nwcj3fi7rvgsxd465ufhqffksulwrrjtxklihs7e5uvzwk723lohw2ldhjso2k43fp5nvxd3nfrt2zg6xs6zxswk3r5wsyz4mtkkyfjhf7sqhintzasulpzwgunvkzjdr2jj2jkfni3dooefmuoajnglevnkz5a5q64k2ymos2xwv3k32yx5pnpikg3vvey4rixt4zl2uv2uhq4mb3kxjsjwfxvczwcddklkxzkkosdaub5vlur4374orukj3nsvc2qnlldpxrjqi2s4c7sipf2fq6cihe4a4rjl3nnrbuctsbemfis675fjrvlqxrjzhwlbwjke5q3dv3fpquefjmipkgdvrzrzzfu5nxyexqruqngtfjq6ikyvacsczihkmtmp4pfkbcuf2comsm2mprawwpqqnuqfg6yflrqsow6t764jppf7zoe7qv3hzoi3z6k7aly6degrkal4xy74fi2nhgvfqxektmfutzivuus2xreftnsxm5evdrxjr3kt4432hjlvpyhrlbmk3vzqobutevspjnqvboa=?u=https%3A%2F%2example.ru%2F%3Futm_source%3Dkad_tizer%26utm_campaign%3D509290%26utm_medium%3D1380663657990203%26utm_content%3D4921726\" data-set=\"href\" target=\"_blank\" class=\"k-bloc wzuRrdoPaKupOzsD\"><div class=\"k-bloc__age\">12+</div><div class=\"k-bloc__img\" style=\"background-image: url('https://example.com/auto/300x194/image/tesr/1726/726/rect_60e3140b614cat1625494539r8069.jpg');\"></div><div class=\"k-bloc__btnwrap\"><div class=\"k-bloc__btn\"><div>Самые милые котята!</div><div class=\"k-bloc__domain\">example.ru</div><div class=\"k-bloc__disclaimer\"></div></div><div class=\"k-bloc__arrow\"><svg width=\"30\" height=\"18\" viewBox=\"0 0 30 18\" fill=\"none\" xmlns=\"http://www.example.com/2000/svg\"><path d=\"M3 9L27 9\" stroke=\"white\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><path d=\"M22.5 4.5L27 9L22.5 13.5\" stroke=\"white\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg></div></div></a></div><style>#EpLvPrThwzjHXYMe * {box-sizing: border-box;font-family: Arial, sans-serif}#EpLvPrThwzjHXYMe .k-bloc {position: relative;width: 300px;height: 250px;display: block;background-color: #fff}#EpLvPrThwzjHXYMe .k-bloc:hover .k-bloc__btnwrap {bottom: 32px}#EpLvPrThwzjHXYMe .k-bloc__img {height: 194px;width: 300px;background-position: center;background-repeat: no-repeat;background-size: cover;overflow: hidden;}#EpLvPrThwzjHXYMe .k-bloc__text {font-weight: 400;position: absolute;bottom: 5px;left: 18px;max-width: 265px;font-size: 8px;line-height: 9px;color: #b4b4b4;height: 18px;overflow: hidden}#EpLvPrThwzjHXYMe .k-bloc__btnwrap {position: absolute;bottom: 27px;left: 8px;display: flex;justify-content: space-between;align-items: flex-end;width: 284px;box-sizing: border-box;text-decoration: none;transition: all .2s;background-color: #4f4f4f;box-shadow: 0 4px 16px rgba(0, 0, 0, 0.2);border-radius: 5px;padding: 12px 8px 12px 12px}#EpLvPrThwzjHXYMe .k-bloc__btn {width: 220px;font-size: 14px;line-height: 16px;color: #fff;font-weight: 700;margin-right: 4px;box-sizing: border-box;transition: all .2s}#EpLvPrThwzjHXYMe .k-bloc__arrow {margin-bottom: -4px;width: 30px;height: 18px;display: flex;justify-content: center;align-items: center;box-sizing: border-box;transition: all .2s}#EpLvPrThwzjHXYMe .k-bloc__arrow svg {width: 100%;height: 100%}#EpLvPrThwzjHXYMe .k-bloc__domain {font-size: 12px;line-height: 14px;color: #69c0ff;margin-top: 8px;margin-bottom: 3px;}#EpLvPrThwzjHXYMe .k-bloc__age {width: 24px;height: 24px;left: 8px;top: 8px;position: absolute;display: flex;justify-content: center;align-items: center;font-weight: bold;font-size: 10px;line-height: 12px;color: gray;background-color: #fcfcfc;opacity: .75;border-radius: 2px}#EpLvPrThwzjHXYMe .k-bloc__disclaimer {font-size: 7px;line-height: 8px;color: #B4B4B4;}</style>"
}
],
"seat": "1",
"group": 0
}
]

}

VIDEO

{
"cur": "USD",
"id": "5c5555d5-5555-555c-addc-55f5d55e5555",
"seatbid": [
{
"bid": [
{
"id": "5",
"impid": "exmpl_5",
"price": 0.6621354882128117,
"lurl": "https://example.com/lurl/830/nnbqypdkjerv4xtfhm5viiy2hy2qc4a5avceq72ymjewgyaokho72rlp6dy55d5ivxd3nfrtm3huswkufdvfiycibgaptd4ir7l7vneyheq77i4mzbgrdueixdjtgmpngpoe4kljv3fpqubainmdevspjnqva6auci4qd3jtezcteykqpbkfeofzk2zfotwdmbnoqvpzvba5sm54yvknsuocl6jdtn63tzkiesqys43g5bzzqwd7w2mxjlffnhkvki4esko2k5n3wycjqvksx7yhko7vi7kayjwnavlnrbegvcsxigbwau5ikvooashq5k2irmu6v6d2wu6yjdyovneiwkpk7b5lkpieq2gak5gb4mqu6flcgbkdx2isnktuznjhwaibpt4wxex4y2hztl4hvowttc3lffpu6s3bkb4fiutybbldraimyom5yryfki4es2jsk27xjkksdwdfaoernmz3mtmczguzwuv2hjbzsmcxyvegs2kjmiyfykypkthey2gbkp6fl6r3jlmtc47xjccniweukhtm2spckwf3h65gpoevcmu6jihkmtgvrtup6u6qhrhw2q77sbfgfqd43bikatlisjjntwv3257pyvrz7fwytrwbxsw2nqkw5i6otq53sk33jhvpq5kq====?1=1&data[]=16267695581629189819560392&v[]=1326260555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=1.051696270431351&loss=${AUCTION_LOSS}",
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"3.0\"><Ad id=\"item_0\"><InLine><AdSystem><![CDATA[KDM]]></AdSystem><AdTitle><![CDATA[Таких милых котят вы еще никогда не видили!]]></AdTitle><Impression><![CDATA[https://example.com/nurl/505/nn2eyn3hbj7vcvtamjzfoz2jpftas4ikd43swlycpvhwanakfvpqgm37pvmgo2stmyaxuwaamr3vh6h2nn2ipiwltxektmfutzivby6nwwcwwasgo5btdkl3bqpvriwerpxzllnnstvfkow2v6u3kub7zp6ztjcrfleefyztgrd5phh4pjgbigg5ninvmt2lmfir7mlnpbecdw2re5ercwqbkrjdqsljgkthbs3akhyfkwfijdt4uup7jkkmez7mko3ufkjtzkzooy45peh2gctvxqzwk7dyl2eht72u2bec7qsx3nejyujduvqajrdlaa3gw56jkfd6iuz36fuglhso6naia6k7ri42xr6utng2wyfs22zj6ovbnaz2itsigqbtzxkqhbewtmsc4gsf56t2k4dwwdozgdq7zngyvcd2xlohjcvta7tojnqva6cvgxoxmqbs6iryqv3atvvweldrpvzvn2zhujtermlnnfewsmswj5fzc35qky36us3j5jke5k3drgsljlz6ufvsljsnjlvvg4damqhx6wqkg4u6wyvzp76fcepzniqo4tee4b2lqv4zvfw3smnqyks4tkmhvow4osfugfhdn7c5ub52vom7wnv3ausnljrma7hzkcqe22eskkw23ioxp3sfn3ot5pdmz3h6mpuhzy7by7yjdtnjwc2ga===?1=1&data[]=16263545302379371112518666&v[]=1903153267&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}]]></Impression><Creatives><Creative id=\"4931228\" AdID=\"4931228\"><Linear skipoffset=\"00:00:00\"><Duration>00:00:29</Duration><TrackingEvents></TrackingEvents><VideoClicks><ClickThrough><![CDATA[https://example.com/h/nopxsxglsjnhtz6mzw7zxl4hvowtsuo6vxnygskbqxrnnjvc5loda7qcpnywq4aunvyeuooqwch4yzzydxgfhqkkyezyl6km2fizbkktqben5lo3qom4x45y7jj7asb65jl7o2ubkfz3yu6246h76vf7jkb75huzkc4exxubvh3lhhvpq6vvhkclncjfiwhbmnjd2epchih5cmcxqjewcugycszdvxlkyjkgnm3dil4fphnznxqtdho6n7avhhwzxsilbfwnvgyevtctmaw6kbejnlgl32frmobhwvsdhoiwvkhsukxwtmd37finastiyjku5s3fwkpjjvj6lmedvsvs45rubdogjuqeqslup3nuqikrgblaemqrmnjnsrbdrbl5avo4ybhnsm4f7fgisupwvrk3qs3ixjknhnwnklqfmrufjmzmgzdtrzrwgs3hnxyexqruqngrbedcisyvacrjjuhkmtprrcdph4eyswjzqm2mazauc2cpme3vw7ykauzh2ksvgindkyaloeeakmtwfycdehjxgbohsxqfi2sonwhjukzj57g3nannnu4cxvksrdmo3c2g62wwzxttgmgauls7vn4wzwu3assdkzykiwiiubxbuvd7vgdzb72sna3ec2bk3c3uyqmdzzjrulazpu======?u=http%3A%2F%2example.com%2Fexmpl.php%3Fkey%3Dg43ie8y23wuj5zbxz34v%26cost%3D0.0%26SID%3D1360206185401685%26ID%3D4931228%26CID%3D510325%26RID%3DEE%26CATID%3D1520%26SUBAGE%3D0%26LANG%3Dru%26PLTFRM%3DANDROID%26price_model%3D2]]></ClickThrough></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" codec=\"0\" bitrate=\"915\" width=\"1280\" height=\"720\"><![CDATA[https://example.com/video/video/1228/228/60e860a7a32fet1625841831r9272.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>"
}
],
"seat": "1",
"group": 0
}
]

}

VIDEO APP

{
"cur": "USD",
"id": "555d8555-d555-5555-a555-5e555555fda5",
"seatbid": [
{
"bid": [
{
"id": "5",
"adid": "5555555",
"crid": "5555555",
"cid": "555555",
"impid": "i555d5555-d555-5555-a555-5e555555fda5",
"price": 0.6890557421065893,
"lurl": "https://example.com/lurl/830/nnbqypdkjerv4xtfhm5viiy2hy2qc4a5avceq72ymjewgyaokho72rlp6dy55d5ivxd3nfrtm3huswkufdvfiycibgaptd4ir7l7vneyheq77i4mzbgrdueixdjtgmpngpoe4kljv3fpqubainmdevspjnqva6auci4qd3jtezcteykqpbkfeofzk2zfotwdmbnoqvpzvba5sm54yvknsuocl6jdtn63tzkiesqys43g5bzzqwd7w2mxjlffnhkvki4esko2k5n3wycjqvksx7yhko7vi7kayjwnavlnrbegvcsxigbwau5ikvooashq5k2irmu6v6d2wu6yjdyovneiwkpk7b5lkpieq2gak5gb4mqu6flcgbkdx2isnktuznjhwaibpt4wxex4y2hztl4hvowttc3lffpu6s3bkb4fiutybbldraimyom5yryfki4es2jsk27xjkksdwdfaoernmz3mtmczguzwuv2hjbzsmcxyvegs2kjmiyfykypkthey2gbkp6fl6r3jlmtc47xjccniweukhtm2spckwf3h65gpoevcmu6jihkmtgvrtup6u6qhrhw2q77sbfgfqd43bikatlisjjntwv3257pyvrz7fwytrwbxsw2nqkw5i6otq53sk33jhvpq5kq====?1=1&data[]=16267695581629189819560392&v[]=1326260555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=1.051696270431351&loss=${AUCTION_LOSS}",
"adomain": [
"example.com",
"example.com"
],
"cat": [
"IAB13-1"
],
"adm": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><VAST version=\"3.0\"><Ad id=\"item_0\"><InLine><AdSystem><![CDATA[KDM]]></AdSystem><AdTitle><![CDATA[Таких милых котят вы еще не видели!]]></AdTitle><Impression><![CDATA[https://example.com/nurl/491/nn2e6ztelryv4b3dmixvaysopftaw6cqd43xm7kypvetcyqip5oqoyrjf4agk2stmyaxwxibmr4fh7pwnn2ovxec4df2tmfutzivbahx66dw4asgo5vtdo33brhfrfnryp4j3nnt2ngdzx44slxdijwpugkkw7jmyuy4g2cql3uiztksmajhflckiazfmt3luikz42yshea5oor6ju5wwklykrjdqsljyju46sta3b4v5qrz2l4tvzso57vu7qcv3uzys2evshrutlcr7z3lebe4naawk7duxfi72x52hehzsm6cjs3gbvs2wrxlks26ryjxhy3an7efkupijbqouv7dt7hynbnlvxd3m2gsk7rz7t4gqwv23r5wndnfotvzmbjs2bywwffwsmswz5p47p2h7zidwhb2o3te3y6aw6zvfeb2mfedevspnorblhtlpo4etrus5bb22xtanrwem6ojngo7n4khq5xssvcshbewsmvgocbwgnnkkzjoas3i2jknj27c7kckxlohwzunuvcyxnrvd4sxliehsx2ugv6s4bhqppvfvecknsbfkx4lmkc5vsst4vfa6vdqoc5wfungskgdbs3ngehuythrktwfnsr4jdetnw7lsdtfnucqkoee3uowtxdifaxeplwfnehir34va===?1=1&data[]=16267883652405580382770346&v[]=4130701133&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}]]></Impression><Creatives><Creative id=\"4924327\" AdID=\"4924327\"><Linear skipoffset=\"00:00:00\"><Duration>00:00:30</Duration><TrackingEvents></TrackingEvents><VideoClicks><ClickThrough><![CDATA[https://example.com/h/noixsxgotznhtcvsqtbjrl4hvowtsun5s6myctcb5coj7w7rvlota7stpnywqwaunvyeuon76kkmyzzydxgfhu2kyezzns2d2fizxkctqbel3f4zqhgkn3hbyvj5qsda3jl6hh6pq2c2xlohwzumev7dt7hynbnlvxd3m2fsktt6vbu3p3cfaopjnms7ytkjeqb4qvquqbfwr72uj5f4ceeyk3ddxollg6xe2w7jkow7ntbz4rvfimdjosqvh6mksttedozrkuleqzuipppyjnnnndjflw2jrfjxtjcrhhew3p7sstggpqd4kvafqqoo6x5e2w6f3jtuyuyyb5a2mvipjiuvekc6bizctzrzh3yuhskr4pcfvccivg3f5j2k7lahbvcqhhawxfmr4ne7sutm5fil424jb2ju26csmndzyuf5ik6dbudnvno3k6td5z6xlgjq7pnmbugntw5leasteu4heltskvseczlblzsaqajspztfkzazgz7qa6s6kr5ss4swgnhwyz24pnnaknk7s642dvugvtvmuxi222s35gsvfdh7fo7dsxg2tmfumaeprvx6niuzt36r5zgugvtqynnqr53bdjkh7rwfrp7ve2bwifucvto7inazb7c4diwbs7i=?u=http%3A%2F%example.com%2Fexmpl.php%3Fkey%3Dgmaej3st93w4pd4n89s5%26cost%3D0.0%26SID%3D1358019555422776%26ID%3D4924327%26CID%3D509220%26RID%3DES%26CATID%3D1175%26SUBAGE%3D0%26LANG%3Dru%26PLTFRM%3DANDROID]]></ClickThrough></VideoClicks><MediaFiles><MediaFile delivery=\"progressive\" type=\"video/mp4\" codec=\"0\" bitrate=\"992\" width=\"1280\" height=\"720\"><![CDATA[https://example.com/video/video/4327/327/60e46a79c6d22t1625582201r8751.mp4]]></MediaFile></MediaFiles></Linear></Creative></Creatives></InLine></Ad></VAST>"
}
],
"seat": "1",
"group": 0
}
]

}

XML интеграция

XML интеграция

Эта документация объясняет, как рекламодатели могут интегрировать свои платформы с Kadam, используя XML.


Bid Request/Response


Поддерживаемые типы рекламы:

  • Native;
  • Push;
  • On site push (inpage);
  • iOS calendar push;
  • Clickunder.

XML Bid Request

XML Bid Request

Описание поддерживаемых параметров

Следующие объекты следует отправлять в GET параметрах запроса:

Параметр Описание Использование Обязательный
sid endpoint ID Уникализация потока в Kadam. Выдается Kadam Обязательный
skey Ключ API Выдается Kadam
ua user agent Для определения ос, устройства, браузера пользователя на стороне Kadam Обязательный
ip IP-адрес пользователя Для определения геолокации устройства пользователя на стороне Kadam Обязательный либо IP, либо IPv6
uid ID пользователя в системе SSP Для уникализации пользователя Обязательный
limit Ограничение количества креативов в ответе Если лимит отсутствует в запросе и на блоке, считается как 1 по умолчанию
language Основной язык браузера, кодировка ISO 3166-1 alpha-2 Для определения языка браузера. Пример передачи: &language=ru-RU или &language=ru. Если параметр language не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп
subage / subage_dt / subage0 / subage_ts/ subage_ts_ms Возраст подписки пользователя Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (секунды в unixtime), subage_ts_ms - фактическая дата подписки (миллисекунды в unixtime) Обязательный для Push
pid ID паблишера В параметре ожидается ID паблишера (сайта, вебмастера) на стороне SSP Обязательный
cat IAB-категория домена По умолчанию на меинстриме - IAB24, на адалте - IAB25-3 Необязательный
page Домен страницы Ожидается страница Желательный
format Формат трафика Cu, pops - для кликандера;

Native, teaser - для тизера;

По умолчанию - push

Необязательный

Примеры Bid Request

PUSH

/feed

?sid=5

&skey=5azqxvgap5yNsm5X5rg5PMsgDD

&ua=Mozilla%2F5.0+%28Linux%3B+Android+9%3B+SAMSUNG+SM-A105FN%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+SamsungBrowser%2F12.1+Chrome%2F79.0.3945.136+Mobile+Safari%2F537.36

&ip=127.1.0.0

&uid=Xef5LfyUte-tzwpV5-fMV

&limit=1

&language=en

&pid=1

&subage=2

&cat=126

&page=example.com

CLICKUNDER

/feed

?sid=555

&format=cu

&ua=Mozilla%2F5.0+%28Linux%3B+Android+10%3B+SM-J600F%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F91.0.4472.88+Mobile+Safari%2F537.36

&ip=127.1.0.0

&uid=555555555

&limit=5

&language=fa-IR

&pid=5555555

&page=example.com

ON SITE PUSH (INPAGE)

/feed

?sid=5

&skey=5azqxvgap5yNsm5X5rg5PMsgDD

&ua=Mozilla%2F5.0+%28Linux%3B+Android+9%3B+SAMSUNG+SM-A105FN%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+SamsungBrowser%2F12.1+Chrome%2F79.0.3945.136+Mobile+Safari%2F537.36

&ip=127.1.0.0

&uid=Xef5LfyUte-tzwpV5-fMV

&limit=1

&language=en

&pid=1

&cat=126

&page=example.com

IOS CALENDAR PUSH

/feed

?sid=555

&skey=ca555555f555ec5a5a5ff55cc5b5fb5c

&ua=iOS%2F14.4+%5558D52%29+dataaccessd%2F1.0

&ip=127.1.0.0

&uid=0.00695555.5515680055292

&language=en

&subage_dt=2021-07-10

&pid=5555555555

&limit=1

NATIVE

/feed

?sid=555

&skey=b5cb555d5efcd555ade5555a5eaa5f55

&ua=Mozilla%2F5.0+%28Linux%3B+Android+11%3B+SM-T500%29+AppleWebKit%2F537.36+%28KHTML%2C+like+Gecko%29+Chrome%2F91.0.4472.120+Safari%2F537.36

&ip=127.1.0.0

&uid=5b5aa555-bd55-555b-a5d5-55f55f5c55df

&language=de

&pid=55

&page=example.com

&format=native

XML Bid Response

XML Bid Response

Описание поддерживаемых параметров (формат Bid Response может быть изменен по вашим требованиям, для этого обратитесь к нашему менеджеру)

result.listing

Параметр Описание Использование Обязательный
url Ссылка для перехода по объявлению
bid Ставка
pixel Nurl
image Ссылка на изображение материала
title Заголовок объявления
descr Текст объявления
site URL сайта
icon Ссылка на иконку

Примеры Bid Response:

PUSH

1. Icon содержит в себе nurl и icon, отдельный вызов pixel (nurl) не требуется

<result>

<listing
title="Looking for test?"
url="http://example.com/click"
descr="Find test here!"
bid="0.003"
image="http://example.com/5454.png"
icon="http://example.com/32434.png"
/>

<result>


2. С отдельным полем “pixel”

<result>

<listing
title="Looking for test?"
url="http://example.com/click"
descr="Find test here!"
bid="0.003"
pixel="http://example.com/nurl"
image="http://example.com/5454.png"
/>

<result>

CLICKUNDER

<result>

<listing
url="http://example.com/click"
bid="0.003"
/>

<result>

ON SITE PUSH (INPAGE)

<result>

<listing
title="Looking for test?"
url="http://example.com/click"
descr="Find test here!"
bid="0.003"
pixel="http://example.com/nurl"
image="http://example.com/5454.png"
icon="http://example.com/32434.png"
/>

<result>

IOS CALENDAR PUSH

<result>

<listing
title="Looking for test?"
url="http://example.com/click"
descr="Find test here!"
bid="0.003"
pixel="http://example.com/nurl"
image="http://example.com/5454.png"
icon="http://example.com/32434.png"
/>

<result>

NATIVE

<result>

<listing
title="Looking for test?"
image="http://example.com/5454.png"
site="http://example.com/click"
url="http://example.com/click"
bid="0.003"
pixel="http://example.com/nurl"
/>

<result>