OpenRTB/Feed документация по интеграции SSP — различия между версиями
Admin (обсуждение | вклад) (Новая страница: «Место для новой документации по RTB») |
Admin (обсуждение | вклад) (→OpenRTB Bid Response) |
||
(не показаны 83 промежуточные версии этого же участника) | |||
Строка 1: | Строка 1: | ||
− | + | == Общая информация == | |
+ | |||
+ | |||
+ | '''Интеграция''' | ||
+ | |||
+ | Узнать подробнее об интеграции по протоколам Feed и OpenRTB: | ||
+ | |||
+ | * [https://wiki.kadam.net/index.php?title=RTB_new#Feed_.D0.B8.D0.BD.D1.82.D0.B5.D0.B3.D1.80.D0.B0.D1.86.D0.B8.D1.8F Интеграция по Feed] | ||
+ | |||
+ | * [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: | ||
+ | |||
+ | * [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#Feed_Bid_Request Feed Bid Request] | ||
+ | |||
+ | * [https://wiki.kadam.net/index.php?title=RTB_new#Feed_Bid_Response Feed 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_Request OpenRTB 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#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] | ||
+ | |||
+ | |||
+ | '''Процесс интеграции''' | ||
+ | |||
+ | 1. Ознакомление с документацией. | ||
+ | |||
+ | 2. SSP регистрирует аккаунт вебмастера в системе [https://pub.kadam.net/en/reg Kadam]. | ||
+ | |||
+ | 3. Kadam создает и выдает эндпоинт/фид под соответствующий формат рекламы и тип интеграции (для каждого отдельный). | ||
+ | |||
+ | 4. Проводятся тесты на предмет работоспособности интеграции и наличия расхождений между данными системы Kadam и SSP. Тесты проводятся на “живых“ рекламных материалах. | ||
+ | |||
+ | 5. Если расхождения в пределах нормы и отсутствуют технические проблемы, запускается интеграция в полноценном рабочем режиме. | ||
+ | |||
+ | |||
+ | '''Ключевые моменты''' | ||
+ | |||
+ | * 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, необходимо убедиться, что вы поддерживаете передачу необходимых параметров и готовы отправлять запросы и получать от нас ответы; | ||
+ | |||
+ | * Клики без nurl не учитываются и попадают в traffic back; | ||
+ | |||
+ | * В документе указаны параметры, поддерживаемые Kadam, если какие-то параметры не описаны, значит их поддержка не реализована. | ||
+ | |||
+ | |||
+ | '''Cookie Matching''' | ||
+ | |||
+ | Для чего необходим Cookie Matching: | ||
+ | * позволяет избегать повторного показа рекламы пользователю; | ||
+ | * может быть использована в предикте его интересов; | ||
+ | * ретаргетинга. | ||
+ | С помощью Cookie Matching можно сопоставить id пользователя (по вашей версии), который просматривал ваш веб-сайт, с соответствующим id пользователя по версии Kadam. | ||
+ | |||
+ | Ознакомиться подробнее с возможными вариантами интеграции можно [https://wiki.kadam.net/index.php?title=Cookie_matching здесь]. Для настройки Cookie Matching необходимо обратиться к менеджеру Kadam. | ||
+ | |||
+ | == Feed интеграция == | ||
+ | |||
+ | '''Feed интеграция''' | ||
+ | |||
+ | Эта документация объясняет, как рекламодатели могут интегрировать свои платформы с Kadam, используя стандарт Feed. | ||
+ | |||
+ | |||
+ | '''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#Feed_Bid_Request Feed 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#Feed_Bid_Response Feed Bid Response] | ||
+ | |||
+ | |||
+ | '''Поддерживаемые типы рекламы:''' | ||
+ | |||
+ | * Native; | ||
+ | |||
+ | * Push; | ||
+ | |||
+ | * On site push (inpage); | ||
+ | |||
+ | * iOS calendar push; | ||
+ | |||
+ | * Clickunder. | ||
+ | |||
+ | == Feed Bid Request == | ||
+ | |||
+ | |||
+ | '''Feed 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 | ||
+ | |} | ||
+ | |||
+ | == Feed Bid Response == | ||
+ | |||
+ | '''Feed Bid Response''' | ||
+ | |||
+ | Описание поддерживаемых параметров (для изменения нейминга параметров в Bid Response обращайтесь к нашему менеджеру) | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |url | ||
+ | |Ссылка для перехода по объявлению | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |bid | ||
+ | |Ставка | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''Примеры Bid Response:''' | ||
+ | |||
+ | '''PUSH''' | ||
+ | |||
+ | '''1. Icon_url содержит в себе nurl и icon_url''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |[ | ||
+ | :{ | ||
+ | ::"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>, | ||
+ | ::"campaign_id": 555555, | ||
+ | ::"category": "1368", | ||
+ | ::"title": "Такого вы еще не видели!", | ||
+ | ::"text": "Самые милые котята", | ||
+ | ::"image_url": <nowiki>"https://example.com/auto/492x328/image/vk/6523/855/rect_607c75584b589t1618755776r1279.png"</nowiki>, | ||
+ | ::"icon_url": <nowiki>"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"</nowiki>, | ||
+ | ::"cpc": 0.031595385186374184 | ||
+ | :} | ||
+ | ] | ||
+ | |} | ||
+ | |||
+ | '''2. С отдельным полем “nurl”''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |[ | ||
+ | :{ | ||
+ | ::"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>, | ||
+ | ::"campaign_id": 555555, | ||
+ | ::"category": "1368", | ||
+ | ::"title": "Такого вы еще не видели!", | ||
+ | ::"text": "Самые милые котята", | ||
+ | ::"image_url": <nowiki>"https://example.com/auto/492x328/image/vk/6523/855/rect_607c75584b589t1618755776r1279.png"</nowiki>, | ||
+ | ::"icon_url": <nowiki>https://example.com/media/200x200/768cb8a8-f9c8-11eb-9d2b-901b0eb89438.jpg</nowiki>, | ||
+ | ::"nurl": <nowiki>https://example.com/nurl/552/nnme4yztlr7aqvzvlvgfkz2bmjvau6truwify55jzhuowviilfitubwzjy4vcgejx23othut2tk5eyby3hezfp2pdgzprdg6niuanxstmza75upsjvjx6ylykrjdqsljhyla6srjfyef4kzyjfutevspxnpna6kv3i4uh6jtrhquzukrrcue7aciwe4jmtw4ql2hvgkt4of7sc4djzfaij2hrrj66qmmgnle6kzbxb4uvlzzskv2e36cjgmir5lj7i4xnwjtkx3uuouypgwhb2cimpvfpnwgxlqilk5ny63grusxw3dlvyefvow4pnti3jlu5olakmwqofvrjmma6xey5ai3kr6eka46s25bkxsusyqffmioeouessypetejmn2hcvcshbewsms2b5nkfjkqbdo7uszjookluy2vcvk7i3ljjfutevspjoiw7mcwg7vew2pkkrhkwy4hw2o3covbnmvkmtkk5njxan3dlzyvqa3aflvwelwqk5diqsty6jkybrsaub56vn6zrnxlausmj5rfd2cq7m5os3mtzoh4yz7yprk6epfb6crotofj3fjmaue7yxf42mi=?1=1&data[]=16263451211203914908929689&v[]=3214290623</nowiki> | ||
+ | :} | ||
+ | ] | ||
+ | |} | ||
+ | |||
+ | '''CLICKUNDER''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"result": { | ||
+ | ::"listing": [ | ||
+ | :::{ | ||
+ | ::::"url": <nowiki>"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"</nowiki>, | ||
+ | ::::"bid": 0.5023327916860582 | ||
+ | :::} | ||
+ | ::] | ||
+ | :} | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''ON SITE PUSH (INPAGE)''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |[ | ||
+ | :{ | ||
+ | ::"id": "555555", | ||
+ | ::"impid": "5", | ||
+ | ::"crid": "555555", | ||
+ | ::"click_url": <nowiki>"https://example.com/h/npwxsxezwznhtbnm4tngo4gpv342t74aqnkgobcrkranjurzbflhuvi7vgzzb72shjo5c2fjkxtuvwofp7sfhe55ncffpt6l4hiir4xnvuv2cmyns5ficvuykvmnashgqtfy3mu6v6d2wu6ijdtijs4nwkpk7b5lko4ex34lu2lezqksn77faoqzewbfiuptmni3kvsshdevnqsuj2zwgwhyk7vi4z7bghzpu75bkov5bjh4ic5tcwci3kovc642ahmjo2hkauuuvokt5oo27gkprey76tndmji7qufq5ke64nggjnfhgk3q66ezgs3zuwufcu3aobtbiu3iimytqnuhimes5ucvqehps2ekynekgyedj2xfggzka5cgak3zkm2euzjwbeufyctgfqwqozq6nrras7s7avth46ifmupde2vyjnuluvhmsdfffrkwa5btquhxktxsra3lwblikme4nnts2ptsqrjkydc6as4wx5pc77wljjnp6rnse7ddhqrscicmmffwkzqppvnqg33wloaltin63trjnwchp3h7dz52pqcjdnv5rhh2tmfutzisbvgqsqnqtjxcyf4ugvdqfjremyllak2j3c7gkzbe6wrzkg5ai5xx3ztgs6cuklmbrunm5ehokjvrljgmpldw?u=https%3A%2F%2example.com%2F%3Fp%3Dgu3donzxgq5gi3bpgqztqnq%26sub1%3Dcnv6d22d21d1a580cff6f855567012d5ff8"</nowiki>, | ||
+ | ::"campaign_id": 555555, | ||
+ | ::"category": "1096", | ||
+ | ::"title": "Такого вы еще не видели!", | ||
+ | ::"text": "Самые милые котята", | ||
+ | ::"image_url": <nowiki>"https://example.com/auto/492x328/image/vk/499/499/rect_60daf0b6704d4t1625551206r7408.jpg"</nowiki>, | ||
+ | ::"icon_url": <nowiki>"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"</nowiki>, | ||
+ | ::"cpc": 0.00027081758307758715 | ||
+ | :} | ||
+ | ] | ||
+ | |} | ||
+ | |||
+ | '''IOS CALENDAR PUSH''' | ||
+ | |||
+ | '''1''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |[ | ||
+ | :{ | ||
+ | ::"click_url": <nowiki>"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"</nowiki>, | ||
+ | ::"nurl": <nowiki>"https://example.com/nurl/841/nnmb2nzxbyvfybbxlvgfk2klmbrac6trs2dfy24yq744suyizfvqvvs7doufmielknmj5ofvuhe2pp4u45ktva6jvg2vap6ltxsmcvrk2fhogmydi6dpf7l2jrgassljgl3nnuwyn44fkgwrjymtql2pjnqva6cuuid4s2bt3zhed4kr7d4flcciwg7ut52k7jnlqvm7vpsgx72xrttdc2nnkwjt72sv25lyfb5nnwifktgfjcvj6btw4nqg7scvkhueqz7kk7qmj2h6pk2fhf6g4cofjj2kmcrhsvyhnmg6ambhoja3n4yiwfw2qs3isjkn2sglkj5qcal47fv3rsovs2ok7b5lvu4yw2ywl5huwypq4hg6wb2yhofeqmvci7quofmktm4wix6iaj2daudykrjdqsmzbwpe2lvtkj4iyub2vfv6neotwsm27b5lvu42c2zk3rgegateje3dmcjibsjfljsmzfjxxzcrdxywvumrbcfwfdw2cordxd6huqp42t3fkruvou5ijxadb5sl6dqzb72s7i6erwjwv6mmv7er7txfbacn4ow4zevwt2xypk2t?1=1&data[]=16263414351155619727343372&v[]=3620955548"</nowiki>, | ||
+ | ::"title": "Такого вы еще не видели!", | ||
+ | ::"description": "Самые милые котята", | ||
+ | ::"price": 0.0009038956149015577 | ||
+ | :} | ||
+ | ] | ||
+ | |} | ||
+ | |||
+ | '''2''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |[ | ||
+ | :{ | ||
+ | ::"id": "5555555", | ||
+ | ::"click_url": <nowiki>"https://example.com/h/np6hsxgn5fnhts7urcogm4eb62k67px2rbkgovcr2b5gzuribflhuvi7slly772shjo5c2gukdtuvsw5odsfhd6tnoffpt6l4hior65gyaz2cm2ys5fgbmdzlk5dtdvsrpf3hne6v6dvlirzt2g7fjsmznr2jync4y5ns2zz6zgvhs2spidrpcclo77vit2lyeiiqvsrybfuzmsv22u4gupqk7ukb2ti6jk6vtv4wz4ymujzjcytdyxizssvvgcx3u5kc2rt2zfzfv4p75jmepcipn6f5ff7znjgrjveefiwqesib5fdcwralyziaqibjt7e5hh5k7efl6nvigathaotjtqve6o4kdr33qzq5ngre6toicivanmbw4eygtispjxebjcq4dez7tneupsi7c3zjykde2k5kazxw6crmfeg2mabfvoqmzd7pyageslfgegx6uahg57hub3idrcmth6jrshprv6qnj4priuzzjgswmgojqn65px345iwbspltycc7x6v3zfhmvrqg5muy7snpo4onj6tkqbfkyjtj2mnoztq2pmvuakjnezbm7dyulxtsmzulyhtpchpoa======?u=https%3A%2F%2Fexample.info%takogo-vi-eshe-ne-videli"</nowiki>, | ||
+ | ::"campaign_id": 555555, | ||
+ | ::"category": "1080", | ||
+ | ::"title": "Такого вы еще не видели!", | ||
+ | ::"text": "Самые милые котята", | ||
+ | ::"image_url": <nowiki>"https://example.com/auto/492x328/image/vk/7371/371/rect_60cda4dada569t1655589818r9023.jpg"</nowiki>, | ||
+ | ::"icon_url": <nowiki>"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"</nowiki>, | ||
+ | ::"cpc": 0.001349156436044723 | ||
+ | :} | ||
+ | ] | ||
+ | |} | ||
+ | |||
+ | '''NATIVE''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |[ | ||
+ | :{ | ||
+ | ::"id": "5555555", | ||
+ | ::"url": <nowiki>"https://example.com/h/npvxsxge6nnhtrfmt3ijvl4hvowts2m7zcd5jigt5f5hysqilfituftqanrabyvw5w7u6akxzzhkgzhypge22p7zndhmktptmdiprvgs3dt7nchfj2bwac5akwvbvklihg7e5qegvtvflirzykhm5rcoznryhbhd23d3nfwnvfhnwy2t3blfdeslnn3bh72jnpuhuvm7hjewseqxx5eurkd2i3jdxd67trl4oshi6lgfler3tdnye7m5jbtue7b4gq7uvmjrxgsm55k5tbl4oovbniz2mtck4fkofnxnx5h7snsxlujwt3wkznicrjf3f5he423lcb4qiwdaime5kxrhujtpq6n42e77s2hpvfekgyfy7nj5eosi4eyor7oumpwxv7o45nz2ymbcbdxf7gd2qnno2s4l4wuhlltdaep7u3wijpa776ntygw5ndjkjb7ugtikgr6cuadfjzqh6wrnlucxw6t7kazfknlalr7uiadgff6vmnsig5qq6lipek573u5u2kmodrqomhuzj6nrj4y2jrm5sy7rd2nq7iosxb7m4pgvggspmhkf475cmz4huzgi3l3o4ndmknbwaseq25krrfewgvxu6s3b6dq43g4hba5yusbsujdzcry=?u=https%3A%2F%2Fexample.com%2Ftrack%3Fc%3D724872%26subid%3D1378335325453686%26subid2%3D320918"</nowiki>, | ||
+ | ::"cid": "555555", | ||
+ | ::"title": "Самые милые котята", | ||
+ | ::"image": <nowiki>"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"</nowiki>, | ||
+ | ::"cpc": 0.0018077912298031153 | ||
+ | :} | ||
+ | ] | ||
+ | |} | ||
+ | |||
+ | == OpenRTB интеграция == | ||
+ | |||
+ | '''OpenRTB интеграция''' | ||
+ | |||
+ | Эта документация объясняет, как рекламодатели могут интегрировать свои платформы с Kadam, используя стандарт OpenRTB. | ||
+ | |||
+ | '''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#OpenRTB_Bid_Request OpenRTB 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#OpenRTB_Bid_Response OpenRTB Bid Response] | ||
+ | |||
+ | '''Поддерживаемые типы рекламы:''' | ||
+ | |||
+ | * Native; | ||
+ | |||
+ | * Native (teaser); | ||
+ | |||
+ | * Banner; | ||
+ | |||
+ | * Push; | ||
+ | |||
+ | * On site push (inpage); | ||
+ | |||
+ | * iOS calendar push; | ||
+ | |||
+ | * Clickunder; | ||
+ | |||
+ | * Video. | ||
+ | |||
+ | == OpenRTB Bid Request == | ||
+ | |||
+ | '''OpenRTB Bid Request''' | ||
+ | |||
+ | Описание поддерживаемых параметров | ||
+ | |||
+ | '''Следующие объекты следует отправлять в кодировке JSON в request body:''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |subage / subage_dt / subage0 / subage_ts | ||
+ | |Возраст подписки пользователя | ||
+ | |Если параметр subage не заполнен, заполнен некорректно или не передается, он считается "неопределенным", это снижает выкуп. Для первого дня подписки ожидается: subage=1, subage0=0, subage_dt - фактическая дата подписки, subage_ts - фактическая дата подписки (unixtime) | ||
+ | |Обязательный для Push Ad | ||
+ | |} | ||
+ | |||
+ | '''imp.native''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |request | ||
+ | |Запрос в кодировке JSON для Push и Native материалов | ||
+ | |Варианты: | ||
+ | |||
+ | openrtb.native.string - JSON текст запроса; | ||
+ | |||
+ | openrtb.native - запрос является JSON объектом. Он аналогичен openrtb.native.string, только в случае строки запрос кодируется в JSON текст | ||
+ | |Обязательный | ||
+ | |- | ||
+ | |ver | ||
+ | |Версия спецификации нативной рекламы, которой соответствует запрос | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''imp.native.request''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |plcmtcnt | ||
+ | |Количество одинаковых размещений в этом шаблоне | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''imp.banner''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |w | ||
+ | |Ширина баннера в пикселях | ||
+ | | | ||
+ | |Обязательный либо “w” и “h”, либо “format” | ||
+ | |- | ||
+ | |h | ||
+ | |Высота баннера в пикселях | ||
+ | | | ||
+ | |Обязательный либо “w” и “h”, либо “format” | ||
+ | |- | ||
+ | |format | ||
+ | |Массив объектов, представляющих допустимые размеры баннера | ||
+ | | | ||
+ | |Обязательный либо “w” и “h”, либо “format” | ||
+ | |} | ||
+ | |||
+ | '''imp.video''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |id | ||
+ | |Уникальный идентификатор сайта | ||
+ | |Для уникализации сайта, создания black- или white-листов партнерами | ||
+ | |Обязательный | ||
+ | |- | ||
+ | |domain | ||
+ | |Домен страницы | ||
+ | |Для внутренней классификации доменов в системе Kadam | ||
+ | |Обязательный | ||
+ | |- | ||
+ | |page | ||
+ | |Полный адрес страницы | ||
+ | |Для внутренней классификации сайтов в системе Kadam | ||
+ | |Рекомендуемый | ||
+ | |- | ||
+ | |name | ||
+ | |Название сайта | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |publisher | ||
+ | |Данные о владельце сайта | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |content | ||
+ | |Подробная информация о содержимом сайта | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |cat | ||
+ | |Список IAB категорий сайта. Массив строк | ||
+ | |Можно не передавать, если заполнен параметр domain, так как Kadam ведется внутренняя классификация доменов | ||
+ | |Рекомендуемый | ||
+ | |- | ||
+ | |ext | ||
+ | |Дополнительные параметры сайта | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''site.publisher''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |id | ||
+ | |Уникальный идентификатор сайта | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''app''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |id | ||
+ | |Уникальный идентификатор владельца приложения | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |name | ||
+ | |Имя владельца приложения | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''user''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |id | ||
+ | |Уникальный идентификатор пользователя в системе | ||
+ | |Если не заполнен, то Kadam генерирует самостоятельно | ||
+ | | | ||
+ | |- | ||
+ | |buyeruid | ||
+ | |Уникальный идентификатор пользователя в системе Kadam | ||
+ | |Используется, если настроен Cookie Matching. Является приоритетней user.id | ||
+ | | | ||
+ | |- | ||
+ | |yob | ||
+ | |Год рождения в виде целого 4-значного числа | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |gender | ||
+ | |Пол | ||
+ | |"M" = мужчина; | ||
+ | |||
+ | "F" = женщина; | ||
+ | |||
+ | "O" = неизвестно | ||
+ | | | ||
+ | |- | ||
+ | |ext | ||
+ | |Дополнительные параметры пользователя | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''user.ext''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |consent | ||
+ | |Строка согласия IAB Transparency and Consent Framework (TCF) v2, полученная от платформы управления согласием (CMP) паблишера. Структура строки определяется IAB TCF v2 | ||
+ | |Это поле будет заполнено, если издатель интегрирован с CMP для TCF v2, и эта CMP указывает, что GDPR применяется к данному рекламному запросу и предоставляет действительную строку согласия | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''device''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |utcoffset | ||
+ | |Количество часов, на которое смещен часовой пояс от UTC | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |country | ||
+ | |Код страны (по стандарту ISO-3166-1 Alpha-3) | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''ext''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |bsection | ||
+ | |Используется для указания категорий материалов, которые запрещены в рамках данного реквеста. Целочисленный вид | ||
+ | |Для получения полного списка категорий необходимо обратиться к менеджеру | ||
+ | |Необязательный | ||
+ | |- | ||
+ | |btags | ||
+ | |Используется для указания тегов материалов, которые запрещены в рамках данного реквеста. Целочисленный вид | ||
+ | |Для получения полного списка тегов необходимо обратиться к менеджеру | ||
+ | |Необязательный | ||
+ | |} | ||
+ | |||
+ | '''Примеры Bid Request''' | ||
+ | |||
+ | '''CLICKUNDER''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"http://example.com"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/ru/"</nowiki>, | ||
+ | ::"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)''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/ru/"</nowiki>, | ||
+ | ::"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)''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/ru/"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://www.example.com/"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com,/ru/"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://apps.apple.com/us/app/example/id555555555?uo=4"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com,/ru/"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/"</nowiki>, | ||
+ | ::"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''' | ||
+ | |||
+ | Описание поддерживаемых параметров | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |id | ||
+ | |ID bid request | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |cur | ||
+ | |Валюта ставки (с использованием ISO-4217) | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |seatbid | ||
+ | |Массив seatbid объектов | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''seatbid''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |bid | ||
+ | |Массив bid объектов | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |seat | ||
+ | |ID покупателя, от имени которого | ||
+ | делается ставка | ||
+ | | | ||
+ | | | ||
+ | |- | ||
+ | |group | ||
+ | |0 = можно выиграть в индивидуальном порядке; | ||
+ | |||
+ | 1 = должны быть выиграны или проиграны группой | ||
+ | |По умолчанию 0 | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | '''seatbid.bid''' | ||
+ | |||
+ | {| class="wikitable" style="width: 85%;" | ||
+ | |- | ||
+ | | style="width: 10%"|'''Параметр''' | ||
+ | | style="width: 20%"|'''Описание''' | ||
+ | | style="width: 50%"|'''Использование''' | ||
+ | | style="width: 20%"|'''Обязательный''' | ||
+ | |- | ||
+ | |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''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"id": "5ccab55d-a5a5-5555-5e55-aa5b5b55b5a5", | ||
+ | :"seatbid": [ | ||
+ | ::{ | ||
+ | :::"bid": [ | ||
+ | ::::{ | ||
+ | :::::"id": "5", | ||
+ | :::::"adid": "5555555", | ||
+ | :::::"crid": "5555555", | ||
+ | :::::"impid": "555555555", | ||
+ | :::::"price": 1.9711000061035155, | ||
+ | :::::"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>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com", | ||
+ | ::::::"example2.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB9-7" | ||
+ | :::::], | ||
+ | :::::"adm":<nowiki>"https://click_url_must_be_here.com"</nowiki> | ||
+ | ::::} | ||
+ | :::], | ||
+ | ::"seat": "1", | ||
+ | ::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''PUSH''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"cur": "USD", | ||
+ | :"id": "9af20dd3-6668-41cd-9656-afd85f2bab14", | ||
+ | :"seatbid": [ | ||
+ | ::{ | ||
+ | :::"bid": [ | ||
+ | :::::{ | ||
+ | ::::::"id": "1", | ||
+ | ::::::"adid": "0", | ||
+ | ::::::"crid": "0", | ||
+ | ::::::"cid": "0", | ||
+ | ::::::"impid": "123456", | ||
+ | ::::::"price": 1.2, | ||
+ | ::::::"nurl": <nowiki>"https://example.com/nurl/111/nn2e2njubj4q2vtfmj6vozsapftaskqnd5xxs7sxpumtenqapqhqanboffigiyfmyevwty6oxhmesukuiboafckkgeytnywd6tljvlprzipqdk7krxbgoihyzknkarirwjl4ksraldz4n5r2kf3qhmbu5keuq6vznvaus2jskzhuxelp7bkvhkciu2zf572kz7agngktohpz4cedj3umn32ewfjwbjjdb27e4vm4khnjatyd4fua3zsojdmvcje4konwvojtkcluvjx4y5f3eomoywgutj2kurjiuvkrniocxo2uj5fwd4hbzw5qp2llvjk6kslcauvrbyr2wotjr22nrfrxq4mc5bkf7ytp35ygfgkenreq6ew2kybee527ebi2u36kykrzydihj5fwcudyksrapallksce2s5zkj43iueyrgz7hlvqwspk66n4ka54g2r2nz4h6adfdfrglgck5ez74tck2fjx33cr4c7eh4svtc6exid37dv7nl3nwbje2t3cyb6jcvfajvujeuww66r5s7xek2zllbvf2typsy7ipsxj3exunm======?1=1&data[]=16305761533610140283188376&v[]=2558667725&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}"</nowiki>, | ||
+ | ::::::"lurl": "<nowiki>https://example.com/lurl/111/nn2e2njubj4q2vtfmj6vozsapftaskqnd5xxs7sxpumtenqapqhqanboffigiyfmyevwty6oxhmesukuiboafckkgeytnywd6tljvlprzipqdk7krxbgoihyzknkarirwjl4ksraldz4n5r2kf3qhmbu5keuq6vznvaus2jskzhuxelp7bkvhkciu2zf572kz7agngktohpz4cedj3umn32ewfjwbjjdb27e4vm4khnjatyd4fua3zsojdmvcje4konwvojtkcluvjx4y5f3eomoywgutj2kurjiuvkrniocxo2uj5fwd4hbzw5qp2llvjk6kslcauvrbyr2wotjr22nrfrxq4mc5bkf7ytp35ygfgkenreq6ew2kybee527ebi2u36kykrzydihj5fwcudyksrapallksce2s5zkj43iueyrgz7hlvqwspk66n4ka54g2r2nz4h6adfdfrglgck5ez74tck2fjx33cr4c7eh4svtc6exid37dv7nl3nwbje2t3cyb6jcvfajvujeuww66r5s7xek2zllbvf2typsy7ipsxj3exunm======?1=1&data[]=16305761533610140283188376&v[]=2558667725&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | ::::::"adm": <nowiki>"{\"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\"}}]}}</nowiki>" | ||
+ | :::::} | ||
+ | ::::] | ||
+ | ::::"seat": "1", | ||
+ | ::::"group": 0 | ||
+ | :::} | ||
+ | ::] | ||
+ | :} | ||
+ | |} | ||
+ | |||
+ | '''ON SITE PUSH (INPAGE)''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"cur": "USD", | ||
+ | :"id": "a55f5c55-5f5f-55fb-a5d5-55555555c555", | ||
+ | :"seatbid": [ | ||
+ | ::{ | ||
+ | :::"bid": [ | ||
+ | ::::{ | ||
+ | :::::"id": "5", | ||
+ | :::::"adid": "5555555", | ||
+ | :::::"crid": "5555555", | ||
+ | :::::"cid": "555555", | ||
+ | :::::"impid": "5555555", | ||
+ | :::::"price": 0.3153782760333318, | ||
+ | :::::"nurl": <nowiki>"https://example.com/nurl/460/nn2bs3ddlz7quademj7aoyq6pftaylyld43x2l2spvggazyipjoagzjmpvlwg2stmyaxuxqln53fhmwmnn2propbtazx537a4waipk5ny63gqasgo5btdhd3brjvrfekr6jmfywy352dzn7irhxdijwptxwn27jm54y4g2dnl3apttcsmbfggocjngjm7vvclyihshg6he4wgs2wj5fwcudyurw3qsdixjlulw3atwovfyrz4hzs33sovfvja6o34ckuxjbtnuw2qwefphvpnclxwezycr5omco3igdn2behpt2xoquye2pvkzxtfhsvtjlxb63akpafkcpqjcirbbsoig4vdwmc2o23pfwnvgyevakr3gbnhnnxs3g2tmckrfixtjsthmnty4g7jvfwcuaygi2nm5wdgbkrugbf4b5jpufnt5vpavcuijqva6huzoq2avttnturapdyk6ag22kjnezfmt2lsfx3avrx5jfwt2suj2vwhlehx7a4lnuwzwuu5i3dioefmu5sjjqqoyd2prmdcqbv6i54k2e2kvepwysbyblzjtrtvey7vdzqsfjz7ghwxja6wnsujnepcvhvk3fdysgjg2zz7c7gk3ifau4ijxb3h7v67kv6g6xmk354x7heku======?1=1&data[]=16263517182058676639420194&v[]=5554186872&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}"</nowiki>, | ||
+ | :::::"lurl": <nowiki>"https://example.com/lurl/460/nn2bs3ddlz7quademj7aoyq6pftaylyld43x2l2spvggazyipjoagzjmpvlwg2stmyaxuxqln53fhmwmnn2propbtazx537a4waipk5ny63gqasgo5btdhd3brjvrfekr6jmfywy352dzn7irhxdijwptxwn27jm54y4g2dnl3apttcsmbfggocjngjm7vvclyihshg6he4wgs2wj5fwcudyurw3qsdixjlulw3atwovfyrz4hzs33sovfvja6o34ckuxjbtnuw2qwefphvpnclxwezycr5omco3igdn2behpt2xoquye2pvkzxtfhsvtjlxb63akpafkcpqjcirbbsoig4vdwmc2o23pfwnvgyevakr3gbnhnnxs3g2tmckrfixtjsthmnty4g7jvfwcuaygi2nm5wdgbkrugbf4b5jpufnt5vpavcuijqva6huzoq2avttnturapdyk6ag22kjnezfmt2lsfx3avrx5jfwt2suj2vwhlehx7a4lnuwzwuu5i3dioefmu5sjjqqoyd2prmdcqbv6i54k2e2kvepwysbyblzjtrtvey7vdzqsfjz7ghwxja6wnsujnepcvhvk3fdysgjg2zz7c7gk3ifau4ijxb3h7v67kv6g6xmk354x7heku======?1=1&data[]=16263517182058676639420194&v[]=5554186872&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB2-3" | ||
+ | :::::], | ||
+ | :::::"adm": <nowiki>"{\"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\"}}]}}</nowiki>" | ||
+ | ::::} | ||
+ | |} | ||
+ | |||
+ | '''NATIVE (TEASER)''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/nurl/497/nn2eyzthaf6vqb3pmj7fgzq4pftac623d42h4kafpungoyaooegqayt5ojlwc2stmygx6wagmf6vhdhxnn2lxg5mzazx565ltt7ibk5ny63gqasgo5fddil3bqavr7ho23p4rqftyvntz4perhxdijwpuh4p65jmfszeqnz2s3552y2iojsveocjfeawlpduefitakrcgiygsmswj5fwdich2rjttqlihdde55ghk3efl3xjkpith7sfrnqjbtgckd2uq5pgezzj4yaymtmrbycixy5lgtwr7deuppctgk2gr43azv3oyuurhlpqjylibxte4sgzkf6iiuz7sfuklppsr5t3a6odxgcy2362k5hlsyctfudrnmkldahvzghicg2up7sqhmodu5xgjwz5rr4evkw4pnuwgoke2udikb4fieqlpkna2f6kuayjrbpdwedrq2jskzhuwynai6ofaxm3nmzi4tkkqfjpxl7bzfhicmcpx5ewbwt3lrtf46kyazqhw66bkmdpyuj67fvdz3smwleqzocx6xubhojr4pxorbfmq6v23r2iwqyzumcdl2qhxy6vrhvgnssvjlewkwl6ka4twtqfsweu5w3f7n5myvrz5fwzdcupzrt7q7cv4i6kbswx66plnvksybikvao6sxgktmfutziq====?1=1&data[]=16263531872967219577169276&v[]=5550842573&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}"</nowiki>, | ||
+ | :::::"lurl": <nowiki>"https://example.com/lurl/497/nn2eyzthaf6vqb3pmj7fgzq4pftac623d42h4kafpungoyaooegqayt5ojlwc2stmygx6wagmf6vhdhxnn2lxg5mzazx565ltt7ibk5ny63gqasgo5fddil3bqavr7ho23p4rqftyvntz4perhxdijwpuh4p65jmfszeqnz2s3552y2iojsveocjfeawlpduefitakrcgiygsmswj5fwdich2rjttqlihdde55ghk3efl3xjkpith7sfrnqjbtgckd2uq5pgezzj4yaymtmrbycixy5lgtwr7deuppctgk2gr43azv3oyuurhlpqjylibxte4sgzkf6iiuz7sfuklppsr5t3a6odxgcy2362k5hlsyctfudrnmkldahvzghicg2up7sqhmodu5xgjwz5rr4evkw4pnuwgoke2udikb4fieqlpkna2f6kuayjrbpdwedrq2jskzhuwynai6ofaxm3nmzi4tkkqfjpxl7bzfhicmcpx5ewbwt3lrtf46kyazqhw66bkmdpyuj67fvdz3smwleqzocx6xubhojr4pxorbfmq6v23r2iwqyzumcdl2qhxy6vrhvgnssvjlewkwl6ka4twtqfsweu5w3f7n5myvrz5fwzdcupzrt7q7cv4i6kbswx66plnvksybikvao6sxgktmfutziq====?1=1&data[]=16263531872967219577169276&v[]=5550842573&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB14" | ||
+ | :::::], | ||
+ | :::::"adm": <nowiki>"{\"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\"}}]}}</nowiki>" | ||
+ | ::::} | ||
+ | :::], | ||
+ | :::"seat": "1", | ||
+ | :::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''NATIVE APP''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"cur": "USD", | ||
+ | :"id": "55fe5555-eb5a-5d55-55ed-a555e5d555a5", | ||
+ | :"seatbid": [ | ||
+ | ::{ | ||
+ | :::"bid": [ | ||
+ | ::::{ | ||
+ | :::::"id": "5", | ||
+ | :::::"adid": "5555555", | ||
+ | :::::"crid": "5555555", | ||
+ | :::::"cid": "555555", | ||
+ | :::::"impid": "e55a55ea55", | ||
+ | :::::"price": 0.010579906888306142, | ||
+ | :::::"nurl": <nowiki>"https://example.com/nurl/799/nn2e43julv6vabtamixag2azpftfy4kzd5xx2lqfpumwiziafrpvmz35omagi2stmyaxsxigmv5fhpu6nn2lzg5bzqzx5g7ov2ph6zgshjyw2ywjjejwemej4ho4dovo5wakgsqjqtxi5vj6hhuzfm53jym7g4o6kntedguz7vgvg23bpbkff6efuxbgsd2kfevaqxrlhbewsmswj65v5udzkxndsq7zgpu6storkhdikseajditvfsoxdfpw6uzkpjr57aiqnho2q6ji6gfhw2nrqztakonl24hsxvphhqictdmyjerhb2pnd5ds5wzgnk7ostpsb4vlgrzjc4tgwexjk7olnm2v7d3nfwnk6xuvpxfwwnk7r5ws3gvpj2kmcrhsvyhnmg6ambhoja3n4yiwfwzes3km4cqx63dsdz4zkoaw2lm3kkorfruw4kuki4itjp6uzyau2uh3ncltewmkzrvmt2lmfihrjdn6bfqzycuj6jwgumyk2qphu5rgg7e2surkj454ujqfvpaknlzfjkgjwcxfcieu2uckvvjwyvozxmiip4uni4ic3dxsfj7pdwd2jg6wnsrjprl4uiikni2qtocgdhewswbkswmfcf7j7atmv77j6h7hehrupj7a24kkkh4b6nlqcv23r5wna======?1=1&data[]=16267702601928352117733179&v[]=555249867&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}"</nowiki>, | ||
+ | :::::"lurl": <nowiki>"https://example.com/lurl/799/nn2e43julv6vabtamixag2azpftfy4kzd5xx2lqfpumwiziafrpvmz35omagi2stmyaxsxigmv5fhpu6nn2lzg5bzqzx5g7ov2ph6zgshjyw2ywjjejwemej4ho4dovo5wakgsqjqtxi5vj6hhuzfm53jym7g4o6kntedguz7vgvg23bpbkff6efuxbgsd2kfevaqxrlhbewsmswj65v5udzkxndsq7zgpu6storkhdikseajditvfsoxdfpw6uzkpjr57aiqnho2q6ji6gfhw2nrqztakonl24hsxvphhqictdmyjerhb2pnd5ds5wzgnk7ostpsb4vlgrzjc4tgwexjk7olnm2v7d3nfwnk6xuvpxfwwnk7r5ws3gvpj2kmcrhsvyhnmg6ambhoja3n4yiwfwzes3km4cqx63dsdz4zkoaw2lm3kkorfruw4kuki4itjp6uzyau2uh3ncltewmkzrvmt2lmfihrjdn6bfqzycuj6jwgumyk2qphu5rgg7e2surkj454ujqfvpaknlzfjkgjwcxfcieu2uckvvjwyvozxmiip4uni4ic3dxsfj7pdwd2jg6wnsrjprl4uiikni2qtocgdhewswbkswmfcf7j7atmv77j6h7hehrupj7a24kkkh4b6nlqcv23r5wna======?1=1&data[]=16267702601928352117733179&v[]=555249867&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB9" | ||
+ | :::::], | ||
+ | :::::"adm": <nowiki>"{\"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\"}}]}}</nowiki>" | ||
+ | ::::} | ||
+ | :::], | ||
+ | :::"seat": "1", | ||
+ | :::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''BANNER''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/nurl/396/nn2eazjrbivaybjqmj4qayy5pftfy7ild43xm4ydpuodo2ypfjpqumtwp5igm2stmyahcxiamb5vhcgznn2ll2fqqa3h5d6drwtxuzccabattpsvc5baddpx72p7vo6554wspnucsd7veivyswn2cxjx5zunu6jwlkimpqzqjzcxuykqpbkfeocnffzfobzrcfnacvcshbewsmvgodfwaupqkvmkqsezqnjp6suprrtoyu6zicuth7wb4frz26m5tclxhpbtltmb2imipgbvvxkinezhmd5dmbciqvpqhk2grboycfy6yuxb6upajylibxte4sgzkerzyu6ano4tgx4xjlgz3ygjktmerrp7z3je3ckrpgtfgoy3hryn6tj2lrnk75zc3v3mgmcvdimclyd2zcapdu4rzwu3bndasj5e6wzyjfutevspj4qrd3esk3jdkcztcypewykqpbkffsdwueydhhkjmgehuvnshlq5lmn5jcrwgruikzj3estbae2h27ksnanwnsr3atetclhhjbvoa62e5i53d6quszglz4twvbl6jro4n7xvkptwvnxyqv75vx522ooujnagovgrrnjuqswo5vlshw3f757myvrz5fw47nmpzrt7q7cv4i6k5oolx7n5nucsybim52ua6pfktmfutziq====?1=1&data[]=16263541733087802523950643&v[]=-1830393555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=2.1730898173053195"</nowiki>, | ||
+ | :::::"lurl": <nowiki>"https://example.com/nurl/396/nn2eazjrbivaybjqmj4qayy5pftfy7ild43xm4ydpuodo2ypfjpqumtwp5igm2stmyahcxiamb5vhcgznn2ll2fqqa3h5d6drwtxuzccabattpsvc5baddpx72p7vo6554wspnucsd7veivyswn2cxjx5zunu6jwlkimpqzqjzcxuykqpbkfeocnffzfobzrcfnacvcshbewsmvgodfwaupqkvmkqsezqnjp6suprrtoyu6zicuth7wb4frz26m5tclxhpbtltmb2imipgbvvxkinezhmd5dmbciqvpqhk2grboycfy6yuxb6upajylibxte4sgzkerzyu6ano4tgx4xjlgz3ygjktmerrp7z3je3ckrpgtfgoy3hryn6tj2lrnk75zc3v3mgmcvdimclyd2zcapdu4rzwu3bndasj5e6wzyjfutevspj4qrd3esk3jdkcztcypewykqpbkffsdwueydhhkjmgehuvnshlq5lmn5jcrwgruikzj3estbae2h27ksnanwnsr3atetclhhjbvoa62e5i53d6quszglz4twvbl6jro4n7xvkptwvnxyqv75vx522ooujnagovgrrnjuqswo5vlshw3f757myvrz5fw47nmpzrt7q7cv4i6k5oolx7n5nucsybim52ua6pfktmfutziq====?1=1&data[]=16263541733087802523950643&v[]=-1830393555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com", | ||
+ | ::::::"example2.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB18-1" | ||
+ | :::::], | ||
+ | :::::"w": 336, | ||
+ | :::::"h": 280, | ||
+ | :::::"adm": <nowiki>"<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>"</nowiki> | ||
+ | ::::} | ||
+ | :::], | ||
+ | :::"seat": "1", | ||
+ | :::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''BANNER APP''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"cur": "USD", | ||
+ | :"id": "th5qj5l5tp5sbjg55t5", | ||
+ | :"seatbid": [ | ||
+ | ::{ | ||
+ | :::"bid": [ | ||
+ | ::::{ | ||
+ | :::::"id": "5", | ||
+ | :::::"adid": "TPL55_AD4921726", | ||
+ | :::::"crid": "TPL55_AD4921726", | ||
+ | :::::"cid": "555555", | ||
+ | :::::"impid": "1", | ||
+ | :::::"price": 0.014145912714302543, | ||
+ | :::::"lurl": <nowiki>"https://example.com/lurl/830/nnbqypdkjerv4xtfhm5viiy2hy2qc4a5avceq72ymjewgyaokho72rlp6dy55d5ivxd3nfrtm3huswkufdvfiycibgaptd4ir7l7vneyheq77i4mzbgrdueixdjtgmpngpoe4kljv3fpqubainmdevspjnqva6auci4qd3jtezcteykqpbkfeofzk2zfotwdmbnoqvpzvba5sm54yvknsuocl6jdtn63tzkiesqys43g5bzzqwd7w2mxjlffnhkvki4esko2k5n3wycjqvksx7yhko7vi7kayjwnavlnrbegvcsxigbwau5ikvooashq5k2irmu6v6d2wu6yjdyovneiwkpk7b5lkpieq2gak5gb4mqu6flcgbkdx2isnktuznjhwaibpt4wxex4y2hztl4hvowttc3lffpu6s3bkb4fiutybbldraimyom5yryfki4es2jsk27xjkksdwdfaoernmz3mtmczguzwuv2hjbzsmcxyvegs2kjmiyfykypkthey2gbkp6fl6r3jlmtc47xjccniweukhtm2spckwf3h65gpoevcmu6jihkmtgvrtup6u6qhrhw2q77sbfgfqd43bikatlisjjntwv3257pyvrz7fwytrwbxsw2nqkw5i6otq53sk33jhvpq5kq====?1=1&data[]=16267695581629189819560392&v[]=1326260555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=1.051696270431351&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB3-10" | ||
+ | :::::], | ||
+ | :::::"adm": <nowiki>"<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>"</nowiki> | ||
+ | ::::} | ||
+ | :::], | ||
+ | :::"seat": "1", | ||
+ | :::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''VIDEO''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"cur": "USD", | ||
+ | :"id": "5c5555d5-5555-555c-addc-55f5d55e5555", | ||
+ | :"seatbid": [ | ||
+ | ::{ | ||
+ | :::"bid": [ | ||
+ | ::::{ | ||
+ | :::::"id": "5", | ||
+ | :::::"impid": "exmpl_5", | ||
+ | :::::"price": 0.6621354882128117, | ||
+ | :::::"lurl": <nowiki>"https://example.com/lurl/830/nnbqypdkjerv4xtfhm5viiy2hy2qc4a5avceq72ymjewgyaokho72rlp6dy55d5ivxd3nfrtm3huswkufdvfiycibgaptd4ir7l7vneyheq77i4mzbgrdueixdjtgmpngpoe4kljv3fpqubainmdevspjnqva6auci4qd3jtezcteykqpbkfeofzk2zfotwdmbnoqvpzvba5sm54yvknsuocl6jdtn63tzkiesqys43g5bzzqwd7w2mxjlffnhkvki4esko2k5n3wycjqvksx7yhko7vi7kayjwnavlnrbegvcsxigbwau5ikvooashq5k2irmu6v6d2wu6yjdyovneiwkpk7b5lkpieq2gak5gb4mqu6flcgbkdx2isnktuznjhwaibpt4wxex4y2hztl4hvowttc3lffpu6s3bkb4fiutybbldraimyom5yryfki4es2jsk27xjkksdwdfaoernmz3mtmczguzwuv2hjbzsmcxyvegs2kjmiyfykypkthey2gbkp6fl6r3jlmtc47xjccniweukhtm2spckwf3h65gpoevcmu6jihkmtgvrtup6u6qhrhw2q77sbfgfqd43bikatlisjjntwv3257pyvrz7fwytrwbxsw2nqkw5i6otq53sk33jhvpq5kq====?1=1&data[]=16267695581629189819560392&v[]=1326260555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=1.051696270431351&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adm": <nowiki>"<?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>"</nowiki> | ||
+ | ::::} | ||
+ | :::], | ||
+ | :::"seat": "1", | ||
+ | :::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | '''VIDEO APP''' | ||
+ | |||
+ | {| class="wikitable" style="max-width: 85%; overflow-x: auto; display: block;" | ||
+ | |{ | ||
+ | :"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": <nowiki>"https://example.com/lurl/830/nnbqypdkjerv4xtfhm5viiy2hy2qc4a5avceq72ymjewgyaokho72rlp6dy55d5ivxd3nfrtm3huswkufdvfiycibgaptd4ir7l7vneyheq77i4mzbgrdueixdjtgmpngpoe4kljv3fpqubainmdevspjnqva6auci4qd3jtezcteykqpbkfeofzk2zfotwdmbnoqvpzvba5sm54yvknsuocl6jdtn63tzkiesqys43g5bzzqwd7w2mxjlffnhkvki4esko2k5n3wycjqvksx7yhko7vi7kayjwnavlnrbegvcsxigbwau5ikvooashq5k2irmu6v6d2wu6yjdyovneiwkpk7b5lkpieq2gak5gb4mqu6flcgbkdx2isnktuznjhwaibpt4wxex4y2hztl4hvowttc3lffpu6s3bkb4fiutybbldraimyom5yryfki4es2jsk27xjkksdwdfaoernmz3mtmczguzwuv2hjbzsmcxyvegs2kjmiyfykypkthey2gbkp6fl6r3jlmtc47xjccniweukhtm2spckwf3h65gpoevcmu6jihkmtgvrtup6u6qhrhw2q77sbfgfqd43bikatlisjjntwv3257pyvrz7fwytrwbxsw2nqkw5i6otq53sk33jhvpq5kq====?1=1&data[]=16267695581629189819560392&v[]=1326260555&cur=${AUCTION_CURRENCY}&bid=${AUCTION_PRICE}&total=1.051696270431351&loss=${AUCTION_LOSS}"</nowiki>, | ||
+ | :::::"adomain": [ | ||
+ | ::::::"example.com", | ||
+ | ::::::"example.com" | ||
+ | :::::], | ||
+ | :::::"cat": [ | ||
+ | ::::::"IAB13-1" | ||
+ | :::::], | ||
+ | :::::"adm": <nowiki>"<?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>"</nowiki> | ||
+ | ::::} | ||
+ | :::], | ||
+ | :::"seat": "1", | ||
+ | :::"group": 0 | ||
+ | ::} | ||
+ | :] | ||
+ | } | ||
+ | |} | ||
+ | |||
+ | == 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> | ||
+ | |} |
Текущая версия на 13:09, 19 октября 2023
Содержание
Общая информация
Интеграция
Узнать подробнее об интеграции по протоколам Feed и OpenRTB:
Bid Request/Response
Описание поддерживаемых параметров и примеры Bid Request/Response:
Процесс интеграции
1. Ознакомление с документацией.
2. SSP регистрирует аккаунт вебмастера в системе Kadam.
3. Kadam создает и выдает эндпоинт/фид под соответствующий формат рекламы и тип интеграции (для каждого отдельный).
4. Проводятся тесты на предмет работоспособности интеграции и наличия расхождений между данными системы Kadam и SSP. Тесты проводятся на “живых“ рекламных материалах.
5. Если расхождения в пределах нормы и отсутствуют технические проблемы, запускается интеграция в полноценном рабочем режиме.
Ключевые моменты
- Kadam поддерживает протоколы Feed, OpenRTB 2.5, Native 1.1, Native 1.2, XML;
- Чтобы подключить новую 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 уведомление о выигрыше | Возможно высылать:
Переключение режима ответа происходит через менеджера. |
|
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
[
] |
2. С отдельным полем “nurl”
[
] |
CLICKUNDER
{
} |
ON SITE PUSH (INPAGE)
[
] |
IOS CALENDAR PUSH
1
[
] |
2
[
] |
NATIVE
[
] |
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
{
} |
PUSH
{
} |
ON SITE PUSH (INPAGE)
{
} |
NATIVE (TEASER)
{
} |
NATIVE APP
{
} |
BANNER
{
} |
BANNER APP
{
} |
VIDEO
{
} |
VIDEO APP
{
} |
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
{
} |
PUSH
{
|
ON SITE PUSH (INPAGE)
{
|
NATIVE (TEASER)
{
} |
NATIVE APP
{
} |
BANNER
{
} |
BANNER APP
{
} |
VIDEO
{
} |
VIDEO APP
{
} |
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>
<result> |
2. С отдельным полем “pixel”
<result>
<result> |
CLICKUNDER
<result>
<result> |
ON SITE PUSH (INPAGE)
<result>
<result> |
IOS CALENDAR PUSH
<result>
<result> |
NATIVE
<result>
<result> |