Skip to main content

Zones de réponse

La réponse JSON de l'API Placement publicitaire contient le tableau zones et les objets renderers et user.

Dans cette page, nous expliquerons le tableau zones, qui contient tous les détails concernant la publicité qui a remporté votre requête.

Le tableau contient un objet contenant des données publicitaires pour chaque identifiant de zone demandé.

PropriétéDescription
idzoneL'ID de la zone publicitaire.
typeLe format publicitaire utilisé, par exemple banner.
donnéesLes données publicitaires (Objet)

Vous trouverez ci-dessous une liste détaillée des propriétés renvoyées pour chaque objet data en fonction des formats publicitaires disponibles.

Bannière​

PropriétéDescription
urlL'URL vers laquelle l'annonce renvoie.
impressionL'URL de l'impression
imageL'image originale téléchargée pour l'annonce.
image_optimaleSi la création téléchargée est un GIF animé, il s'agit de la version MP4 optimisée qui est créée pour être utilisée dans la publicité.
largeurLa largeur de l'annonce en pixels.
hauteurLa hauteur de l'annonce en pixels.
médiasCeci indique de quel type de bannière il s'agit : Image, HTML ou vidéo : Il s'agit respectivement de img_banner, html_banner ou video_banner.

Exemples de réponses aux bannières​

Image Banner:

{
    "zones": [
        {
            "idzone": 1111111,
            "type": "banner",
            "data": {
                "url": "http://main.example.com/click.php?data=H4sIAAAAAAAAAyVOu04DMRD8lTRprX14bW9JQ0PBN6xzPlGAgCToQJqPx7nTTrGa0TxOyELNnKCJuWX3yqpVBW_3.9ftrE9neZ7Yti3FekuXzw8ABHBhKmoujuUa33H9O0RJ3JJkSmxALs3YJUNrqbkYjNpkGQKWmWIFUKJfMQI_UqMvY20_jukTVOZVuXr3EcrlYqNXW6lHjl6G1t3T32PiGEbzTtjp46Y7F27Hp1ltHz.JXZ31j96M1xdQzRbNJbxE1EJhbfWL8bLQCBvyD4rI3QwpAQAA",
                "impression": "http://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAzVPS05DMQy8Chdo5PEnn+5YsGCL4ADJa7ICIYqQiuTD4z5ax9HEI2fGZmIcCAfoA7Wj8ZGac0JNrJRg/vz66Ao/nftXP/9+p+3zw3NRLbhDVZFcXErU2dyoujJVa+Saq6GxOtjZLTt5EBxAiUiAqq0ViBRhB5E/vb3sF47EDMQvIbqwUVDXUVBrQraUEzRkw+oqdiHv4zRX/WlegCUobbTZBXmzOYotGl37yFNKCJGP9x65L0P/J4nlcHW+Ex4imsPh9hYV8wjynYnY98Gte81yosm2lswFmW2jPBsv07YQw/0B+rSsfmgBAAA=",
                "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
                "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
                "width": 300,
                "height": 250,
                "media": "img_banner"
            }
        }
    ]
}

Bannière HTML:

{
    "zones": [
        {
            "idzone": 2222222,
            "type": "banner",
            "data": {
                "html": "\n<div id=\"example_id\">\nExample HTML Ad!\n</div>\n",
                "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAAz1OW2oDMQy8Si8Qo7Fky8p3+18IPYDteqGwJYGkkA8dvt7dUj1AjGY0ihRxIpwgL2Rn4XMiR0khRg0REsDF3y7vTn4b69f9tv7cw+PqauxJPGWPouIgN1h2jazFET1uK3I2cGZLc6RApMmN/OPyujdmxikpzwkCuw1KCcgp5ACRqZqnnZ5T7QosDLVmozJyT6NpWqhVqS0P1o3oba2zQr9+b46Hq8hh9Ac4M2cjHDMAY/YZ5DsyY//8n11qtiy0LJU/e2Xl0a3FUqlq70q/g8aBP0ABAAA=",
                "width": 300,
                "height": 250,
                "media": "html_banner"
            }
        }
    ]
}

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 adhésive​

PropriétéDescription
urlL'URL du clic
impressionL'URL de l'impression
imageL'image originale téléchargée pour l'annonce.
image_optimaleDans une bannière adhésive, si la création téléchargée est un GIF animé, il s'agit de la version MP4 optimisée qui est créée pour être utilisée dans la publicité.
largeurLa largeur de l'annonce en pixels.
hauteurLa hauteur de l'annonce en pixels.
fréquence_périodeFréquence en minutes de l'affichage de la publicité.
v_posLa position verticale de l'annonce.
h_posLa position horizontale de l'annonce.
médiasCeci indique de quel type de bannière il s'agit : Image, HTML, ou vidéo : Il s'agit respectivement de img_banner, html_banner, ou video_banner.

Exemple de réponse à une bannière autocollante​

{
    "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
urlL'URL du clic
impressionL'URL de l'impression
imageL'URL de l'image
image_optimaleSi la création téléchargée est un GIF animé, il s'agit de la version MP4 optimisée qui est créée pour être utilisée dans la publicité.
largeurLa largeur de l'annonce en pixels.
hauteurLa hauteur de l'annonce en pixels.
fréquence_périodeFréquence d'affichage de la publicité en minutes.
médiasCeci indique le type de bannière utilisé : Image, HTML, ou vidéo : Il s'agit respectivement de img_banner, html_banner, ou video_banner.

Exemple de réponse à un 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"
           }
       }
   ]
}

Publicité native​

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

data.layout

