Зоны ответа

В JSON-ответе API размещения рекламы содержатся зоны массив и рендереры и пользовательские объекты.

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

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

Свойство	Описание
idzone	ID рекламной зоны.
type	Используемый формат рекламы, например banner.
data	Данные рекламы (объект)

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

Баннер

Свойство	Описание
url	URL, на который ведет реклама.
impression	URL показа
image	Исходное изображение, загруженное для рекламы.
optimum_image	Если загруженный креатив — анимированный GIF, это его оптимизированная версия в формате MP4, создаваемая для использования в рекламе.
width	Ширина рекламы в пикселях.
height	Высота рекламы в пикселях.
media	Это показывает, какой это тип баннера: изображение, 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\">\nПример HTML-рекламы!\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 перехода по клику
impression	URL показа
image	Исходное изображение, загруженное для рекламы.
optimum_image	В закрепленном баннере, если загруженный креатив — анимированный GIF, это его оптимизированная версия в формате MP4, создаваемая для использования в рекламе.
width	Ширина рекламы в пикселях.
height	Высота рекламы в пикселях.
frequency_period	Как часто реклама показывается в минутах.
v_pos	Вертикальное положение рекламы.
h_pos	Горизонтальное положение рекламы.
media	Это показывает, какой это тип баннера: изображение, 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 перехода по клику
impression	URL показа
image	URL изображения
optimum_image	Если загруженный креатив — анимированный GIF, это его оптимизированная версия в формате MP4, создаваемая для использования в рекламе.
width	Ширина рекламы в пикселях.
height	Высота рекламы в пикселях.
frequency_period	Как часто реклама показывается в минутах.
media	Это показывает, какой тип баннера используется: изображение, 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 вернет два объекта: layout и ad_items

data.layout

