Zones de réponse

La réponse JSON de l'API de placement publicitaire contient les zones tableau et les moteurs de rendu et utilisateur objets.

Sur cette page, nous allons expliquer le zones tableau, qui contient tous les détails concernant l'annonce qui a remporté votre requête d'annonce.

Le tableau contient un objet avec les données de l'annonce pour chaque ID de zone demandé.

Propriété	Description
idzone	L'ID de la zone publicitaire.
type	Le format d'annonce utilisé, par ex. bannière.
données	Les données de l'annonce (objet)

Ci-dessous, vous trouverez une liste détaillée des propriétés renvoyées pour chaque données objet selon les formats publicitaires disponibles.

Bannière

Propriété	Description
url	L'URL vers laquelle l'annonce redirige.
impression	L'URL d'impression
image	L'image originale téléchargée pour l'annonce.
optimum_image	Si la création téléchargée est un GIF animé, il s'agit de sa version MP4 optimisée, créée pour être utilisée dans l'annonce.
width	La largeur de l'annonce en pixels.
height	La hauteur de l'annonce en pixels.
media	Cela indique quel type de bannière il s'agit : image, HTML ou vidéo : cela devrait être img_banner, html_banner ou video_banner, respectivement.

Exemples de réponse de bannière

Bannière image :

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

Bannière HTML :

{
    "zones": [
        {
            "idzone": 2222222,
            "type": "banner",
            "data": {
                "html": "\n<div id=\"example_id\">\nExemple d'annonce HTML !\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"
            }
        }
    ]
}

Bannière vidéo :

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

Bannière fixe

Propriété	Description
url	L'URL de clic
impression	L'URL d'impression
image	L'image originale téléchargée pour l'annonce.
optimum_image	Dans une bannière fixe, si la création téléchargée est un GIF animé, il s'agit de sa version MP4 optimisée, créée pour être utilisée dans l'annonce.
width	La largeur de l'annonce en pixels.
height	La hauteur de l'annonce en pixels.
frequency_period	À quelle fréquence, en minutes, l'annonce s'affiche.
v_pos	La position verticale de l'annonce.
h_pos	La position horizontale de l'annonce.
media	Cela indique quel type de bannière il s'agit : image, HTML ou vidéo : cela devrait être img_banner, html_banner, ou video_banner respectivement.

Exemple de réponse de bannière fixe

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

Messages instantanés

Propriété	Description
url	L'URL de clic
impression	L'URL d'impression
image	L'URL de l'image
optimum_image	Si la création téléchargée est un GIF animé, il s'agit de sa version MP4 optimisée, créée pour être utilisée dans l'annonce.
width	La largeur de l'annonce en pixels.
height	La hauteur de l'annonce en pixels.
frequency_period	À quelle fréquence l'annonce s'affiche, en minutes.
media	Cela indique quel type de bannière est utilisé : image, HTML ou vidéo : cela devrait être img_banner, html_banner, ou video_banner respectivement.

Exemple de réponse de message instantané

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

Annonces natives

Lorsque la réponse renvoie une annonce native, zones.data renverra deux objets : layout et ad_items

data.layout