PropriétéDescription
widgetHeaderContentHtmlL'URL de la marque "Powered by" qui apparaît.*
branding_logoL'URL du logo de la marque qui s'affiche s'il est activé
branding_logo_hoverL'URL du logo de la marque qui s'affiche lorsque l'utilisateur le survole.*
itemsPerRowLe nombre de publicités qui s'affichent dans chaque ligne du widget.
itemsPerColLe nombre de publicités qui s'affichent dans chaque colonne du widget.
famille_de_policesLa famille de polices utilisée dans l'annonce.
taille_de_l'en-têteLa taille de la police utilisée dans l'en-tête de la marque.
header_font_colorLa couleur de la police utilisée dans l'en-tête de la marque.
couleur de fond du widgetLe code hexadécimal de la couleur d'arrière-plan utilisée pour le widget.
largeur_du_widgetLa largeur de l'ensemble du widget.
largeur_minimale_pour_la_mise_en_place_complèteLa largeur minimale pour une mise en page de taille normale, en pixels.
hauteur de l'articleLa hauteur de chaque annonce individuelle.
item_paddingL'espace entre chaque annonce.
hauteur_de_l'imageLa hauteur de l'image dans chaque annonce.
largeur_de_l'imageLa largeur de l'image dans chaque annonce.
texte_marge_hautTaille en pixels de la marge supérieure du texte.
marge_du_texte_basTaille en pixels de la marge inférieure du texte.
margedu_texteà_gaucheTaille en pixels de la marge gauche du texte.
marge_texte_droiteTaille en pixels de la marge droite du texte.
taille_du_titreLa taille de la police du titre de chaque annonce.
title_font_colorLa couleur de la police du titre de chaque annonce.
title_font_weightLe poids de la police du titre de chaque annonce.
titre_décorationSi le titre est souligné ou non.
title_hover_colorCouleur de la police lorsque le titre est survolé.
title_hover_font_weightPoids de la police lorsque le titre est survolé.
titre_hover_decorationSi le titre est souligné au survol ou non.
description_font_sizeLa taille de la police de la description de chaque annonce.
description_font_colorLa couleur de la police de la description de chaque annonce.
description_font_weightLe poids de la police de la description pour chaque annonce.
description_décorationSi la description est soulignée ou non.
description_hover_colorCouleur de la police lorsque la description est survolée.
description_hover_font_weightPoids de la police lorsque la description est survolée.
description_hover_decorationSi la description est soulignée au survol ou non.
ouvrir_dans_une_nouvelle_fenêtreIndique si l'annonce doit être ouverte dans une nouvelle fenêtre lorsque l'on clique dessus. 1=oui, 0=non.
mobile_responsive_typeLe type de réactivité lors de l'utilisation d'un appareil mobile (c.-à-d. aucune ou compacte). 1=compact, 0=non.
header_is_on_topIndique si l'image de marque doit être affichée au-dessus ou au-dessous des annonces. 1=oui, 0=non.
alignement_du_texte_de_l'en-têteL'alignement horizontal de l'en-tête de la marque.
titre_activéIndique si le titre est activé ou non. 1=oui, 0=non.
description_activéeIndique si la description est activée ou non. 1=oui, 0=non.
image_border_sizeTaille en pixels de la bordure de l'image.
image_border_colorLa couleur du code hexadécimal de la bordure de l'image.
alignement_du_texteL'alignement du texte : gauche, centre ou droite.
customcss_enabledPermet d'activer ou non les css personnalisés. 1=oui, 0=non.
customcssSi cette option est activée, le code CSS personnalisé s'affichera ici.
activée_en-têteIndique si l'en-tête est activé ou non. 1=oui, 0=non.
point de rupture mobileLe point de rupture, en pixels, entre les vues desktop et mobile de la zone publicitaire.
espace_vL'espacement vertical en pixels entre les annonces, défini dans les options avancées.
espacement_hL'espacement horizontal en pixels entre les annonces, défini dans les options avancées.
zoomSi l'annonce doit être agrandie ou réduite au survol.
mobile_rowsLe nombre de lignes de publicités dans le widget mobile.
mobile_colsLe nombre de colonnes de publicités dans le widget mobile.
use_v2_scriptSi la zone de publicité a été créée avec la nouvelle configuration V2 ou l'ancienne v1.
texte_activéIndique si le titre et la description doivent être affichés. 1=oui, 0=non.
largeur_image_mobileLa largeur de l'image dans chaque annonce sur mobile.
taille_de_la_boîte_de_texte_mobileTaille de la zone de texte sur mobile. Plage de validité 50-500.
mobile_text_enabledIndique si le titre est activé ou non sur les téléphones portables. 1=oui, 0=non.
mobile_text_positionLa position du texte sur le mobile : en bas ou à droite.
espacementdeséléments_de_chaque_côtéLe remplissage de chaque côté des annonces, si elles ont été configurées avec l'ancienne configuration v1.
position_du_texteSi le texte est positionné à gauche ou à droite.
taille_de_la_boîte_de_texteTaille de la zone de texte en pixels. Plage de 50 à 500.
hauteur du widgetLa hauteur de l'ensemble du widget.
marque_activéeSi l'image de marque est activée ou non.
taille_de_la_marqueLa taille de la police de caractères de l'image de marque.
couleur_de_la_marqueLa couleur de la police de caractères de l'image de marque.
poids_de_la_marqueLe poids de la police de caractères de l'image de marque.
décoration_de_la_marqueSi la police est soulignée ou non.
hauteur_image_mobileLa hauteur de l'image dans chaque annonce sur mobile.
publisherAdTypeType de publicité native, c'est-à-dire recommandation, sortie ou interstitiel : native-recommendation, native-interstitiel.

data.ad_items

