> 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/pt/api-de-posicionamento-de-anuncios/resposta/ad-plac-response.md). # Zonas de Resposta O JSON de resposta da API de colocação de anúncios contém o **zonas** array e os [**renderizadores**](https://docs.exoclick.com/docs/ad-plac-renderers/) e [**utilizador**](/api/pt/api-de-posicionamento-de-anuncios/resposta/ad-plac-user.md) objetos. Nesta página vamos explicar o **zonas** array, que contém todos os detalhes relativos ao anúncio que venceu o seu pedido de anúncio. O array contém um objeto com os dados do anúncio para cada ID de zona solicitado. | Propriedade | Descrição | | ----------- | ----------------------------------------------------- | | idzone | O ID da zona do anúncio. | | type | O formato de anúncio utilizado, por exemplo `banner`. | | data | Os dados do anúncio (Objeto) | Abaixo encontrará uma lista detalhada das propriedades devolvidas para cada **data** objeto de acordo com os formatos de anúncio disponíveis. ## Banner | Propriedade | Descrição | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | url | O URL para o qual o anúncio direciona. | | impression | O URL de impressão | | image | A imagem original carregada para o anúncio. | | optimum\_image | Se o criativo carregado for um GIF animado, esta é a versão MP4 otimizada dele, criada para ser usada no anúncio. | | width | A largura do anúncio em pixels. | | height | A altura do anúncio em pixels. | | media | Isto mostra que tipo de banner é este: imagem, HTML ou vídeo: Deve ser `img_banner`, `html_banner` ou `video_banner`, respetivamente. | ### Exemplos de resposta de banner **Banner de imagem:** ```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
\nAnúncio HTML de exemplo!\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 fixo | Propriedade | Descrição | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | url | O URL de clique | | impression | O URL de impressão | | image | A imagem original carregada para o anúncio. | | optimum\_image | Num banner fixo, se o criativo carregado for um GIF animado, esta é a versão MP4 otimizada dele, criada para ser usada no anúncio. | | width | A largura do anúncio em pixels. | | height | A altura do anúncio em pixels. | | frequency\_period | Com que frequência, em minutos, o anúncio é mostrado. | | v\_pos | A posição vertical do anúncio. | | h\_pos | A posição horizontal do anúncio. | | media | Isto mostra que tipo de banner é este: imagem, HTML ou vídeo: Deve ser `img_banner`, `html_banner`, ou `video_banner` respetivamente. | ### Exemplo de resposta de banner fixo ```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" } } ] } ``` ## Mensagens instantâneas | Propriedade | Descrição | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | url | O URL de clique | | impression | O URL de impressão | | image | O URL da imagem | | optimum\_image | Se o criativo carregado for um GIF animado, esta é a versão MP4 otimizada dele, criada para ser usada no anúncio. | | width | A largura do anúncio em pixels. | | height | A altura do anúncio em pixels. | | frequency\_period | Com que frequência o anúncio é mostrado, em minutos. | | media | Isto mostra que tipo de banner é utilizado: imagem, HTML ou vídeo: Deve ser `img_banner`, `html_banner`, ou `video_banner` respetivamente. | ### Exemplo de resposta de mensagem instantânea ```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" } } ] } ``` ## Anúncios nativos Quando a resposta devolver um anúncio nativo, zones.data devolverá dois objetos: **layout** e **ad\_items** **data.layout** | Propriedade | Descrição | | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | widgetHeaderContentHtml | O URL da marca 'Powered by' que é apresentada.\* | | branding\_logo | O URL do logótipo da marca que é apresentado, se ativado.\* | | branding\_logo\_hover | O URL do logótipo da marca que é apresentado quando o utilizador passa o rato por cima.\* | | itemsPerRow | O número de anúncios que são mostrados em cada linha do widget. | | itemsPerCol | O número de anúncios que são mostrados em cada coluna do widget. | | font\_family | A família de tipos de letra usada no anúncio. | | header\_font\_size | O tamanho do tipo de letra usado no cabeçalho da marca. | | header\_font\_color | A cor do tipo de letra usada no cabeçalho da marca. | | widget\_background\_color | O código hexadecimal da cor de fundo usado para o widget. | | widget\_width | A largura de todo o widget. | | minimum\_width\_for\_full\_sized\_layout | A largura mínima para uma disposição em tamanho completo, em pixels. | | item\_height | A altura de cada anúncio individual. | | item\_padding | O espaçamento entre cada anúncio. | | image\_height | A altura da imagem em cada anúncio. | | image\_width | A largura da imagem em cada anúncio. | | text\_margin\_top | O tamanho, em pixels, da margem superior do texto. | | text\_margin\_bottom | O tamanho, em pixels, da margem inferior do texto. | | text\_margin\_left | O tamanho, em pixels, da margem esquerda do texto. | | text\_margin\_right | O tamanho, em pixels, da margem direita do texto. | | title\_font\_size | O tamanho do tipo de letra do título de cada anúncio. | | title\_font\_color | A cor do tipo de letra do título de cada anúncio. | | title\_font\_weight | O peso do tipo de letra do título de cada anúncio. | | title\_decoration | Se o título está sublinhado ou não. | | title\_hover\_color | A cor do tipo de letra quando se passa o rato por cima do título. | | title\_hover\_font\_weight | O peso do tipo de letra quando se passa o rato por cima do título. | | title\_hover\_decoration | Se o título é sublinhado ao passar o rato por cima ou não. | | description\_font\_size | O tamanho do tipo de letra da descrição de cada anúncio. | | description\_font\_color | A cor do tipo de letra da descrição de cada anúncio. | | description\_font\_weight | O peso do tipo de letra da descrição de cada anúncio. | | description\_decoration | Se a descrição está sublinhada ou não. | | description\_hover\_color | A cor do tipo de letra quando se passa o rato por cima da descrição. | | description\_hover\_font\_weight | O peso do tipo de letra quando se passa o rato por cima da descrição. | | description\_hover\_decoration | Se a descrição é sublinhada ao passar o rato por cima ou não. | | open\_in\_new\_window | Se o anúncio deve ser aberto numa nova janela quando clicado. 1=sim, 0=não. | | mobile\_responsive\_type | O tipo de responsividade quando se utiliza um dispositivo móvel (ou seja, nenhum ou compacto). 1=compacto, 0=não. | | header\_is\_on\_top | Se a marca deve ser apresentada acima ou abaixo dos anúncios. 1=sim, 0=não. | | header\_text\_align | O alinhamento horizontal do cabeçalho da marca. | | title\_enabled | Se o título está ativado ou não. 1=sim, 0=não. | | description\_enabled | Se a descrição está ativada ou não. 1=sim, 0=não. | | image\_border\_size | O tamanho, em pixels, da borda da imagem. | | image\_border\_color | O código hexadecimal da cor da borda da imagem. | | text\_align | O alinhamento do texto: esquerda, centro ou direita. | | customcss\_enabled | Se o CSS personalizado está ativado ou não. 1=sim, 0=não. | | customcss | Se ativado, o CSS personalizado será apresentado aqui. | | header\_enabled | Se o cabeçalho está ativado ou não. 1=sim, 0=não. | | mobile\_breakpoint | O ponto de quebra, em pixels, entre as vistas de desktop e mobile da zona do anúncio. | | spacing\_v | O espaçamento vertical, em pixels, entre os anúncios, definido nas Opções Avançadas. | | spacing\_h | O espaçamento horizontal, em pixels, entre os anúncios, definido nas Opções Avançadas. | | zoom | Se o anúncio deve ampliar/reduzir ao passar o rato por cima. | | mobile\_rows | O número de linhas de anúncios no widget móvel. | | mobile\_cols | O número de colunas de anúncios no widget móvel. | | use\_v2\_script | Se a zona de anúncios foi criada com a configuração V2 mais recente ou com a v1 anterior. | | text\_enabled | Se o título e a descrição do texto devem ser apresentados. 1=sim, 0=não. | | mobile\_image\_width | A largura da imagem em cada anúncio no mobile. | | mobile\_text\_box\_size | O tamanho da caixa de texto em mobile. Intervalo válido 50-500. | | mobile\_text\_enabled | Se o título está ativado ou não no mobile. 1=sim, 0=não. | | mobile\_text\_position | A posição do texto no mobile: em baixo ou à direita. | | item\_spacing\_on\_each\_side | O espaçamento em cada lado dos anúncios, se tiverem sido configurados usando a configuração antiga v1. | | text\_position | Se o texto é posicionado no lado esquerdo ou direito. | | text\_box\_size | O tamanho da caixa de texto em pixels. Intervalo 50-500. | | widget\_height | A altura de todo o widget. | | brand\_enabled | Se a marca está ativada ou não. | | brand\_font\_size | O tamanho do tipo de letra da marca. | | brand\_font\_color | A cor do tipo de letra da marca. | | brand\_font\_weight | O peso do tipo de letra da marca. | | brand\_decoration | Se o tipo de letra está sublinhado ou não. | | mobile\_image\_height | A altura da imagem em cada anúncio no mobile. | | publisherAdType | Que tipo de anúncio nativo é este, ou seja, recomendação, saída ou intersticial: `native-recommendation`, `native-interstitial`. | **data.ad\_items** | Propriedade | Descrição | | --------------------- | --------------------------------------------------------------------------------------------- | | idvariation | O ID da variação. | | image | A imagem original carregada para o anúncio. | | url | O URL de clique. | | impression | O URL de impressão. | | title | O texto do título do anúncio. | | description | O texto da descrição do anúncio. | | brand | O texto da marca do anúncio. | | original\_url | O URL original da página de destino. | | image\_position | A posição da imagem do anúncio (como a imagem será recortada). | | size | O tamanho do formato de anúncio selecionado | | iframe\_url | Se for usado um iframe como variação, este será o URL do iframe. | | video\_thumb\_id | O identificador do recurso miniatura de vídeo (se presente) associado ao criativo do anúncio. | | video\_thumb\_url | O URL do recurso miniatura de vídeo (se presente). | | video\_thumb\_enabled | O estado do recurso miniatura de vídeo (se presente). | ### Exemplo de resposta de anúncios nativos ```json { "zones": [ { "idzone": 4058715, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "Fornecido por ", "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": "descrição 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": "Título nativo 3", "description": "Descrição nativa 3", "brand": "Marca nativa 3", "original_url": "https://www.example.com/natives-3", "image_position": "50% 50%" }, { "image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png", "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0nH364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==", "title": "Título nativo 2", "description": "Descrição nativa 2", "brand": "Nativo 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": "título 4", "description": "descrição 4", "brand": "marca 4", "original_url": "https://www.example.com/natives-4", "image_position": "50% 50%" } ] } } ] } ``` ## Vídeo Outstream | Propriedade | Descrição | | --------------- | --------------------------------------------------------------------------------------------------------- | | url | O URL de clique | | rastreamento | Um objeto com informações de rastreamento. | | vídeo | O ficheiro do anúncio em vídeo ou o link VAST a carregar. | | brandingEnabled | Sinalizador para ativar a marca. **Este valor não é usado atualmente** | | frequencyPeriod | Com que frequência, em minutos, o anúncio é mostrado. | | maximumWidth | Tamanho da largura do vídeo. | | isVast | Indica se a campanha vencedora é um anúncio em vídeo normal (false) ou uma campanha com link VAST (true). | | ctaEnabled | Sinalizador para exibir uma CTA no anúncio | | cta | Um objeto contendo os detalhes da CTA | | impression | O URL de impressão | **data.tracking** Neste momento, o **data.tracking** objeto apenas devolve um `progresso` array com objetos destinados a rastrear a reprodução do vídeo. Desses objetos, aquele com `"offset": "00:00:10.000"` é o que deve ser chamado para registar a visualização do vídeo. As propriedades de cada objeto são explicadas abaixo: | Propriedade | Descrição | | ----------- | ------------------------------------------------------------------------------------- | | offset | Marcador de progresso em segundos ou como percentagem do anúncio em vídeo reproduzido | | url | URL de rastreamento | **data.cta** | Propriedade | Descrição | | --------------- | -------------------------------------------------- | | URL de exibição | URL relacionada com a página de destino do anúncio | | texto | Texto a ser usado no elemento CTA | ### Exemplo de resposta de vídeo 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 mais" } } } ] } ``` ## Vídeo Slider | Propriedade | Descrição | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | url | O URL de clique | | rastreamento | Um objeto com informações de rastreamento. | | vídeo | O ficheiro do anúncio em vídeo ou o link VAST a carregar. | | screenDensity | Inteiro que indica a parcela do espaço máximo do ecrã ocupada pelo anúncio no dispositivo do utilizador | | onComplete | Indica o comportamento do anúncio depois de o vídeo terminar de ser reproduzido. "hide" significa que o anúncio deve ser ocultado, enquanto "repeat" significa que o anúncio deve permanecer na página para permitir ao utilizador reproduzi-lo novamente | | closeAfter | Indica a quantidade de segundos necessária antes de o botão de fechar ser mostrado no anúncio | | brandingEnabled | Sinalizador para ativar a marca. **Esta propriedade atualmente não é usada** | | frequencyPeriod | Com que frequência, em minutos, o anúncio é mostrado. | | impression | O URL de impressão | | isVast | Indica se a campanha vencedora é um anúncio em vídeo normal (false) ou uma campanha com link VAST (true). | | ctaEnabled | Sinalizador para exibir uma CTA no anúncio | | cta | Um objeto contendo os detalhes da CTA | **data.tracking** Neste momento, o **data.tracking** objeto apenas devolve um `progresso` array com objetos destinados a rastrear a reprodução do vídeo. Desses objetos, aquele com `"offset": "00:00:10.000"` é o que deve ser chamado para registar a visualização do vídeo. As propriedades de cada objeto são explicadas abaixo: | Propriedade | Descrição | | ----------- | ------------------------------------------------------------------------------------- | | offset | Marcador de progresso em segundos ou como percentagem do anúncio em vídeo reproduzido | | url | URL de rastreamento | **data.cta** | Propriedade | Descrição | | --------------- | -------------------------------------------------- | | URL de exibição | URL relacionada com a página de destino do anúncio | | texto | Texto a ser usado no elemento CTA | ### Exemplo de resposta de Vídeo Slider ```json { "zones": [ { "idzone": 12345, "type": "video_slider", "data": { "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884", "tracking": { "progress": [ { "offset": "00:00:10.000", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...." }, { "offset": "25%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...." }, { "offset": "50%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...." }, { "offset": "75%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...." }, { "offset": "100%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...." } ] }, "video": "https://u3y8v8u4.aucdn.net/library/141372/7bbd0e98bb9b36baf778a8b970c74e26f51c037a.mp4", "screenDensity": 25, "onComplete": "repeat", "closeAfter": null, "brandingEnabled": 1, "frequencyPeriod": 0, "impression": "https://s.example.com/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345...", "isVast": false, "ctaEnabled": 1, "cta": { "displayUrl": "fullclickenabled.com", "text": "Assistir grátis" } } } ] } ``` ## Interstitials de página inteira | Propriedade | Descrição | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | | url | O URL de clique | | impression | O URL de impressão | | image | A imagem original carregada para o anúncio. | | optimum\_image | Se o criativo carregado for um GIF animado, esta é a versão MP4 otimizada dele, criada para ser usada no anúncio. | | width | A largura do anúncio em pixels. | | height | A altura do anúncio em pixels. | | frequency\_count | Quantas vezes o anúncio pode ser exibido | | frequency\_period | Com que frequência, em minutos, o anúncio é exibido | | frequency\_trigger\_type | Sinalizador para indicar se a frequência deste anúncio se baseia em impressões (0) ou cliques (1) | | ad\_trigger\_method | Método de disparo ativado para esta zona de anúncio | | ad\_trigger\_classes | Classes que devem disparar o anúncio, se houver | | first\_trigger\_clicks | Número de cliques necessários na visita inicial do utilizador para disparar o anúncio | | next\_trigger\_clicks | Número de cliques necessários após o primeiro disparo do anúncio para o exibir novamente | | chrome\_enabled | Sinalizador para indicar se esta zona de anúncio está ativada para Chrome (1), desativada (0) ou ativada exclusivamente para este navegador (2) | | capping\_enabled | Sinalizador para indicar se o capping deve ser aplicado a esta zona de anúncio ou não | | media | Isto mostra que tipo de banner é este: imagem, HTML ou vídeo: Deve ser `img_banner`, `html_banner` ou `video_banner`, respetivamente. | **Nota:** Nota: a maioria das propriedades da resposta do intersticial de página inteira está relacionada com o capping e o disparo do anúncio. Como é responsável por renderizar o anúncio, cabe-lhe decidir se quer ou não prestar atenção a estas propriedades. ### Exemplo de resposta de intersticial de página inteira Note que, embora o exemplo mostre um intersticial de página inteira para Desktop, a resposta para um intersticial de página inteira para Mobile deve ser a mesma, exceto 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 } } ] } ``` ## Push In-Page | Propriedade | Descrição | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | url | O URL de clique | | impression | A URL de impressão | | image | A imagem original carregada para o anúncio. | | optimum\_image | Se o criativo carregado for um GIF animado, esta é a versão MP4 otimizada dele, criada para ser usada no anúncio. | | title | Título da notificação | | description | Descrição da notificação | | horizontal\_position | Indica a posição horizontal na página (esquerda, centro, direita) | | vertical\_position | Indica a posição vertical na página (topo, meio, inferior) | | delay | Número de segundos antes de a notificação aparecer após o carregamento da página | | max\_notifications\_on\_page | Número de notificações que podem aparecer na página ao mesmo tempo | | once\_closed\_hide\_for | Duração, em segundos, durante a qual o anúncio fica oculto depois de fechado (necessita de consentimento de cookies do utilizador) | | user\_session\_capping | Número de vezes que o anúncio é mostrado ao utilizador (necessita de consentimento de cookies do utilizador) | | delay\_between\_notifications | Número de segundos antes de a próxima notificação aparecer após o carregamento da anterior | ### Exemplo de resposta de notificação push In-Page ```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 é uma descrição", "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 Uma resposta para um pedido Multi-formato pode devolver resultados diferentes: * Se o anúncio vencedor for uma campanha Native, a resposta conterá um [**objeto de dados Native normal.**](#native-ads) * Se o anúncio vencedor for uma campanha Banner e tiver um **Zona única** no layout, a resposta conterá um [**objeto de dados Banner normal.**](#banner) * Se o anúncio vencedor for uma campanha Banner e escolheu um layout com **vários anúncios**, então a resposta conterá um **grupo** objeto com as seguintes propriedades: | Propriedade | Descrição | | ----------- | ------------------------------------------------------------------------------ | | orientação | A orientação da disposição multi-zona, que pode ser "horizontal" ou "vertical" | | ad\_items | Array contendo os dados do anúncio para cada espaço no layout. | Independentemente do resultado, a propriedade **multizoneid** será adicionada à resposta, indicando o ID da zona do anúncio multi-formato a que esta resposta corresponde. ### Exemplo de resposta multi-formato O exemplo seguinte mostra o **zonas** objeto para uma zona de anúncio multi-formato com um **Horizontal x 3** layout: ```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_E6FIYRkOjTYgSFUKjlPznkQx44RvDhEEYkCElrVAmGAKzmlFgsEV4QORNgSkVbReICBMQXLOLC3o.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 } ] } } ] } ``` ## Anúncios de display responsivos Alguns formatos, como Banners e intersticiais de página inteira, podem ativar [**Anúncios de display responsivos**](/exoclick-docs/general-responsive-display-ads.md) para receber demanda de campanhas de anúncios nativos, além da demanda dos seus formatos de anúncio originais. Nessas situações, a resposta conterá o **original\_zone** objeto que indica o tipo e os dados do formato original. Aqui está um exemplo de um formato de anúncio Banner: ```json { "zones": [ { "idzone": 5353142, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "Powered By <\/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 os sistemas online \ud83d\udc68\u200d\ud83d\ude80", "description": "Alcance as estrelas neste novo jogo de simulação 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 } } } ] } ``` ## Rastreamento de impressões Certifique-se de fazer uma chamada GET para a URL de impressão para registar as impressões das suas solicitações de anúncios. Uma forma de conseguir isso é criar um ficheiro de imagem invisível usando a URL de impressão como origem na página onde o anúncio será exibido, por exemplo: ```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/pt/api-de-posicionamento-de-anuncios/resposta/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.