> 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/es/api-de-colocacion-de-anuncios/respuesta/ad-plac-response.md). # Zonas de respuesta El JSON de respuesta de la API de colocación de anuncios contiene el **zonas** array y los [**renderizadores**](https://docs.exoclick.com/docs/ad-plac-renderers/) y [**usuario**](/api/es/api-de-colocacion-de-anuncios/respuesta/ad-plac-user.md) objetos. En esta página explicaremos la **zonas** array, que contiene todos los detalles sobre el anuncio que ganó tu solicitud de anuncio. El array contiene un objeto con los datos del anuncio para cada ID de zona solicitado. | Propiedad | Descripción | | --------- | ------------------------------------------------- | | idzone | El ID de la zona de anuncios. | | type | El formato de anuncio utilizado, p. ej. `banner`. | | data | Los datos del anuncio (objeto) | A continuación encontrarás una lista detallada de las propiedades devueltas para cada **data** objeto según los formatos de anuncio disponibles. ## Banner | Propiedad | Descripción | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | url | La URL a la que dirige el anuncio. | | impression | La URL de impresión | | image | La imagen original cargada para el anuncio. | | optimum\_image | Si la creatividad cargada es un GIF animado, esta es su versión MP4 optimizada, creada para usarla en el anuncio. | | width | El ancho del anuncio en píxeles. | | height | La altura del anuncio en píxeles. | | media | Esto muestra qué tipo de banner es: imagen, HTML o vídeo: debería ser `img_banner`, `html_banner` o `video_banner`, respectivamente. | ### Ejemplos de respuesta de banner **Banner de imagen:** ```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" } } ] } ``` **Banner HTML:** ```json { "zones": [ { "idzone": 2222222, "type": "banner", "data": { "html": "\n
\nExample HTML Ad!\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" } } ] } ``` **Banner de vídeo:** ```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" } } ] } ``` ## Banner fijo | Propiedad | Descripción | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | url | La URL de clic | | impression | La URL de impresión | | image | La imagen original cargada para el anuncio. | | optimum\_image | En un banner fijo, si la creatividad cargada es un GIF animado, esta es su versión MP4 optimizada, creada para usarla en el anuncio. | | width | El ancho del anuncio en píxeles. | | height | La altura del anuncio en píxeles. | | frequency\_period | Cada cuántos minutos se muestra el anuncio. | | v\_pos | La posición vertical del anuncio. | | h\_pos | La posición horizontal del anuncio. | | media | Esto muestra qué tipo de banner es: imagen, HTML o vídeo: debería ser `img_banner`, `html_banner`, o `video_banner` respectivamente. | ### Ejemplo de respuesta de banner fijo ```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" } } ] } ``` ## Mensajes instantáneos | Propiedad | Descripción | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | url | La URL de clic | | impression | La URL de impresión | | image | La URL de la imagen | | optimum\_image | Si la creatividad cargada es un GIF animado, esta es su versión MP4 optimizada, creada para usarla en el anuncio. | | width | El ancho del anuncio en píxeles. | | height | La altura del anuncio en píxeles. | | frequency\_period | Cada cuántos minutos se muestra el anuncio. | | media | Esto muestra qué tipo de banner se utiliza: imagen, HTML o vídeo: debería ser `img_banner`, `html_banner`, o `video_banner` respectivamente. | ### Ejemplo de respuesta de mensaje instantáneo ```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" } } ] } ``` ## Anuncios nativos Cuando la respuesta devuelve un anuncio nativo, zones.data devolverá dos objetos: **layout** y **ad\_items** **data.layout** | Propiedad | Descripción | | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | widgetHeaderContentHtml | La URL de la marca 'Powered by' que se muestra.\* | | branding\_logo | La URL del logotipo de marca que se muestra si está habilitado.\* | | branding\_logo\_hover | La URL del logotipo de marca que se muestra cuando el usuario pasa el cursor sobre él.\* | | itemsPerRow | El número de anuncios que se muestran en cada fila del widget. | | itemsPerCol | El número de anuncios que se muestran en cada columna del widget. | | font\_family | La familia de fuente utilizada en el anuncio. | | header\_font\_size | El tamaño de fuente utilizado en el encabezado de marca. | | header\_font\_color | El color de la fuente utilizada en el encabezado de marca. | | widget\_background\_color | El código hexadecimal del color de fondo utilizado para el widget. | | widget\_width | El ancho de todo el widget. | | minimum\_width\_for\_full\_sized\_layout | El ancho mínimo para un diseño de tamaño completo en píxeles. | | item\_height | La altura de cada anuncio individual. | | item\_padding | El relleno entre cada uno de los anuncios. | | image\_height | La altura de la imagen en cada anuncio. | | image\_width | El ancho de la imagen en cada anuncio. | | text\_margin\_top | El tamaño en píxeles del margen superior del texto. | | text\_margin\_bottom | El tamaño en píxeles del margen inferior del texto. | | text\_margin\_left | El tamaño en píxeles del margen izquierdo del texto. | | text\_margin\_right | El tamaño en píxeles del margen derecho del texto. | | title\_font\_size | El tamaño de fuente del título de cada anuncio. | | title\_font\_color | El color de fuente del título de cada anuncio. | | title\_font\_weight | El grosor de fuente del título de cada anuncio. | | title\_decoration | Si el título está subrayado o no. | | title\_hover\_color | El color de fuente cuando se pasa el cursor sobre el título. | | title\_hover\_font\_weight | El grosor de fuente cuando se pasa el cursor sobre el título. | | title\_hover\_decoration | Si el título se subraya al pasar el cursor o no. | | description\_font\_size | El tamaño de fuente de la descripción de cada anuncio. | | description\_font\_color | El color de fuente de la descripción de cada anuncio. | | description\_font\_weight | El grosor de fuente de la descripción de cada anuncio. | | description\_decoration | Si la descripción está subrayada o no. | | description\_hover\_color | El color de fuente cuando se pasa el cursor sobre la descripción. | | description\_hover\_font\_weight | El grosor de fuente cuando se pasa el cursor sobre la descripción. | | description\_hover\_decoration | Si la descripción se subraya al pasar el cursor o no. | | open\_in\_new\_window | Si el anuncio debe abrirse en una nueva ventana al hacer clic. 1=sí, 0=no. | | mobile\_responsive\_type | El tipo de adaptabilidad al usar un dispositivo móvil (es decir, sin formato o compacto). 1=compacto, 0=no. | | header\_is\_on\_top | Si la marca debe mostrarse encima o debajo de los anuncios. 1=sí, 0=no. | | header\_text\_align | La alineación horizontal del encabezado de marca. | | title\_enabled | Si el título está habilitado o no. 1=sí, 0=no. | | description\_enabled | Si la descripción está habilitada o no. 1=sí, 0=no. | | image\_border\_size | El tamaño en píxeles del borde de la imagen. | | image\_border\_color | El color hexadecimal del borde de la imagen. | | text\_align | La alineación del texto: izquierda, centro o derecha. | | customcss\_enabled | Si el CSS personalizado está habilitado o no. 1=sí, 0=no. | | customcss | Si está habilitado, el CSS personalizado se mostrará aquí. | | header\_enabled | Si el encabezado está habilitado o no. 1=sí, 0=no. | | mobile\_breakpoint | El punto de ruptura en píxeles entre las vistas de escritorio y móvil de la zona de anuncios. | | spacing\_v | El espaciado vertical en píxeles entre los anuncios, configurado en Opciones avanzadas. | | spacing\_h | El espaciado horizontal en píxeles entre los anuncios, configurado en Opciones avanzadas. | | zoom | Si el anuncio debe acercarse o alejarse al pasar el cursor. | | mobile\_rows | El número de filas de anuncios en el widget móvil. | | mobile\_cols | El número de columnas de anuncios en el widget móvil. | | use\_v2\_script | Si la zona de anuncios se creó con la configuración V2 más reciente o con la v1 anterior. | | text\_enabled | Si el título y la descripción de texto deben mostrarse. 1=sí, 0=no. | | mobile\_image\_width | El ancho de la imagen en cada anuncio en móvil. | | mobile\_text\_box\_size | El tamaño del cuadro de texto en móvil. Rango válido 50-500. | | mobile\_text\_enabled | Si el título está habilitado o no en móvil. 1=sí, 0=no. | | mobile\_text\_position | La posición del texto en móvil: inferior o derecha. | | item\_spacing\_on\_each\_side | El relleno en cada lado de los anuncios, si se configuraron usando la antigua configuración v1. | | text\_position | Si el texto está posicionado en el lado izquierdo o derecho. | | text\_box\_size | El tamaño del cuadro de texto en píxeles. Rango 50-500. | | widget\_height | La altura de todo el widget. | | brand\_enabled | Si la marca está habilitada o no. | | brand\_font\_size | El tamaño de fuente de la marca. | | brand\_font\_color | El color de fuente de la marca. | | brand\_font\_weight | El grosor de fuente de la marca. | | brand\_decoration | Si la fuente está subrayada o no. | | mobile\_image\_height | La altura de la imagen en cada anuncio en móvil. | | publisherAdType | Qué tipo de anuncio nativo es, es decir, recommendation, exit o interstitial: `native-recommendation`, `native-interstitial`. | **data.ad\_items** | Propiedad | Descripción | | --------------------- | -------------------------------------------------------------------------------------------------------------- | | idvariation | El ID de la variación. | | image | La imagen original cargada para el anuncio. | | url | La URL de clic. | | impression | La URL de impresión. | | title | El texto del título del anuncio. | | description | El texto de la descripción del anuncio. | | brand | El texto de la marca del anuncio. | | original\_url | La URL original de la página de destino. | | image\_position | La posición de la imagen del anuncio (cómo se recortará la imagen). | | size | El tamaño del formato de anuncio seleccionado | | iframe\_url | Si se usa un iframe como variación, esta será la URL del iframe. | | video\_thumb\_id | El identificador del recurso de miniatura de vídeo (si está presente) asociado con la creatividad del anuncio. | | video\_thumb\_url | La URL del recurso de miniatura de vídeo (si está presente). | | video\_thumb\_enabled | El estado del recurso de miniatura de vídeo (si está presente). | ### Ejemplo de respuesta de anuncios nativos ```json { "zones": [ { "idzone": 4058715, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "Powered By ", "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": "título 5", "description": "descripción 5", "brand": "marca 5", "original_url": "https://www.example.com/natives-5", "image_position": "50% 50%" }, { "image": "https://static.example.com/library/432437/d51084a3da98f857bca6ba19037cfe90b9a93c0b.jpg", "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OOW7EMAxFrzLNlBG4iFrKNGlS5AySR0ICZANsxCn.4UN7gIAEuH0.8oLIkjNVMOF1277Xqz5e5cl93_cwftttDcvXh9efbXv7GeuDAiCAEzNrJU34V4FzDc4LrBZEEhCNuWQyRLKS2WBUvMtQBzjGQWA3sGiEHirzaWae6rBeR1NOi42ebVJvsfU0NPsGob839_PuSboAciaH6XFZ9Z6RpHp.XekuLfEMES_PsCEcS7ZOc6HU6pR0mxIlVuNcUvsDR8DGSCMBAAA-", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OSU4EMQz8Ch/oqLzFydxAvADEA9I96ROIA5c5+PHj7gEJV+Ko7FKlGEwLaGE8wS7iF6pB3guxFxIrzDVe3p5DKeZtXH/K9v0VKqzif09z7c1CYc3JwtBSze7ooUbUHBbpKoGEHDJLtyQFFI74eH89LyUYkf34kFCUCwpFR2gOcUMQi4YT7ZIZ1z6HUN1srm471qFjrTMDHebr58hzpsUJKi6Vg3/pI0vGE4mFHgRce2QhznVW03/yMU3nbjW7wfu8trHtuk3kZBuT7xcrT8hLAQAA", "title": "Native 3 title", "description": "Native 3 description", "brand": "Native 3 brand", "original_url": "https://www.example.com/natives-3", "image_position": "50% 50%" }, { "image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png", "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0nH364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==", "title": "Native 2 title", "description": "Native 2 description", "brand": "Marca nativa 12", "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%" } ] } } ] } ``` ## Vídeo outstream | Propiedad | Descripción | | --------------- | -------------------------------------------------------------------------------------------------------- | | url | La URL de clic | | seguimiento | Un objeto con información de seguimiento. | | vídeo | El archivo del anuncio de vídeo o el enlace VAST a cargar. | | brandingEnabled | Indicador para habilitar el branding. **Este valor actualmente no se usa** | | frequencyPeriod | Cada cuántos minutos se muestra el anuncio. | | maximumWidth | Tamaño del ancho del vídeo. | | isVast | Indica si la campaña ganadora es un anuncio de vídeo normal (false) o una campaña de enlace VAST (true). | | ctaEnabled | Indicador para mostrar un CTA en el anuncio | | cta | Un objeto que contiene los detalles del CTA | | impression | La URL de impresión | **data.tracking** Por el momento, el **data.tracking** objeto solo devuelve un `progreso` arreglo con objetos destinados a rastrear la reproducción del video. De estos objetos, el que tiene `"offset": "00:00:10.000"` es el que se debe llamar para registrar la visualización del video. Las propiedades de cada objeto se explican a continuación: | Propiedad | Descripción | | --------- | ----------------------------------------------------------------------------------- | | offset | Marcador de progreso en segundos o como porcentaje del anuncio de video reproducido | | url | URL de seguimiento | **data.cta** | Propiedad | Descripción | | ---------- | ---------------------------------------------------- | | displayUrl | URL relacionada con la página de destino del anuncio | | text | Texto que se utilizará en el elemento CTA | ### Ejemplo de respuesta de video outstream ```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": "Ver más" } } } ] } ``` ## Control deslizante de video | Propiedad | Descripción | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | url | La URL de clic | | seguimiento | Un objeto con información de seguimiento. | | vídeo | El archivo del anuncio de vídeo o el enlace VAST a cargar. | | screenDensity | Entero que indica la proporción del espacio máximo de pantalla que ocupa el anuncio en el dispositivo del usuario | | onComplete | Indica el comportamiento del anuncio después de que el video haya terminado de reproducirse. "hide" significa que el anuncio debe ocultarse, mientras que "repeat" significa que el anuncio debe permanecer en la página para permitir que el usuario lo reproduzca de nuevo | | closeAfter | Indica la cantidad de segundos necesarios antes de que se muestre el botón de cierre en el anuncio | | brandingEnabled | Indicador para habilitar el branding. **Esta propiedad actualmente no se usa** | | frequencyPeriod | Cada cuántos minutos se muestra el anuncio. | | impression | La URL de impresión | | isVast | Indica si la campaña ganadora es un anuncio de vídeo normal (false) o una campaña de enlace VAST (true). | | ctaEnabled | Indicador para mostrar un CTA en el anuncio | | cta | Un objeto que contiene los detalles del CTA | **data.tracking** Por el momento, el **data.tracking** objeto solo devuelve un `progreso` arreglo con objetos destinados a rastrear la reproducción del video. De estos objetos, el que tiene `"offset": "00:00:10.000"` es el que se debe llamar para registrar la visualización del video. Las propiedades de cada objeto se explican a continuación: | Propiedad | Descripción | | --------- | ----------------------------------------------------------------------------------- | | offset | Marcador de progreso en segundos o como porcentaje del anuncio de video reproducido | | url | URL de seguimiento | **data.cta** | Propiedad | Descripción | | ---------- | ---------------------------------------------------- | | displayUrl | URL relacionada con la página de destino del anuncio | | text | Texto que se utilizará en el elemento CTA | ### Ejemplo de respuesta de control deslizante de video ```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": "Ver gratis" } } } ] } ``` ## Intersticiales de página completa | Propiedad | Descripción | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | url | La URL de clic | | impression | La URL de impresión | | image | La imagen original cargada para el anuncio. | | optimum\_image | Si la creatividad cargada es un GIF animado, esta es su versión MP4 optimizada, creada para usarla en el anuncio. | | width | El ancho del anuncio en píxeles. | | height | La altura del anuncio en píxeles. | | frequency\_count | Cuántas veces puede mostrarse el anuncio | | frequency\_period | Con qué frecuencia, en minutos, se muestra el anuncio | | frequency\_trigger\_type | Indicador para señalar si la frecuencia de este anuncio se basa en impresiones (0) o clics (1) | | ad\_trigger\_method | Método de activación habilitado para esta zona de anuncios | | ad\_trigger\_classes | Clases que deberían activar el anuncio, si las hay | | first\_trigger\_clicks | Número de clics necesarios en la visita inicial del usuario para activar el anuncio | | next\_trigger\_clicks | Número de clics necesarios después del primer disparo del anuncio para mostrarlo de nuevo | | chrome\_enabled | Indicador para señalar si esta zona de anuncios está habilitada para Chrome (1), deshabilitada (0) o habilitada exclusivamente para este navegador (2) | | capping\_enabled | Indicador para señalar si se debe aplicar capping a esta zona de anuncios o no | | media | Esto muestra qué tipo de banner es: imagen, HTML o vídeo: debería ser `img_banner`, `html_banner` o `video_banner`, respectivamente. | **Nota:** la mayoría de las propiedades de la respuesta de Interstitial de página completa están relacionadas con el capping y la activación del anuncio. Como tú te encargas de renderizar el anuncio, depende de ti decidir si quieres prestar atención a estas propiedades o no. ### Ejemplo de respuesta de Interstitial de página completa Ten en cuenta que, aunque el ejemplo muestra un interstitial de página completa para escritorio, la respuesta para un interstitial de página completa móvil debería ser la misma, salvo por 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 } } ] } ``` ## Notificación push en la página | Propiedad | Descripción | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ | | url | La URL de clic | | impression | La URL de impresión | | image | La imagen original cargada para el anuncio. | | optimum\_image | Si la creatividad cargada es un GIF animado, esta es su versión MP4 optimizada, creada para usarla en el anuncio. | | title | Título de la notificación | | description | Descripción de la notificación | | horizontal\_position | Indica la posición horizontal en la página (izquierda, centro, derecha) | | vertical\_position | Indica la posición vertical en la página (arriba, medio, abajo) | | delay | Número de segundos antes de que aparezca la notificación después de que se cargue la página | | max\_notifications\_on\_page | Número de notificaciones que pueden aparecer en la página al mismo tiempo | | once\_closed\_hide\_for | Duración en segundos durante la cual el anuncio permanece oculto una vez cerrado (necesita el consentimiento de cookies del usuario) | | user\_session\_capping | Número de veces que se muestra el anuncio al usuario (necesita el consentimiento de cookies del usuario) | | delay\_between\_notifications | Número de segundos antes de que aparezca la siguiente notificación después de que se cargue la anterior | ### Ejemplo de respuesta de notificación push en la página ```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":"Título", "description":"Esta es una descripción", "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-formato Una respuesta para una solicitud Multi-formato puede devolver resultados diferentes: * Si el anuncio ganador es una campaña nativa, entonces la respuesta contendrá un [**objeto de datos nativo estándar.**](#native-ads) * Si el anuncio ganador es una campaña de banner y tienes una **Zona única** en el diseño, entonces la respuesta contendrá un [**objeto de datos de banner estándar.**](#banner) * Si el anuncio ganador es una campaña de banner y elegiste un diseño con **anuncios múltiples**, entonces la respuesta contendrá un **grupo** objeto con las siguientes propiedades: | Propiedad | Descripción | | ----------- | ------------------------------------------------------------------------------------- | | orientation | La orientación del diseño de múltiples zonas, que puede ser "horizontal" o "vertical" | | ad\_items | Arreglo que contiene los datos del anuncio de cada espacio del diseño. | Independientemente del resultado, la propiedad **multizoneid** se añadirá a la respuesta, indicando el ID de la zona de anuncios multi-formato al que corresponde esta respuesta. ### Ejemplo de respuesta multi-formato El siguiente ejemplo muestra el **zonas** objeto para una zona de anuncios multi-formato con un **Horizontal x 3** diseño: ```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 } ] } } ] } ``` ## Anuncios display responsivos Algunos formatos, como los banners y los intersticiales de página completa, pueden habilitar [**Anuncios display responsivos**](/exoclick-docs/general-responsive-display-ads.md) recibir demanda de campañas de anuncios nativos además de la demanda de sus formatos publicitarios originales. En estas situaciones, la respuesta contendrá el **original\_zone** objeto que indica el tipo y los datos del formato original. Aquí hay un ejemplo de un formato de anuncio banner: ```json { "zones": [ { "idzone": 5353142, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "Desarrollado por <\/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": "Todos los sistemas en línea 👨‍🚀", "description": "Alcanza las estrellas en este nuevo juego de simulación espacial.", "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 } } } ] } ``` ## Seguimiento de impresiones Asegúrate de hacer una llamada GET a la URL de impresión para registrar las impresiones de tus solicitudes de anuncios. Una forma de lograrlo es creando un archivo de imagen invisible usando la URL de impresión como origen en la página donde se mostrará el anuncio, por ejemplo: ```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/es/api-de-colocacion-de-anuncios/respuesta/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.