Zonas de respuesta
La respuesta JSON de la API de inserción de anuncios contiene la matriz zones y los objetos renderers y user.
En esta página explicaremos la matriz zonas, que contiene todos los detalles relativos al anuncio que ganó su solicitud de anuncio.
La matriz contiene un objeto con datos de anuncios para cada ID de zona solicitada.
| Propiedad | Descripción |
|---|---|
| idzone | ID de la zona publicitaria. |
| tipo | El formato de anuncio utilizado, por ejemplo banner. |
| datos | Los datos del anuncio (Objeto) |
A continuación encontrará una lista detallada de las propiedades devueltas para cada objeto data según los formatos de anuncio disponibles.
Banner
| Propiedad | Descripción |
|---|---|
| url | La URL a la que dirige el anuncio. |
| impresión | La URL de impresión |
| imagen | La imagen original cargada para el anuncio. |
| imagen_optima | Si la creatividad cargada es un GIF animado, ésta es la versión MP4 optimizada del mismo que se crea para su uso en el anuncio. |
| anchura | La anchura del anuncio en píxeles. |
| altura | La altura del anuncio en píxeles. |
| medios de comunicación | Indica de qué tipo de banner se trata: Imagen, HTML o vídeo: Debe ser img_banner, html_banner o video_banner, respectivamente. |
Ejemplos de respuesta de banner
Imagen Banner:
{
"zones": [
{
"idzone": 1111111,
"type": "banner",
"data": {
"url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVOu04DMRD8lTRprX14bW9JQ0PBN6xzPlGAgCToQJqPx7nTTrGa0TxOyELNnKCJuWX3yqpVBW_3.9ftrE9neZ7Yti3FekuXzw8ABHBhKmoujuUa33H9O0RJ3JJkSmxALs3YJUNrqbkYjNpkGQKWmWIFUKJfMQI_UqMvY20_jukTVOZVuXr3EcrlYqNXW6lHjl6G1t3T32PiGEbzTtjp46Y7F27Hp1ltHz.JXZ31j96M1xdQzRbNJbxE1EJhbfWL8bLQCBvyD4rI3QwpAQAA",
"impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVPS05DMQy8Chdo5PEnn+5YsGCL4ADJa7ICIYqQiuTD4z5ax9HEI2fGZmIcCAfoA7Wj8ZGac0JNrJRg/vz66Ao/nftXP/9+p+3zw3NRLbhDVZFcXErU2dyoujJVa+Saq6GxOtjZLTt5EBxAiUiAqq0ViBRhB5E/vb3sF47EDMQvIbqwUVDXUVBrQraUEzRkw+oqdiHv4zRX/WlegCUobbTZBXmzOYotGl37yFNKCJGP9x65L0P/J4nlcHW+Ex4imsPh9hYV8wjynYnY98Gte81yosm2lswFmW2jPBsv07YQw/0B+rSsfmgBAAA=",
"image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
"optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
"width": 300,
"height": 250,
"media": "img_banner"
}
}
]
}
Banner HTML:
{
"zones": [
{
"idzone": 2222222,
"type": "banner",
"data": {
"html": "\n<div id=\"example_id\">\nExample HTML Ad!\n</div>\n",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1OW2oDMQy8Si8Qo7Fky8p3+18IPYDteqGwJYGkkA8dvt7dUj1AjGY0ihRxIpwgL2Rn4XMiR0khRg0REsDF3y7vTn4b69f9tv7cw+PqauxJPGWPouIgN1h2jazFET1uK3I2cGZLc6RApMmN/OPyujdmxikpzwkCuw1KCcgp5ACRqZqnnZ5T7QosDLVmozJyT6NpWqhVqS0P1o3oba2zQr9+b46Hq8hh9Ac4M2cjHDMAY/YZ5DsyY//8n11qtiy0LJU/e2Xl0a3FUqlq70q/g8aBP0ABAAA=",
"width": 300,
"height": 250,
"media": "html_banner"
}
}
]
}
Vídeo Banner:
{
"zones": [
{
"idzone": 4444444,
"type": "banner",
"data": {
"url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVPy4rbQBD8lb34GNHz1Oi4EBaDHe3itWRHt3kpWWLNjGTJOKE_PmOZbuimqruKekFOQVaMIxTA8Pc8p.uGvW7oW.45LlNhdPhlpngtbBweMHv7chv23d.jvXzZP2RDpU1DRmJ0H9vabD.O.23dlFdqxv1kktasIfTcfpK_yxwvy.AO.93ox5Y08zR24bgMwf2QLUyTTok1x1ND_p2WOFxjiqPbyQ6mdP5cLs.jdO6kMeoUFtfV9f1Qdy65WzjU56m9pa6971M4hnS.HX7KlgbqA7U.9uw9K.X3cWRZym7p6zdEBEQiCUgOgjJMcQox.EdQpAVRBeVQEIHIZVkJkICsUhVwiQJURglSJDSLEEQGcKfisWZNbZzv1VKhEpkvCekZKStTec2ItMKbUvRgNNdGelauP.aic6_W2Q6yq2JQEXzBlX5WVuGSqOfGOBNrhAysrJDr4Pi.Q2l6kB6ctbLKNlaUXnvOcwiheleq__CkLqj3AQAA",
"impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1PSU4DQQz8Ch9Iq7x1u3NDIgeuQB7Qk+k5QYKQkHLw47FGEbYP5a3KZjAdQAfSJ6Ij/KgSXMgLKwpZvH48h1J8336ut+ssl9tXsFUWjwYR9vBmaB7SvUNrGDyUUbtoaG3dUBHEwUGBcEuIkILTwTKL0/ktzu8vgeLkLWc4BLiz5dKuTe6FqpVaSDWz0NzHHTGWdW7+26MRbUKtL30OoXqxuTTbsAwdS53SduHlc2Ts5yPvQn7mgp6tgqq8C+PhSaY1lR5YVCzSEHslzer/bJLZ2upl+jbHyoJGa9u20W0Mn75Y+wNJJUoPYQEAAA==",
"video": "http://static.example.com/library/256238/906f02361f3cd12043514304c777ed489599f637.mp4",
"width": 300,
"height": 250,
"media": "video_banner"
}
}
]
}
Banner adhesivo
| Propiedad | Descripción |
|---|---|
| url | La URL del clic |
| impresión | La URL de impresión |
| imagen | La imagen original cargada para el anuncio. |
| imagen_optima | En un banner adhesivo, si la creatividad cargada es un GIF animado, ésta es la versión MP4 optimizada del mismo que se crea para su uso en el anuncio. |
| anchura | La anchura del anuncio en píxeles. |
| altura | La altura del anuncio en píxeles. |
| frecuencia_periodo | La frecuencia en minutos con la que se muestra el anuncio. |
| v_pos | La posición vertical del anuncio. |
| h_pos | La posición horizontal del anuncio. |
| medios de comunicación | Indica de qué tipo de banner se trata: Imagen, HTML o vídeo: Debe ser img_banner, html_banner, o video_banner respectivamente. |
Ejemplo de respuesta a un banner adhesivo
{
"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 del clic |
| impresión | La URL de impresión |
| imagen | La URL de la imagen |
| imagen_optima | Si la creatividad cargada es un GIF animado, ésta es la versión MP4 optimizada del mismo que se crea para su uso en el anuncio. |
| anchura | La anchura del anuncio en píxeles. |
| altura | La altura del anuncio en píxeles. |
| frecuencia_periodo | Frecuencia de aparición del anuncio en minutos. |
| medios de comunicación | Muestra el tipo de banner utilizado: Imagen, HTML o vídeo: Debe ser img_banner, html_banner o video_banner respectivamente. |
Ejemplo de respuesta a un mensaje instantáneo
{
"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 devuelva 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.* |
| logotipo_marca | La URL del logotipo de la marca que se muestra si está activado.* |
| branding_logo_hover | URL del logotipo de la marca que se muestra cuando el usuario pasa el ratón por encima.* |
| 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 fuentes utilizada en el anuncio. |
| tamaño_fuente_cabecera | El tamaño de la fuente utilizada en la cabecera de la marca. |
| header_font_color | El color de la fuente utilizada en la cabecera de la marca. |
| widget_background_color | El código hexadecimal del color de fondo utilizado para el widget. |
| widget_ancho | La anchura de todo el widget. |
| ancho_mínimo_para_la_presentación_de_tamaño_completo | La anchura mínima para un diseño a tamaño completo en píxeles. |
| altura_artículo | La altura de cada anuncio individual. |
| item_padding | El relleno entre cada uno de los anuncios. |
| altura_imagen | La altura de la imagen en cada anuncio. |
| ancho_imagen | La anchura de la imagen en cada anuncio. |
| margen_texto_arriba | 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. |
| margen_texto_izquierdo | 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 letra del título de cada anuncio. |
| title_font_color | El color de la fuente del título de cada anuncio. |
| title_font_weight | El peso de la fuente del título de cada anuncio. |
| título_decoración | Si el título está subrayado o no. |
| title_hover_color | El color de la fuente cuando se pasa el ratón por encima del título. |
| title_hover_font_weight | El peso de la fuente cuando se pasa el ratón por encima del título. |
| title_hover_decoration | Si el título se subraya al pasar el ratón por encima o no. |
| description_font_size | El tamaño de letra de la descripción de cada anuncio. |
| description_font_color | El color de la fuente de la descripción de cada anuncio. |
| description_font_weight | El peso de la fuente de la descripción de cada anuncio. |
| descripción_decoración | Si la descripción está subrayada o no. |
| description_hover_color | El color de la fuente cuando se pasa el ratón por encima de la descripción. |
| description_hover_font_weight | El peso de la fuente cuando se pasa el ratón por encima de la descripción. |
| description_hover_decoration | Si la descripción se subraya al pasar el ratón por encima o no. |
| abrir_en_nueva_ventana | Si el anuncio debe abrirse en una nueva ventana al hacer clic. 1=sí, 0=no. |
| mobile_responsive_type | El tipo de capacidad de respuesta cuando se utiliza un dispositivo móvil (es decir, ninguna o compacta). 1=compacta, 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 de la cabecera de la marca. |
| título_habilitado | Si el título está habilitado o no. 1=sí, 0=no. |
| description_enabled | Si la descripción está activada o no. 1=sí, 0=no. |
| tamaño_borde_imagen | El tamaño en píxeles del borde de la imagen. |
| color_borde_imagen | El color del código 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á activada, la CSS personalizada se mostrará aquí. |
| header_enabled | Si la cabecera está activada 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 publicitaria. |
| espaciado_v | El espaciado vertical en píxeles entre los anuncios, establecido en Opciones avanzadas. |
| espaciado_h | El espacio horizontal en píxeles entre los anuncios, establecido en Opciones avanzadas. |
| zoom | Si el anuncio debe acercarse o alejarse al pasar el ratón por encima. |
| filas_móviles | El número de filas de anuncios en el widget móvil. |
| protocolos_móviles | El número de columnas de anuncios en el widget móvil. |
| usar_script_v2 | Si la zona publicitaria se creó con la nueva configuración V2 o con la antigua v1. |
| texto_activado | Si se debe mostrar el título del texto y la descripción. 1=sí, 0=no. |
| ancho_imagen_móvil | La anchura de la imagen de cada anuncio en móvil. |
| mobile_text_box_size | El tamaño de la caja de texto en el 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 el móvil: abajo o a la derecha. |
| item_spacing_on_each_side | El relleno a cada lado de los anuncios, si se configuraron con la antigua configuración v1. |
| posición_texto | Si el texto se coloca a la izquierda o a la derecha. |
| tamaño_caja_texto | 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á activada o no. |
| brand_font_size | El tamaño de letra de la marca. |
| brand_font_color | El color de la fuente de la marca. |
| brand_font_weight | El peso tipográfico de la marca. |
| brand_decoration | Si la fuente está subrayada o no. |
| altura_imagen_móvil | La altura de la imagen de cada anuncio en móvil. |
| publisherAdType | Qué tipo de anuncio nativo es, es decir, recomendación, salida o intersticial: native-recommendation, native-interstitial. |
data.ad_items
| Propiedad | Descripción |
|---|---|
| imagen | La imagen original cargada para el anuncio. |
| url | La URL del clic |
| impresión | La URL de impresión |
| título | El texto del título del anuncio. |
| descripción | El texto descriptivo del anuncio. |
| marca | El texto de marca del anuncio. |
| uRL_original | La url original de la página de destino. |
| posición_imagen | La posición de la imagen del anuncio (cómo se recortará la imagen). |
Ejemplo de respuesta de anuncios nativos
{
"zones": [
{
"idzone": 4058715,
"type": "native_ad",
"data": {
"layout": {
"widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https://www.exoclick.com\" rel=\"nofollow\">Powered By <span></span></a>",
"branding_logo": "//static.example.com/widget-branding-logo.png",
"branding_logo_hover": "//static.example.com/widget-branding-logo-hover.png",
"itemsPerRow": 4,
"itemsPerCol": 1,
"font_family": "Arial, Helvetica, Verdana, sans-serif",
"header_font_size": "12px",
"header_font_color": "#999999",
"widget_background_color": "transparent",
"widget_width": "1830px",
"minimum_width_for_full_sized_layout": "450px",
"item_height": "300px",
"item_padding": "10px",
"image_height": "450px",
"image_width": "450px",
"text_margin_top": "3px",
"text_margin_bottom": "3px",
"text_margin_left": "0px",
"text_margin_right": "0px",
"title_font_size": "16px",
"title_font_color": "#000000",
"title_font_weight": "normal",
"title_decoration": "none",
"title_hover_color": "#0000FF",
"title_hover_font_weight": "normal",
"title_hover_decoration": "none",
"description_font_size": "14px",
"description_font_color": "#555555",
"description_font_weight": "normal",
"description_decoration": "none",
"description_hover_color": "#0055FF",
"description_hover_font_weight": "normal",
"description_hover_decoration": "none",
"open_in_new_window": 1,
"mobile_responsive_type": 1,
"header_is_on_top": 1,
"header_text_align": "right",
"title_enabled": 1,
"description_enabled": 0,
"image_border_size": "",
"image_border_color": "",
"text_align": "left",
"customcss_enabled": 0,
"customcss": null,
"header_enabled": 1,
"mobile_breakpoint": "450",
"spacing_v": "10",
"spacing_h": "10",
"zoom": "1",
"mobile_rows": "2",
"mobile_cols": "1",
"use_v2_script": "1",
"text_enabled": "1",
"mobile_image_width": "450",
"mobile_text_box_size": "90",
"mobile_text_enabled": "1",
"mobile_text_position": "bottom",
"item_spacing_on_each_side": "5px",
"text_position": "bottom",
"text_box_size": "90px",
"widget_height": "570px",
"brand_enabled": "1",
"brand_font_size": "11px",
"brand_font_color": "#555555",
"brand_font_weight": "normal",
"brand_decoration": "none",
"mobile_image_height": "450",
"publisherAdType": "native-recommendation"
},
"ad_items": [
{
"image": "https://static.example.com/library/432437/97567ec37c751bc909fc06c96920bb353efefe36.jpg",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OO27EMAxEr7LNljE0okhJZZo0KfYMkj9IgPwAG3GKOfxybSDgAJTI0RtdmBBzhhCBb9v2s17l.RpfXPu.D_Nfm9Zh_P70.1fb3n_n9UlJBhIGQGoQ47.LyHVw3gDRIUYjkwIlR2UKWjKUGopPQQ80xziI8CKiJMrDpb7NwCIO63VuAht17lmX0Ftq3WbJ_iKwfzTXkXuQLjzGZ8kjWeQ8hWj1.HUNp7WkoyXeXqmW0acQp0mWKdaUUaqUcTQbkaqlOziYDlsjAQAA",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OS04FMQy7CheYKs6nad8OxAlAHKDzW4FYsHmLHJ5M0ZOI00apLddMjIWwMD2R3cRvqAHvBewFYoW5xsvbcyjiuI/9p2zfX6HCKv4YzbU3CyVrDgujlmp2h4Qa0Jwt0lWCEnLJLN1yKYRwio/313mQYIq8rw9BRblQQXQKzUe6U4BFw4FTMuPajyGomx2r20nr0LHWIwNd5uvnyJ5paQLFpcrkHpArnkgs+FuIa48siklnNf0nH+JUR60bidjoKd+HbHLuO7bTvP0ChQRmKEsBAAA=",
"title": "title 5",
"description": "description 5",
"brand": "brand 5",
"original_url": "https://www.example.com/natives-5",
"image_position": "50% 50%"
},
{
"image": "https://static.example.com/library/432437/d51084a3da98f857bca6ba19037cfe90b9a93c0b.jpg",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OOW7EMAxFrzLNlBG4iFrKNGlS5AySR0ICZANsxCn.4UN7gIAEuH0.8oLIkjNVMOF1277Xqz5e5cl93_cwftttDcvXh9efbXv7GeuDAiCAEzNrJU34V4FzDc4LrBZEEhCNuWQyRLKS2WBUvMtQBzjGQWA3sGiEHirzaWae6rBeR1NOi42ebVJvsfU0NPsGob839_PuSboAciaH6XFZ9Z6RpHp.XekuLfEMES_PsCEcS7ZOc6HU6pR0mxIlVuNcUvsDR8DGSCMBAAA-",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OSU4EMQz8Ch/oqLzFydxAvADEA9I96ROIA5c5+PHj7gEJV+Ko7FKlGEwLaGE8wS7iF6pB3guxFxIrzDVe3p5DKeZtXH/K9v0VKqzif09z7c1CYc3JwtBSze7ooUbUHBbpKoGEHDJLtyQFFI74eH89LyUYkf34kFCUCwpFR2gOcUMQi4YT7ZIZ1z6HUN1srm471qFjrTMDHebr58hzpsUJKi6Vg3/pI0vGE4mFHgRce2QhznVW03/yMU3nbjW7wfu8trHtuk3kZBuT7xcrT8hLAQAA",
"title": "Native 3 title",
"description": "Native 3 description",
"brand": "Native 3 brand",
"original_url": "https://www.example.com/natives-3",
"image_position": "50% 50%"
},
{
"image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0n364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==",
"title": "Native 2 title",
"description": "Native 2 description",
"brand": "Native 12 bran",
"original_url": "https://www.example.com/natives-2",
"image_position": "50% 50%"
},
{
"image": "https://static.example.com/library/432437/d32054c6f9c66c2853bff50b00578b15e0739875.jpg",
"url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2Ou27GIAyFX.Vf_rHIxgbC2KVLhz4DEFAr9SYlajqch69JpApL.HL8Hd.g7FNiBuN137.3uzze_ZPFcRyu_5Z1c.3rw.rPsr_99O1BARDAkZklk0T8q8ApO8M5luC8j4AG5mXSlYL9AYEW6zLEAIYxEKY12ItCpirY1DaGGKzmXoRjC72mMKgWLTV2SbZBqO_F4vQ9STcDn8l8Mp1Frox8zOfVmS7pcgkVL89IK8fcZHQdSyfxWe2MtjYRP1RT_gOkVnReIgEAAA--",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01PSU4EMQz8Ch/oqLy103MD8QIQD0i6MycQBy5z8ONxGs0IV+LETqlcYTAtoIXxBLuIX2gN8q0QeyGxwrzGy9tzKMW4teOn7N9focIqfj+q61YtFFadLAw12exOFGpEdV5SVQIJmTRLtSwKQOGIj/fXcyctGJF5TiQU5YJCsSE0m7ghiEUjBa+SJvs2mtC62+huV/Smra8jHU31/tlynXZxgorLuqUSHpDpTyQW+ivASchAnM8Z9T99wIh1b2PHcbhxFwEN4UbjmD/+BS14KDZMAQAA",
"title": "title 4",
"description": "description 4",
"brand": "brand 4",
"original_url": "https://www.example.com/natives-4",
"image_position": "50% 50%"
}
]
}
}
]
}
Vídeo en directo
| Propiedad | Descripción |
|---|---|
| url | La URL del clic |
| seguimiento | Un objeto con información de seguimiento. |
| vídeo | El archivo del anuncio en vídeo o el enlace VAST a cargar. |
| brandingEnabled | Bandera para activar la marca. Este valor no se utiliza actualmente |
| frecuenciaPeriodo | La frecuencia en minutos con la que se muestra el anuncio. |
| anchura máxima | Tamaño de la anchura del vídeo. |
| isVast | Indica si la campaña ganadora es un anuncio de vídeo normal (falso) o una campaña de enlaces VAST (verdadero). |
| ctaEnabled | Bandera para mostrar una CTA en el anuncio |
| cta | Un objeto que contiene los detalles de la CTA |
| impresión | La URL de impresión |
data.tracking
Por el momento, el objeto data.tracking sólo devuelve una matriz progress con objetos destinados a seguir la reproducción del vídeo. De estos objetos, el que tiene "offset": "00:00:10.000" es el que hay que llamar para persistir la vista del vídeo. Las propiedades de cada objeto se explican a continuación:
| Propiedad | Descripción |
|---|---|
| offset | Marcador de progreso en segundos o como porcentaje del anuncio en vídeo reproducido |
| url | URL de seguimiento |
data.cta
| Propiedad | Descripción |
|---|---|
| displayUrl | URL relacionada con la página de destino del anuncio |
| texto | Texto que se utilizará en el elemento CTA |
Ejemplo de respuesta de vídeo saliente
{
"zones": [
{
"idzone": 12345,
"type": "outstream_video",
"data": {
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
"tracking": {
"progress": [
{
"offset": "00:00:10.000",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
},
{
"offset": "25%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
},
{
"offset": "50%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
},
{
"offset": "75%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
},
{
"offset": "100%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
}
]
},
"video": "https:\/\/u3y8v8u4.aucdn.net\/library\/940460\/8f1ab6fd40cb27cba71db1229c250d6bce1f8b68.mp4",
"brandingEnabled": 0,
"frequencyPeriod": 60,
"maximumWidth": 1000,
"impression": "https:\/\/s.example.com\/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345....",
"isVast": false,
"ctaEnabled": 1,
"cta": {
"displayUrl": "singleflirt.com",
"text": "View More"
}
}
}
]
}
Deslizador de vídeo
| Propiedad | Descripción |
|---|---|
| url | La URL del clic |
| seguimiento | Un objeto con información de seguimiento. |
| vídeo | El archivo del anuncio en vídeo o el enlace VAST a cargar. |
| pantallaDensidad | Número entero que indica la parte del espacio máximo de pantalla ocupado por el anuncio en el dispositivo de un usuario |
| onComplete | Indica el comportamiento del anuncio una vez finalizada la reproducción del vídeo. "ocultar" significa que el anuncio debe ocultarse, mientras que "repetir" significa que el anuncio debe permanecer en la página para que el usuario pueda volver a reproducirlo |
| closeAfter | Indica la cantidad de segundos necesarios antes de que se muestre el botón de cierre en el anuncio |
| brandingEnabled | Bandera para habilitar la marca. Esta propiedad no se utiliza actualmente |
| frecuenciaPeriodo | La frecuencia en minutos con la que se muestra el anuncio. |
| impresión | La URL de impresión |
| isVast | Indica si la campaña ganadora es un anuncio de vídeo normal (falso) o una campaña de enlaces VAST (verdadero). |
| ctaEnabled | Bandera para mostrar una CTA en el anuncio |
| cta | Un objeto que contiene los detalles de la CTA |
data.tracking
Por el momento, el objeto data.tracking sólo devuelve una matriz progress con objetos destinados a seguir la reproducción del vídeo. De estos objetos, el que tiene "offset": "00:00:10.000" es el que hay que llamar para persistir la vista del vídeo. Las propiedades de cada objeto se explican a continuación:
| Propiedad | Descripción |
|---|---|
| offset | Marcador de progreso en segundos o como porcentaje del anuncio en vídeo reproducido |
| url | URL de seguimiento |
data.cta
| Propiedad | Descripción |
|---|---|
| displayUrl | URL relacionada con la página de destino del anuncio |
| texto | Texto que se utilizará en el elemento CTA |
Ejemplo de respuesta a un deslizador de vídeo
{
"zones": [
{
"idzone": 12345,
"type": "video_slider",
"data": {
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
"tracking": {
"progress": [
{
"offset": "00:00:10.000",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
},
{
"offset": "25%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
},
{
"offset": "50%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
},
{
"offset": "75%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
},
{
"offset": "100%",
"url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
}
]
},
"video": "https://u3y8v8u4.aucdn.net/library/141372/7bbd0e98bb9b36baf778a8b970c74e26f51c037a.mp4",
"screenDensity": 25,
"onComplete": "repeat",
"closeAfter": null,
"brandingEnabled": 1,
"frequencyPeriod": 0,
"impression": "https://s.example.com/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345...",
"isVast": false,
"ctaEnabled": 1,
"cta": {
"displayUrl": "fullclickenabled.com",
"text": "Watch Free"
}
}
}
]
}
Intersticiales de página completa
| Propiedad | Descripción |
|---|---|
| url | La URL del clic |
| impresión | La URL de impresión |
| imagen | La imagen original cargada para el anuncio. |
| imagen_optima | Si la creatividad cargada es un GIF animado, ésta es la versión MP4 optimizada del mismo que se crea para su uso en el anuncio. |
| anchura | La anchura del anuncio en píxeles. |
| altura | La altura del anuncio en píxeles. |
| recuento_de_frecuencia | Cuántas veces puede mostrarse el anuncio |
| frecuencia_periodo | Frecuencia en minutos con la que se muestra el anuncio |
| tipo_disparador_de_frecuencia | Bandera para indicar si la frecuencia de este anuncio se basa en impresiones (0) o clics (1) |
| ad_trigger_method | Método de activación activado para esta zona publicitaria |
| ad_trigger_classes | Clases que deben activar el anuncio, si las hay |
| primeros_clics_disparadores | Número de clics necesarios en la visita inicial del usuario para activar el anuncio |
| next_trigger_clicks | Número de clics necesarios tras la primera activación del anuncio para volver a mostrarlo |
| chrome_enabled | Bandera para indicar si esta zona de anuncios está habilitada para Chrome (1), deshabilitada (0) o habilitada exclusivamente para este navegador (2) |
| capping_enabled | Bandera para indicar si la limitación debe aplicarse a esta zona de anuncios o no |
| medios de comunicación | Indica de qué tipo de banner se trata: Imagen, HTML o vídeo: Debe ser img_banner, html_banner o video_banner, respectivamente. |
Nota: la mayoría de las propiedades de la respuesta Intersticial de página completa están relacionadas con la cobertura y el activador del anuncio. Dado que usted es el encargado de renderizar el anuncio, le corresponde a usted decidir si desea prestar atención a estas propiedades o no.
Ejemplo de respuesta intersticial a página completa
Tenga en cuenta que, aunque el ejemplo muestra un Interstitial de página completa de escritorio, la respuesta para un Interstitial de página completa móvil debería ser la misma, aparte del zone.type.
{
"zones": [
{
"idzone": 5808222,
"type": "desktop_fullpage_interstitial",
"data": {
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01S2W7jOgz9mrwlgTZL8uPcWRAggWNkb18KWZIbz3iV5aYx9PFDp0XviIZBHx4d0iQFFxGJWEDh6n3bz.i3GfkFz.12W_ZF_VravCycX.qmArRUtQEQvMp5ghCd0V.DW6i2WOTW6.viWvjCzOgP7wY7I9y3WlXtA9GRxixHdqGkxAuWKbLIBBELZjMdScaVlghu9EOWDllZ9Ffr4FYkkSSEQECXhf7j1SuAjTNpkq6yZJVkm1WarIVu6tP5TsZxHKqq77oWjkmfN.llz9VwPp1Q7wCsj.O2NuaJn5BrL8cj8NF42jZN44ayMbtkczgYDdGxveyH0qz580Q8bEfnKRtaP_qKuLqrcdPhinXO.3HoKfFmtzEbt0vezGGXuN3l4A9t6i.JqXdus0suoHlX33n83w95To.paF0bnQ57ch9Mqj6q.cg3uW7N.bPKOrHafiL_BKEYcFn_5F_uf3arbhWP9fbw1r5URxJtSfbOry9mLbbFuTqr8ZJl.9_Wnu9dR.xQdFm.PZOhsO.3_OnbArr6Hcajitcauio.NwFWAQvOGWIxF.Fms0r13rpitNMSBILJUuIllmhJMFCxiCIGJ3yOKkQYh8BwICEWoAUUjtB7jMCZLCboHSOJguLS5jGTSmLDSUQ0hQ3JIy6lioU1MlAGcgxHgaIYaYptzCjWlDPDMmI4jhXViGIegywKN9rra9OU_aNKSAaFEhmIQISzAOs8_2LMgTG_.qqce3cv_Fz17TwvSluryk7QI2RsrobSh4f4ZJRSHiM6eRgxFsdhahWk.IxPJr_YUDW8gxQc.HyqZ_oMP_fpP_T_jUYfzhJoS4QQ_hLql62tevf2.C2YTpgIH2KQPbxBx7frkEtGIgQzs0LzDNoTUcHjTJuYiDzW.i9X4F4Z5wMAAA--&cb=e2e_69493367093292.02215167",
"impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA11QS0pEMRC8iheYUP1J0nHt7AXxAG\/yMig4jvjEH314k4y4MEWgSVW6qpvBcUe8Y75CvgZfa3YmDkaBDIEJvr+7dSX\/aIfTsr2118fvFur55EWhCV5AIskJwjDzaDBm9kjkOeXIUZ0ox6j9eOndHR2iXaQUe0kB+130DL+\/u5mXOiQ6JeCzoCtmBmdzG1xhfBIMviRrx6K2GK2JI1eJlY4xmS0lt9VcUFCFWlGhKklXPfCaqCxSIZRK7wb\/kK0+nM9P25yqu\/X5uxVncFJH6D1GoDhzz+x93gLx3fgtBNVSvB\/4pJft67m6\/8kviC5DnYbBUP6jLyD8VoGGMabxeNjCSzttr+8zok6zgEFdtjk3dqnKEe3QF7cIlyxYI+ohq1VqyLYu7QfZRfrR8QEAAA==&cb=e2e_69493367093c99.73988768",
"image": "https:\/\/s3t3d2y1.afcdn.net\/library\/940460\/c8c01e1ff28dea8c9345f243dcd7b4ca8c7df26d.jpg",
"optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/940460\/a359ed6758e1c53523936ed27a001b7bf0f726ab.webp",
"width": 1600,
"height": 900,
"frequency_count": 1,
"frequency_period": 720,
"frequency_trigger_type": 0,
"ad_trigger_method": 3,
"ad_trigger_classes": "",
"first_trigger_clicks": 0,
"next_trigger_clicks": 0,
"chrome_enabled": 1,
"capping_enabled": 1,
"media": "img_banner",
"cid": 7675254,
}
}
]
}
Empuje dentro de la página
| Propiedad. | Descripción |
|---|---|
| url | La URL del clic |
| impresión | La URL de impresión |
| imagen | La imagen original cargada para el anuncio. |
| imagen_optima | Si la creatividad cargada es un GIF animado, ésta es la versión MP4 optimizada del mismo que se crea para su uso en el anuncio. |
| título | Título de la notificación |
| descripción | Descripción de la notificación |
| posición_horizontal | Indica la posición horizontal en la página (izquierda, centro, derecha) |
| posición_vertical | Indica la posición vertical en la página (arriba, en medio, abajo) |
| retraso | Número de segundos antes de que aparezca la notificación tras la carga de la página |
| max_notificaciones_en_pagina | Número de notificaciones que pueden aparecer en la página al mismo tiempo |
| una_vez_cerrado_para_ocultar | Tiempo en segundos que permanece oculto el anuncio una vez que se cierra (necesita el consentimiento de la cookie por parte del usuario) |
| user_session_capping | Número de veces que se muestra el anuncio al usuario (necesita el consentimiento de la cookie por parte del usuario) |
| retraso_entre_notificaciones | Número de segundos antes de que aparezca la siguiente notificación después de que se cargue la anterior |
Ejemplo de respuesta a una notificación push dentro de la página
{
"idzone":9999999,
"type":"in_page_push_notification",
"data":{
"url":"https://syndication.example.com/click.php?data=H4sIAAAAAAAAA02QvW7DMAyEX0VLVoGUSP2MXbp06DPQltwadeQgNuIU4MPXMYo2OE68w0ccOUF25BUs6.e6XpaTfzm51322bbNrXdaxfdh.PquCYkg55BQh6OU63upS7_OlybnaNimCJWfBoibnIfmISjlRdqwMSZVQvSLvGNDo4E5pB.7SQB1jHXwntQvZMlCMLgRkYA9Ij3wNnAPGobiB.l7EA_AQZOBSsCOqOwZ0.W5l7GUd52brXcpir3P_tehx0Ty55nDN4Zpp7mUyv0XNVjvTSWv1aj7X82T0IP_rAXOgTxv6S7C6I.FIPeuN9f1Ni3OIsXj0.0sEMJXEUQafa5QaovwASom5rH8BAAA-",
"image":"https://static.example.com/library/195600/0ce94b4e2b6222ee26594af823a65cb7059ca62d.jpg",
"title":"Title",
"description":"This is a description",
"impression":"https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA1VPW2rDQAy8Si+QZaSV9pH/XiBQ8O/au4bQ1glxKS7o8N24hFAJSTMwjCQG+wPigdIL8VH0iGAEJ+zgyIZhMCG73s7fbW3b5bqUz+aWD6OsAXiMSClnmOQkmdUUyTQhs3hL7JF8JCM1b3ikA3AX2uvbaa8ucAQyYYuMTVI339cbd+OOscGCjEpt9mNpY8hOITFyCKRQDxJYC5oDxbnyLNNUiu9b5lBmrZVGkXb3sfVnqeepfJ0vi2tbqau7Xab39XkaJ9qFzzz80R6wHZVuMpn9E8HUuHevOyHrz8wcYhHNtVSfRVklttxAOSTh6RdhQ+r1fQEAAA==",
"optimum_image":"https://static.example.com/library/195600/0c9243bcbb139db5671a779366a98a08f678b2f1.webp",
"horizontal_position":"right",
"vertical_position":"top",
"delay":0,
"max_notifications_on_page":2,
"once_closed_hide_for":10,
"user_session_capping":0,
"delay_between_notifications":10
}
}
Multiformato
Una respuesta para una solicitud Multi-Formato puede devolver resultados diferentes:
- Si el anuncio ganador es una campaña Native, la respuesta contendrá un objeto de datos Native regular.
- Si el anuncio ganador es una campaña de Banner y tiene una Zona única en el diseño, la respuesta contendrá un objeto de datos Banner normal.
- Si el anuncio ganador es una campaña de banners y ha elegido un diseño con múltiples anuncios, la respuesta contendrá un objeto group con las siguientes propiedades:
| Propiedad | Descripción |
|---|---|
| orientación | La orientación de la disposición multizona, que puede ser "horizontal" o "vertical". |
| ad_items | Matriz que contiene los datos de los anuncios para cada lugar de la presentación. |
Independientemente del resultado, se añadirá a la respuesta la propiedad multizoneid, que indica el ID de zona de la zona de anuncios multiformato a la que corresponde esta respuesta.
Ejemplo de respuesta multiformato
El siguiente ejemplo muestra el objeto zonas para una zona publicitaria Multiformato con una disposición Horizontal x 3:
{
"zones": [
{
"group": {
"orientation": "horizontal",
"ad_items": [
{
"idzone": 12345,
"type": "banner",
"data": {
"url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01RTU_DMAz9NbtVlT.SNDlygAsHkPgFaZuySS2dmrAO5B9PEtCGHFmW37P97HROWSISlGNK53jghwM95RfTuoU2puCX87qHLYztsC4ZEAHBzhiF2oKTPfSLz7Tt9B0KQwiptdiihZYwU0kbUg6saNaMYEQjiigUEtflXiAMcCWdqcUcwRXBggirrCtPybiDgTE4xTiwUaPqaTToPA_AaFwuA9k5Dsd1nWMVAdX2fW9u.Sbnm2Na5iZtX6fU.HhuptMcPvwSSqpCY5j855yktqzamI0DLhGCUs5J3R9I_gjFVPX5HDYvWyIpBfkS5hcvzUQe317_1dyNim8B8O7xNj.2i3.P26VupaRMb6m2K4WX_HEvz2J0D9xZNyF7oyftstYRhr7TTo3QjT9DY7Q.5AEAAA--&cb=e2e_69495dc1258023.87481108",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW27CMBC8Si+ANftw4u13+a+KOEBiQotUiEQQ0GoPXzu0FI9ke3dnH7MMjgviBfMT4RnyzOZMHBIFSghM8OXq1ZX8MvT7bjoNx933EPK4d43EFt1AIo0ThJGSR4lCaDwSeWuamNmJY8NqSG6ts6NAtASUYjUCULjw9erFl+s3L63bmnV72AW4coTTPErpxK7FIGNcCWkuB0MWGkyFsjS60Z43DVknGUKNFTr8IlP+GMfPaR4fNwTStlaLfw6XIscgvqg5RYuqmZcDn8Pd9HXI7nc6PCakorD+XH59NfeR848HzfebZj58CvvufTqeb\/udm4a6r7oFUoWfu+OuO+3Gw72898rgzcDWgIX6bAOGNmZpt9SzbOMPcuXp2OIBAAA=&cb=e2e_69495dc1258be3.55680913",
"image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
"optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
"width": 300,
"height": 250,
"media": "img_banner",
},
"multizoneid": 67890
},
{
"idzone": 12345,
"type": "banner",
"data": {
"url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01Ry07DMBD8mt4iax.2Ex85wIUDSHyBk7i0UkKrODQF7cezdlFBa9mr2dnZh9tgO2IQMCiHdT3nHT_s6EnPtm0mjUuKczbDaVZEBARb7y26DoJsqZ9jXtNy_E6FIYRkOjTYgSFUKjlPznkQx44RvDhEEYtCElrVAmGAKzmlFgsEV4QORNgSkVbReICBMQXLOLC3o.1p9BgiD8Dog6aBbJyHw.k01TarrGLb1tzxRvHmsM5Tsy5fx7WJ.dzsj1P6iHMqUA2NaR8_p1WqZO2N2Qfg4iFYG4KU.YOV33gxW2_dRqezFk8KXxfhb_GiJfL49vov58_o9hoALDfeS2czx_e8XOpAWlDK97RVq2RdiOTlWXqA6CEmSBg7l6hl71se1O8p7e3wA2CxptPbAQAA&cb=e2e_69495dc1259304.50721064",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW24CMQy8Si9ANLbjkPBd/qsiDpDdhRapsBKLgFY+fL3Lo40l27HHjzGDdUY8Y34hLCALLsbEIVOgjMAEW67eLJJdNs2+DqfNcfezCW2\/t6jERa2ARJIRhJGzqagQkimRzUvMLDBiTayaYGVubHCRyMyRdPwEAA6GrVevtly\/m8+eMz8MmwBXVu8z7WIlWnSfCuNKyFM7FLRCmxKFWkmxiw13iUqVFkKpOBx2kaH97PuvYVofNwmknD2tj4CJ0ykQm401ziXGUswfbErX4fvQmj3hMM3IznD0TO6xsfY\/5k\/oDgkjadc0YWFD2NeP4Xi+3XYa6Pw9MV6AYoSd63FXT7v+8Oxt266JaKo2XJ37tlHJrhO6bcp+HvwC8uORF98BAAA=&cb=e2e_69495dc1259ad5.34119103",
"image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
"optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
"width": 300,
"height": 250,
"media": "img_banner"
},
"multizoneid": 67890
},
{
"idzone": 12345,
"type": "banner",
"data": {
"url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA11Ry07DMBD8Gm5ptLt.xD5ygAsHkPgC13GaqHlUcdq0aD8eO0UFofFhNTP7tAGQZIChVNwuyyk.iecnek2vd2PdTHN0fSi7sVzaxO3deDhOx11_vp7n285PYz3tKAnMwFhpLVEZsLyG_eDiEubuK5R.GpiQSoMlGigJk5V0RUICsBJKIGhWiMwSmdhWqRawALiSStYMS3BFSGOykESUuiTdghcYrBTohZa13FOt0TrhQaC2KQ14FdG309THbQjYsK5r8eCLxBftMvTFMt.6pXDxVDRdH0Y3hExtUh0ad.4X3kpuswmhLYgcIUhpLef9K8k_esbdm65hSOkccfYzyYfK_PL58SfjF_SvCnAsB3eI82XbI_W5d.LNeyHi9zfW0hitq6bx6SahrpXz5AjznzifTvwNlJrwcuoBAAA-&cb=e2e_69495dc1259e91.21591992",
"impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01Q0U7DMBD7FX5gle8uuSY8wzvSxAe0WQtIjEkrYgP548mysRErp4vPTqwoNK5EV6p3gnvYvWaqaJekk4ROBXxcPzEID9O4HZbPaf\/2M3Vlt6W5WO\/MEDOnwBQpMVo0gTOKMAFBEyjqvVoAmHsqUWFBVYPEdujB5\/VD21KhNOCosRrb4+xD4yUrjoLU\/MgoJlMOJsU8bMKoG5c8WIGJ5yoHD7aU193ufWl5cUYn0bWO4x9Bq\/kzjKuTp4YPIWfWBbbxsHx\/FPIqB2NC0uinjnbhTt7\/mhvEbm2rS7cdXpb9V0sVeLGd\/+V6Cz3MmIupz9BxRF+8L5vZVQLmnH3+BX0inm26AQAA&cb=e2e_69495dc125a500.54289539",
"image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
"optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
"width": 300,
"height": 250,
"media": "img_banner"
},
"multizoneid": 67890
}
]
}
}
]
}
Anuncios en pantalla con capacidad de respuesta
Algunos formatos, como los banners y los intersticiales de página completa, pueden habilitar Responsive Display Ads para recibir demanda de campañas de Native Ads además de la demanda de sus formatos de anuncios originales. En estas situaciones, la respuesta contendrá el objeto original_zone que indica el tipo y los datos del formato original.
He aquí un ejemplo de formato de anuncio Banner:
{
"zones": [
{
"idzone": 5353142,
"type": "native_ad",
"data": {
"layout": {
"widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https:\/\/www.exoclick.com\" rel=\"nofollow\">Powered By <span><\/span><\/a>",
"branding_logo": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo.png",
"branding_logo_hover": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo-hover.png",
"itemsPerRow": 1,
"itemsPerCol": 1,
"font_family": "Arial, Helvetica, Verdana, sans-serif",
"header_font_size": "12px",
"header_font_color": "#999999",
"widget_background_color": "transparent",
"widget_width": "450px",
"minimum_width_for_full_sized_layout": "450px",
"item_height": "300px",
"item_padding": "10px",
"image_height": "450px",
"image_width": "450px",
"text_margin_top": "3px",
"text_margin_bottom": "3px",
"text_margin_left": "0px",
"text_margin_right": "0px",
"title_font_size": "16px",
"title_font_color": "#000000",
"title_font_weight": "normal",
"title_decoration": "none",
"title_hover_color": "#0000FF",
"title_hover_font_weight": "normal",
"title_hover_decoration": "none",
"description_font_size": "14px",
"description_font_color": "#555555",
"description_font_weight": "normal",
"description_decoration": "none",
"description_hover_color": "#0055FF",
"description_hover_font_weight": "normal",
"description_hover_decoration": "none",
"open_in_new_window": 1,
"mobile_responsive_type": 1,
"header_is_on_top": 1,
"header_text_align": "right",
"title_enabled": 1,
"description_enabled": 1,
"image_border_size": "",
"image_border_color": "",
"text_align": "left",
"customcss_enabled": 1,
"customcss": "{\n width: 300px !important;\n height: 250px !important;\n}\n.exo-native-widget-header {\n display: none !important;\n}\n.exo-native-widget-item-container {\n width: 300px !important;\n height: 250px !important;\n max-width: 300px !important;\n padding-right: 0 !important;\n padding-bottom: 0 !important;\n}\n.exo-native-widget-item-image-wrapper { \n width: 300px !important;\n height: 250px !important;\n max-height: 250px !important;\n overflow: hidden !important;\n}\n.exo-native-widget-item-content-box {\n position: relative !important;\n}\n.exo-native-widget-item-content {\n position: absolute !important;\n z-index: 5 !important;\n top: 180px !important;\n background-color: white !important;\n opacity: 0.7 !important;\n height: auto !important;\n max-height: 110px !important;\n min-height: 70px !important;\n width: 100% !important;\n max-width: 300px !important;\n}\n.exo-native-widget-item-title {\n padding: 10px 8px 4px 8px !important;\n height: 20px !important;\n color: black !important;\n font-weight: 900 !important;\n font-size: 18px !important;\n display: flex !important;\n align-items: center;\n justify-content: center;\n text-align: center;\n white-space: normal !important;\n}\n.exo-native-widget-item-text {\n padding: 20px 8px 4px 8px !important;\n height: 20px !important;\n color: grey !important;\n font-weight: normal !important;\n font-size: 13px !important;\n display: flex !important;\n align-items: center;\n justify-content: center;\n text-align: center;\n white-space: normal !important;\n}\n.exo-native-widget-item-brand {\n padding: 5px 8px 0px 8px !important;\n height: 20px !important;\n font-weight: normal !important;\n font-size: 18px !important;\n display: none !important;\n align-items: center;\n justify-content: center;\n text-align: center;\n white-space: normal !important;\n}",
"header_enabled": 1,
"mobile_breakpoint": 450,
"spacing_v": 10,
"spacing_h": 10,
"zoom": 1,
"mobile_rows": 1,
"mobile_cols": 1,
"use_v2_script": 1,
"text_enabled": 1,
"mobile_image_width": 450,
"mobile_text_box_size": 90,
"mobile_text_enabled": 1,
"mobile_text_position": "bottom",
"mobile_image_height": 450,
"delaySeconds": 0,
"frequency": 0,
"frequencyCount": 0,
"publisherAdType": "native-recommendation",
"adTriggerType": "",
"popTriggerMethod": "",
"popTriggerClasses": "",
"item_spacing_on_each_side": "5px",
"text_position": "bottom",
"text_box_size": "90px",
"widget_height": "570px",
"brand_enabled": 0,
"brand_font_size": "11px",
"brand_font_color": "#555555",
"brand_font_weight": "normal",
"brand_decoration": "none"
},
"ad_items": [
{
"image": "https:\/\/s.example.net\/library\/451295\/4c5353dfe10c9e8ea12b05cc44eb0c6cafbc6100.jpg",
"url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01RwW7DIAz9mt4iZBuHwnGH7rLDJvUDJkJIWylZqpA16.SPH6Cpmx4YYz.eMZi93rMzYhS0cl7Xa9rppx095zHOXXdX88lPURUzzMspqjBPORfT..GYVxEQ3BvDaJFQtthNPq1xuXxXphCSsqjQgiLMVCDDYBmk1a1GJmkRRRiFxO2zFohggSP4QrB5q5mIGFvR4CBojI41Bm245456g87rABqNy8dANp3CeZ7HVKtDxbZtzSPe5HhzXqexWZf7ZW18ujbDZYwfucESqqk.Dv5zXKVKFmitjQNdPARm56Q2DiS_hALOs.Xq5tuWVggNCFGhlq0cjm__.H8oDFCQf6DYzFX4KJ3U5E9pudWGWErh_JRVLsui3LL.64tQ77kbnOfWDtH2vQeLjgM548MQYvgB99zVE.gBAAA-&cb=e2e_694966c98c6cc2.67060117",
"optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/451295\/15c408293013fe9637290dbc36ec5a3fbd671c48.webp",
"title": "All systems online \ud83d\udc68\u200d\ud83d\ude80",
"description": "Reach for the stars in this new space simulation game.",
"brand": "ogame.com",
"original_url": "https:\/\/lobby.ogame.gameforge.com\/es_ES\/",
"image_position": "50% 50%",
"format": "native_ad",
"size": "300x300",
"iframe_url": "",
"impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA01QW04DMQy8ChfoymM72Q3f9B9R9QC7aXhIlEpdRAHN4Um2tJCRbDlje2yraFhBV6o3kFvXWwEV2g3oMEinEK4393TwVKb9OL+X48t36fJhTw\/QFJgEZpEQUxkGBgsGVwaAsbfeU+M0ugwuTD2VUmGuqo7Qgk4kSmAv3G7uuN4+sIr3qhenJJYpWiN6DZBUPiHD0kmSZENJbsgWfeeT7iLSaFkMMdV04cnm\/Hw4vM7L5HJGB8Q6HMPlg1Y3SWJctRqDuKfE+oQLPc5fb5m8pgc\/O1q12hZrdX\/8f2D4XTUsFk1+SRfO3X58mo8f56suevXwrebMX3uyFMEoKT5OZZzyVC9gIfa7WDBZHqfwA7sG\/xjOAQAA&cb=e2e_694966c98c7af4.92854754",
"count_only_viewed_impressions": 0,
"video_thumb_id": null,
"video_thumb_url": null,
"video_thumb_enabled": 0
}
]
},
"original_zone": {
"type": "banner",
"data": {
"width": 300,
"height": 250
}
}
}
]
}
Seguimiento de impresiones
Asegúrese de realizar una llamada GET a la URL de impresión para registrar las impresiones de sus solicitudes de anuncios. Una forma de conseguirlo es crear un archivo de imagen invisible utilizando la URL de impresión como fuente en la página en la que se mostrará el anuncio, por ejemplo
<img src="impression_url" width="0" height="0">