PropriétéDescription
imageL'image originale téléchargée pour l'annonce.
urlL'URL du clic
impressionL'URL de l'impression
titreLe texte du titre de l'annonce.
descriptionLe texte de description de l'annonce.
marqueLe texte de la marque de l'annonce.
original_urlL'url originale de la page d'atterrissage.
position de l'imageLa position de l'image publicitaire (comment l'image sera recadrée).

Exemple de réponse aux publicités 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": "none",
                    "open_in_new_window": 1,
                    "mobile_responsive_type": 1,
                    "header_is_on_top": 1,
                    "header_text_align": "right",
                    "title_enabled": 1,
                    "description_enabled": 0,
                    "image_border_size": "",
                    "image_border_color": "",
                    "text_align": "left",
                    "customcss_enabled": 0,
                    "customcss": null,
                    "header_enabled": 1,
                    "mobile_breakpoint": "450",
                    "spacing_v": "10",
                    "spacing_h": "10",
                    "zoom": "1",
                    "mobile_rows": "2",
                    "mobile_cols": "1",
                    "use_v2_script": "1",
                    "text_enabled": "1",
                    "mobile_image_width": "450",
                    "mobile_text_box_size": "90",
                    "mobile_text_enabled": "1",
                    "mobile_text_position": "bottom",
                    "item_spacing_on_each_side": "5px",
                    "text_position": "bottom",
                    "text_box_size": "90px",
                    "widget_height": "570px",
                    "brand_enabled": "1",
                    "brand_font_size": "11px",
                    "brand_font_color": "#555555",
                    "brand_font_weight": "normal",
                    "brand_decoration": "none",
                    "mobile_image_height": "450",
                    "publisherAdType": "native-recommendation"
                },
                "ad_items": [
                    {
                        "image": "https://static.example.com/library/432437/97567ec37c751bc909fc06c96920bb353efefe36.jpg",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OO27EMAxEr7LNljE0okhJZZo0KfYMkj9IgPwAG3GKOfxybSDgAJTI0RtdmBBzhhCBb9v2s17l.RpfXPu.D_Nfm9Zh_P70.1fb3n_n9UlJBhIGQGoQ47.LyHVw3gDRIUYjkwIlR2UKWjKUGopPQQ80xziI8CKiJMrDpb7NwCIO63VuAht17lmX0Ftq3WbJ_iKwfzTXkXuQLjzGZ8kjWeQ8hWj1.HUNp7WkoyXeXqmW0acQp0mWKdaUUaqUcTQbkaqlOziYDlsjAQAA",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OS04FMQy7CheYKs6nad8OxAlAHKDzW4FYsHmLHJ5M0ZOI00apLddMjIWwMD2R3cRvqAHvBewFYoW5xsvbcyjiuI/9p2zfX6HCKv4YzbU3CyVrDgujlmp2h4Qa0Jwt0lWCEnLJLN1yKYRwio/313mQYIq8rw9BRblQQXQKzUe6U4BFw4FTMuPajyGomx2r20nr0LHWIwNd5uvnyJ5paQLFpcrkHpArnkgs+FuIa48siklnNf0nH+JUR60bidjoKd+HbHLuO7bTvP0ChQRmKEsBAAA=",
                        "title": "title 5",
                        "description": "description 5",
                        "brand": "brand 5",
                        "original_url": "https://www.example.com/natives-5",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/d51084a3da98f857bca6ba19037cfe90b9a93c0b.jpg",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2OOW7EMAxFrzLNlBG4iFrKNGlS5AySR0ICZANsxCn.4UN7gIAEuH0.8oLIkjNVMOF1277Xqz5e5cl93_cwftttDcvXh9efbXv7GeuDAiCAEzNrJU34V4FzDc4LrBZEEhCNuWQyRLKS2WBUvMtQBzjGQWA3sGiEHirzaWae6rBeR1NOi42ebVJvsfU0NPsGob839_PuSboAciaH6XFZ9Z6RpHp.XekuLfEMES_PsCEcS7ZOc6HU6pR0mxIlVuNcUvsDR8DGSCMBAAA-",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01OSU4EMQz8Ch/oqLzFydxAvADEA9I96ROIA5c5+PHj7gEJV+Ko7FKlGEwLaGE8wS7iF6pB3guxFxIrzDVe3p5DKeZtXH/K9v0VKqzif09z7c1CYc3JwtBSze7ooUbUHBbpKoGEHDJLtyQFFI74eH89LyUYkf34kFCUCwpFR2gOcUMQi4YT7ZIZ1z6HUN1srm471qFjrTMDHebr58hzpsUJKi6Vg3/pI0vGE4mFHgRce2QhznVW03/yMU3nbjW7wfu8trHtuk3kZBuT7xcrT8hLAQAA",
                        "title": "Native 3 title",
                        "description": "Native 3 description",
                        "brand": "Native 3 brand",
                        "original_url": "https://www.example.com/natives-3",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/59bb52f508ef418172a4809481e24a5ec01d9cfb.png",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2QOW7EMAxFrzLNlBG4iJJZppkmRc4gjWUkQDbARpziHz4cTxCQALV8vk_whMxSK1Uw4WXbvtazPp7lErnvexo_bV7T9fM97h9te_0e64MAIIALM6uTFvyrwNVT8BKrJZECZGOeKjEy2VTZYDTFK0MDEJgAgSPAohl6U1n8VuZFA9Z9NOVytdGrLdRbbr0MjWmjs7.1yMP3IJ0QVPoLvTmr3k8kxY.pne7SKR8l4_kJ5CLmOhp5pnmm1od1iZUs7p06_QJgI9fDIwEAAA--",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA02OTU7EMAyFr8IFGj3/xensQJwAxAGSTroCsWAzCx9+3DJI2Ikjx0/PH4NpAS2MJ9hF/EI1yNdC7IXECnONl7fnUIp569efsn1/hQqr+N/TXNdmobDmZGFoqWZ3pMKImoMiXSWQKYfM0i2bkgNHfLy/njdVwYisx0JCUS4oFCtC8xM3BLFoONEuyTjW2YXqZnO47Rhd+6gzgQ7z8dnznLQ4k4pLpQcFHiyJJxIL/TbgukYG4hxnNP0n364sUKu1XQeq7juSgm3qgK29zzv4Hxr/SwEAAA==",
                        "title": "Native 2 title",
                        "description": "Native 2 description",
                        "brand": "Native 12 bran",
                        "original_url": "https://www.example.com/natives-2",
                        "image_position": "50% 50%"
                    },
                    {
                        "image": "https://static.example.com/library/432437/d32054c6f9c66c2853bff50b00578b15e0739875.jpg",
                        "url": "https://main.example.com/click.php?data=H4sIAAAAAAAAAz2Ou27GIAyFX.Vf_rHIxgbC2KVLhz4DEFAr9SYlajqch69JpApL.HL8Hd.g7FNiBuN137.3uzze_ZPFcRyu_5Z1c.3rw.rPsr_99O1BARDAkZklk0T8q8ApO8M5luC8j4AG5mXSlYL9AYEW6zLEAIYxEKY12ItCpirY1DaGGKzmXoRjC72mMKgWLTV2SbZBqO_F4vQ9STcDn8l8Mp1Frox8zOfVmS7pcgkVL89IK8fcZHQdSyfxWe2MtjYRP1RT_gOkVnReIgEAAA--",
                        "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01PSU4EMQz8Ch/oqLy103MD8QIQD0i6MycQBy5z8ONxGs0IV+LETqlcYTAtoIXxBLuIX2gN8q0QeyGxwrzGy9tzKMW4teOn7N9focIqfj+q61YtFFadLAw12exOFGpEdV5SVQIJmTRLtSwKQOGIj/fXcyctGJF5TiQU5YJCsSE0m7ghiEUjBa+SJvs2mtC62+huV/Smra8jHU31/tlynXZxgorLuqUSHpDpTyQW+ivASchAnM8Z9T99wIh1b2PHcbhxFwEN4UbjmD/+BS14KDZMAQAA",
                        "title": "title 4",
                        "description": "description 4",
                        "brand": "brand 4",
                        "original_url": "https://www.example.com/natives-4",
                        "image_position": "50% 50%"
                    }
                ]
            }
        }
    ]
}

