Зоны реагирования

JSON-файл ответа Ad Placement API содержит массив zones и объекты renderers и user.

На этой странице мы расскажем о массиве zones, который содержит все данные об объявлении, выигравшем ваш рекламный запрос.

Массив содержит объект с рекламными данными для каждого запрошенного идентификатора зоны.

Недвижимость	Описание
idzone	Идентификатор рекламной зоны.
тип	Используемый формат объявления, например `баннер`.
данные	Данные объявления (объект)

Ниже приведен подробный список свойств, возвращаемых для каждого объекта data в соответствии с доступными форматами объявлений.

Баннер

Недвижимость	Описание
url	URL-адрес, на который направлено объявление.
впечатление	URL-адрес впечатления
изображение	Оригинальное изображение, загруженное для объявления.
оптимальное_изображение	Если креатив загружен в виде анимированного GIF, это оптимизированная версия MP4, которая создается для использования в рекламе.
ширина	Ширина объявления в пикселях.
высота	Высота объявления в пикселях.
сМИ	Это показывает, к какому типу относится баннер: Изображение, HTML или видео: Это должно быть `img_banner`, `html_banner` или `video_banner`, соответственно.

Примеры ответов на баннеры

Изображение баннера:

{
    "zones": [
        {
            "idzone": 1111111,
            "type": "banner",
            "data": {
                "url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVOu04DMRD8lTRprX14bW9JQ0PBN6xzPlGAgCToQJqPx7nTTrGa0TxOyELNnKCJuWX3yqpVBW_3.9ftrE9neZ7Yti3FekuXzw8ABHBhKmoujuUa33H9O0RJ3JJkSmxALs3YJUNrqbkYjNpkGQKWmWIFUKJfMQI_UqMvY20_jukTVOZVuXr3EcrlYqNXW6lHjl6G1t3T32PiGEbzTtjp46Y7F27Hp1ltHz.JXZ31j96M1xdQzRbNJbxE1EJhbfWL8bLQCBvyD4rI3QwpAQAA",
                "impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVPS05DMQy8Chdo5PEnn+5YsGCL4ADJa7ICIYqQiuTD4z5ax9HEI2fGZmIcCAfoA7Wj8ZGac0JNrJRg/vz66Ao/nftXP/9+p+3zw3NRLbhDVZFcXErU2dyoujJVa+Saq6GxOtjZLTt5EBxAiUiAqq0ViBRhB5E/vb3sF47EDMQvIbqwUVDXUVBrQraUEzRkw+oqdiHv4zRX/WlegCUobbTZBXmzOYotGl37yFNKCJGP9x65L0P/J4nlcHW+Ex4imsPh9hYV8wjynYnY98Gte81yosm2lswFmW2jPBsv07YQw/0B+rSsfmgBAAA=",
                "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
                "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
                "width": 300,
                "height": 250,
                "media": "img_banner"
            }
        }
    ]
}

HTML-баннер:

{
    "zones": [
        {
            "idzone": 2222222,
            "type": "banner",
            "data": {
                "html": "\n<div id=\"example_id\">\nExample HTML Ad!\n</div>\n",
                "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1OW2oDMQy8Si8Qo7Fky8p3+18IPYDteqGwJYGkkA8dvt7dUj1AjGY0ihRxIpwgL2Rn4XMiR0khRg0REsDF3y7vTn4b69f9tv7cw+PqauxJPGWPouIgN1h2jazFET1uK3I2cGZLc6RApMmN/OPyujdmxikpzwkCuw1KCcgp5ACRqZqnnZ5T7QosDLVmozJyT6NpWqhVqS0P1o3oba2zQr9+b46Hq8hh9Ac4M2cjHDMAY/YZ5DsyY//8n11qtiy0LJU/e2Xl0a3FUqlq70q/g8aBP0ABAAA=",
                "width": 300,
                "height": 250,
                "media": "html_banner"
            }
        }
    ]
}

Видеобаннер:

{
    "zones": [
        {
            "idzone": 4444444,
            "type": "banner",
            "data": {
                "url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVPy4rbQBD8lb34GNHz1Oi4EBaDHe3itWRHt3kpWWLNjGTJOKE_PmOZbuimqruKekFOQVaMIxTA8Pc8p.uGvW7oW.45LlNhdPhlpngtbBweMHv7chv23d.jvXzZP2RDpU1DRmJ0H9vabD.O.23dlFdqxv1kktasIfTcfpK_yxwvy.AO.93ox5Y08zR24bgMwf2QLUyTTok1x1ND_p2WOFxjiqPbyQ6mdP5cLs.jdO6kMeoUFtfV9f1Qdy65WzjU56m9pa6971M4hnS.HX7KlgbqA7U.9uw9K.X3cWRZym7p6zdEBEQiCUgOgjJMcQox.EdQpAVRBeVQEIHIZVkJkICsUhVwiQJURglSJDSLEEQGcKfisWZNbZzv1VKhEpkvCekZKStTec2ItMKbUvRgNNdGelauP.aic6_W2Q6yq2JQEXzBlX5WVuGSqOfGOBNrhAysrJDr4Pi.Q2l6kB6ctbLKNlaUXnvOcwiheleq__CkLqj3AQAA",
                "impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1PSU4DQQz8Ch9Iq7x1u3NDIgeuQB7Qk+k5QYKQkHLw47FGEbYP5a3KZjAdQAfSJ6Ij/KgSXMgLKwpZvH48h1J8336ut+ssl9tXsFUWjwYR9vBmaB7SvUNrGDyUUbtoaG3dUBHEwUGBcEuIkILTwTKL0/ktzu8vgeLkLWc4BLiz5dKuTe6FqpVaSDWz0NzHHTGWdW7+26MRbUKtL30OoXqxuTTbsAwdS53SduHlc2Ts5yPvQn7mgp6tgqq8C+PhSaY1lR5YVCzSEHslzer/bJLZ2upl+jbHyoJGa9u20W0Mn75Y+wNJJUoPYQEAAA==",
                "video": "http://static.example.com/library/256238/906f02361f3cd12043514304c777ed489599f637.mp4",
                "width": 300,
                "height": 250,
                "media": "video_banner"
            }
        }
    ]
}

Липкий баннер

Недвижимость	Описание
url	URL-адрес клика
впечатление	URL-адрес впечатления
изображение	Оригинальное изображение, загруженное для объявления.
оптимальное_изображение	В липком баннере, если креатив загружен в виде анимированного GIF, это оптимизированная MP4-версия, которая создается для использования в объявлении.
ширина	Ширина объявления в пикселях.
высота	Высота объявления в пикселях.
частотный_период	Частота показа рекламы в минутах.
v_pos	Вертикальное положение объявления.
h_pos	Горизонтальное положение объявления.
сМИ	Это показывает, к какому типу относится баннер: Изображение, HTML или видео: Это должно быть `img_banner`, `html_banner` или `video_banner` соответственно.

Пример ответа на липкий баннер

