Zonas de resposta

A resposta JSON da API do posicionamento de anúncios contém a matriz zonas e os objectos renderers e user.

Nesta página, explicaremos a matriz zonas, que contém todos os detalhes relativos ao anúncio que ganhou o seu pedido de anúncio.

A matriz contém um objeto com dados de anúncios para cada ID de zona solicitada.

Imóveis	Descrição
idzone	O ID da zona de anúncios.
tipo	O formato de anúncio utilizado, por exemplo, "banner".
dados	Os dados do anúncio (Objeto)

Abaixo encontrará uma lista detalhada das propriedades devolvidas para cada objeto data de acordo com os formatos de anúncio disponíveis.

Bandeira

Imóveis	Descrição
url	O URL para o qual o anúncio é direcionado.
impressão	O URL de impressão
imagem	A imagem original carregada para o anúncio.
imagem_ótima	Se o criativo carregado for um GIF animado, esta é a versão MP4 optimizada do mesmo que é criada para utilização no anúncio.
largura	A largura do anúncio em píxeis.
altura	A altura do anúncio em píxeis.
meios de comunicação	Mostra o tipo de banner que está a ser utilizado: Imagem, HTML, ou vídeo: Deve ser img_banner, html_banner ou video_banner, respetivamente.

Exemplos de resposta de banner

Imagem 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"
            }
        }
    ]
}

Banner de vídeo:

{
    "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 autocolante

Imóveis	Descrição
url	O URL de clique
impressão	O URL de impressão
imagem	A imagem original carregada para o anúncio.
imagem_ótima	Num sticky banner, se o criativo carregado for um GIF animado, esta é a versão MP4 optimizada do mesmo que é criada para utilização no anúncio.
largura	A largura do anúncio em píxeis.
altura	A altura do anúncio em píxeis.
período_de_frequência	A frequência de apresentação do anúncio, em minutos.
v_pos	A posição vertical do anúncio.
h_pos	A posição horizontal do anúncio.
meios de comunicação	Mostra o tipo de banner que está a ser utilizado: Imagem, HTML, ou vídeo: Isto deve ser img_banner, html_banner, ou video_banner respetivamente.

Exemplo de resposta de Sticky Banner

{
    "zones": [
        {
            "idzone": 4204610,
            "type": "sticky_banner",
            "data": {
                "url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAz1Qy4rbQBD8FV98jOie9xwNy.LgzVokkmx808tsQLIeI4Ex_fHpsZPQA1NVU11NjxIejXAEiaavZRnDVu624p3P_VsIX0k99JHK94Bb.QYaPJitMB2TZv69MAyCsXLWopIicsl86LhezSYoFqT3xvjIdLQLUAYhUsv0e7aL0DFs74yWOUYMTbr_rPZp9rH_zG0Q1XTRZanHcy7EKcshW7vm58dhaqcC82WeLrds7W9NcTIFzHM5jjLPTjk.TuvQh2EcpuZgLjCP51_c.COaxvMx9L3i5xVW.Rj6GScJYVIdPMYHzHIIzcFmNs3sMc1Tezt2nFFgUcWQN7sjAkKDyngHUtL_rUkk6BKhIEFN__6G_m5NGhyRQhKEggO0IQlwF5qzmBI5zbpFvEq0vvJtKdHUuq2svkJVqrIyrbRPb9WVfJ4TmQFtXsKGhQ09HbE4hue6F5JKaopuBa8eHh8v5DoeyLSqFhbKuuaNjPMtz1etr5pKOrTX.g.ZmJDwMAIAAA--",
                "impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVOO25DMQy7Si8QQ3/L2Qp06dz2AParPaXImkGHj56LiDJEEJRFAsIL8AXoDeGKfFUOKuiFBApqfH6/h2Dcb4ly3P+CyatSUHOpHtyaWQshEEMIBU/e0Cin14rCFJjuUAsI1+QQpy9+vj72wxM1GOBBKeO+iO4FTYsVFAk55Vx7nKsVcTHWNtrsjHboHFUXjC592OS6rePWs3de+EcB9/MUvYTITzKzvzgLa2RBbCVrR34BY/2uLofrmg3XRGudh1uVCXosPOgJ0ouJzUoBAAA=",
                "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
                "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
                "width": 300,
                "height": 250,
                "frequency_period": 1440,
                "v_pos": "top",
                "h_pos": "left",
                "media": "img_banner"
            }
        }
    ]
}

Mensagens instantâneas

Imóveis	Descrição
url	O URL de clique
impressão	O URL de impressão
imagem	O URL da imagem
imagem_ótima	Se o criativo carregado for um GIF animado, esta é a versão MP4 optimizada do mesmo que é criada para utilização no anúncio.
largura	A largura do anúncio em píxeis.
altura	A altura do anúncio em píxeis.
período_de_frequência	A frequência com que o anúncio é apresentado, em minutos.
meios de comunicação	Isto mostra que tipo de banner é utilizado: Imagem, HTML, ou vídeo: Isto deve ser img_banner, html_banner, ou video_banner respetivamente.

Exemplo de resposta a uma mensagem instantânea

{
   "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 devolve um anúncio nativo, zones.data devolve dois objectos: layout e ad_items

data.layout

Imóveis	Descrição
widgetHeaderContentHtml	O URL da marca "Powered by" que aparece.*
logótipo da marca	O URL para o logótipo da marca que aparece se estiver ativado.*
branding_logo_hover	O URL do logótipo da marca que é apresentado quando o utilizador passa por cima dele
itensPorLinha	O número de anúncios que são apresentados em cada linha do widget.
itensPorCol	O número de anúncios que são apresentados em cada coluna do widget.
família_de_fonte	A família de letra utilizada no anúncio.
tamanho_da_fonte_do_cabeçalho	O tamanho do tipo de letra utilizado no cabeçalho da marca.
cor_da_fonte_do_cabeçalho	A cor do tipo de letra utilizado no cabeçalho da marca.
cor do fundo do widget	O código hexadecimal da cor de fundo utilizada para o widget.
widget_width	A largura de todo o widget.
largura_mínima_para_layout_de_tamanho_completo	A largura mínima para um layout de tamanho normal em pixels.
item_height	A altura de cada anúncio individual.
preenchimento do item	O preenchimento entre cada um dos anúncios.
altura_da_imagem	A altura da imagem em cada anúncio.
largura_da_imagem	A largura da imagem em cada anúncio.
text_margin_top	O tamanho em píxeis da margem superior do texto.
text_margin_bottom	O tamanho em píxeis da margem inferior do texto.
text_margin_left	O tamanho em píxeis da margem esquerda do texto.
text_margin_right	O tamanho em píxeis da margem direita do texto.
tamanho_da_fonte_do_título	O tamanho do tipo de letra do título de cada anúncio.
cor_da_fonte_do_título	A cor do tipo de letra do título de cada anúncio.
peso_da_fonte_do_título	A espessura do tipo de letra do título de cada anúncio.
decoração_título	Se o título está sublinhado ou não.
cor_do_título_hover	A cor do tipo de letra quando se passa o rato por cima do título.
peso_da_fonte_do_título_hover	O peso do tipo de letra quando se passa o rato por cima do título.
decoração_do_título	Se o título é sublinhado ao passar o rato ou não.
descrição_tamanho_da_fonte	O tamanho da letra da descrição de cada anúncio.
descrição_cor_da_fonte	A cor do tipo de letra da descrição de cada anúncio.
descrição_peso_da_fonte	O peso do tipo de letra da descrição de cada anúncio.
descrição_decoração	Se a descrição está sublinhada ou não.
descrição_cor_do_hover	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 ou não.
abrir_em_nova_janela	Se o anúncio deve ser aberto numa nova janela quando se clica nele. 1=sim, 0=não.
mobile_responsive_type	O tipo de capacidade de resposta 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 por cima ou por baixo dos anúncios. 1=sim, 0=não.
alinhamento_do_texto_do_cabeçalho	O alinhamento horizontal do cabeçalho da marca.
título_activado	Se o título está ativado ou não. 1=sim, 0=não.
descrição_activada	Se a descrição está activada ou não. 1=sim, 0=não.
tamanho_da_margem_da_imagem	O tamanho em píxeis do contorno da imagem.
cor_da_margem_da_imagem	A cor do código hexadecimal do contorno da imagem.
alinhamento_do_texto	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.
ponto de rutura móvel	O ponto de rutura, em píxeis, entre as visualizações para computador e para telemóvel da zona de anúncios.
espaçamento_v	O espaçamento vertical em píxeis entre os anúncios, definido nas Opções avançadas.
espaçamento_h	O espaçamento horizontal em píxeis entre os anúncios, definido nas Opções avançadas.
zoom	Se o anúncio deve aumentar ou diminuir o zoom ao passar o rato.
linhas_móveis	O número de linhas de anúncios no widget para telemóvel.
colunas_móveis	O número de colunas de anúncios no widget para telemóvel.
use_v2_script	Se a zona de anúncios foi criada com a configuração V2 mais recente ou com a v1 mais antiga.
text_enabled	Se o título e a descrição do texto devem ser apresentados. 1=sim, 0=não.
largura_da_imagem_móvel	A largura da imagem em cada anúncio no telemóvel.
tamanho_da_caixa_de_texto_móvel	O tamanho da caixa de texto no telemóvel. Intervalo válido 50-500.
mobile_text_enabled	Se o título está ativado ou não no telemóvel. 1=sim, 0=não.
posição_do_texto_móvel	A posição do texto no telemóvel: em baixo ou à direita.
item_spacing_on_each_side	O preenchimento de cada lado dos anúncios, se tiverem sido configurados com a antiga configuração v1.
posição_do_texto	Se o texto é posicionado no lado esquerdo ou direito.
tamanho_da_caixa_de_texto	O tamanho da caixa de texto em pixéis. Intervalo 50-500.
widget_height	A altura de todo o widget.
brand_enabled	Se a marca está activada ou não.
tamanho_da_fonte_da_marca	O tamanho do tipo de letra da marca.
cor_da_fonte_da_marca	A cor do tipo de letra da marca.
brand_font_weight	O peso do tipo de letra da marca.
decoração_da_marca	Se o tipo de letra está sublinhado ou não.
altura_da_imagem_móvel	A altura da imagem em cada anúncio no telemóvel.
publisherAdType	Que tipo de anúncio nativo é este, ou seja, recomendação, saída ou intersticial: native-recommendation, native-interstitial.

data.ad_items

Imóveis	Descrição
imagem	A imagem original carregada para o anúncio.
url	O URL de clique
impressão	O URL de impressão
título	O texto do título do anúncio.
descrição	O texto de descrição do anúncio.
marca	O texto da marca do anúncio.
original_url	O URL original da página de destino.
posição_da_imagem	A posição da imagem do anúncio (como a imagem será cortada).

Exemplo de resposta a anúncios 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 Outstream

Imóveis	Descrição
url	O URL de clique
rastreamento	Um objeto com informações de localização.
vídeo	O ficheiro de anúncio em vídeo ou a ligação VAST a carregar.
brandingEnabled	Sinalizador para ativar a marca. **Este valor não é atualmente utilizado
período de frequência	A frequência de apresentação do anúncio, em minutos.
largura máxima	Tamanho da largura do vídeo.
éVast	Indica se a campanha vencedora é um anúncio de vídeo normal (falso) ou uma campanha de ligação VAST (verdadeiro).
ctaEnabled	Sinalizador para apresentar uma CTA no anúncio
cta	Um objeto que contém os detalhes da CTA
impressão	O URL de impressão

data.tracking

No momento, o objeto data.tracking retorna apenas um array progress com objetos destinados a acompanhar a reprodução do vídeo. Desses objetos, aquele com "offset": "00:00:10.000" é o que deve ser chamado para persistir a visualização do vídeo. As propriedades de cada objeto são explicadas abaixo:

Imóveis	Descrição
compensar	Marcador de progresso em segundos ou como percentagem do anúncio em vídeo reproduzido
url	URL de rastreio

data.cta

Imóveis	Descrição
displayUrl	URL relacionado com a página de destino do anúncio
texto	Texto a ser utilizado no elemento CTA

Exemplo de resposta de vídeo outstream

{
    "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"
                }
            }
        }
    ]
}