Propriété	Description
widgetHeaderContentHtml	L'URL de la mention « Powered by » affichée.*
branding_logo	L'URL du logo de branding affiché si l'option est activée.*
branding_logo_hover	L'URL du logo de branding affiché lorsque l'utilisateur le survole.*
itemsPerRow	Le nombre d'annonces affichées sur chaque ligne du widget.
itemsPerCol	Le nombre d'annonces affichées dans chaque colonne du widget.
font_family	La famille de police utilisée dans l'annonce.
header_font_size	La taille de police utilisée dans l'en-tête de branding.
header_font_color	La couleur de police utilisée dans l'en-tête de branding.
widget_background_color	Le code hexadécimal de la couleur de fond utilisée pour le widget.
widget_width	La largeur de l'ensemble du widget.
minimum_width_for_full_sized_layout	La largeur minimale pour une mise en page pleine taille, en pixels.
item_height	La hauteur de chaque annonce individuelle.
item_padding	L'espacement entre chacune des annonces.
image_height	La hauteur de l'image dans chaque annonce.
image_width	La largeur de l'image dans chaque annonce.
text_margin_top	La taille, en pixels, de la marge supérieure du texte.
text_margin_bottom	La taille, en pixels, de la marge inférieure du texte.
text_margin_left	La taille, en pixels, de la marge gauche du texte.
text_margin_right	La taille, en pixels, de la marge droite du texte.
title_font_size	La taille de police du titre de chaque annonce.
title_font_color	La couleur de police du titre de chaque annonce.
title_font_weight	L'épaisseur de police du titre de chaque annonce.
title_decoration	Si le titre est souligné ou non.
title_hover_color	La couleur de police lorsque le titre est survolé.
title_hover_font_weight	L'épaisseur de police lorsque le titre est survolé.
title_hover_decoration	Si le titre est souligné au survol ou non.
description_font_size	La taille de police de la description de chaque annonce.
description_font_color	La couleur de police de la description de chaque annonce.
description_font_weight	L'épaisseur de police de la description de chaque annonce.
description_decoration	Si la description est soulignée ou non.
description_hover_color	La couleur de police lorsque la description est survolée.
description_hover_font_weight	L'épaisseur de police lorsque la description est survolée.
description_hover_decoration	Si la description est soulignée au survol ou non.
open_in_new_window	Si l'annonce doit s'ouvrir dans une nouvelle fenêtre lorsqu'elle est cliquée. 1=oui, 0=non.
mobile_responsive_type	Le type de réactivité lors de l'utilisation d'un appareil mobile (c.-à-d. aucun ou compact). 1=compact, 0=non.
header_is_on_top	Si le branding doit être affiché au-dessus ou en dessous des annonces. 1=oui, 0=non.
header_text_align	L'alignement horizontal de l'en-tête de branding.
title_enabled	Si le titre est activé ou non. 1=oui, 0=non.
description_enabled	Si la description est activée ou non. 1=oui, 0=non.
image_border_size	La taille, en pixels, de la bordure de l'image.
image_border_color	Le code hexadécimal de la couleur de la bordure de l'image.
text_align	L'alignement du texte : gauche, centré ou droite.
customcss_enabled	Si le CSS personnalisé est activé ou non. 1=oui, 0=non.
customcss	S'il est activé, le CSS personnalisé s'affichera ici.
header_enabled	Si l'en-tête est activé ou non. 1=oui, 0=non.
mobile_breakpoint	Le point de rupture, en pixels, entre les vues ordinateur et mobile de la zone publicitaire.
spacing_v	L'espacement vertical, en pixels, entre les annonces, défini dans les options avancées.
spacing_h	L'espacement horizontal, en pixels, entre les annonces, défini dans les options avancées.
zoom	Si l'annonce doit zoomer/dézoomer au survol.
mobile_rows	Le nombre de lignes d'annonces dans le widget mobile.
mobile_cols	Le nombre de colonnes d'annonces dans le widget mobile.
use_v2_script	Si la zone publicitaire a été créée avec la nouvelle configuration V2 ou l'ancienne v1.
text_enabled	Si le titre et la description du texte doivent être affichés. 1=oui, 0=non.
mobile_image_width	La largeur de l'image dans chaque annonce sur mobile.
mobile_text_box_size	La taille de la zone de texte sur mobile. Plage valide : 50-500.
mobile_text_enabled	Si le titre est activé ou non sur mobile. 1=oui, 0=non.
mobile_text_position	La position du texte sur mobile : en bas ou à droite.
item_spacing_on_each_side	L'espacement de chaque côté des annonces, s'ils ont été configurés à l'aide de l'ancienne configuration v1.
text_position	Si le texte est positionné à gauche ou à droite.
text_box_size	La taille de la zone de texte en pixels. Plage 50-500.
widget_height	La hauteur de l'ensemble du widget.
brand_enabled	Si le branding est activé ou non.
brand_font_size	La taille de police du branding.
brand_font_color	La couleur de police du branding.
brand_font_weight	L'épaisseur de police du branding.
brand_decoration	Si la police est soulignée ou non.
mobile_image_height	La hauteur de l'image dans chaque annonce sur mobile.
publisherAdType	Quel type d'annonce native il s'agit, c.-à-d. recommandation, sortie ou interstitielle : native-recommendation, native-interstitial.