{
    "zones": [
        {
            "idzone": 4204610,
            "type": "sticky_banner",
            "data": {
                "url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAz1Qy4rbQBD8FV98jOie9xwNy.LgzVokkmx808tsQLIeI4Ex_fHpsZPQA1NVU11NjxIejXAEiaavZRnDVu624p3P_VsIX0k99JHK94Bb.QYaPJitMB2TZv69MAyCsXLWopIicsl86LhezSYoFqT3xvjIdLQLUAYhUsv0e7aL0DFs74yWOUYMTbr_rPZp9rH_zG0Q1XTRZanHcy7EKcshW7vm58dhaqcC82WeLrds7W9NcTIFzHM5jjLPTjk.TuvQh2EcpuZgLjCP51_c.COaxvMx9L3i5xVW.Rj6GScJYVIdPMYHzHIIzcFmNs3sMc1Tezt2nFFgUcWQN7sjAkKDyngHUtL_rUkk6BKhIEFN__6G_m5NGhyRQhKEggO0IQlwF5qzmBI5zbpFvEq0vvJtKdHUuq2svkJVqrIyrbRPb9WVfJ4TmQFtXsKGhQ09HbE4hue6F5JKaopuBa8eHh8v5DoeyLSqFhbKuuaNjPMtz1etr5pKOrTX.g.ZmJDwMAIAAA--",
                "impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVOO25DMQy7Si8QQ3/L2Qp06dz2AParPaXImkGHj56LiDJEEJRFAsIL8AXoDeGKfFUOKuiFBApqfH6/h2Dcb4ly3P+CyatSUHOpHtyaWQshEEMIBU/e0Cin14rCFJjuUAsI1+QQpy9+vj72wxM1GOBBKeO+iO4FTYsVFAk55Vx7nKsVcTHWNtrsjHboHFUXjC592OS6rePWs3de+EcB9/MUvYTITzKzvzgLa2RBbCVrR34BY/2uLofrmg3XRGudh1uVCXosPOgJ0ouJzUoBAAA=",
                "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
                "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
                "width": 300,
                "height": 250,
                "frequency_period": 1440,
                "v_pos": "top",
                "h_pos": "left",
                "media": "img_banner"
            }
        }
    ]
}

Мгновенные сообщения

Недвижимость	Описание
url	URL-адрес клика
впечатление	URL-адрес впечатления
изображение	URL-адрес изображения
оптимальное_изображение	Если креатив загружен в виде анимированного GIF, это оптимизированная версия MP4, которая создается для использования в рекламе.
ширина	Ширина объявления в пикселях.
высота	Высота объявления в пикселях.
частотный_период	Частота показа рекламы в минутах.
сМИ	Это показывает, какой тип баннера используется: Изображение, HTML или видео: Это должно быть `img_banner`, `html_banner` или `video_banner` соответственно.

Пример ответа на мгновенное сообщение

{
   "zones": [
       {
           "idzone": 4031007,
           "type": "instant_message",
           "data": {
               "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAA01Oy2oDMQz8lVxyXSTLtuxjLrn00G_wQ0uhDQmbBEqZj6.6uZQZJJiRRjogUi2UBUz4eDxu96OcjuHs7JvNZVwvAAjgTBJKUE74se16a9vnboaFyxIiLW4gxixclT1UmEiRmF1lBHDwlJSBkOibE4EdaH3aWp4VJfmAMq_CWnu1JpxHsq5ppd5i69lEfYPQv5rz9Rg5Dtjl_3gZe_GLfy3i_Q0tyZrFyuxT2KKFMWqfJKIjTx3yC41GCKIMAQAA",
               "impression": "https://syndication.example.com/cimp.php?t=imp&data=H4sIAAAAAAAAA01OQWrEMAz8Sj8QM5Jly9lzf1AKucppcmnLloXCUubxdbIUqpFgJEbSKBSTYFJ5QrtIu+RCTdKSGpIULstCE/5st+tX3N7Tev1kVqlOy2rZWa3g6JAFcBaRweeGmmlWs8wuFKWyVIKtDA4iQejg68vzWUPCSi24S8Hgx1dBMk3DxNDbmOEORn/b9vY900X2LD73eYssdS1b97Kjh0Wv27B1bPWPGHlaxgNJ1c5b/zA92hHgHzu9gjNE1zC4eoS59xY1AmsvHq6mv8/Xp409AQAA",
               "image": "https://static.example.com/library/32167/30faa1b47960b066dbc594e9251fbedf2349192e.jpg",
               "optimum_image": "http://static.example.com/library/428515/d17db557c0761f48323156f47fd53dc3de393806.mp4",
               "width": 250,
               "height": 150,
               "frequency_period": 1440,
               "media": "img_banner"
           }
       }
   ]
}

Нативная реклама

Когда ответ возвращает нативное объявление, zones.data возвращает два объекта: макет и ad_items

data.layout

