> 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/it/api-di-posizionamento-annunci/risposta/ad-plac-response.md). # Zone di risposta Il JSON di risposta dell'API Ad Placement contiene i **zone** array e i [**renderer**](https://docs.exoclick.com/docs/ad-plac-renderers/) e [**utente**](/api/it/api-di-posizionamento-annunci/risposta/ad-plac-user.md) oggetti. In questa pagina spiegheremo l' **zone** array, che contiene tutti i dettagli relativi all'annuncio che ha vinto la tua richiesta di annuncio. L'array contiene un oggetto con i dati dell'annuncio per ogni ID zona richiesto. | Proprietà | Descrizione | | --------- | ------------------------------------------------ | | idzone | L'ID della zona dell'annuncio. | | type | Il formato annuncio utilizzato, ad es. `banner`. | | data | I dati dell'annuncio (oggetto) | Di seguito trovi un elenco dettagliato delle proprietà restituite per ciascun **data** oggetto in base ai formati annuncio disponibili. ## Banner | Proprietà | Descrizione | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | url | L'URL a cui l'annuncio reindirizza. | | impression | L'URL di impressione | | image | L'immagine originale caricata per l'annuncio. | | optimum\_image | Se il creativo caricato è un GIF animato, questa è la versione MP4 ottimizzata creata per l'uso nell'annuncio. | | width | La larghezza dell'annuncio in pixel. | | height | L'altezza dell'annuncio in pixel. | | media | Questo mostra che tipo di banner è: immagine, HTML o video: dovrebbe essere `img_banner`, `html_banner` o `video_banner`, rispettivamente. | ### Esempi di risposta Banner **Banner immagine:** ```json { "zones": [ { "idzone": 1111111, "type": "banner", "data": { "url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVOu04DMRD8lTRprX14bW9JQ0PBN6xzPlGAgCToQJqPx7nTTrGa0TxOyELNnKCJuWX3yqpVBW_3.9ftrE9neZ7Yti3FekuXzw8ABHBhKmoujuUa33H9O0RJ3JJkSmxALs3YJUNrqbkYjNpkGQKWmWIFUKJfMQI_UqMvY20_jukTVOZVuXr3EcrlYqNXW6lHjl6G1t3T32PiGEbzTtjp46Y7F27Hp1ltHz.JXZ31j96M1xdQzRbNJbxE1EJhbfWL8bLQCBvyD4rI3QwpAQAA", "impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVPS05DMQy8Chdo5PEnn+5YsGCL4ADJa7ICIYqQiuTD4z5ax9HEI2fGZmIcCAfoA7Wj8ZGac0JNrJRg/vz66Ao/nftXP/9+p+3zw3NRLbhDVZFcXErU2dyoujJVa+Saq6GxOtjZLTt5EBxAiUiAqq0ViBRhB5E/vb3sF47EDMQvIbqwUVDXUVBrQraUEzRkw+oqdiHv4zRX/WlegCUobbTZBXmzOYotGl37yFNKCJGP9x65L0P/J4nlcHW+Ex4imsPh9hYV8wjynYnY98Gte81yosm2lswFmW2jPBsv07YQw/0B+rSsfmgBAAA=", "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif", "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4", "width": 300, "height": 250, "media": "img_banner" } } ] } ``` **Banner HTML:** ```json { "zones": [ { "idzone": 2222222, "type": "banner", "data": { "html": "\n
\nExample HTML Ad!\n
\n", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1OW2oDMQy8Si8Qo7Fky8p3+18IPYDteqGwJYGkkA8dvt7dUj1AjGY0ihRxIpwgL2Rn4XMiR0khRg0REsDF3y7vTn4b69f9tv7cw+PqauxJPGWPouIgN1h2jazFET1uK3I2cGZLc6RApMmN/OPyujdmxikpzwkCuw1KCcgp5ACRqZqnnZ5T7QosDLVmozJyT6NpWqhVqS0P1o3oba2zQr9+b46Hq8hh9Ac4M2cjHDMAY/YZ5DsyY//8n11qtiy0LJU/e2Xl0a3FUqlq70q/g8aBP0ABAAA=", "width": 300, "height": 250, "media": "html_banner" } } ] } ``` **Banner video:** ```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 sticky | Proprietà | Descrizione | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | url | L'URL di clic | | impression | L'URL di impressione | | image | L'immagine originale caricata per l'annuncio. | | optimum\_image | In un banner sticky, se il creativo caricato è un GIF animato, questa è la versione MP4 ottimizzata creata per l'uso nell'annuncio. | | width | La larghezza dell'annuncio in pixel. | | height | L'altezza dell'annuncio in pixel. | | frequency\_period | Con quale frequenza, in minuti, viene mostrato l'annuncio. | | v\_pos | La posizione verticale dell'annuncio. | | h\_pos | La posizione orizzontale dell'annuncio. | | media | Questo mostra che tipo di banner è: immagine, HTML o video: dovrebbe essere `img_banner`, `html_banner`, o `video_banner` rispettivamente. | ### Esempio di risposta del banner sticky ```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" } } ] } ``` ## Messaggi istantanei | Proprietà | Descrizione | | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | url | L'URL di clic | | impression | L'URL di impressione | | image | L'URL dell'immagine | | optimum\_image | Se il creativo caricato è un GIF animato, questa è la versione MP4 ottimizzata creata per l'uso nell'annuncio. | | width | La larghezza dell'annuncio in pixel. | | height | L'altezza dell'annuncio in pixel. | | frequency\_period | Con quale frequenza viene mostrato l'annuncio, in minuti. | | media | Questo mostra quale tipo di banner viene utilizzato: immagine, HTML o video: dovrebbe essere `img_banner`, `html_banner`, o `video_banner` rispettivamente. | ### Esempio di risposta del messaggio istantaneo ```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" } } ] } ``` ## Annunci nativi Quando la risposta restituisce un annuncio nativo, zones.data restituirà due oggetti: **layout** e **ad\_items** **data.layout** | Proprietà | Descrizione | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | | widgetHeaderContentHtml | L'URL del branding 'Powered by' visualizzato.\* | | branding\_logo | L'URL del logo del branding visualizzato se abilitato.\* | | branding\_logo\_hover | L'URL del logo del branding visualizzato quando l'utente vi passa sopra.\* | | itemsPerRow | Il numero di annunci mostrati in ciascuna riga del widget. | | itemsPerCol | Il numero di annunci mostrati in ciascuna colonna del widget. | | font\_family | La famiglia di font utilizzata nell'annuncio. | | header\_font\_size | La dimensione del font utilizzata nell'intestazione del branding. | | header\_font\_color | Il colore del font utilizzato nell'intestazione del branding. | | widget\_background\_color | Il codice esadecimale del colore di sfondo utilizzato per il widget. | | widget\_width | La larghezza dell'intero widget. | | minimum\_width\_for\_full\_sized\_layout | La larghezza minima per un layout a grandezza naturale, in pixel. | | item\_height | L'altezza di ciascun annuncio. | | item\_padding | Il padding tra ciascun annuncio. | | image\_height | L'altezza dell'immagine in ciascun annuncio. | | image\_width | La larghezza dell'immagine in ciascun annuncio. | | text\_margin\_top | La dimensione in pixel del margine superiore del testo. | | text\_margin\_bottom | La dimensione in pixel del margine inferiore del testo. | | text\_margin\_left | La dimensione in pixel del margine sinistro del testo. | | text\_margin\_right | La dimensione in pixel del margine destro del testo. | | title\_font\_size | La dimensione del font del titolo per ciascun annuncio. | | title\_font\_color | Il colore del font del titolo per ciascun annuncio. | | title\_font\_weight | Il peso del font del titolo per ciascun annuncio. | | title\_decoration | Se il titolo è sottolineato o meno. | | title\_hover\_color | Il colore del font quando si passa il mouse sul titolo. | | title\_hover\_font\_weight | Il peso del font quando si passa il mouse sul titolo. | | title\_hover\_decoration | Se il titolo è sottolineato al passaggio del mouse o meno. | | description\_font\_size | La dimensione del font della descrizione per ciascun annuncio. | | description\_font\_color | Il colore del font della descrizione per ciascun annuncio. | | description\_font\_weight | Il peso del font della descrizione per ciascun annuncio. | | description\_decoration | Se la descrizione è sottolineata o meno. | | description\_hover\_color | Il colore del font quando si passa il mouse sulla descrizione. | | description\_hover\_font\_weight | Il peso del font quando si passa il mouse sulla descrizione. | | description\_hover\_decoration | Se la descrizione è sottolineata al passaggio del mouse o meno. | | open\_in\_new\_window | Se l'annuncio deve aprirsi in una nuova finestra quando viene cliccato. 1=sì, 0=no. | | mobile\_responsive\_type | Il tipo di responsive quando si usa un dispositivo mobile (ad esempio nessuno o compatto). 1=compatto, 0=no. | | header\_is\_on\_top | Se il branding deve essere visualizzato sopra o sotto gli annunci. 1=sì, 0=no. | | header\_text\_align | L'allineamento orizzontale dell'intestazione del branding. | | title\_enabled | Se il titolo è abilitato o meno. 1=sì, 0=no. | | description\_enabled | Se la descrizione è abilitata o meno. 1=sì, 0=no. | | image\_border\_size | La dimensione in pixel del bordo dell'immagine. | | image\_border\_color | Il colore esadecimale del bordo dell'immagine. | | text\_align | L'allineamento del testo: sinistra, centro o destra. | | customcss\_enabled | Se il CSS personalizzato è abilitato o meno. 1=sì, 0=no. | | customcss | Se abilitato, il CSS personalizzato verrà visualizzato qui. | | header\_enabled | Se l'intestazione è abilitata o meno. 1=sì, 0=no. | | mobile\_breakpoint | Il breakpoint, in pixel, tra la visualizzazione desktop e quella mobile della zona annuncio. | | spacing\_v | La spaziatura verticale in pixel tra gli annunci, impostata nelle Opzioni avanzate. | | spacing\_h | La spaziatura orizzontale in pixel tra gli annunci, impostata nelle Opzioni avanzate. | | zoom | Se l'annuncio deve ingrandirsi/ridursi al passaggio del mouse. | | mobile\_rows | Il numero di righe di annunci nel widget mobile. | | mobile\_cols | Il numero di colonne di annunci nel widget mobile. | | use\_v2\_script | Se la zona annuncio è stata creata con la nuova configurazione V2 o con la vecchia v1. | | text\_enabled | Se il titolo e la descrizione del testo devono essere visualizzati. 1=sì, 0=no. | | mobile\_image\_width | La larghezza dell'immagine in ciascun annuncio su mobile. | | mobile\_text\_box\_size | La dimensione della casella di testo su mobile. Intervallo valido 50-500. | | mobile\_text\_enabled | Se il titolo è abilitato o meno su mobile. 1=sì, 0=no. | | mobile\_text\_position | La posizione del testo su mobile: in basso o a destra. | | item\_spacing\_on\_each\_side | Il padding su ciascun lato degli annunci, se sono stati configurati usando la vecchia configurazione v1. | | text\_position | Se il testo è posizionato sul lato sinistro o destro. | | text\_box\_size | La dimensione della casella di testo in pixel. Intervallo 50-500. | | widget\_height | L'altezza dell'intero widget. | | brand\_enabled | Se il branding è abilitato o meno. | | brand\_font\_size | La dimensione del font del branding. | | brand\_font\_color | Il colore del font del branding. | | brand\_font\_weight | Il peso del font del branding. | | brand\_decoration | Se il font è sottolineato o meno. | | mobile\_image\_height | L'altezza dell'immagine in ciascun annuncio su mobile. | | publisherAdType | Che tipo di annuncio nativo è, cioè recommendation, exit o interstitial: `native-recommendation`, `native-interstitial`. | **data.ad\_items** | Proprietà | Descrizione | | --------------------- | ---------------------------------------------------------------------------------------------------- | | idvariation | L'ID della variazione. | | image | L'immagine originale caricata per l'annuncio. | | url | L'URL di clic. | | impression | L'URL di impressione. | | title | Il testo del titolo dell'annuncio. | | description | Il testo della descrizione dell'annuncio. | | brand | Il testo del brand dell'annuncio. | | original\_url | L'URL originale della pagina di destinazione. | | image\_position | La posizione dell'immagine dell'annuncio (come verrà ritagliata l'immagine). | | size | La dimensione del formato annuncio selezionato | | iframe\_url | Se viene usato un iframe come variazione, questa sarà l'URL dell'iframe. | | video\_thumb\_id | L'identificatore dell'asset della miniatura video (se presente) associato al creativo dell'annuncio. | | video\_thumb\_url | L'URL dell'asset della miniatura video (se presente). | | video\_thumb\_enabled | Lo stato dell'asset della miniatura video (se presente). | ### Esempio di risposta degli annunci nativi ```json { "zones": [ { "idzone": 4058715, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "Powered By ", "branding_logo": "//static.example.com/widget-branding-logo.png", "branding_logo_hover": "//static.example.com/widget-branding-logo-hover.png", "itemsPerRow": 4, "itemsPerCol": 1, "font_family": "Arial, Helvetica, Verdana, sans-serif", "header_font_size": "12px", "header_font_color": "#999999", "widget_background_color": "transparent", "widget_width": "1830px", "minimum_width_for_full_sized_layout": "450px", "item_height": "300px", "item_padding": "10px", "image_height": "450px", "image_width": "450px", "text_margin_top": "3px", "text_margin_bottom": "3px", "text_margin_left": "0px", "text_margin_right": "0px", "title_font_size": "16px", "title_font_color": "#000000", "title_font_weight": "normal", "title_decoration": "none", "title_hover_color": "#0000FF", "title_hover_font_weight": "normal", "title_hover_decoration": "none", "description_font_size": "14px", "description_font_color": "#555555", "description_font_weight": "normal", "description_decoration": "none", "description_hover_color": "#0055FF" "description_hover_font_weight": "normal", "description_hover_decoration": "none", "open_in_new_window": 1, "mobile_responsive_type": 1, "header_is_on_top": 1, "header_text_align": "right", "title_enabled": 1, "description_enabled": 0, "image_border_size": "", "image_border_color": "", "text_align": "left", "customcss_enabled": 0, "customcss": null, "header_enabled": 1, "mobile_breakpoint": "450", "spacing_v": "10", "spacing_h": "10", "zoom": "1", "mobile_rows": "2", "mobile_cols": "1", "use_v2_script": "1", "text_enabled": "1", "mobile_image_width": "450", "mobile_text_box_size": "90", "mobile_text_enabled": "1", "mobile_text_position": "bottom", "item_spacing_on_each_side": "5px", "text_position": "bottom", "text_box_size": "90px", "widget_height": "570px", "brand_enabled": "1", "brand_font_size": "11px", "brand_font_color": "#555555", "brand_font_weight": "normal", "brand_decoration": "none", "mobile_image_height": "450", "publisherAdType": "native-recommendation" }, "ad_items": [ { "image": "https://static.example.com/library/432437/97567ec37c751bc909fc06c96920bb353efefe36.jpg", "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OO27EMAxEr7LNljE0okhJZZo0KfYMkj9IgPwAG3GKOfxybSDgAJTI0RtdmBBzhhCBb9v2s17l.RpfXPu.D_Nfm9Zh_P70.1fb3n_n9UlJBhIGQGoQ47.LyHVw3gDRIUYjkwIlR2UKWjKUGopPQQ80xziI8CKiJMrDpb7NwCIO63VuAht17lmX0Ftq3WbJ_iKwfzTXkXuQLjzGZ8kjWeQ8hWj1.HUNp7WkoyXeXqmW0acQp0mWKdaUUaqUcTQbkaqlOziYDlsjAQAA", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OS04FMQy7CheYKs6nad8OxAlAHKDzW4FYsHmLHJ5M0ZOI00apLddMjIWwMD2R3cRvqAHvBewFYoW5xsvbcyjiuI/9p2zfX6HCKv4YzbU3CyVrDgujlmp2h4Qa0Jwt0lWCEnLJLN1yKYRwio/313mQYIq8rw9BRblQQXQKzUe6U4BFw4FTMuPajyGomx2r20nr0LHWIwNd5uvnyJ5paQLFpcrkHpArnkgs+FuIa48siklnNf0nH+JUR60bidjoKd+HbHLuO7bTvP0ChQRmKEsBAAA=", "title": "titolo 5", "description": "descrizione 5", "brand": "marchio 5", "original_url": "https://www.example.com/natives-5", "image_position": "50% 50%" }, { "image": "https://static.example.com/library/432437/d51084a3da98f857bca6ba19037cfe90b9a93c0b.jpg", "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OOW7EMAxFrzLNlBG4iFrKNGlS5AySR0ICZANsxCn.4UN7gIAEuH0.8oLIkjNVMOF1277Xqz5e5cl93_cwftttDcvXh9efbXv7GeuDAiCAEzNrJU34V4FzDc4LrBZEEhCNuWQyRLKS2WBUvMtQBzjGQWA3sGiEHirzaWae6rBeR1NOi42ebVJvsfU0NPsGob839_PuSboAciaH6XFZ9Z6RpHp.XekuLfEMES_PsCEcS7ZOc6HU6pR0mxIlVuNcUvsDR8DGSCMBAAA-", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OSU4EMQz8Ch/oqLzFydxAvADEA9I96ROIA5c5+PHj7gEJV+Ko7FKlGEwLaGE8wS7iF6pB3guxFxIrzDVe3p5DKeZtXH/K9v0VKqzif09z7c1CYc3JwtBSze7ooUbUHBbpKoGEHDJLtyQFFI74eH89LyUYkf34kFCUCwpFR2gOcUMQi4YT7ZIZ1z6HUN1srm471qFjrTMDHebr58hzpsUJKi6Vg3/pI0vGE4mFHgRce2QhznVW03/yMU3nbjW7wfu8trHtuk3kZBuT7xcrT8hLAQAA", "title": "Native 3 title", "description": "Native 3 description", "brand": "Native 3 brand", "original_url": "https://www.example.com/natives-3", "image_position": "50% 50%" }, { "image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png", "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0nH364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==", "title": "Native 2 title", "description": "Native 2 description", "brand": "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": "titolo 4", "description": "descrizione 4", "brand": "marchio 4", "original_url": "https://www.example.com/natives-4", "image_position": "50% 50%" } ] } } ] } ``` ## Video outstream | Proprietà | Descrizione | | --------------- | ------------------------------------------------------------------------------------------------------- | | url | L'URL di clic | | tracking | Un oggetto con informazioni di tracciamento. | | video | Il file video dell'annuncio o il link VAST da caricare. | | brandingEnabled | Flag per abilitare il branding. **Questo valore non è attualmente utilizzato** | | frequencyPeriod | Con quale frequenza, in minuti, viene mostrato l'annuncio. | | maximumWidth | Dimensione della larghezza del video. | | isVast | Indica se la campagna vincente è un normale annuncio video (false) o una campagna con link VAST (true). | | ctaEnabled | Flag per visualizzare un CTA sull'annuncio | | cta | Un oggetto contenente i dettagli del CTA | | impression | L'URL di impressione | **data.tracking** Al momento, l' **data.tracking** oggetto restituisce solo un `avanzamento` array di oggetti destinati a tracciare la riproduzione del video. Tra questi oggetti, quello con `"offset": "00:00:10.000"` è quello da chiamare per registrare la visualizzazione del video. Le proprietà di ciascun oggetto sono spiegate di seguito: | Proprietà | Descrizione | | --------- | ------------------------------------------------------------------------------------------ | | offset | Indicatore di avanzamento in secondi o come percentuale del video pubblicitario riprodotto | | url | URL di tracciamento | **data.cta** | Proprietà | Descrizione | | ---------- | -------------------------------------------- | | displayUrl | URL relativo alla landing page dell'annuncio | | text | Testo da utilizzare nell'elemento CTA | ### Esempio di risposta video outstream ```json { "zones": [ { "idzone": 12345, "type": "outstream_video", "data": { "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884", "tracking": { "progress": [ { "offset": "00:00:10.000", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...." }, { "offset": "25%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...." }, { "offset": "50%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...." }, { "offset": "75%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...." }, { "offset": "100%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...." } ] }, "video": "https:\/\/u3y8v8u4.aucdn.net\/library\/940460\/8f1ab6fd40cb27cba71db1229c250d6bce1f8b68.mp4", "brandingEnabled": 0, "frequencyPeriod": 60, "maximumWidth": 1000, "impression": "https:\/\/s.example.com\/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345....", "isVast": false, "ctaEnabled": 1, "cta": { "displayUrl": "singleflirt.com", "text": "Vedi altro" } } } ] } ``` ## Slider video | Proprietà | Descrizione | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | url | L'URL di clic | | tracking | Un oggetto con informazioni di tracciamento. | | video | Il file video dell'annuncio o il link VAST da caricare. | | screenDensity | Intero che indica la porzione dello spazio massimo dello schermo occupata dall'annuncio sul dispositivo dell'utente | | onComplete | Indica il comportamento dell'annuncio dopo che il video ha terminato la riproduzione. "hide" significa che l'annuncio deve essere nascosto, mentre "repeat" significa che l'annuncio deve rimanere nella pagina per consentire all'utente di rivederlo | | closeAfter | Indica il numero di secondi necessari prima che il pulsante di chiusura venga mostrato sull'annuncio | | brandingEnabled | Flag per abilitare il branding. **Questa proprietà non è attualmente utilizzata** | | frequencyPeriod | Con quale frequenza, in minuti, viene mostrato l'annuncio. | | impression | L'URL di impressione | | isVast | Indica se la campagna vincente è un normale annuncio video (false) o una campagna con link VAST (true). | | ctaEnabled | Flag per visualizzare un CTA sull'annuncio | | cta | Un oggetto contenente i dettagli del CTA | **data.tracking** Al momento, l' **data.tracking** oggetto restituisce solo un `avanzamento` array di oggetti destinati a tracciare la riproduzione del video. Tra questi oggetti, quello con `"offset": "00:00:10.000"` è quello da chiamare per registrare la visualizzazione del video. Le proprietà di ciascun oggetto sono spiegate di seguito: | Proprietà | Descrizione | | --------- | ------------------------------------------------------------------------------------------ | | offset | Indicatore di avanzamento in secondi o come percentuale del video pubblicitario riprodotto | | url | URL di tracciamento | **data.cta** | Proprietà | Descrizione | | ---------- | -------------------------------------------- | | displayUrl | URL relativo alla landing page dell'annuncio | | text | Testo da utilizzare nell'elemento CTA | ### Esempio di risposta Video Slider ```json { "zones": [ { "idzone": 12345, "type": "video_slider", "data": { "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884", "tracking": { "progress": [ { "offset": "00:00:10.000", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...." }, { "offset": "25%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...." }, { "offset": "50%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...." }, { "offset": "75%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...." }, { "offset": "100%", "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...." } ] }, "video": "https://u3y8v8u4.aucdn.net/library/141372/7bbd0e98bb9b36baf778a8b970c74e26f51c037a.mp4", "screenDensity": 25, "onComplete": "repeat", "closeAfter": null, "brandingEnabled": 1, "frequencyPeriod": 0, "impression": "https://s.example.com/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345...", "isVast": false, "ctaEnabled": 1, "cta": { "displayUrl": "fullclickenabled.com", "text": "Guarda gratis" } } } ] } ``` ## Interstitial a pagina intera | Proprietà | Descrizione | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- | | url | L'URL di clic | | impression | L'URL di impressione | | image | L'immagine originale caricata per l'annuncio. | | optimum\_image | Se il creativo caricato è un GIF animato, questa è la versione MP4 ottimizzata creata per l'uso nell'annuncio. | | width | La larghezza dell'annuncio in pixel. | | height | L'altezza dell'annuncio in pixel. | | frequency\_count | Quante volte può essere mostrato l'annuncio | | frequency\_period | Con quale frequenza, in minuti, viene mostrato l'annuncio | | frequency\_trigger\_type | Flag che indica se la frequenza di questo annuncio si basa sulle impressioni (0) o sui clic (1) | | ad\_trigger\_method | Metodo di attivazione abilitato per questa zona pubblicitaria | | ad\_trigger\_classes | Classi che dovrebbero attivare l'annuncio, se presenti | | first\_trigger\_clicks | Numero di clic necessari nella visita iniziale dell'utente per attivare l'annuncio | | next\_trigger\_clicks | Numero di clic necessari dopo il primo trigger dell'annuncio per visualizzare di nuovo l'annuncio | | chrome\_enabled | Flag che indica se questa zona pubblicitaria è abilitata per Chrome (1), disabilitata (0) o abilitata esclusivamente per questo browser (2) | | capping\_enabled | Flag che indica se il capping deve essere applicato o meno a questa zona pubblicitaria | | media | Questo mostra che tipo di banner è: immagine, HTML o video: dovrebbe essere `img_banner`, `html_banner` o `video_banner`, rispettivamente. | **Nota:** la maggior parte delle proprietà della risposta Fullpage Interstitial è relativa al capping e all'attivazione dell'annuncio. Poiché sei responsabile del rendering dell'annuncio, spetta a te decidere se vuoi prestare attenzione o meno a queste proprietà. ### Esempio di risposta Fullpage Interstitial Nota che, anche se l'esempio mostra un Fullpage Interstitial Desktop, la risposta per un Fullpage Interstitial Mobile dovrebbe essere la stessa, a parte 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 pagina | Proprietà | Descrizione | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------ | | url | L'URL di clic | | impression | L'URL di impressione | | image | L'immagine originale caricata per l'annuncio. | | optimum\_image | Se il creativo caricato è un GIF animato, questa è la versione MP4 ottimizzata creata per l'uso nell'annuncio. | | title | Titolo della notifica | | description | Descrizione della notifica | | horizontal\_position | Indica la posizione orizzontale nella pagina (sinistra, centro, destra) | | vertical\_position | Indica la posizione verticale nella pagina (alto, centro, basso) | | delay | Numero di secondi prima che la notifica appaia dopo il caricamento della pagina | | max\_notifications\_on\_page | Numero di notifiche che possono apparire sulla pagina contemporaneamente | | once\_closed\_hide\_for | Durata in secondi per cui l'annuncio rimane nascosto una volta chiuso (richiede il consenso ai cookie dell'utente) | | user\_session\_capping | Numero di volte che l'annuncio viene mostrato all'utente (richiede il consenso ai cookie dell'utente) | | delay\_between\_notifications | Numero di secondi prima che la notifica successiva appaia dopo il caricamento della precedente | ### Esempio di risposta per la notifica Push in pagina ```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":"Titolo", "description":"Questa è una descrizione", "impression":"https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA1VPW2rDQAy8Si+QZaSV9pH/XiBQ8O/au4bQ1glxKS7o8N24hFAJSTMwjCQG+wPigdIL8VH0iGAEJ+zgyIZhMCG73s7fbW3b5bqUz+aWD6OsAXiMSClnmOQkmdUUyTQhs3hL7JF8JCM1b3ikA3AX2uvbaa8ucAQyYYuMTVI339cbd+OOscGCjEpt9mNpY8hOITFyCKRQDxJYC5oDxbnyLNNUiu9b5lBmrZVGkXb3sfVnqeepfJ0vi2tbqau7Xab39XkaJ9qFzzz80R6wHZVuMpn9E8HUuHevOyHrz8wcYhHNtVSfRVklttxAOSTh6RdhQ+r1fQEAAA==", "optimum_image":"https://static.example.com/library/195600/0c9243bcbb139db5671a779366a98a08f678b2f1.webp", "horizontal_position":"right", "vertical_position":"top", "delay":0, "max_notifications_on_page":2, "once_closed_hide_for":10, "user_session_capping":0, "delay_between_notifications":10 } } ``` ## Multi-formato Una risposta a una richiesta Multi-Format potrebbe restituire risultati diversi: * Se l'annuncio vincente è una campagna Native, la risposta conterrà un [**oggetto dati Native standard.**](#native-ads) * Se l'annuncio vincente è una campagna Banner e hai un **Zona singola** nel layout, la risposta conterrà un [**oggetto dati Banner standard.**](#banner) * Se l'annuncio vincente è una campagna Banner e hai scelto un layout con **annunci multipli**, la risposta conterrà un **gruppo** oggetto con le seguenti proprietà: | Proprietà | Descrizione | | ----------- | ------------------------------------------------------------------------------ | | orientation | L'orientamento del layout Multi-Zone, che può essere "horizontal" o "vertical" | | ad\_items | Array contenente i dati dell'annuncio per ogni spazio nel layout. | Indipendentemente dal risultato, la proprietà **multizoneid** verrà aggiunta alla risposta, indicando l'ID della zona dell'area pubblicitaria multi-formato a cui questa risposta corrisponde. ### Esempio di risposta Multi-Format L'esempio seguente mostra l' **zone** oggetto per una zona pubblicitaria Multi-Format con un **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_E6FIYRkOjTYgSFUKjlPznkQx44RvDhEEYtCElrVAmGAKzmlFgsEV4QORNgSkVbReICBMQXLOLC3o.1p9BgiD8Dog6aBbJyHw.k01TarrGLb1tzxRvHmsM5Tsy5fx7WJ.dzsj1P6iHMqUA2NaR8_p1WqZO2N2Qfg4iFYG4KU.YOV33gxW2_dRqezFk8KXxfhb_GiJfL49vov58_o9hoALDfeS2czx_e8XOpAWlDK97RVq2RdiOTlWXqA6CEmSBg7l6hl71se1O8p7e3wA2CxptPbAQAA&cb=e2e_69495dc1259304.50721064", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW24CMQy8Si9ANLbjkPBd/qsiDpDdhRapsBKLgFY+fL3Lo40l27HHjzGDdUY8Y34hLCALLsbEIVOgjMAEW67eLJJdNs2+DqfNcfezCW2\/t6jERa2ARJIRhJGzqagQkimRzUvMLDBiTayaYGVubHCRyMyRdPwEAA6GrVevtly\/m8+eMz8MmwBXVu8z7WIlWnSfCuNKyFM7FLRCmxKFWkmxiw13iUqVFkKpOBx2kaH97PuvYVofNwmknD2tj4CJ0ykQm401ziXGUswfbErX4fvQmj3hMM3IznD0TO6xsfY\/5k\/oDgkjadc0YWFD2NeP4Xi+3XYa6Pw9MV6AYoSd63FXT7v+8Oxt266JaKo2XJ37tlHJrhO6bcp+HvwC8uORF98BAAA=&cb=e2e_69495dc1258be3.55680913", "image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg", "optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp", "width": 300, "height": 250, "media": "img_banner" }, "multizoneid": 67890 }, { "idzone": 12345, "type": "banner", "data": { "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA11Ry07DMBD8Gm5ptLt.xD5ygAsHkPgC13GaqHlUcdq0aD8eO0UFofFhNTP7tAGQZIChVNwuyyk.iecnek2vd2PdTHN0fSi7sVzaxO3deDhOx11_vp7n285PYz3tKAnMwFhpLVEZsLyG_eDiEubuK5R.GpiQSoMlGigJk5V0RUICsBJKIGhWiMwSmdhWqRawALiSStYMS3BFSGOykESUuiTdghcYrBTohZa13FOt0TrhQaC2KQ14FdG309THbQjYsK5r8eCLxBftMvTFMt.6pXDxVDRdH0Y3hExtUh0ad.4X3kpuswmhLYgcIUhpLef9K8k_esbdm65hSOkccfYzyYfK_PL58SfjF_SvCnAsB3eI82XbI_W5d.LNeyHi9zfW0hitq6bx6SahrpXz5AjznzifTvwNlJrwcuoBAAA-&cb=e2e_69495dc1259e91.21591992", "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01Q0U7DMBD7FX5gle8uuSY8wzvSxAe0WQtIjEkrYgP548mysRErp4vPTqwoNK5EV6p3gnvYvWaqaJekk4ROBXxcPzEID9O4HZbPaf\/2M3Vlt6W5WO\/MEDOnwBQpMVo0gTOKMAFBEyjqvVoAmHsqUWFBVYPEdujB5\/VD21KhNOCosRrb4+xD4yUrjoLU\/MgoJlMOJsU8bMKoG5c8WIGJ5yoHD7aU193ufWl5cUYn0bWO4x9Bq\/kzjKuTp4YPIWfWBbbxsHx\/FPIqB2NC0uinjnbhTt7\/mhvEbm2rS7cdXpb9V0sVeLGd\/+V6Cz3MmIupz9BxRF+8L5vZVQLmnH3+BX0inm26AQAA&cb=e2e_69495dc125a500.54289539", "image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg", "optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp", "width": 300, "height": 250, "media": "img_banner" }, "multizoneid": 67890 } ] } } ] } ``` ## Annunci display responsive Alcuni formati, come i banner e gli interstitial a pagina intera, possono abilitare [**Annunci display responsive**](/exoclick-docs/general-responsive-display-ads.md) di ricevere domanda dalle campagne Native Ads oltre alla domanda dai loro formati pubblicitari originali. In queste situazioni, la risposta conterrà il **original\_zone** oggetto che indica il tipo e i dati del formato originale. Ecco un esempio per un formato pubblicitario Banner: ```json { "zones": [ { "idzone": 5353142, "type": "native_ad", "data": { "layout": { "widgetHeaderContentHtml": "Offerto da <\/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": "Tutti i sistemi online \ud83d\udc68\u200d\ud83d\ude80", "description": "Punta alle stelle in questo nuovo gioco di simulazione spaziale.", "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 } } } ] } ``` ## Tracciamento delle impression Assicurati di effettuare una chiamata GET all'URL dell'impression per registrare le impressioni per le richieste del tuo annuncio. Un modo per farlo è creare un file immagine invisibile usando l'URL dell'impression come sorgente nella pagina in cui verrà visualizzato l'annuncio, ad esempio: ```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/it/api-di-posizionamento-annunci/risposta/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.