data.ad_items

Propriété	Description
idvariation	L'ID de la variation.
image	L'image originale téléchargée pour l'annonce.
url	L'URL de clic.
impression	L'URL d'impression.
title	Le texte du titre de l'annonce.
description	Le texte de description de l'annonce.
brand	Le texte de marque de l'annonce.
original_url	L'URL d'origine de la page de destination.
image_position	La position de l'image de l'annonce (comment l'image sera recadrée).
size	La taille du format d'annonce sélectionné
iframe_url	Si un iframe est utilisé comme variation, ce sera l'URL de l'iframe.
video_thumb_id	L'identifiant de l'élément miniature vidéo (s'il est présent) associé à la création publicitaire.
video_thumb_url	L'URL de l'élément miniature vidéo (s'il est présent).
video_thumb_enabled	L'état de l'élément miniature vidéo (s'il est présent).

Exemple de réponse d'annonces natives

{
    "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": "aucun",
                    "open_in_new_window": 1,
                    "mobile_responsive_type": 1,
                    "header_is_on_top": 1,
                    "header_text_align": "droite",
                    "title_enabled": 1,
                    "description_enabled": 0,
                    "image_border_size": "",
                    "image_border_color": "",
                    "text_align": "gauche",
                    "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": "bas",
                    "item_spacing_on_each_side": "5px",
                    "text_position": "bas",
                    "text_box_size": "90px",
                    "widget_height": "570px",
                    "brand_enabled": "1",
                    "brand_font_size": "11px",
                    "brand_font_color": "#555555",
                    "brand_font_weight": "normal",
                    "brand_decoration": "aucun",
                    "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": "titre 5",
                        "description": "description 5",
                        "brand": "marque 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": "titre Native 3",
                        "description": "description Native 3",
                        "brand": "marque Native 3",
                        "original_url": "https://www.example.com/natives-3",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0nH364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==",
                        "title": "titre Native 2",
                        "description": "description Native 2",
                        "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": "titre 4",
                        "description": "description 4",
                        "brand": "marque 4",
                        "original_url": "https://www.example.com/natives-4",
                        "image_position": "50% 50%"
                    }
                ]
            }
        }
    ]
}

Vidéo Outstream

Propriété	Description
url	L'URL de clic
suivi	Un objet avec des informations de suivi.
vidéo	Le fichier d'annonce vidéo ou le lien VAST à charger.
brandingEnabled	Indicateur pour activer la marque. Cette valeur n'est actuellement pas utilisée
frequencyPeriod	À quelle fréquence, en minutes, l'annonce s'affiche.
maximumWidth	Taille de la largeur de la vidéo.
isVast	Indique si la campagne gagnante est une annonce vidéo standard (false) ou une campagne de lien VAST (true).
ctaEnabled	Indicateur pour afficher un CTA sur l'annonce
cta	Un objet contenant les détails du CTA
impression	L'URL d'impression

data.tracking

Pour le moment, l' data.tracking objet ne renvoie qu'un tableau de progression avec des objets destinés à suivre la lecture de la vidéo. Parmi ces objets, celui avec "offset": "00:00:10.000" est celui à appeler pour enregistrer la vue de la vidéo. Les propriétés de chaque objet sont expliquées ci-dessous :

Propriété	Description
offset	Marqueur de progression en secondes ou en pourcentage de la publicité vidéo lue
url	URL de suivi

data.cta

Propriété	Description
displayUrl	URL liée à la page de destination de l'annonce
text	Texte à utiliser dans l'élément CTA

Exemple de réponse vidéo 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": "Voir plus"
                }
            }
        }
    ]
}

Slider vidéo