Недвижимость	Описание
widgetHeaderContentHtml	URL-адрес брендинга "Powered by", который отображается.*
брендинг_логотип	URL-адрес логотипа брендинга, который отображается, если он включен.*
branding_logo_hover	URL-адрес логотипа брендинга, который отображается при наведении на него курсора мыши.*
itemsPerRow	Количество объявлений, показываемых в каждой строке виджета.
itemsPerCol	Количество объявлений, показываемых в каждой колонке виджета.
font_family	Семейство шрифта, используемого в объявлении.
размершрифтазаголовка	Размер шрифта, используемого в заголовке лендинга.
цветшрифтазаголовка	Цвет шрифта, используемого в заголовке лендинга.
цветфонавиджета	Шестнадцатеричный код цвета фона, используемого для виджета.
ширина виджета	Ширина всего виджета.
минимальнаяширинадляполногоразмера_макета	Минимальная ширина для полноразмерного макета в пикселях.
высота элемента	Высота каждого отдельного объявления.
добавление элемента	Прокладка между каждым из объявлений.
высота_изображения	Высота изображения в каждом объявлении.
ширина изображения	Ширина изображения в каждом объявлении.
text_margin_top	Размер в пикселях верхнего поля текста.
text_margin_bottom	Размер в пикселях нижнего поля текста.
text_margin_left	Размер в пикселях левого поля текста.
text_margin_right	Размер в пикселях правого поля текста.
размер_шрифта заголовка	Размер шрифта заголовка для каждого объявления.
цветшрифтазаголовка	Цвет шрифта заголовка для каждого объявления.
весшрифтазаголовка	Вес шрифта заголовка для каждого объявления.
украшение_заголовка	Подчеркивается ли заголовок или нет.
title_hover_color	Цвет шрифта при наведении курсора на заголовок.
title_hover_font_weight	Вес шрифта при наведении курсора на заголовок.
title_hover_decoration	Подчеркивать ли заголовок при наведении или нет.
описаниешрифтразмер	Размер шрифта описания для каждого объявления.
описаниешрифтацвета	Цвет шрифта описания для каждого объявления.
описаниешрифтвес	Вес шрифта описания для каждого объявления.
описание_декорирования	Подчеркнуто ли описание или нет.
описаниенависающегоцвета	Цвет шрифта при наведении курсора на описание.
description_hover_font_weight	Вес шрифта при наведении на описание.
описаниенависающегодекора	Подчеркивать ли описание при наведении или нет.
открытьвновом_окне	Должно ли объявление открываться в новом окне при нажатии. 1=да, 0=нет.
mobile_responsive_type	Тип отзывчивости при использовании мобильного устройства (т.е. нет или компактный). 1=компактный, 0=нет.
header_is_on_top	Должен ли лендинг отображаться над или под объявлениями. 1=да, 0=нет.
header_text_align	Горизонтальное выравнивание заголовка лендинга.
title_enabled	Включен ли заголовок или нет. 1=да, 0=нет.
описание_включено	Включено ли описание или нет. 1=да, 0=нет.
размер_границы	Размер в пикселях границы изображения.
цвет_границы	Цвет шестнадцатеричного кода границы изображения.
text_align	Выравнивание текста: слева, по центру или справа.
customcss_enabled	Включен ли пользовательский css или нет. 1=да, 0=нет.
customcss	Если включено, здесь будет отображаться пользовательский css.
header_enabled	Включен ли заголовок или нет. 1=да, 0=нет.
mobile_breakpoint	Точка разрыва в пикселях между просмотром рекламной зоны на настольных и мобильных компьютерах.
интервал_v	Расстояние между объявлениями по вертикали в пикселях, задается в разделе "Дополнительные параметры".
расстояние_h	Расстояние между объявлениями по горизонтали в пикселях, задается в разделе "Дополнительные параметры".
зум	Должно ли объявление увеличиваться/уменьшаться при наведении.
мобильные_строки	Количество рядов объявлений в мобильном виджете.
мобильные_колонки	Количество колонок объявлений в мобильном виджете.
использоватьv2скрипт	Была ли рекламная зона создана с помощью новой настройки V2 или старой v1.
text_enabled	Должны ли отображаться текстовые заголовок и описание. 1=да, 0=нет.
ширина мобильного_изображения	Ширина изображения в каждом объявлении на мобильных устройствах.
mobile_text_box_size	Размер текстового поля на мобильных устройствах. Допустимый диапазон 50-500.
mobile_text_enabled	Включен или нет заголовок на мобильных устройствах. 1=да, 0=нет.
mobile_text_position	Положение текста на мобильных устройствах: внизу или справа.
расстояниемеждуэлементаминакаждой_стороне	Подложки с каждой стороны объявлений, если они были настроены с помощью старой версии v1.
положение текста	Располагается ли текст слева или справа.
размер текстового поля	Размер текстового поля в пикселях. Диапазон 50-500.
высота_виджета	Высота всего виджета.
brand_enabled	Включен ли брендинг или нет.
brand_font_size	Размер шрифта для брендинга.
brand_font_color	Цвет шрифта для брендинга.
brand_font_weight	Вес шрифта для брендинга.
бренд_декор	Подчеркивать или нет шрифт.
mobile_image_height	Высота изображения в каждом объявлении на мобильных устройствах.
publisherAdType	Тип нативного объявления, т.е. рекомендация, выход или интерстиция: `native-recommendation`, `native-interstitial`.

data.ad_items

Недвижимость	Описание
изображение	Оригинальное изображение, загруженное для объявления.
url	URL-адрес клика
впечатление	URL-адрес впечатления
название	Заглавный текст объявления.
описание	Текст описания объявления.
бренд	Фирменный текст объявления.
original_url	Оригинальный url целевой страницы.
положение изображения	Положение рекламного изображения (как оно будет обрезано).

Пример ответа на нативную рекламу