Vidéo Outstream​

PropriétéDescription
urlL'URL du clic
suiviUn objet avec des informations de suivi.
vidéoLe fichier de la publicité vidéo ou le lien VAST à charger.
brandingEnabledIndicateur permettant d'activer le marquage. **Cette valeur n'est pas utilisée pour l'instant
fréquencePériodeFréquence en minutes de l'affichage de la publicité.
largeur maximaleTaille de la largeur de la vidéo.
estVasteIndique si la campagne gagnante est une publicité vidéo ordinaire (faux) ou une campagne de liens VAST (vrai).
ctaEnabledDrapeau pour afficher un CTA sur l'annonce
ctaUn objet contenant les détails de l'OTC
impressionL'URL de l'impression

data.tracking

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

PropriétéDescription
compensationMarqueur de progression en secondes ou en pourcentage de la publicité vidéo diffusée
urlURL de suivi

data.cta

PropriétéDescription
uRL d'affichageURL liée à la page d'atterrissage de l'annonce
texteTexte à utiliser dans l'élément CTA

Exemple de réponse vidéo en flux sortant​

{
    "zones": [
        {
            "idzone": 12345,
            "type": "outstream_video",
            "data": {
                "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA11S246bMBD9mrwl0fiKeexVkXabRc2SXeWlMsYkaA02YDct8sfXZFfbqhqwRjPHx2cuGc8YyWiEePHeTSvyYYW_pu96vW6ntj8b3Zh29FtluxQ1sq9TMHnd6DEAWZGvYdxI124a7dVlc2l9W6_IZz8GvcLcOyU7d4sophBtQG.kEGhDK4k3VYazDdWVYoJyqQSkG1OoilCZdrroMd1ihDGBaUoo06oXL88paMe62Be7ar_bV_e7Yn.XKdsfy.PxaYbQddMwDL31dXG6L54PDJUwD6f.MYSpvuNHGIe7E2P8NPRlWR7JAR5sZ5wLIWVPMLrnQzD1twXo.gqVjzibD2x.msvTzH5zhp5IVVaPWDJMDsGaYJDtSHC2Q3Z02EGPxy7MFhnbjYmT7T_W.nzZ3u.GXQ4IxOBcdXp.6P2rmtf3FheZuv42oWM59w_m_2QSk1z1VPwoXtyX7_zyQ7H5JeMNM_vw6DuhbZP0QAjOk6Gnrp87P1Hj.8nZ3tLE3vWjVTv8YZO6.SmNRbbnPnUze9uAtAIo4zwhGUPxqqtOTl6P7ayX4UeM8FagLRKwxShBUcZYaoGIbyOKDKEYKYo45lnighjRYjmGX6lqiJoRLDQCiQQiEktQkom8JjXOlBQ5REIxxhSxSCAHRZDOKUGKcFrTCtcc5ZIoIIjniRbilUzqYq2ZbuqSoCQQi4gzwJzGtL7rd8Q6IdYX35m1H3.3fi0nt25ao3vZ6SV0S9W6kcH4eCNfjBDCcyCLh4DSPI9Li9ITb_nFxDs6qV5KFhlPmCW4_DF.ORT_wP8aeW0RbIEtBwB6Z5q2nTxP489bXWkscQG8skHk8SfG8eEuNlQ3NMd5zasMNUwJIYBIBVLRnNMc_QHDw8Gc2AMAAA--&cb=e2e_6949260fe161c8.72624884",
                "tracking": {
                    "progress": [
                        {
                            "offset": "00:00:10.000",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=00%3A00%3A10.000&idzone=12345...."
                        },
                        {
                            "offset": "25%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=25%25&idzone=12345...."
                        },
                        {
                            "offset": "50%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=50%25&idzone=12345...."
                        },
                        {
                            "offset": "75%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=75%25&idzone=12345...."
                        },
                        {
                            "offset": "100%",
                            "url": "https:\/\/s.example.com\/vregister.php?a=vview&tracking_event=progress&progress=100%25&idzone=12345...."
                        }
                    ]
                },
                "video": "https:\/\/u3y8v8u4.aucdn.net\/library\/940460\/8f1ab6fd40cb27cba71db1229c250d6bce1f8b68.mp4",
                "brandingEnabled": 0,
                "frequencyPeriod": 60,
                "maximumWidth": 1000,
                "impression": "https:\/\/s.example.com\/vregister.php?a=vimp&tracking_event=impression&t=api&idzone=12345....",
                "isVast": false,
                "ctaEnabled": 1,
                "cta": {
                    "displayUrl": "singleflirt.com",
                    "text": "View More"
                }
            }
        }
    ]
}

