> For the complete documentation index, see [llms.txt](https://docs.exoclick.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.exoclick.com/api/ru/api-razmesheniya-reklamy/otvet/ad-plac-response.md). # Зоны ответа В JSON-ответе API размещения рекламы содержатся **зоны** массив и [**рендереры**](https://docs.exoclick.com/docs/ad-plac-renderers/) и [**пользовательские**](/api/ru/api-razmesheniya-reklamy/otvet/ad-plac-user.md) объекты. На этой странице мы объясним **зоны** массив, который содержит все сведения о рекламе, выигравшей ваш запрос на рекламу. Массив содержит объект с данными о рекламе для каждого запрошенного 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`, соответственно. | ### Примеры ответа для баннера **Баннер с изображением:** ```json { "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-баннер:** ```json { "zones": [ { "idzone": 2222222, "type": "banner", "data": { "html": "\n
\nПример HTML-рекламы!\n
\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" } } ] } ``` **Видео-баннер:** ```json { "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` соответственно. | ### Пример ответа для закрепленного баннера ```json { "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` соответственно. | ### Пример ответа для мгновенного сообщения ```json { "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 | Статус ресурса миниатюры видео (если есть). | ### Пример ответа для нативной рекламы ```json { "zones": [ { "idzone": 4058715, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "При поддержке ", "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 ```json { "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 ```json { "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. ```json { "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 ```json { "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.**](#native-ads) * Если выигравшее объявление является кампанией Banner и у вас есть **Одна зона** в макете, ответ будет содержать [**обычный объект данных Banner.**](#banner) * Если выигравшее объявление является кампанией Banner и вы выбрали макет с **несколькими объявлениями**, ответ будет содержать **объект группы** со следующими свойствами: | Свойство | Описание | | ----------- | ---------------------------------------------------------------------------- | | orientation | Ориентация макета Multi-Zone, которая может быть "horizontal" или "vertical" | | ad\_items | Массив, содержащий данные объявления для каждого места в макете. | Независимо от результата, свойство **multizoneid** будет добавлено в ответ, указывая ID зоны многоформатной рекламной зоны, которой соответствует этот ответ. ### Пример ответа Multi-Format Следующий пример показывает **зоны** объект для многоформатной рекламной зоны с **Горизонтальный x 3** макет: ```json { "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 } ] } } ] } ``` ## Адаптивные медийные объявления Некоторые форматы, такие как баннеры и полностраничные межстраничные объявления, могут включать [**Адаптивные медийные объявления**](/exoclick-docs/general-responsive-display-ads.md) чтобы получать спрос от кампаний Native Ads в дополнение к спросу от их исходных рекламных форматов. В таких случаях ответ будет содержать **original\_zone** объект, указывающий тип и данные исходного формата. Вот пример формата баннерной рекламы: ```json { "zones": [ { "idzone": 5353142, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "При поддержке <\/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 показов в качестве источника на странице, где будет отображаться реклама, например: ```html ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.exoclick.com/api/ru/api-razmesheniya-reklamy/otvet/ad-plac-response.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.