Controlo deslizante de vídeo

Imóveis	Descrição
url	O URL de clique
rastreamento	Um objeto com informações de localização.
vídeo	O ficheiro de anúncio em vídeo ou a ligação VAST a carregar.
screenDensity	Número inteiro que indica a percentagem do espaço máximo do ecrã ocupado pelo anúncio no dispositivo de um 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 que o utilizador o reproduza
fecharDepois	Indica o número de segundos necessários para que o botão Fechar seja apresentado no anúncio
brandingEnabled	Sinalizador para ativar a marca. **Esta propriedade não é atualmente utilizada
período de frequência	A frequência de apresentação do anúncio, em minutos.
impressão	O URL de impressão
éVast	Indica se a campanha vencedora é um anúncio de vídeo normal (falso) ou uma campanha de ligação VAST (verdadeiro).
ctaEnabled	Sinalizador para apresentar uma CTA no anúncio
cta	Um objeto que contém os detalhes da CTA

data.tracking

No momento, o objeto data.tracking retorna apenas um array progress com objetos destinados a acompanhar a reprodução do vídeo. Desses objetos, aquele com "offset": "00:00:10.000" é o que deve ser chamado para persistir a visualização do vídeo. As propriedades de cada objeto são explicadas abaixo:

Imóveis	Descrição
compensar	Marcador de progresso em segundos ou como percentagem do anúncio em vídeo reproduzido
url	URL de rastreio

data.cta

Imóveis	Descrição
displayUrl	URL relacionado com a página de destino do anúncio
texto	Texto a ser utilizado no elemento CTA

Exemplo de resposta de vídeo deslizante