{
    "zones": [
        {
            "idzone": 4058715,
            "type": "native_ad",
            "data": {
                "layout": {
                    "widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https://www.exoclick.com\" rel=\"nofollow\">Powered By <span></span></a>",
                    "branding_logo": "//static.example.com/widget-branding-logo.png",
                    "branding_logo_hover": "//static.example.com/widget-branding-logo-hover.png",
                    "itemsPerRow": 4,
                    "itemsPerCol": 1,
                    "font_family": "Arial, Helvetica, Verdana, sans-serif",
                    "header_font_size": "12px",
                    "header_font_color": "#999999",
                    "widget_background_color": "transparent",
                    "widget_width": "1830px",
                    "minimum_width_for_full_sized_layout": "450px",
                    "item_height": "300px",
                    "item_padding": "10px",
                    "image_height": "450px",
                    "image_width": "450px",
                    "text_margin_top": "3px",
                    "text_margin_bottom": "3px",
                    "text_margin_left": "0px",
                    "text_margin_right": "0px",
                    "title_font_size": "16px",
                    "title_font_color": "#000000",
                    "title_font_weight": "normal",
                    "title_decoration": "none",
                    "title_hover_color": "#0000FF",
                    "title_hover_font_weight": "normal",
                    "title_hover_decoration": "none",
                    "description_font_size": "14px",
                    "description_font_color": "#555555",
                    "description_font_weight": "normal",
                    "description_decoration": "none",
                    "description_hover_color": "#0055FF",
                    "description_hover_font_weight": "normal",
                    "description_hover_decoration": "none",
                    "open_in_new_window": 1,
                    "mobile_responsive_type": 1,
                    "header_is_on_top": 1,
                    "header_text_align": "right",
                    "title_enabled": 1,
                    "description_enabled": 0,
                    "image_border_size": "",
                    "image_border_color": "",
                    "text_align": "left",
                    "customcss_enabled": 0,
                    "customcss": null,
                    "header_enabled": 1,
                    "mobile_breakpoint": "450",
                    "spacing_v": "10",
                    "spacing_h": "10",
                    "zoom": "1",
                    "mobile_rows": "2",
                    "mobile_cols": "1",
                    "use_v2_script": "1",
                    "text_enabled": "1",
                    "mobile_image_width": "450",
                    "mobile_text_box_size": "90",
                    "mobile_text_enabled": "1",
                    "mobile_text_position": "bottom",
                    "item_spacing_on_each_side": "5px",
                    "text_position": "bottom",
                    "text_box_size": "90px",
                    "widget_height": "570px",
                    "brand_enabled": "1",
                    "brand_font_size": "11px",
                    "brand_font_color": "#555555",
                    "brand_font_weight": "normal",
                    "brand_decoration": "none",
                    "mobile_image_height": "450",
                    "publisherAdType": "native-recommendation"
                },
                "ad_items": [
                    {
                        "image": "https://static.example.com/library/432437/97567ec37c751bc909fc06c96920bb353efefe36.jpg",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OO27EMAxEr7LNljE0okhJZZo0KfYMkj9IgPwAG3GKOfxybSDgAJTI0RtdmBBzhhCBb9v2s17l.RpfXPu.D_Nfm9Zh_P70.1fb3n_n9UlJBhIGQGoQ47.LyHVw3gDRIUYjkwIlR2UKWjKUGopPQQ80xziI8CKiJMrDpb7NwCIO63VuAht17lmX0Ftq3WbJ_iKwfzTXkXuQLjzGZ8kjWeQ8hWj1.HUNp7WkoyXeXqmW0acQp0mWKdaUUaqUcTQbkaqlOziYDlsjAQAA",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OS04FMQy7CheYKs6nad8OxAlAHKDzW4FYsHmLHJ5M0ZOI00apLddMjIWwMD2R3cRvqAHvBewFYoW5xsvbcyjiuI/9p2zfX6HCKv4YzbU3CyVrDgujlmp2h4Qa0Jwt0lWCEnLJLN1yKYRwio/313mQYIq8rw9BRblQQXQKzUe6U4BFw4FTMuPajyGomx2r20nr0LHWIwNd5uvnyJ5paQLFpcrkHpArnkgs+FuIa48siklnNf0nH+JUR60bidjoKd+HbHLuO7bTvP0ChQRmKEsBAAA=",
                        "title": "title 5",
                        "description": "description 5",
                        "brand": "brand 5",
                        "original_url": "https://www.example.com/natives-5",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/d51084a3da98f857bca6ba19037cfe90b9a93c0b.jpg",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OOW7EMAxFrzLNlBG4iFrKNGlS5AySR0ICZANsxCn.4UN7gIAEuH0.8oLIkjNVMOF1277Xqz5e5cl93_cwftttDcvXh9efbXv7GeuDAiCAEzNrJU34V4FzDc4LrBZEEhCNuWQyRLKS2WBUvMtQBzjGQWA3sGiEHirzaWae6rBeR1NOi42ebVJvsfU0NPsGob839_PuSboAciaH6XFZ9Z6RpHp.XekuLfEMES_PsCEcS7ZOc6HU6pR0mxIlVuNcUvsDR8DGSCMBAAA-",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OSU4EMQz8Ch/oqLzFydxAvADEA9I96ROIA5c5+PHj7gEJV+Ko7FKlGEwLaGE8wS7iF6pB3guxFxIrzDVe3p5DKeZtXH/K9v0VKqzif09z7c1CYc3JwtBSze7ooUbUHBbpKoGEHDJLtyQFFI74eH89LyUYkf34kFCUCwpFR2gOcUMQi4YT7ZIZ1z6HUN1srm471qFjrTMDHebr58hzpsUJKi6Vg3/pI0vGE4mFHgRce2QhznVW03/yMU3nbjW7wfu8trHtuk3kZBuT7xcrT8hLAQAA",
                        "title": "Native 3 title",
                        "description": "Native 3 description",
                        "brand": "Native 3 brand",
                        "original_url": "https://www.example.com/natives-3",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0n364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==",
                        "title": "Native 2 title",
                        "description": "Native 2 description",
                        "brand": "Native 12 bran",
                        "original_url": "https://www.example.com/natives-2",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/d32054c6f9c66c2853bff50b00578b15e0739875.jpg",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2Ou27GIAyFX.Vf_rHIxgbC2KVLhz4DEFAr9SYlajqch69JpApL.HL8Hd.g7FNiBuN137.3uzze_ZPFcRyu_5Z1c.3rw.rPsr_99O1BARDAkZklk0T8q8ApO8M5luC8j4AG5mXSlYL9AYEW6zLEAIYxEKY12ItCpirY1DaGGKzmXoRjC72mMKgWLTV2SbZBqO_F4vQ9STcDn8l8Mp1Frox8zOfVmS7pcgkVL89IK8fcZHQdSyfxWe2MtjYRP1RT_gOkVnReIgEAAA--",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01PSU4EMQz8Ch/oqLy103MD8QIQD0i6MycQBy5z8ONxGs0IV+LETqlcYTAtoIXxBLuIX2gN8q0QeyGxwrzGy9tzKMW4teOn7N9focIqfj+q61YtFFadLAw12exOFGpEdV5SVQIJmTRLtSwKQOGIj/fXcyctGJF5TiQU5YJCsSE0m7ghiEUjBa+SJvs2mtC62+huV/Smra8jHU31/tlynXZxgorLuqUSHpDpTyQW+ivASchAnM8Z9T99wIh1b2PHcbhxFwEN4UbjmD/+BS14KDZMAQAA",
                        "title": "title 4",
                        "description": "description 4",
                        "brand": "brand 4",
                        "original_url": "https://www.example.com/natives-4",
                        "image_position": "50% 50%"
                    }
                ]
            }
        }
    ]
}

Видео Outstream

Недвижимость	Описание
url	URL-адрес клика
отслеживание	Объект с информацией о слежении.
видео	Файл видеорекламы или ссылка VAST для загрузки.
brandingEnabled	Флаг для включения брендинга. Это значение в настоящее время не используется
frequencyPeriod	Частота показа рекламы в минутах.
maximumWidth	Размер ширины видео.
isVast	Указывает, является ли победившая кампания обычной видеорекламой (false) или кампанией с VAST-ссылками (true).
ctaEnabled	Флаг для отображения CTA в объявлении
cta	Объект, содержащий информацию о CTA
впечатление	URL-адрес впечатления

data.tracking

На данный момент объект data.tracking возвращает только массив progress с объектами, предназначенными для отслеживания воспроизведения видео. Из этих объектов тот, который имеет смещение: 00:00:10.000, является тем, который нужно вызвать для сохранения вида видео. Свойства каждого объекта описаны ниже:

Недвижимость	Описание
смещение	Отметка о прогрессе в секундах или в процентах от просмотренной видеорекламы
url	URL-адрес отслеживания

data.cta

Недвижимость	Описание
displayUrl	URL, относящийся к целевой странице объявления
текст	Текст, который будет использоваться в элементе CTA

Пример ответа на видеозапись из внешнего потока

{
    "zones": [
        {
            "idzone": 12345,
            "type": "outstream_video",
            "data": {
                "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
                "tracking": {
                    "progress": [
                        {
                            "offset": "00:00:10.000",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
                        },
                        {
                            "offset": "25%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
                        },
                        {
                            "offset": "50%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
                        },
                        {
                            "offset": "75%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
                        },
                        {
                            "offset": "100%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
                        }
                    ]
                },
                "video": "https:\/\/u3y8v8u4.aucdn.net\/library\/940460\/8f1ab6fd40cb27cba71db1229c250d6bce1f8b68.mp4",
                "brandingEnabled": 0,
                "frequencyPeriod": 60,
                "maximumWidth": 1000,
                "impression": "https:\/\/s.example.com\/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345....",
                "isVast": false,
                "ctaEnabled": 1,
                "cta": {
                    "displayUrl": "singleflirt.com",
                    "text": "View More"
                }
            }
        }
    ]
}

Видеослайдер