Свойство	Описание
widgetHeaderContentHtml	URL отображаемого брендинга «При поддержке».*
branding_logo	URL логотипа брендинга, который отображается при включении.*
branding_logo_hover	URL логотипа брендинга, который отображается при наведении пользователя.*
itemsPerRow	Количество объявлений, отображаемых в каждой строке виджета.
itemsPerCol	Количество объявлений, отображаемых в каждом столбце виджета.
font_family	Шрифт, используемый в рекламе.
header_font_size	Размер шрифта, используемого в заголовке брендинга.
header_font_color	Цвет шрифта, используемого в заголовке брендинга.
widget_background_color	Шестнадцатеричный код цвета фона, используемого для виджета.
widget_width	Ширина всего виджета.
minimum_width_for_full_sized_layout	Минимальная ширина полноразмерного макета в пикселях.
item_height	Высота каждого отдельного объявления.
item_padding	Отступ между каждым из объявлений.
image_height	Высота изображения в каждом объявлении.
image_width	Ширина изображения в каждом объявлении.
text_margin_top	Размер верхнего отступа текста в пикселях.
text_margin_bottom	Размер нижнего отступа текста в пикселях.
text_margin_left	Размер левого отступа текста в пикселях.
text_margin_right	Размер правого отступа текста в пикселях.
title_font_size	Размер шрифта заголовка каждого объявления.
title_font_color	Цвет шрифта заголовка каждого объявления.
title_font_weight	Начертание шрифта заголовка каждого объявления.
title_decoration	Подчеркнут ли заголовок.
title_hover_color	Цвет шрифта при наведении на заголовок.
title_hover_font_weight	Начертание шрифта при наведении на заголовок.
title_hover_decoration	Подчеркивается ли заголовок при наведении.
description_font_size	Размер шрифта описания каждого объявления.
description_font_color	Цвет шрифта описания каждого объявления.
description_font_weight	Начертание шрифта описания каждого объявления.
description_decoration	Подчеркнуто ли описание.
description_hover_color	Цвет шрифта при наведении на описание.
description_hover_font_weight	Начертание шрифта при наведении на описание.
description_hover_decoration	Подчеркивается ли описание при наведении.
open_in_new_window	Должна ли реклама открываться в новом окне при нажатии. 1=да, 0=нет.
mobile_responsive_type	Тип адаптивности при использовании мобильного устройства (то есть none или compact). 1=compact, 0=нет.
header_is_on_top	Следует ли показывать брендинг над объявлениями или под ними. 1=да, 0=нет.
header_text_align	Горизонтальное выравнивание заголовка брендинга.
title_enabled	Включен ли заголовок. 1=да, 0=нет.
description_enabled	Включено ли описание. 1=да, 0=нет.
image_border_size	Размер границы изображения в пикселях.
image_border_color	Шестнадцатеричный код цвета границы изображения.
text_align	Выравнивание текста: слева, по центру или справа.
customcss_enabled	Включен ли пользовательский CSS или нет. 1=да, 0=нет.
customcss	Если включен, пользовательский CSS будет отображаться здесь.
header_enabled	Включен ли заголовок или нет. 1=да, 0=нет.
mobile_breakpoint	Точка перехода в пикселях между десктопным и мобильным представлениями рекламной зоны.
spacing_v	Вертикальный промежуток в пикселях между объявлениями, заданный в дополнительных параметрах.
spacing_h	Горизонтальный промежуток в пикселях между объявлениями, заданный в дополнительных параметрах.
zoom	Должна ли реклама увеличиваться/уменьшаться при наведении.
mobile_rows	Количество строк объявлений в мобильном виджете.
mobile_cols	Количество столбцов объявлений в мобильном виджете.
use_v2_script	Была ли рекламная зона создана с новой настройкой V2 или со старой v1.
text_enabled	Должны ли отображаться текст заголовка и описание. 1=да, 0=нет.
mobile_image_width	Ширина изображения в каждом объявлении на мобильном устройстве.
mobile_text_box_size	Размер текстового блока на мобильном устройстве. Допустимый диапазон 50-500.
mobile_text_enabled	Включен ли заголовок на мобильном устройстве или нет. 1=да, 0=нет.
mobile_text_position	Положение текста на мобильном устройстве: снизу или справа.
item_spacing_on_each_side	Отступ с каждой стороны объявлений, если они были настроены с использованием старой настройки v1.
text_position	Расположен ли текст слева или справа.
text_box_size	Размер текстового блока в пикселях. Диапазон 50-500.
widget_height	Высота всего виджета.
brand_enabled	Включен ли брендинг или нет.
brand_font_size	Размер шрифта брендинга.
brand_font_color	Цвет шрифта брендинга.
brand_font_weight	Начертание шрифта брендинга.
brand_decoration	Подчеркнут ли шрифт.
mobile_image_height	Высота изображения в каждом объявлении на мобильном устройстве.
publisherAdType	Что это за тип нативной рекламы, то есть recommendation, exit или interstitial: native-recommendation, native-interstitial.

data.ad_items

Свойство	Описание
idvariation	ID вариации.
image	Исходное изображение, загруженное для рекламы.
url	URL перехода по клику.
impression	URL показа.
title	Текст заголовка рекламы.
description	Текст описания рекламы.
brand	Текст бренда рекламы.
original_url	Исходный URL целевой страницы.
image_position	Положение изображения рекламы (как будет обрезано изображение).
size	Размер выбранного формата рекламы
iframe_url	Если в качестве варианта используется iframe, это будет URL iframe.
video_thumb_id	Идентификатор ресурса миниатюры видео (если есть), связанного с рекламным креативом.
video_thumb_url	URL ресурса миниатюры видео (если есть).
video_thumb_enabled	Статус ресурса миниатюры видео (если есть).

Пример ответа для нативной рекламы