{
    "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"
                }
            }
        }
    ]
}

Intersticiais de página inteira

Imóveis	Descrição
url	O URL de clique
impressão	O URL de impressão
imagem	A imagem original carregada para o anúncio.
imagem_ótima	Se o criativo carregado for um GIF animado, esta é a versão MP4 optimizada do mesmo que é criada para utilização no anúncio.
largura	A largura do anúncio em píxeis.
altura	A altura do anúncio em píxeis.
contagem de frequências	Quantas vezes o anúncio pode ser apresentado
período_de_frequência	Com que frequência, em minutos, o anúncio é apresentado
tipo_de_activação_de_frequência	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 acionamento ativado para esta zona de anúncios
classes_de_activadores_adicionais	Classes que devem acionar o anúncio, se existirem
primeiros_trigger_clicks	Número de cliques necessários na visita inicial do utilizador para ativar o anúncio
próximos_trigger_clicks	Número de cliques necessários após o primeiro acionamento do anúncio para que o anúncio seja apresentado novamente
chrome_enabled	Sinalizador para indicar se esta zona de anúncios está activada para o Chrome (1), desactivada (0) ou activada exclusivamente para este navegador (2)
capping_enabled	Sinalizador para indicar se o limite máximo deve ser aplicado a esta zona de publicidade ou não
meios de comunicação	Mostra o tipo de banner que está a ser utilizado: Imagem, HTML, ou vídeo: Deve ser img_banner, html_banner ou video_banner, respetivamente.

Nota: a maioria das propriedades da resposta Intersticial Fullpage está relacionada com o limite e o acionamento do anúncio. Uma vez que o utilizador é responsável pela apresentação do anúncio, cabe-lhe a si decidir se quer ou não prestar atenção a estas propriedades.

Exemplo de resposta intersticial de página inteira

Note-se que, embora o exemplo mostre um Interstitial de página inteira para ambiente de trabalho, a resposta para um Interstitial de página inteira para telemóvel deve ser a mesma, à exceção do 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,
            }
        }
    ]
}

Impulso na página

Propriedade.	Descrição
url	O URL de clique
impressão	O URL de impressão
imagem	A imagem original carregada para o anúncio.
imagem_ótima	Se o criativo carregado for um GIF animado, esta é a versão MP4 optimizada do mesmo que é criada para utilização no anúncio.
título	Título da notificação
descrição	Descrição da notificação
posição_horizontal	Indica a posição horizontal na página (esquerda, centro, direita)
posição_vertical	Indica a posição vertical na página (topo, meio, fundo)
atraso	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
uma vez_fechado_esconder_para	Período de tempo, em segundos, durante o qual o anúncio fica oculto depois de fechado (necessita do consentimento do utilizador para o cookie)
user_session_capping	Número de vezes que o anúncio é mostrado ao utilizador (necessita do consentimento do utilizador para o cookie)
atraso_entre_notificações	Número de segundos antes de aparecer a notificação seguinte após o carregamento da anterior

Exemplo de resposta de notificação push na 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
  }
}

Multi-formato

Uma resposta a um pedido multiformato pode apresentar resultados diferentes:

• Se o anúncio vencedor for uma campanha nativa, a resposta conterá um objeto de dados nativo regular
• Se o anúncio vencedor for uma campanha de banner e tiver uma Zona única no esquema, a resposta conterá um objeto de dados de banner regular
• Se o anúncio vencedor for uma campanha de banners e tiver escolhido um esquema com múltiplos anúncios, a resposta conterá um objeto group com as seguintes propriedades:

Imóveis	Descrição
orientação	A orientação do esquema de várias zonas, que pode ser "horizontal" ou "vertical"
ad_items	Matriz que contém os dados do anúncio para cada ponto do esquema.

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 multiformato

O exemplo seguinte mostra o objeto zonas para uma zona de anúncio Multi-Formato com uma disposição 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
                    }
                ]
            }
        }
    ]
}

Anúncios gráficos responsivos

Alguns formatos, como os Banners e os intersticiais Fullpage, podem permitir que os Responsive Display Ads recebam procura de campanhas de Native Ads, para além da procura dos seus formatos de anúncio originais. Nestas situações, a resposta conterá o objeto original_zone que indica o tipo e os dados do formato original.

Eis um exemplo de um formato de anúncio em 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
                }
            }
        }
    ]
}

Controlo de impressões

Certifique-se de que faz uma chamada GET para o URL de impressão para registar as impressões dos seus pedidos de anúncios. Uma forma de o conseguir é criar um ficheiro de imagem invisível utilizando o URL de impressão como fonte na página onde o anúncio será apresentado, por exemplo

<img src="impression_url" width="0" height="0">