Slider vidéo​

PropriétéDescription
urlL'URL du clic
suiviUn objet avec des informations de suivi.
vidéoLe fichier de la publicité vidéo ou le lien VAST à charger.
densité de l'écranEntier indiquant la part de l'espace d'écran maximum occupé par la publicité sur l'appareil de l'utilisateur
onComplete"cacher" signifie que la publicité doit être masquée, tandis que "répéter" signifie que la publicité doit rester sur la page pour permettre à l'utilisateur de la rejouer
closeAfterIndique le nombre de secondes nécessaires avant que le bouton de fermeture ne s'affiche sur l'annonce
brandingEnabledDrapeau pour activer le marquage. **Cette propriété n'est actuellement pas utilisée
fréquencePériodeFréquence en minutes de l'affichage de la publicité.
impressionL'URL de l'impression
estVasteIndique si la campagne gagnante est une publicité vidéo ordinaire (faux) ou une campagne de liens VAST (vrai).
ctaEnabledDrapeau pour afficher un CTA sur l'annonce
ctaUn objet contenant les détails de l'OTC

data.tracking

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

PropriétéDescription
compensationMarqueur de progression en secondes ou en pourcentage de la publicité vidéo diffusée
urlURL de suivi

data.cta

PropriétéDescription
uRL d'affichageURL liée à la page d'atterrissage de l'annonce
texteTexte à utiliser dans l'élément CTA

Exemple de réponse pour un 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": "Watch Free"
                }
            }
        }
    ]
}

Interstitiels Fullpage​

PropriétéDescription
urlL'URL du clic
impressionL'URL de l'impression
imageL'image originale téléchargée pour l'annonce.
image_optimaleSi la création téléchargée est un GIF animé, il s'agit de la version MP4 optimisée qui est créée pour être utilisée dans la publicité.
largeurLa largeur de l'annonce en pixels.
hauteurLa hauteur de l'annonce en pixels.
fréquence_countCombien de fois l'annonce peut-elle être diffusée ?
fréquence_périodeFréquence en minutes de l'affichage de l'annonce
type_de_déclenchement_de_la_fréquenceDrapeau indiquant si la fréquence de cette annonce est basée sur les impressions (0) ou les clics (1)
ad_trigger_methodMéthode de déclenchement activée pour cette zone publicitaire
ad_trigger_classesClasses qui doivent déclencher l'annonce, le cas échéant
premiers_déclenchements_clicsNombre de clics nécessaires lors de la première visite de l'utilisateur pour déclencher la publicité
prochains_déclenchements_clicsNombre de clics nécessaires après le premier déclenchement de l'annonce pour que celle-ci soit à nouveau affichée
chrome_enabledDrapeau indiquant si cette zone publicitaire est activée pour Chrome (1), désactivée (0) ou activée exclusivement pour ce navigateur (2)
capping_enabledDrapeau indiquant si le plafonnement doit être appliqué à cette zone publicitaire ou non
médiasCeci indique de quel type de bannière il s'agit : Image, HTML ou vidéo : Il s'agit respectivement de img_banner, html_banner ou video_banner.

Note: la plupart des propriétés de la réponse interstitielle de Fullpage sont liées au plafonnement et au déclenchement de l'annonce. Comme vous êtes responsable du rendu de l'annonce, c'est à vous de décider si vous voulez prêter attention à ces propriétés ou non.

Exemple de réponse interstitielle en pleine page​

Notez que, bien que l'exemple montre un interstitiel de page complète de bureau, la réponse pour un interstitiel de page complète de mobile devrait être la même, à part le type de zone.


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

Poussée dans les pages (In-Page Push)​

Propriété.Description
urlL'URL du clic
impressionL'URL de l'impression
imageL'image originale téléchargée pour l'annonce.
image_optimaleSi la création téléchargée est un GIF animé, il s'agit de la version MP4 optimisée qui est créée pour être utilisée dans la publicité.
titreTitre de la notification
descriptionDescription de la notification
position_horizontaleIndique la position horizontale sur la page (gauche, centre, droite)
position_verticaleIndique la position verticale sur la page (haut, milieu, bas)
retardNombre de secondes avant l'apparition de la notification après le chargement de la page
max_notifications_on_pageNombre de notifications pouvant apparaître simultanément sur la page
une fois_fermée_cachée_pourDurée en secondes pendant laquelle la publicité est masquée une fois fermée (nécessite l'accord de l'utilisateur pour le cookie)
user_session_cappingNombre de fois que l'annonce est montrée à l'utilisateur (nécessite l'accord de l'utilisateur pour les cookies)
délai_entre_les_notificationsNombre de secondes avant que la notification suivante n'apparaisse après le chargement de la précédente

Exemple de réponse à une notification push dans une 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":"Title",
    "description":"This is a description",
    "impression":"https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA1VPW2rDQAy8Si+QZaSV9pH/XiBQ8O/au4bQ1glxKS7o8N24hFAJSTMwjCQG+wPigdIL8VH0iGAEJ+zgyIZhMCG73s7fbW3b5bqUz+aWD6OsAXiMSClnmOQkmdUUyTQhs3hL7JF8JCM1b3ikA3AX2uvbaa8ucAQyYYuMTVI339cbd+OOscGCjEpt9mNpY8hOITFyCKRQDxJYC5oDxbnyLNNUiu9b5lBmrZVGkXb3sfVnqeepfJ0vi2tbqau7Xab39XkaJ9qFzzz80R6wHZVuMpn9E8HUuHevOyHrz8wcYhHNtVSfRVklttxAOSTh6RdhQ+r1fQEAAA==",
    "optimum_image":"https://static.example.com/library/195600/0c9243bcbb139db5671a779366a98a08f678b2f1.webp",
    "horizontal_position":"right",
    "vertical_position":"top",
    "delay":0,
    "max_notifications_on_page":2,
    "once_closed_hide_for":10,
    "user_session_capping":0,
    "delay_between_notifications":10
  }
}