Propriété	Description
url	L'URL de clic
suivi	Un objet avec des informations de suivi.
vidéo	Le fichier d'annonce vidéo ou le lien VAST à charger.
screenDensity	Entier indiquant la part de l'espace d'écran maximal occupée par l'annonce sur l'appareil de l'utilisateur
onComplete	Indique le comportement de l'annonce une fois la vidéo terminée. "hide" signifie que l'annonce doit être masquée, tandis que "repeat" signifie que l'annonce doit rester sur la page pour permettre à l'utilisateur de la rejouer
closeAfter	Indique le nombre de secondes nécessaires avant que le bouton de fermeture ne s'affiche sur l'annonce
brandingEnabled	Indicateur pour activer la marque. Cette propriété n'est actuellement pas utilisée
frequencyPeriod	À quelle fréquence, en minutes, l'annonce s'affiche.
impression	L'URL d'impression
isVast	Indique si la campagne gagnante est une annonce vidéo standard (false) ou une campagne de lien VAST (true).
ctaEnabled	Indicateur pour afficher un CTA sur l'annonce
cta	Un objet contenant les détails du CTA

data.tracking

Pour le moment, l' data.tracking objet ne renvoie qu'un tableau de progression avec des objets destinés à suivre la lecture de la vidéo. Parmi ces objets, celui avec "offset": "00:00:10.000" est celui à appeler pour enregistrer la vue de la vidéo. Les propriétés de chaque objet sont expliquées ci-dessous :

Propriété	Description
offset	Marqueur de progression en secondes ou en pourcentage de la publicité vidéo lue
url	URL de suivi

data.cta

Propriété	Description
displayUrl	URL liée à la page de destination de l'annonce
text	Texte à utiliser dans l'élément CTA

Exemple de réponse du Slider vidéo

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

Interstitiels plein écran

Propriété	Description
url	L'URL de clic
impression	L'URL d'impression
image	L'image originale téléchargée pour l'annonce.
optimum_image	Si la création téléchargée est un GIF animé, il s'agit de sa version MP4 optimisée, créée pour être utilisée dans l'annonce.
width	La largeur de l'annonce en pixels.
height	La hauteur de l'annonce en pixels.
frequency_count	Nombre de fois que l'annonce peut s'afficher
frequency_period	À quelle fréquence, en minutes, l'annonce s'affiche
frequency_trigger_type	Indicateur précisant si la fréquence de cette annonce est basée sur les impressions (0) ou sur les clics (1)
ad_trigger_method	Méthode de déclenchement activée pour cette zone d'annonce
ad_trigger_classes	Classes qui doivent déclencher l'annonce, le cas échéant
first_trigger_clicks	Nombre de clics nécessaires lors de la visite initiale de l'utilisateur pour déclencher l'annonce
next_trigger_clicks	Nombre de clics nécessaires après le premier déclenchement de l'annonce pour l'afficher à nouveau
chrome_enabled	Indicateur précisant si cette zone d'annonce est activée pour Chrome (1), désactivée (0) ou activée exclusivement pour ce navigateur (2)
capping_enabled	Indicateur précisant si le plafonnement doit être appliqué à cette zone d'annonce ou non
media	Cela indique quel type de bannière il s'agit : image, HTML ou vidéo : cela devrait être img_banner, html_banner ou video_banner, respectivement.

Remarque : la plupart des propriétés de la réponse Interstitiel plein écran sont liées au plafonnement et au déclenchement de l'annonce. Puisque c'est vous qui vous chargez du rendu de l'annonce, c'est à vous de décider si vous souhaitez ou non tenir compte de ces propriétés.

Exemple de réponse Interstitiel plein écran

Notez que, même si l'exemple montre un Interstitiel plein écran de bureau, la réponse pour un Interstitiel plein écran mobile devrait être identique, à l'exception de 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
            }
        }
    ]
}

Push intégré à la page