{
    "zones": [
        {
            "idzone": 4058715,
            "type": "native_ad",
            "data": {
                "layout": {
                    "widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https://www.exoclick.com\" rel=\"nofollow\">При поддержке <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": "заголовок 5",
                        "description": "описание 5",
                        "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",
                        "description": "Описание Native 3",
                        "brand": "Бренд Native 3",
                        "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/TbgukYG4hxnNP0nH364sUKu1XQeq7juSgm3qgK29zzv4Hxr/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
impression	URL показа

data.tracking

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

Свойство	Описание
offset	Метка прогресса в секундах или в процентах просмотренной видеорекламы
url	URL отслеживания

data.cta

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

Пример ответа Outstream Video

{
    "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": "Смотреть ещё"
                }
            }
        }
    ]
}

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

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

data.tracking

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

Свойство	Описание
offset	Метка прогресса в секундах или в процентах просмотренной видеорекламы
url	URL отслеживания

data.cta

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

Пример ответа Video Slider

{
    "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": "Смотреть бесплатно"
                }
            }
        }
    ]
}

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

Свойство	Описание
url	URL перехода по клику
impression	URL показа
image	Исходное изображение, загруженное для рекламы.
optimum_image	Если загруженный креатив — анимированный GIF, это его оптимизированная версия в формате MP4, создаваемая для использования в рекламе.
width	Ширина рекламы в пикселях.
height	Высота рекламы в пикселях.
frequency_count	Сколько раз может показываться объявление
frequency_period	Как часто в минутах показывается объявление
frequency_trigger_type	Флаг, указывающий, основана ли частота этого объявления на показах (0) или кликах (1)
ad_trigger_method	Метод триггера, включенный для этой рекламной зоны
ad_trigger_classes	Классы, которые должны запускать показ объявления, если таковые имеются
first_trigger_clicks	Количество кликов, необходимых при первом посещении пользователя для запуска объявления
next_trigger_clicks	Количество кликов, необходимых после первого срабатывания объявления, чтобы показать его снова
chrome_enabled	Флаг, указывающий, включена ли эта рекламная зона для Chrome (1), отключена (0) или включена исключительно для этого браузера (2)
capping_enabled	Флаг, указывающий, следует ли применять лимитирование к этой рекламной зоне
media	Это показывает, какой это тип баннера: изображение, HTML или видео: это должно быть img_banner, html_banner или video_banner, соответственно.

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

Пример ответа Fullpage Interstitial

Обратите внимание, что хотя пример показывает Desktop 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
            }
        }
    ]
}

Внутристраничный Push

Свойство	Описание
url	URL перехода по клику
impression	URL показа
image	Исходное изображение, загруженное для рекламы.
optimum_image	Если загруженный креатив — анимированный GIF, это его оптимизированная версия в формате MP4, создаваемая для использования в рекламе.
title	Заголовок уведомления
description	Описание уведомления
horizontal_position	Указывает горизонтальное положение на странице (слева, по центру, справа)
vertical_position	Указывает вертикальное положение на странице (вверху, посередине, внизу)
delay	Количество секунд до появления уведомления после загрузки страницы
max_notifications_on_page	Количество уведомлений, которые могут одновременно отображаться на странице
once_closed_hide_for	Продолжительность скрытия объявления в секундах после его закрытия (требуется согласие пользователя на использование cookie)
user_session_capping	Количество раз, когда объявление показывается пользователю (требуется согласие пользователя на использование cookie)
delay_between_notifications	Количество секунд до появления следующего уведомления после загрузки предыдущего

Пример ответа In-Page Push Notification

{
  "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":"Заголовок",
    "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 может вернуть разные результаты:

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

Свойство	Описание
orientation	Ориентация макета Multi-Zone, которая может быть "horizontal" или "vertical"
ad_items	Массив, содержащий данные объявления для каждого места в макете.

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

Пример ответа Multi-Format

Следующий пример показывает зоны объект для многоформатной рекламной зоны с Горизонтальный 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_69495dc1258be3.55680913",
                            "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
                    }
                ]
            }
        }
    ]
}

Адаптивные медийные объявления

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

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

{
    "zones": [
        {
            "idzone": 5353142,
            "type": "native_ad",
            "data": {
                "layout": {
                    "widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https:\/\/www.exoclick.com\" rel=\"nofollow\">При поддержке <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": "Все системы онлайн 👨‍🚀",
                        "description": "Дотянитесь до звёзд в этой новой космической игре-симуляторе.",
                        "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">