Недвижимость	Описание
url	URL-адрес клика
отслеживание	Объект с информацией о слежении.
видео	Файл видеорекламы или ссылка VAST для загрузки.
screenDensity	Целое число, указывающее на долю максимального экранного пространства, занимаемого рекламой на устройстве пользователя
onComplete	Указывает на поведение рекламы после окончания воспроизведения видео. "Скрыть" означает, что реклама должна быть скрыта, в то время как "Повторить" означает, что реклама должна оставаться на странице, чтобы пользователь мог воспроизвести ее
closeAfter	Указывает количество секунд, необходимое для отображения кнопки закрытия в объявлении
brandingEnabled	Флаг для включения брендинга. Это свойство в настоящее время не используется
frequencyPeriod	Частота показа рекламы в минутах.
впечатление	URL-адрес впечатления
isVast	Указывает, является ли победившая кампания обычной видеорекламой (false) или кампанией с VAST-ссылками (true).
ctaEnabled	Флаг для отображения CTA в объявлении
cta	Объект, содержащий информацию о CTA

data.tracking

Недвижимость	Описание
смещение	Отметка о прогрессе в секундах или в процентах от просмотренной видеорекламы
url	URL-адрес отслеживания

data.cta

Недвижимость	Описание
displayUrl	URL, относящийся к целевой странице объявления
текст	Текст, который будет использоваться в элементе CTA

Пример ответа на видеослайдер

{
    "zones": [
        {
            "idzone": 12345,
            "type": "video_slider",
            "data": {
                "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
                "tracking": {
                    "progress": [
                        {
                            "offset": "00:00:10.000",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
                        },
                        {
                            "offset": "25%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
                        },
                        {
                            "offset": "50%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
                        },
                        {
                            "offset": "75%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
                        },
                        {
                            "offset": "100%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
                        }
                    ]
                },
                "video": "https://u3y8v8u4.aucdn.net/library/141372/7bbd0e98bb9b36baf778a8b970c74e26f51c037a.mp4",
                "screenDensity": 25,
                "onComplete": "repeat",
                "closeAfter": null,
                "brandingEnabled": 1,
                "frequencyPeriod": 0,
                "impression": "https://s.example.com/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345...",
                "isVast": false,
                "ctaEnabled": 1,
                "cta": {
                    "displayUrl": "fullclickenabled.com",
                    "text": "Watch Free"
                }
            }
        }
    ]
}

Межстраничные объявления

Недвижимость	Описание
url	URL-адрес клика
впечатление	URL-адрес впечатления
изображение	Оригинальное изображение, загруженное для объявления.
оптимальное_изображение	Если креатив загружен в виде анимированного GIF, это оптимизированная версия MP4, которая создается для использования в рекламе.
ширина	Ширина объявления в пикселях.
высота	Высота объявления в пикселях.
счётчик_частот	Сколько раз может быть показано объявление
частотный_период	Как часто в минутах показывается реклама
типчастотноготриггера	Флаг, указывающий, основана ли частота этого объявления на показах (0) или на кликах (1)
ad_trigger_method	Метод триггера включен для этой рекламной зоны
ad_trigger_classes	Классы, которые должны вызвать объявление, если таковые имеются
первыйтриггеркликов	Количество кликов, необходимое при первом посещении сайта пользователем для запуска рекламы
следующийтриггеркликов	Количество кликов, необходимое после первого срабатывания рекламы для повторного показа объявления
chrome_enabled	Флаг, указывающий, включена ли эта рекламная зона для Chrome (1), отключена (0) или включена только для этого браузера (2)
capping_enabled	Флаг, указывающий, следует ли применять к данной рекламной зоне кэппинг или нет
сМИ	Это показывает, к какому типу относится баннер: Изображение, HTML или видео: Это должно быть `img_banner`, `html_banner` или `video_banner`, соответственно.

Примечание: большинство свойств отклика Fullpage Interstitial связаны с отображением и запуском объявления. Поскольку вы сами отвечаете за отображение объявления, вам решать, обращать внимание на эти свойства или нет.

Пример межстраничного ответа

Обратите внимание, что, хотя в примере показан Fullpage Interstitial для рабочего стола, ответ для Mobile Fullpage Interstitial должен быть таким же, за исключением zone.type.

{
    "zones": [
        {
            "idzone": 5808222,
            "type": "desktop_fullpage_interstitial",
            "data": {
                "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01S2W7jOgz9mrwlgTZL8uPcWRAggWNkb18KWZIbz3iV5aYx9PFDp0XviIZBHx4d0iQFFxGJWEDh6n3bz.i3GfkFz.12W_ZF_VravCycX.qmArRUtQEQvMp5ghCd0V.DW6i2WOTW6.viWvjCzOgP7wY7I9y3WlXtA9GRxixHdqGkxAuWKbLIBBELZjMdScaVlghu9EOWDllZ9Ffr4FYkkSSEQECXhf7j1SuAjTNpkq6yZJVkm1WarIVu6tP5TsZxHKqq77oWjkmfN.llz9VwPp1Q7wCsj.O2NuaJn5BrL8cj8NF42jZN44ayMbtkczgYDdGxveyH0qz580Q8bEfnKRtaP_qKuLqrcdPhinXO.3HoKfFmtzEbt0vezGGXuN3l4A9t6i.JqXdus0suoHlX33n83w95To.paF0bnQ57ch9Mqj6q.cg3uW7N.bPKOrHafiL_BKEYcFn_5F_uf3arbhWP9fbw1r5URxJtSfbOry9mLbbFuTqr8ZJl.9_Wnu9dR.xQdFm.PZOhsO.3_OnbArr6Hcajitcauio.NwFWAQvOGWIxF.Fms0r13rpitNMSBILJUuIllmhJMFCxiCIGJ3yOKkQYh8BwICEWoAUUjtB7jMCZLCboHSOJguLS5jGTSmLDSUQ0hQ3JIy6lioU1MlAGcgxHgaIYaYptzCjWlDPDMmI4jhXViGIegywKN9rra9OU_aNKSAaFEhmIQISzAOs8_2LMgTG_.qqce3cv_Fz17TwvSluryk7QI2RsrobSh4f4ZJRSHiM6eRgxFsdhahWk.IxPJr_YUDW8gxQc.HyqZ_oMP_fpP_T_jUYfzhJoS4QQ_hLql62tevf2.C2YTpgIH2KQPbxBx7frkEtGIgQzs0LzDNoTUcHjTJuYiDzW.i9X4F4Z5wMAAA--&cb=e2e_69493367093292.02215167",
                "impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA11QS0pEMRC8iheYUP1J0nHt7AXxAG\/yMig4jvjEH314k4y4MEWgSVW6qpvBcUe8Y75CvgZfa3YmDkaBDIEJvr+7dSX\/aIfTsr2118fvFur55EWhCV5AIskJwjDzaDBm9kjkOeXIUZ0ox6j9eOndHR2iXaQUe0kB+130DL+\/u5mXOiQ6JeCzoCtmBmdzG1xhfBIMviRrx6K2GK2JI1eJlY4xmS0lt9VcUFCFWlGhKklXPfCaqCxSIZRK7wb\/kK0+nM9P25yqu\/X5uxVncFJH6D1GoDhzz+x93gLx3fgtBNVSvB\/4pJft67m6\/8kviC5DnYbBUP6jLyD8VoGGMabxeNjCSzttr+8zok6zgEFdtjk3dqnKEe3QF7cIlyxYI+ohq1VqyLYu7QfZRfrR8QEAAA==&cb=e2e_69493367093c99.73988768",
                "image": "https:\/\/s3t3d2y1.afcdn.net\/library\/940460\/c8c01e1ff28dea8c9345f243dcd7b4ca8c7df26d.jpg",
                "optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/940460\/a359ed6758e1c53523936ed27a001b7bf0f726ab.webp",
                "width": 1600,
                "height": 900,
                "frequency_count": 1,
                "frequency_period": 720,
                "frequency_trigger_type": 0,
                "ad_trigger_method": 3,
                "ad_trigger_classes": "",
                "first_trigger_clicks": 0,
                "next_trigger_clicks": 0,
                "chrome_enabled": 1,
                "capping_enabled": 1,
                "media": "img_banner",
                "cid": 7675254,
            }
        }
    ]
}