Multi-Format​

Une réponse à une demande multiformat peut renvoyer des résultats différents :

  • Si la publicité gagnante est une campagne native, la réponse contiendra un objet de données natif régulier
  • Si la publicité gagnante est une campagne de bannières et que vous avez une Zone unique sur la mise en page, la réponse contiendra un objet de données de bannière ordinaire
  • Si la publicité gagnante est une campagne de bannières et que vous avez choisi une mise en page avec plusieurs publicités, la réponse contiendra un objet group avec les propriétés suivantes :
PropriétéDescription
l'orientationL'orientation de la présentation multizone, qui peut être "horizontale" ou "verticale".
ad_itemsTableau contenant les données publicitaires 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'identifiant de la zone de publicité multiformat à laquelle cette réponse correspond.

Exemple de réponse multiformat​

L'exemple suivant montre l'objet zones pour une zone publicitaire multiformat avec une mise en page horizontale x 3 :

{
    "zones": [
        {
            "group": {
                "orientation": "horizontal",
                "ad_items": [
                    {
                        "idzone": 12345,
                        "type": "banner",
                        "data": {
                            "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01RTU_DMAz9NbtVlT.SNDlygAsHkPgFaZuySS2dmrAO5B9PEtCGHFmW37P97HROWSISlGNK53jghwM95RfTuoU2puCX87qHLYztsC4ZEAHBzhiF2oKTPfSLz7Tt9B0KQwiptdiihZYwU0kbUg6saNaMYEQjiigUEtflXiAMcCWdqcUcwRXBggirrCtPybiDgTE4xTiwUaPqaTToPA_AaFwuA9k5Dsd1nWMVAdX2fW9u.Sbnm2Na5iZtX6fU.HhuptMcPvwSSqpCY5j855yktqzamI0DLhGCUs5J3R9I_gjFVPX5HDYvWyIpBfkS5hcvzUQe317_1dyNim8B8O7xNj.2i3.P26VupaRMb6m2K4WX_HEvz2J0D9xZNyF7oyftstYRhr7TTo3QjT9DY7Q.5AEAAA--&cb=e2e_69495dc1258023.87481108",
                            "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW27CMBC8Si+ANftw4u13+a+KOEBiQotUiEQQ0GoPXzu0FI9ke3dnH7MMjgviBfMT4RnyzOZMHBIFSghM8OXq1ZX8MvT7bjoNx933EPK4d43EFt1AIo0ThJGSR4lCaDwSeWuamNmJY8NqSG6ts6NAtASUYjUCULjw9erFl+s3L63bmnV72AW4coTTPErpxK7FIGNcCWkuB0MWGkyFsjS60Z43DVknGUKNFTr8IlP+GMfPaR4fNwTStlaLfw6XIscgvqg5RYuqmZcDn8Pd9HXI7nc6PCakorD+XH59NfeR848HzfebZj58CvvufTqeb\/udm4a6r7oFUoWfu+OuO+3Gw72898rgzcDWgIX6bAOGNmZpt9SzbOMPcuXp2OIBAAA=&cb=e2e_69495dc1258be3.55680913",
                            "image": "http://example.com/library/328752/47de5c021bd0d00b59ff78456c69f601baac9925.gif",
                            "optimum_image": "http://example.com/library/328752/c990e4df40cc46482927c08350b2c960a59679e5.mp4",
                            "width": 300,
                            "height": 250,
                            "media": "img_banner",
                        },
                        "multizoneid": 67890
                    },
                    {
                        "idzone": 12345,
                        "type": "banner",
                        "data": {
                            "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA01Ry07DMBD8mt4iax.2Ex85wIUDSHyBk7i0UkKrODQF7cezdlFBa9mr2dnZh9tgO2IQMCiHdT3nHT_s6EnPtm0mjUuKczbDaVZEBARb7y26DoJsqZ9jXtNy_E6FIYRkOjTYgSFUKjlPznkQx44RvDhEEYtCElrVAmGAKzmlFgsEV4QORNgSkVbReICBMQXLOLC3o.1p9BgiD8Dog6aBbJyHw.k01TarrGLb1tzxRvHmsM5Tsy5fx7WJ.dzsj1P6iHMqUA2NaR8_p1WqZO2N2Qfg4iFYG4KU.YOV33gxW2_dRqezFk8KXxfhb_GiJfL49vov58_o9hoALDfeS2czx_e8XOpAWlDK97RVq2RdiOTlWXqA6CEmSBg7l6hl71se1O8p7e3wA2CxptPbAQAA&cb=e2e_69495dc1259304.50721064",
                            "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01QW24CMQy8Si9ANLbjkPBd/qsiDpDdhRapsBKLgFY+fL3Lo40l27HHjzGDdUY8Y34hLCALLsbEIVOgjMAEW67eLJJdNs2+DqfNcfezCW2\/t6jERa2ARJIRhJGzqagQkimRzUvMLDBiTayaYGVubHCRyMyRdPwEAA6GrVevtly\/m8+eMz8MmwBXVu8z7WIlWnSfCuNKyFM7FLRCmxKFWkmxiw13iUqVFkKpOBx2kaH97PuvYVofNwmknD2tj4CJ0ykQm401ziXGUswfbErX4fvQmj3hMM3IznD0TO6xsfY\/5k\/oDgkjadc0YWFD2NeP4Xi+3XYa6Pw9MV6AYoSd63FXT7v+8Oxt266JaKo2XJ37tlHJrhO6bcp+HvwC8uORF98BAAA=&cb=e2e_69495dc1259ad5.34119103",
                            "image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
                            "optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
                            "width": 300,
                            "height": 250,
                            "media": "img_banner"
                        },
                        "multizoneid": 67890
                    },
                    {
                        "idzone": 12345,
                        "type": "banner",
                        "data": {
                            "url": "https://syndication.example.com/click.php?d=H4sIAAAAAAAAA11Ry07DMBD8Gm5ptLt.xD5ygAsHkPgC13GaqHlUcdq0aD8eO0UFofFhNTP7tAGQZIChVNwuyyk.iecnek2vd2PdTHN0fSi7sVzaxO3deDhOx11_vp7n285PYz3tKAnMwFhpLVEZsLyG_eDiEubuK5R.GpiQSoMlGigJk5V0RUICsBJKIGhWiMwSmdhWqRawALiSStYMS3BFSGOykESUuiTdghcYrBTohZa13FOt0TrhQaC2KQ14FdG309THbQjYsK5r8eCLxBftMvTFMt.6pXDxVDRdH0Y3hExtUh0ad.4X3kpuswmhLYgcIUhpLef9K8k_esbdm65hSOkccfYzyYfK_PL58SfjF_SvCnAsB3eI82XbI_W5d.LNeyHi9zfW0hitq6bx6SahrpXz5AjznzifTvwNlJrwcuoBAAA-&cb=e2e_69495dc1259e91.21591992",
                            "impression": "https://syndication.example.com/cimp.php?t=api&data=H4sIAAAAAAAAA01Q0U7DMBD7FX5gle8uuSY8wzvSxAe0WQtIjEkrYgP548mysRErp4vPTqwoNK5EV6p3gnvYvWaqaJekk4ROBXxcPzEID9O4HZbPaf\/2M3Vlt6W5WO\/MEDOnwBQpMVo0gTOKMAFBEyjqvVoAmHsqUWFBVYPEdujB5\/VD21KhNOCosRrb4+xD4yUrjoLU\/MgoJlMOJsU8bMKoG5c8WIGJ5yoHD7aU193ufWl5cUYn0bWO4x9Bq\/kzjKuTp4YPIWfWBbbxsHx\/FPIqB2NC0uinjnbhTt7\/mhvEbm2rS7cdXpb9V0sVeLGd\/+V6Cz3MmIupz9BxRF+8L5vZVQLmnH3+BX0inm26AQAA&cb=e2e_69495dc125a500.54289539",
                            "image": "https://example.com/library/451295/ca73592afb53e581f294bf7298e8ffb5f8da4c9f.jpg",
                            "optimum_image": "https://example.com/library/451295/51d30fc0dfe338ef5c05314ad9f6778c1bd6016f.webp",
                            "width": 300,
                            "height": 250,
                            "media": "img_banner"
                        },
                        "multizoneid": 67890
                    }
                ]
            }
        }
    ]
}