Propriété	Description
url	L'URL de clic
impression	L'URL d'impression
image	L'image originale téléchargée pour l'annonce.
optimum_image	Si la création téléchargée est un GIF animé, il s'agit de sa version MP4 optimisée, créée pour être utilisée dans l'annonce.
title	Titre de la notification
description	Description de la notification
position horizontale	Indique la position horizontale sur la page (gauche, centre, droite)
position verticale	Indique la position verticale sur la page (haut, milieu, bas)
délai	Nombre de secondes avant l'apparition de la notification après le chargement de la page
max_notifications_on_page	Nombre de notifications pouvant apparaître sur la page en même temps
once_closed_hide_for	Durée en secondes pendant laquelle l'annonce est masquée une fois fermée (nécessite le consentement aux cookies de l'utilisateur)
user_session_capping	Nombre de fois que l'annonce est affichée à l'utilisateur (nécessite le consentement aux cookies de l'utilisateur)
delay_between_notifications	Nombre de secondes avant l'apparition de la notification suivante après le chargement de la précédente

Exemple de réponse de notification Push intégrée à la page

{
  "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":"Titre",
    "description":"Ceci est une 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":"droite",
    "vertical_position":"haut",
    "delay":0,
    "max_notifications_on_page":2,
    "once_closed_hide_for":10,
    "user_session_capping":0,
    "delay_between_notifications":10
  }
}

Multi-format

Une réponse à une requête Multi-format peut renvoyer différents résultats :

• Si l'annonce gagnante est une campagne Native, la réponse contiendra un objet de données Native standard.
• Si l'annonce gagnante est une campagne bannière et que vous avez un Zone unique sur la mise en page, la réponse contiendra un objet de données bannière standard.
• Si l'annonce gagnante est une campagne bannière et que vous avez choisi une mise en page avec plusieurs annonces, la réponse contiendra un groupe objet avec les propriétés suivantes :

Propriété	Description
orientation	L'orientation de la mise en page multi-zone, qui peut être "horizontal" ou "vertical"
ad_items	Tableau contenant les données d'annonce pour chaque emplacement de la mise en page.

Quel que soit le résultat, la propriété multizoneid sera ajoutée à la réponse, indiquant l'ID de la zone d'annonce multi-format à laquelle cette réponse correspond.

Exemple de réponse Multi-format

L'exemple suivant montre l' zones objet pour une zone d'annonce Multi-format avec un Horizontal x 3 mise en page :

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

Annonces display responsives

Certains formats, comme les bannières et les interstitiels plein écran, peuvent activer Annonces display responsives pour recevoir de la demande des campagnes d'annonces natives en plus de la demande de leurs formats d'annonce d'origine. Dans ces situations, la réponse contiendra le original_zone objet indiquant le type et les données du format d'origine.

Voici un exemple pour un format d'annonce Bannière :

{
    "zones": [
        {
            "idzone": 5353142,
            "type": "native_ad",
            "data": {
                "layout": {
                    "widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https:\/\/www.exoclick.com\" rel=\"nofollow\">Propulsé par <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": "aucun",
                    "open_in_new_window": 1,
                    "mobile_responsive_type": 1,
                    "header_is_on_top": 1,
                    "header_text_align": "droite",
                    "title_enabled": 1,
                    "description_enabled": 1,
                    "image_border_size": "",
                    "image_border_color": "",
                    "text_align": "gauche",
                    "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": "bas",
                    "mobile_image_height": 450,
                    "delaySeconds": 0,
                    "frequency": 0,
                    "frequencyCount": 0,
                    "publisherAdType": "native-recommendation",
                    "adTriggerType": "",
                    "popTriggerMethod": "",
                    "popTriggerClasses": "",
                    "item_spacing_on_each_side": "5px",
                    "text_position": "bas",
                    "text_box_size": "90px",
                    "widget_height": "570px",
                    "brand_enabled": 0,
                    "brand_font_size": "11px",
                    "brand_font_color": "#555555",
                    "brand_font_weight": "normal",
                    "brand_decoration": "aucun"
                },
                "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": "Tous les systèmes sont en ligne \ud83d\udc68\u200d\ud83d\ude80",
                        "description": "Atteignez les étoiles dans ce nouveau jeu de simulation spatiale.",
                        "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
                }
            }
        }
    ]
}

Suivi des impressions

Assurez-vous d'effectuer un appel GET vers l'URL d'impression afin d'enregistrer les impressions de vos requêtes publicitaires. Une façon d'y parvenir consiste à créer un fichier image invisible en utilisant l'URL d'impression comme source sur la page où la publicité sera affichée, par exemple :

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