Продвижение по страницам

Недвижимость.	Описание
url	URL-адрес клика
впечатление	URL-адрес впечатления
изображение	Оригинальное изображение, загруженное для объявления.
оптимальное_изображение	Если креатив загружен в виде анимированного GIF, это оптимизированная версия MP4, которая создается для использования в рекламе.
название	Название уведомления
описание	Описание уведомления
горизонтальное_положение	Указывает горизонтальное положение на странице (слева, по центру, справа)
вертикальная_позиция	Указывает вертикальное положение на странице (сверху, посередине, снизу)
задержка	Количество секунд до появления уведомления после загрузки страницы
max_notifications_on_page	Количество уведомлений, которые могут появляться на странице одновременно
однаждызакрытаятайна_для	Продолжительность времени в секундах, в течение которого объявление будет скрыто после его закрытия (требуется согласие пользователя на использование cookie)
user_session_capping	Количество показов рекламы пользователю (требуется согласие пользователя на использование cookie)
задержкамеждууведомлениями	Количество секунд до появления следующего уведомления после загрузки предыдущего

Пример ответа на Push-уведомление на странице

{
  "idzone":9999999,
  "type":"in_page_push_notification",
  "data":{
    "url":"https://syndication.example.com/click.php?data=H4sIAAAAAAAAA02QvW7DMAyEX0VLVoGUSP2MXbp06DPQltwadeQgNuIU4MPXMYo2OE68w0ccOUF25BUs6.e6XpaTfzm51322bbNrXdaxfdh.PquCYkg55BQh6OU63upS7_OlybnaNimCJWfBoibnIfmISjlRdqwMSZVQvSLvGNDo4E5pB.7SQB1jHXwntQvZMlCMLgRkYA9Ij3wNnAPGobiB.l7EA_AQZOBSsCOqOwZ0.W5l7GUd52brXcpir3P_tehx0Ty55nDN4Zpp7mUyv0XNVjvTSWv1aj7X82T0IP_rAXOgTxv6S7C6I.FIPeuN9f1Ni3OIsXj0.0sEMJXEUQafa5QaovwASom5rH8BAAA-",
    "image":"https://static.example.com/library/195600/0ce94b4e2b6222ee26594af823a65cb7059ca62d.jpg",
    "title":"Title",
    "description":"This is a description",
    "impression":"https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA1VPW2rDQAy8Si+QZaSV9pH/XiBQ8O/au4bQ1glxKS7o8N24hFAJSTMwjCQG+wPigdIL8VH0iGAEJ+zgyIZhMCG73s7fbW3b5bqUz+aWD6OsAXiMSClnmOQkmdUUyTQhs3hL7JF8JCM1b3ikA3AX2uvbaa8ucAQyYYuMTVI339cbd+OOscGCjEpt9mNpY8hOITFyCKRQDxJYC5oDxbnyLNNUiu9b5lBmrZVGkXb3sfVnqeepfJ0vi2tbqau7Xab39XkaJ9qFzzz80R6wHZVuMpn9E8HUuHevOyHrz8wcYhHNtVSfRVklttxAOSTh6RdhQ+r1fQEAAA==",
    "optimum_image":"https://static.example.com/library/195600/0c9243bcbb139db5671a779366a98a08f678b2f1.webp",
    "horizontal_position":"right",
    "vertical_position":"top",
    "delay":0,
    "max_notifications_on_page":2,
    "once_closed_hide_for":10,
    "user_session_capping":0,
    "delay_between_notifications":10
  }
}

Многоформатный

Ответ на запрос Multi-Format может дать разные результаты:

Если победившее объявление является нативной кампанией, то ответ будет содержать обычный объект нативных данных
Если победившее объявление - баннерная кампания и на макете есть Одиночная зона, то ответ будет содержать объект данных обычного баннера
Если объявление, победившее в конкурсе, является баннерным и вы выбрали макет с множеством объявлений, то ответ будет содержать объект group со следующими свойствами:

Недвижимость	Описание
ориентация	Ориентация многозонального макета, которая может быть "горизонтальной" или "вертикальной"
ad_items	Массив, содержащий данные об объявлениях для каждого места на макете.

Независимо от результата, в ответ будет добавлено свойство multizoneid, указывающее на идентификатор зоны мультиформатной рекламы, которой соответствует данный ответ.

Пример ответа в нескольких форматах

В следующем примере показан объект zones для рекламной зоны Multi-Format с макетом Horizontal x 3:

{
    "zones": [
        {
            "group": {
                "orientation": "horizontal",
                "ad_items": [
                    {
                        "idzone": 12345,
                        "type": "banner",
                        "data": {
                            "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01RTU_DMAz9NbtVlT.SNDlygAsHkPgFaZuySS2dmrAO5B9PEtCGHFmW37P97HROWSISlGNK53jghwM95RfTuoU2puCX87qHLYztsC4ZEAHBzhiF2oKTPfSLz7Tt9B0KQwiptdiihZYwU0kbUg6saNaMYEQjiigUEtflXiAMcCWdqcUcwRXBggirrCtPybiDgTE4xTiwUaPqaTToPA_AaFwuA9k5Dsd1nWMVAdX2fW9u.Sbnm2Na5iZtX6fU.HhuptMcPvwSSqpCY5j855yktqzamI0DLhGCUs5J3R9I_gjFVPX5HDYvWyIpBfkS5hcvzUQe317_1dyNim8B8O7xNj.2i3.P26VupaRMb6m2K4WX_HEvz2J0D9xZNyF7oyftstYRhr7TTo3QjT9DY7Q.5AEAAA--&cb=e2e_69495dc1258023.87481108",
                            "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW27CMBC8Si+ANftw4u13+a+KOEBiQotUiEQQ0GoPXzu0FI9ke3dnH7MMjgviBfMT4RnyzOZMHBIFSghM8OXq1ZX8MvT7bjoNx933EPK4d43EFt1AIo0ThJGSR4lCaDwSeWuamNmJY8NqSG6ts6NAtASUYjUCULjw9erFl+s3L63bmnV72AW4coTTPErpxK7FIGNcCWkuB0MWGkyFsjS60Z43DVknGUKNFTr8IlP+GMfPaR4fNwTStlaLfw6XIscgvqg5RYuqmZcDn8Pd9HXI7nc6PCakorD+XH59NfeR848HzfebZj58CvvufTqeb\/udm4a6r7oFUoWfu+OuO+3Gw72898rgzcDWgIX6bAOGNmZpt9SzbOMPcuXp2OIBAAA=&cb=e2e_69495dc1258be3.55680913",
                            "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
                            "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
                            "width": 300,
                            "height": 250,
                            "media": "img_banner",
                        },
                        "multizoneid": 67890
                    },
                    {
                        "idzone": 12345,
                        "type": "banner",
                        "data": {
                            "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01Ry07DMBD8mt4iax.2Ex85wIUDSHyBk7i0UkKrODQF7cezdlFBa9mr2dnZh9tgO2IQMCiHdT3nHT_s6EnPtm0mjUuKczbDaVZEBARb7y26DoJsqZ9jXtNy_E6FIYRkOjTYgSFUKjlPznkQx44RvDhEEYtCElrVAmGAKzmlFgsEV4QORNgSkVbReICBMQXLOLC3o.1p9BgiD8Dog6aBbJyHw.k01TarrGLb1tzxRvHmsM5Tsy5fx7WJ.dzsj1P6iHMqUA2NaR8_p1WqZO2N2Qfg4iFYG4KU.YOV33gxW2_dRqezFk8KXxfhb_GiJfL49vov58_o9hoALDfeS2czx_e8XOpAWlDK97RVq2RdiOTlWXqA6CEmSBg7l6hl71se1O8p7e3wA2CxptPbAQAA&cb=e2e_69495dc1259304.50721064",
                            "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW24CMQy8Si9ANLbjkPBd/qsiDpDdhRapsBKLgFY+fL3Lo40l27HHjzGDdUY8Y34hLCALLsbEIVOgjMAEW67eLJJdNs2+DqfNcfezCW2\/t6jERa2ARJIRhJGzqagQkimRzUvMLDBiTayaYGVubHCRyMyRdPwEAA6GrVevtly\/m8+eMz8MmwBXVu8z7WIlWnSfCuNKyFM7FLRCmxKFWkmxiw13iUqVFkKpOBx2kaH97PuvYVofNwmknD2tj4CJ0ykQm401ziXGUswfbErX4fvQmj3hMM3IznD0TO6xsfY\/5k\/oDgkjadc0YWFD2NeP4Xi+3XYa6Pw9MV6AYoSd63FXT7v+8Oxt266JaKo2XJ37tlHJrhO6bcp+HvwC8uORF98BAAA=&cb=e2e_69495dc1259ad5.34119103",
                            "image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
                            "optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
                            "width": 300,
                            "height": 250,
                            "media": "img_banner"
                        },
                        "multizoneid": 67890
                    },
                    {
                        "idzone": 12345,
                        "type": "banner",
                        "data": {
                            "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA11Ry07DMBD8Gm5ptLt.xD5ygAsHkPgC13GaqHlUcdq0aD8eO0UFofFhNTP7tAGQZIChVNwuyyk.iecnek2vd2PdTHN0fSi7sVzaxO3deDhOx11_vp7n285PYz3tKAnMwFhpLVEZsLyG_eDiEubuK5R.GpiQSoMlGigJk5V0RUICsBJKIGhWiMwSmdhWqRawALiSStYMS3BFSGOykESUuiTdghcYrBTohZa13FOt0TrhQaC2KQ14FdG309THbQjYsK5r8eCLxBftMvTFMt.6pXDxVDRdH0Y3hExtUh0ad.4X3kpuswmhLYgcIUhpLef9K8k_esbdm65hSOkccfYzyYfK_PL58SfjF_SvCnAsB3eI82XbI_W5d.LNeyHi9zfW0hitq6bx6SahrpXz5AjznzifTvwNlJrwcuoBAAA-&cb=e2e_69495dc1259e91.21591992",
                            "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01Q0U7DMBD7FX5gle8uuSY8wzvSxAe0WQtIjEkrYgP548mysRErp4vPTqwoNK5EV6p3gnvYvWaqaJekk4ROBXxcPzEID9O4HZbPaf\/2M3Vlt6W5WO\/MEDOnwBQpMVo0gTOKMAFBEyjqvVoAmHsqUWFBVYPEdujB5\/VD21KhNOCosRrb4+xD4yUrjoLU\/MgoJlMOJsU8bMKoG5c8WIGJ5yoHD7aU193ufWl5cUYn0bWO4x9Bq\/kzjKuTp4YPIWfWBbbxsHx\/FPIqB2NC0uinjnbhTt7\/mhvEbm2rS7cdXpb9V0sVeLGd\/+V6Cz3MmIupz9BxRF+8L5vZVQLmnH3+BX0inm26AQAA&cb=e2e_69495dc125a500.54289539",
                            "image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
                            "optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
                            "width": 300,
                            "height": 250,
                            "media": "img_banner"
                        },
                        "multizoneid": 67890
                    }
                ]
            }
        }
    ]
}

Отзывчивые рекламные объявления

Некоторые форматы, например баннеры и интерстиции на Fullpage, могут позволить Responsive Display Ads получать спрос от кампаний Native Ads в дополнение к спросу от их оригинальных форматов объявлений. В таких ситуациях ответ будет содержать объект original_zone, указывающий на тип и данные оригинального формата.

Вот пример формата баннерной рекламы:

{
    "zones": [
        {
            "idzone": 5353142,
            "type": "native_ad",
            "data": {
                "layout": {
                    "widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https:\/\/www.exoclick.com\" rel=\"nofollow\">Powered By <span><\/span><\/a>",
                    "branding_logo": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo.png",
                    "branding_logo_hover": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo-hover.png",
                    "itemsPerRow": 1,
                    "itemsPerCol": 1,
                    "font_family": "Arial, Helvetica, Verdana, sans-serif",
                    "header_font_size": "12px",
                    "header_font_color": "#999999",
                    "widget_background_color": "transparent",
                    "widget_width": "450px",
                    "minimum_width_for_full_sized_layout": "450px",
                    "item_height": "300px",
                    "item_padding": "10px",
                    "image_height": "450px",
                    "image_width": "450px",
                    "text_margin_top": "3px",
                    "text_margin_bottom": "3px",
                    "text_margin_left": "0px",
                    "text_margin_right": "0px",
                    "title_font_size": "16px",
                    "title_font_color": "#000000",
                    "title_font_weight": "normal",
                    "title_decoration": "none",
                    "title_hover_color": "#0000FF",
                    "title_hover_font_weight": "normal",
                    "title_hover_decoration": "none",
                    "description_font_size": "14px",
                    "description_font_color": "#555555",
                    "description_font_weight": "normal",
                    "description_decoration": "none",
                    "description_hover_color": "#0055FF",
                    "description_hover_font_weight": "normal",
                    "description_hover_decoration": "none",
                    "open_in_new_window": 1,
                    "mobile_responsive_type": 1,
                    "header_is_on_top": 1,
                    "header_text_align": "right",
                    "title_enabled": 1,
                    "description_enabled": 1,
                    "image_border_size": "",
                    "image_border_color": "",
                    "text_align": "left",
                    "customcss_enabled": 1,
                    "customcss": "{\n    width: 300px !important;\n    height: 250px !important;\n}\n.exo-native-widget-header {\n    display: none !important;\n}\n.exo-native-widget-item-container {\n    width: 300px !important;\n    height: 250px !important;\n    max-width: 300px !important;\n    padding-right: 0 !important;\n    padding-bottom: 0 !important;\n}\n.exo-native-widget-item-image-wrapper { \n    width: 300px !important;\n    height: 250px !important;\n    max-height: 250px !important;\n    overflow: hidden !important;\n}\n.exo-native-widget-item-content-box {\n    position: relative !important;\n}\n.exo-native-widget-item-content {\n    position: absolute !important;\n    z-index: 5 !important;\n    top: 180px !important;\n    background-color: white !important;\n    opacity: 0.7 !important;\n    height: auto !important;\n    max-height: 110px !important;\n    min-height: 70px !important;\n    width: 100% !important;\n    max-width: 300px !important;\n}\n.exo-native-widget-item-title {\n    padding: 10px 8px 4px 8px !important;\n    height: 20px !important;\n    color: black !important;\n    font-weight: 900 !important;\n    font-size: 18px !important;\n    display: flex !important;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    white-space: normal !important;\n}\n.exo-native-widget-item-text {\n    padding: 20px 8px 4px 8px !important;\n    height: 20px !important;\n    color: grey !important;\n    font-weight: normal !important;\n    font-size: 13px !important;\n    display: flex !important;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    white-space: normal !important;\n}\n.exo-native-widget-item-brand {\n    padding: 5px 8px 0px 8px !important;\n    height: 20px !important;\n    font-weight: normal !important;\n    font-size: 18px !important;\n    display: none !important;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    white-space: normal !important;\n}",
                    "header_enabled": 1,
                    "mobile_breakpoint": 450,
                    "spacing_v": 10,
                    "spacing_h": 10,
                    "zoom": 1,
                    "mobile_rows": 1,
                    "mobile_cols": 1,
                    "use_v2_script": 1,
                    "text_enabled": 1,
                    "mobile_image_width": 450,
                    "mobile_text_box_size": 90,
                    "mobile_text_enabled": 1,
                    "mobile_text_position": "bottom",
                    "mobile_image_height": 450,
                    "delaySeconds": 0,
                    "frequency": 0,
                    "frequencyCount": 0,
                    "publisherAdType": "native-recommendation",
                    "adTriggerType": "",
                    "popTriggerMethod": "",
                    "popTriggerClasses": "",
                    "item_spacing_on_each_side": "5px",
                    "text_position": "bottom",
                    "text_box_size": "90px",
                    "widget_height": "570px",
                    "brand_enabled": 0,
                    "brand_font_size": "11px",
                    "brand_font_color": "#555555",
                    "brand_font_weight": "normal",
                    "brand_decoration": "none"
                },
                "ad_items": [
                    {
                        "image": "https:\/\/s.example.net\/library\/451295\/4c5353dfe10c9e8ea12b05cc44eb0c6cafbc6100.jpg",
                        "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01RwW7DIAz9mt4iZBuHwnGH7rLDJvUDJkJIWylZqpA16.SPH6Cpmx4YYz.eMZi93rMzYhS0cl7Xa9rppx095zHOXXdX88lPURUzzMspqjBPORfT..GYVxEQ3BvDaJFQtthNPq1xuXxXphCSsqjQgiLMVCDDYBmk1a1GJmkRRRiFxO2zFohggSP4QrB5q5mIGFvR4CBojI41Bm245456g87rABqNy8dANp3CeZ7HVKtDxbZtzSPe5HhzXqexWZf7ZW18ujbDZYwfucESqqk.Dv5zXKVKFmitjQNdPARm56Q2DiS_hALOs.Xq5tuWVggNCFGhlq0cjm__.H8oDFCQf6DYzFX4KJ3U5E9pudWGWErh_JRVLsui3LL.64tQ77kbnOfWDtH2vQeLjgM548MQYvgB99zVE.gBAAA-&cb=e2e_694966c98c6cc2.67060117",
                        "optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/451295\/15c408293013fe9637290dbc36ec5a3fbd671c48.webp",
                        "title": "All systems online \ud83d\udc68\u200d\ud83d\ude80",
                        "description": "Reach for the stars in this new space simulation game.",
                        "brand": "ogame.com",
                        "original_url": "https:\/\/lobby.ogame.gameforge.com\/es_ES\/",
                        "image_position": "50% 50%",
                        "format": "native_ad",
                        "size": "300x300",
                        "iframe_url": "",
                        "impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA01QW04DMQy8ChfoymM72Q3f9B9R9QC7aXhIlEpdRAHN4Um2tJCRbDlje2yraFhBV6o3kFvXWwEV2g3oMEinEK4393TwVKb9OL+X48t36fJhTw\/QFJgEZpEQUxkGBgsGVwaAsbfeU+M0ugwuTD2VUmGuqo7Qgk4kSmAv3G7uuN4+sIr3qhenJJYpWiN6DZBUPiHD0kmSZENJbsgWfeeT7iLSaFkMMdV04cnm\/Hw4vM7L5HJGB8Q6HMPlg1Y3SWJctRqDuKfE+oQLPc5fb5m8pgc\/O1q12hZrdX\/8f2D4XTUsFk1+SRfO3X58mo8f56suevXwrebMX3uyFMEoKT5OZZzyVC9gIfa7WDBZHqfwA7sG\/xjOAQAA&cb=e2e_694966c98c7af4.92854754",
                        "count_only_viewed_impressions": 0,
                        "video_thumb_id": null,
                        "video_thumb_url": null,
                        "video_thumb_enabled": 0
                    }
                ]
            },
            "original_zone": {
                "type": "banner",
                "data": {
                    "width": 300,
                    "height": 250
                }
            }
        }
    ]
}

Отслеживание впечатлений

Обязательно выполните GET-вызов для URL-адреса впечатления, чтобы зарегистрировать впечатления для ваших рекламных запросов. Один из способов добиться этого - создать невидимый файл изображения, используя URL-адрес впечатления в качестве источника на странице, где будет показано объявление, например

<img src="impression_url" width="0" height="0">

Баннер​

Примеры ответов на баннеры​

Липкий баннер​

Пример ответа на липкий баннер​

Мгновенные сообщения​

Пример ответа на мгновенное сообщение​

Нативная реклама​

Пример ответа на нативную рекламу​

Видео Outstream​

Пример ответа на видеозапись из внешнего потока​

Видеослайдер​

Пример ответа на видеослайдер​

Межстраничные объявления​

Пример межстраничного ответа​

Продвижение по страницам​

Пример ответа на Push-уведомление на странице​

Многоформатный​

Пример ответа в нескольких форматах​

Отзывчивые рекламные объявления​

Отслеживание впечатлений​