Annonces d'affichage réactives​

Certains formats, comme les bannières et les interstitiels Fullpage, peuvent permettre aux Responsive Display Ads de recevoir la demande des campagnes Native Ads en plus de la demande de leurs formats publicitaires d'origine. Dans ce cas, la réponse contiendra l'objet original_zone indiquant le type et les données du format original.

Voici un exemple de bannière publicitaire :


{
    "zones": [
        {
            "idzone": 5353142,
            "type": "native_ad",
            "data": {
                "layout": {
                    "widgetHeaderContentHtml": "<a target=\"_blank\" href=\"https:\/\/www.exoclick.com\" rel=\"nofollow\">Powered By <span><\/span><\/a>",
                    "branding_logo": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo.png",
                    "branding_logo_hover": "\/\/s3t3d2y1.afcdn.net\/widget-branding-logo-hover.png",
                    "itemsPerRow": 1,
                    "itemsPerCol": 1,
                    "font_family": "Arial, Helvetica, Verdana, sans-serif",
                    "header_font_size": "12px",
                    "header_font_color": "#999999",
                    "widget_background_color": "transparent",
                    "widget_width": "450px",
                    "minimum_width_for_full_sized_layout": "450px",
                    "item_height": "300px",
                    "item_padding": "10px",
                    "image_height": "450px",
                    "image_width": "450px",
                    "text_margin_top": "3px",
                    "text_margin_bottom": "3px",
                    "text_margin_left": "0px",
                    "text_margin_right": "0px",
                    "title_font_size": "16px",
                    "title_font_color": "#000000",
                    "title_font_weight": "normal",
                    "title_decoration": "none",
                    "title_hover_color": "#0000FF",
                    "title_hover_font_weight": "normal",
                    "title_hover_decoration": "none",
                    "description_font_size": "14px",
                    "description_font_color": "#555555",
                    "description_font_weight": "normal",
                    "description_decoration": "none",
                    "description_hover_color": "#0055FF",
                    "description_hover_font_weight": "normal",
                    "description_hover_decoration": "none",
                    "open_in_new_window": 1,
                    "mobile_responsive_type": 1,
                    "header_is_on_top": 1,
                    "header_text_align": "right",
                    "title_enabled": 1,
                    "description_enabled": 1,
                    "image_border_size": "",
                    "image_border_color": "",
                    "text_align": "left",
                    "customcss_enabled": 1,
                    "customcss": "{\n    width: 300px !important;\n    height: 250px !important;\n}\n.exo-native-widget-header {\n    display: none !important;\n}\n.exo-native-widget-item-container {\n    width: 300px !important;\n    height: 250px !important;\n    max-width: 300px !important;\n    padding-right: 0 !important;\n    padding-bottom: 0 !important;\n}\n.exo-native-widget-item-image-wrapper { \n    width: 300px !important;\n    height: 250px !important;\n    max-height: 250px !important;\n    overflow: hidden !important;\n}\n.exo-native-widget-item-content-box {\n    position: relative !important;\n}\n.exo-native-widget-item-content {\n    position: absolute !important;\n    z-index: 5 !important;\n    top: 180px !important;\n    background-color: white !important;\n    opacity: 0.7 !important;\n    height: auto !important;\n    max-height: 110px !important;\n    min-height: 70px !important;\n    width: 100% !important;\n    max-width: 300px !important;\n}\n.exo-native-widget-item-title {\n    padding: 10px 8px 4px 8px !important;\n    height: 20px !important;\n    color: black !important;\n    font-weight: 900 !important;\n    font-size: 18px !important;\n    display: flex !important;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    white-space: normal !important;\n}\n.exo-native-widget-item-text {\n    padding: 20px 8px 4px 8px !important;\n    height: 20px !important;\n    color: grey !important;\n    font-weight: normal !important;\n    font-size: 13px !important;\n    display: flex !important;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    white-space: normal !important;\n}\n.exo-native-widget-item-brand {\n    padding: 5px 8px 0px 8px !important;\n    height: 20px !important;\n    font-weight: normal !important;\n    font-size: 18px !important;\n    display: none !important;\n    align-items: center;\n    justify-content: center;\n    text-align: center;\n    white-space: normal !important;\n}",
                    "header_enabled": 1,
                    "mobile_breakpoint": 450,
                    "spacing_v": 10,
                    "spacing_h": 10,
                    "zoom": 1,
                    "mobile_rows": 1,
                    "mobile_cols": 1,
                    "use_v2_script": 1,
                    "text_enabled": 1,
                    "mobile_image_width": 450,
                    "mobile_text_box_size": 90,
                    "mobile_text_enabled": 1,
                    "mobile_text_position": "bottom",
                    "mobile_image_height": 450,
                    "delaySeconds": 0,
                    "frequency": 0,
                    "frequencyCount": 0,
                    "publisherAdType": "native-recommendation",
                    "adTriggerType": "",
                    "popTriggerMethod": "",
                    "popTriggerClasses": "",
                    "item_spacing_on_each_side": "5px",
                    "text_position": "bottom",
                    "text_box_size": "90px",
                    "widget_height": "570px",
                    "brand_enabled": 0,
                    "brand_font_size": "11px",
                    "brand_font_color": "#555555",
                    "brand_font_weight": "normal",
                    "brand_decoration": "none"
                },
                "ad_items": [
                    {
                        "image": "https:\/\/s.example.net\/library\/451295\/4c5353dfe10c9e8ea12b05cc44eb0c6cafbc6100.jpg",
                        "url": "https:\/\/s.example.com\/click.php?d=H4sIAAAAAAAAA01RwW7DIAz9mt4iZBuHwnGH7rLDJvUDJkJIWylZqpA16.SPH6Cpmx4YYz.eMZi93rMzYhS0cl7Xa9rppx095zHOXXdX88lPURUzzMspqjBPORfT..GYVxEQ3BvDaJFQtthNPq1xuXxXphCSsqjQgiLMVCDDYBmk1a1GJmkRRRiFxO2zFohggSP4QrB5q5mIGFvR4CBojI41Bm245456g87rABqNy8dANp3CeZ7HVKtDxbZtzSPe5HhzXqexWZf7ZW18ujbDZYwfucESqqk.Dv5zXKVKFmitjQNdPARm56Q2DiS_hALOs.Xq5tuWVggNCFGhlq0cjm__.H8oDFCQf6DYzFX4KJ3U5E9pudWGWErh_JRVLsui3LL.64tQ77kbnOfWDtH2vQeLjgM548MQYvgB99zVE.gBAAA-&cb=e2e_694966c98c6cc2.67060117",
                        "optimum_image": "https:\/\/s3t3d2y1.afcdn.net\/library\/451295\/15c408293013fe9637290dbc36ec5a3fbd671c48.webp",
                        "title": "All systems online \ud83d\udc68\u200d\ud83d\ude80",
                        "description": "Reach for the stars in this new space simulation game.",
                        "brand": "ogame.com",
                        "original_url": "https:\/\/lobby.ogame.gameforge.com\/es_ES\/",
                        "image_position": "50% 50%",
                        "format": "native_ad",
                        "size": "300x300",
                        "iframe_url": "",
                        "impression": "https:\/\/s.example.com\/cimp.php?t=api&data=H4sIAAAAAAAAA01QW04DMQy8ChfoymM72Q3f9B9R9QC7aXhIlEpdRAHN4Um2tJCRbDlje2yraFhBV6o3kFvXWwEV2g3oMEinEK4393TwVKb9OL+X48t36fJhTw\/QFJgEZpEQUxkGBgsGVwaAsbfeU+M0ugwuTD2VUmGuqo7Qgk4kSmAv3G7uuN4+sIr3qhenJJYpWiN6DZBUPiHD0kmSZENJbsgWfeeT7iLSaFkMMdV04cnm\/Hw4vM7L5HJGB8Q6HMPlg1Y3SWJctRqDuKfE+oQLPc5fb5m8pgc\/O1q12hZrdX\/8f2D4XTUsFk1+SRfO3X58mo8f56suevXwrebMX3uyFMEoKT5OZZzyVC9gIfa7WDBZHqfwA7sG\/xjOAQAA&cb=e2e_694966c98c7af4.92854754",
                        "count_only_viewed_impressions": 0,
                        "video_thumb_id": null,
                        "video_thumb_url": null,
                        "video_thumb_enabled": 0
                    }
                ]
            },
            "original_zone": {
                "type": "banner",
                "data": {
                    "width": 300,
                    "height": 250
                }
            }
        }
    ]
}

Suivi des impressions​

Veillez à effectuer un appel GET pour l'URL d'impression afin d'enregistrer les impressions pour vos demandes d'annonces. Pour ce faire, vous pouvez créer un fichier image invisible en utilisant l'URL de l'impression comme source sur la page où l'annonce sera affichée, par exemple

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