Annonces natives

Elles s'intègrent parfaitement au contenu et aux éléments graphiques environnants, ce qui les rend plus attractives pour les utilisateurs, qui sont plus susceptibles de cliquer dessus. L'inventaire d'annonces natives est disponible dans les applications mobiles, ainsi que sur les sites Web pour ordinateur et mobile. Pour en savoir plus sur les annonces natives, consultez la section Présentation des annonces natives.

Les annonces natives sont compatibles avec Authorized Buyers et Open Bidding.

Voici le workflow pour les annonces natives:

  1. Une demande d'annonce native est envoyée à Google. L'appel spécifie l'un des modèles d'annonces natives suivants, ou les deux, chacun spécifiant les champs natifs préférés.
  2. Google envoie aux acheteurs une demande d'enchère RTB contenant la liste des champs requis.
  3. Les acheteurs intéressés répondent en envoyant les informations demandées.
  4. Google lance une mise aux enchères afin de sélectionner l'enchère gagnante, puis envoie à l'éditeur les éléments de création fournis par l'acheteur.
  5. L'éditeur assemble les éléments pour créer une annonce native dont il adapte le style à l'aspect du site.

Formats des messages

Google est compatible avec la spécification OpenRTB au format JSON et Protobuf.

Pour les annonces natives OpenRTB Protobuf, les champs suivants diffèrent de la spécification:

JSON Type JSON Protobuf Type de Protocol Buffer utilisé
BidRequest.imp[].native.request string BidRequest.imp[].native.request_native NativeRequest
BidResponse.seatbid[].bid[].adm string BidResponse.seatbid[].bid[].adm_native NativeResponse

Les champs OpenRTB Protobuf sont des messages Protobuf plutôt que des chaînes.

Si vous utilisez l'implémentation OpenRTB Protobuf, votre point de terminaison reçoit des requêtes d'enchères contenant BidRequest.imp.native.request_native plutôt que BidRequest.imp.native.request. De plus, votre point de terminaison doit renvoyer des réponses aux enchères qui renseignent BidResponse.seatbid.bid.adm_native plutôt que BidResponse.seatbid.bid.adm, sinon il sera filtré de l'enchère.

Si vous utilisez un SDK acheteur pour afficher des annonces natives, vous devez inclure une image type dans declared_ad lorsque vous envoyez des créations pour examen.

Modèles d'annonces natives

Les modèles d'annonces natives décrivent les composants d'une annonce native et déterminent le contenu et la structure de NativeRequest OpenRTB ou de NativeAdTemplate du protocole Google RTB obsolète dans la requête d'enchère. Google est compatible avec les deux modèles d'annonces natives les plus courants pour les annonces natives non vidéo et vidéo:

Il existe d'autres modèles dont les exigences peuvent différer au niveau des champs, des variables et des tailles.

Modèle d'annonce incitant à installer une application

Les tableaux suivants présentent les champs marqués comme Obligatoire ou Recommandé. Les règles suivantes s'appliquent :

  • Les champs marqués comme Obligatoire sont obligatoires pour l'enchérisseur.
  • Les champs marqués comme Recommandés ne sont pas obligatoires pour l'enchérisseur. L'éditeur peut les afficher ou non s'ils sont fournis (par exemple, la note en étoiles).
  • L'incitation à l'action est toujours marquée comme Recommandée, car une valeur par défaut est attribuée si aucune n'est envoyée par l'enchérisseur, mais elle s'affiche toujours si elle est envoyée.

Le tableau suivant liste les champs d'un modèle d'annonce incitant à installer une application. Les applications mobiles utilisent ces champs pour créer des annonces natives incitant à installer une application.

Champ Description Obligatoire ou recommandé ? Toujours affiché ? Taille d'image recommandée/nombre maximal de caractères Exemple
Titre Titre de l'application Obligatoire Oui 25 caractères Flood-It!
Image Une capture d'écran de l'application ou une autre image pertinente Obligatoire Non 1 200 x 627 px ou 600 x 600 px,en fonction du format requis par l'éditeur. <Capture d'écran du jeu Flood-It!>
Corps Texte principal de l'application Obligatoire Non 90 caractères Derrière son apparente simplicité se cache un défi alléchant : un jeu addictif !
Icône de l'application L'icône de l'appli Obligatoire Non 128 x 128 px <Icône de l'application Flood-it!>
Incitation à l'action Action utilisateur préférée Recommandé Oui 15 caractères Installer
Note Nombre d'étoiles (0 à 5) représentant la note de l'application sur la plate-forme de téléchargement Recommandé Non 0 à 5 4.5
Prix Coût de l'application Recommandé Non 15 caractères Gratuit

Remarques sur la longueur du texte

Si un acheteur envoie un composant texte (corps du texte, par exemple) plus long que le nombre maximal de caractères suggéré, le texte peut être tronqué et ellipse par Google ou l'éditeur. Notez que les limites de troncation sont réduites de moitié pour le chinois, le japonais et le coréen. Par exemple, la limite applicable aux titres est de 90 caractères pour l'anglais et de 45 caractères pour le chinois.

Remarques concernant la taille des images

Les éditeurs sont autorisés à:

  • Recadrer l'image principale de manière symétrique jusqu'à 20% dans une dimension (hauteur ou largeur)
  • Redimensionnez l'image sans modifier ses proportions.
  • Les images dont les proportions sont sensiblement différentes de celles suggérées par la hauteur et la largeur peuvent être filtrées.

Modèle d'annonce de contenu

Le tableau suivant liste les champs d'un modèle d'annonce de contenu. Les éditeurs utilisent ces champs pour créer des annonces natives de contenu.

Champ Description Obligatoire ou recommandé ? Toujours affiché ? Taille d'image recommandée/nombre maximal de caractères * Exemple
Titre En-tête de l'annonce Obligatoire Oui 25 caractères Taux hypothécaires les plus bas
Image L'image principale de l'annonce Obligatoire Non 1 200 x 627 px ou 600 x 600 px,en fonction du format requis par l'éditeur. <Image principale de l'annonce>
Corps Le contenu de l'annonce Obligatoire Non 90 caractères Votre maison de rêve à Brooklyn, plus abordable et plus rapidement que vous ne le pensez !
Logo Logo de l'annonceur ou autre petite image pertinente Recommandé Non 128 x 128 px <Logo de NY Mortgage Inc.>
Incitation à l'action Action préférée de l'utilisateur Recommandé Non 15 caractères Demander un devis
Annonceur Texte permettant d'identifier l'annonceur ou la marque Obligatoire Non 25 caractères NY Mortgage Inc.

Modèle d'annonce vidéo incitant à installer une application

Champ Description Obligatoire ou recommandé ? Toujours affiché ? Taille d'image recommandée/Nombre maximal de caractères * Exemple
Vidéo Réponse vidéo VAST contenant tous les éléments nécessaires à la lecture d'une annonce vidéo Obligatoire Non - URL vers un fichier XML VAST contenant un Flood-It! Annonce vidéo
Titre Titre de l'application Obligatoire Oui 25 caractères Flood-It!
Image Image (vignette) affichée dans le lecteur avant qu'un internaute ne clique sur l'annonce vidéo ou pendant son chargement. Obligatoire Non Elle doit correspondre aux proportions de la vidéo (par exemple, 1 280 x 720 pour une vidéo au format 16:9, 4:3 pour une vidéo au format 640 x 480). Capture d'écran du jeu Flood-It! ou à partir de la vidéo ;
Corps Texte principal de l'application Obligatoire Non 90 caractères D'une simplicité trompeuse et d'une difficulté alléchante, ce jeu est délicieusement addictif !
Icône de l'application L'icône de l'appli Obligatoire Non 128 x 128 px Icône de l'application Flood-It!
Incitation à l'action Action utilisateur préférée Obligatoire Oui 15 caractères Installer
Note Nombre d'étoiles (entre 0 et 5) correspondant à la note de l'application sur la plate-forme de téléchargement Recommandé Non 0 à 5 4.5
Prix Coût de l'application Recommandé Non 15 caractères Gratuit

Restrictions

  • Vidéo: toutes les vidéos doivent se présenter sous la forme d'une URL VAST ou d'un tag VAST. Vous ne pouvez pas spécifier de fichier vidéo brut tel qu'un fichier WebM, MP4, etc.

  • Longueur du texte: si un acheteur spécifie un élément de texte tel que body dans la réponse, il peut être tronqué et remplacé par des points de suspension par Google ou l'éditeur. Notez que les limites de troncation sont réduites de moitié pour le chinois, le japonais et le coréen. Par exemple, la limite applicable aux titres est de 90 caractères pour l'anglais et de 45 caractères pour le chinois.

  • Taille des images: les éditeurs sont autorisés à:

    • Recadrer l'image principale de manière symétrique jusqu'à 20% dans une dimension (hauteur ou largeur)
    • Redimensionnez l'image sans modifier ses proportions.

Exemple d'annonce incitant à installer une application

vidéo native

Modèle d'annonce de contenu vidéo

Champ Description Obligatoire ou recommandé ? Toujours affiché ? Taille d'image recommandée/Nombre maximal de caractères * Exemple
Vidéo Réponse vidéo VAST contenant tous les éléments nécessaires à la lecture d'une annonce vidéo Obligatoire Oui - URL vers un fichier XML VAST contenant un Flood-It! Annonce vidéo
Titre En-tête de l'annonce Obligatoire Oui 25 caractères Taux hypothécaires les plus bas
Image Image (vignette) affichée dans le lecteur avant qu'un internaute ne clique sur l'annonce vidéo ou pendant son chargement. Obligatoire Non Elle doit correspondre aux proportions de la vidéo (par exemple, 1 280 x 720 pour une vidéo au format 16:9, 4:3 pour une vidéo au format 640 x 480). Capture d'écran de la vidéo
Corps Le contenu de l'annonce Obligatoire Non 90 caractères Votre maison de rêve à Brooklyn, plus abordable et plus rapidement que vous ne le pensez !
Logo Logo de l'annonceur ou autre petite image pertinente Recommandé Non 128 x 128 px Logo de NY Mortgage Inc.
Incitation à l'action Action préférée de l'utilisateur Obligatoire Non 15 caractères Demander un devis
Annonceur Texte permettant d'identifier l'annonceur ou la marque Obligatoire Non 25 caractères NY Mortgage Inc.

Champs méta

Les métachamps suivants sont partagés par tous les modèles d'annonces compatibles:

Protocole Google RTB Équivalent OpenRTB Description
NativeAd.click_link_url Link.url URL appelée par le navigateur lorsque l'utilisateur clique sur l'annonce. Peut être la première étape d'une chaîne de redirection qui mène finalement à la page de destination. Pour les annonces natives, nous vous recommandons d'utiliser click_link_url comme champ pour définir la destination vers laquelle l'utilisateur sera redirigé. Il est obligatoire d'utiliser ce champ dans le cas des pages de destination dynamiques.
Ad.click_through_url Bid.adomain

Doit être défini si l'enchérisseur a l'intention de définir une enchère. Il s'agit de l'ensemble des URL de destination de l'extrait, y compris les URL vers lesquelles l'utilisateur sera redirigé s'il clique sur l'annonce affichée et toutes les URL visibles dans l'annonce affichée. N'incluez pas d'appels intermédiaires à l'adserver sans rapport avec la page de destination finale. Une réponse d'enchère qui renvoie un extrait ou une annonce vidéo, mais qui déclare qu'aucun click_through_url ne sera utilisé, sera supprimée. Ne définissez ce champ que si html_snippet, video_url ou native_ad sont définis. Ces données sont utilisées comme déclaration d'URL de destination, par exemple pour le post-filtrage des URL bloquées par l'éditeur ou la catégorisation des annonces. Reportez-vous à NativeAd.click_link_url lorsque vous utilisez des annonces natives.

Pour les annonces non natives, il n'est pas utilisé pour le suivi des clics ni pour toute autre fonctionnalité d'annonce. Il sert uniquement à déclarer une URL de destination.

Pour les annonces natives, si NativeAd.click_link_url n'est pas défini, la première valeur de click_through_url est utilisée pour rediriger l'utilisateur vers la page de destination. De plus, toutes les valeurs sont utilisées comme déclarations d'URL de destination (comme dans le cas non natif).
NativeAd.click_tracking_urls Link.clicktrackers Facultatif. URL supplémentaires permettant aux annonceurs de suivre les clics des utilisateurs sur l'annonce.
Ad.ad_choices_destination_url BidExt.ad_choices_destination_url Lien vers une page de préférences publicitaires ou de désactivation. Si elle est présente, une icône standard Choisir sa pub est ajoutée à la création native et associée à cette URL. Cette fonctionnalité est compatible avec les annonces natives, mais ne fait pas partie du message natif dans la réponse à l'enchère.
Ad.impression_tracking_url NativeResponse.imptrackers L'impression native doit être suivie avec impression_tracking_url dans le protocole d'enchères en temps réel Authorized Buyers ou avec des outils de suivi des impressions natives dans OpenRTB.

required_fields et recommended_fields sont spécifiés par l'éditeur. Nous vous expliquons comment traduire ces champs de bits pour déterminer si un champ est obligatoire ou recommandé.

Un champ de bits utilise chaque bit d'une valeur binaire pour stocker une instruction "true" ou "false", ce qui équivaut à envoyer de nombreux signaux booléens tels que is_logo_required ou is_header_required, mais tous regroupés.

Exemple

Pour cet exemple, nous utiliserons une valeur required_fields de 1085.

Commencez par trouver la valeur binaire équivalente : 10000111101

Une fois que vous avez la valeur binaire, vous pouvez vérifier les bits pour voir si un champ est obligatoire (1) ou non (0).

Le tableau suivant met en correspondance les champs avec leur emplacement dans la valeur binaire. Lisez le binaire de droite à gauche, le bit 1 correspondant à la position la plus à droite de la valeur binaire.

Champ Emplacement des valeurs binaires (de droite à gauche)
HEADLINE 1
BODY 2
CALL_TO_ACTION 4
ADVERTISER 8
IMAGE 16
LOGO 32
APP_ICON 64
STAR_RATING 128
PRICE 256
STORE 512
VIDEO 1024

En examinant l'exemple de valeur binaire 10000111101, le bit 1 (le plus à droite) est 1, ce qui signifie qu'il s'agit d'une valeur requise. Selon le tableau, le bit 1 correspond à HEADLINE.

Les deux bits (deuxième valeur à droite) sont 0, ce qui signifie qu'ils ne sont pas obligatoires. Le 2-bit correspond à BODY.

Voici tous les champs obligatoires interprétés dans notre exemple:

Valeur Description Obligatoire ?
1 VIDEO Oui
0 STORE Non
0 PRICE Non
0 STAR_RATING Non
0 APP_ICON Non
1 LOGO Oui
1 IMAGE Oui
1 ADVERTISER Oui
1 CALL_TO_ACTION Oui
0 BODY Non
1 HEADLINE Oui

Représentation du modèle d'annonce native dans la demande d'enchère

Lorsqu'une demande d'enchère contenant un inventaire natif est reçue, elle contient le modèle d'annonce native sous différentes formes en fonction du protocole utilisé. Nous vous recommandons d'utiliser OpenRTB, car le protocole Google est obsolète.

Dans OpenRTB, le modèle d'annonce native est décrit avec le message NativeRequest. Dans le protocole Google RTB, il est décrit avec NativeAdTemplate. Ces messages fournissent les informations suivantes sur l'inventaire d'annonces natives:

  • Champs obligatoires ou recommandés.
  • Dimensions des images, des logos et des icônes d'application
  • Spécifications du style de l'annonce.

ID des éléments OpenRTB

OpenRTB transmet un tableau d'assets dans la requête d'enchère qui décrit la structure de l'annonce native que vous devez renvoyer dans la réponse. Chaque composant de la requête doit comporter un ID qui doit être spécifié pour le composant correspondant dans la réponse. Pour voir comment ces ID correspondent entre la requête et la réponse, consultez l'exemple de demande d'enchères natives et l'exemple de réponse aux enchères natives.

Représentation d'une annonce native dans la réponse à l'enchère

Lorsqu'il définit des enchères sur un inventaire natif, un acheteur doit renseigner les champs obligatoires identifiés dans la demande d'enchère. Dans OpenRTB, vous pouvez le faire avec BidResponse.seatbid.bid.adm_native lorsque vous utilisez Protobuf, ou BidResponse.seatbid.bid.adm pour JSON. Pour le protocole Google obsolète, cela se fait avec le champ BidResponse.ad.native_ad.

Exemples de demandes d'enchères

Demandes d'enchères non vidéo

OpenRTB ProtobufOpenRTB JSONGoogle
Requête sérialisée
id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 5
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}
 
{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}
Demande sérialisée
id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 1200
    image_height: 627
    style_id: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Demandes d'enchères vidéo

{
  id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
  ip: "\0338\355",
  google_user_id: "CAESEJ1ur2l94_8ruuu",
  cookie_version: 1,
  cookie_age_seconds: 5184000,
  hosted_match_data: "W9ABDAAAAGR67nl0",
  user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
  publisher_country: "IN",
  geo_criteria_id: 1007796,
  timezone_offset: 330,
  publisher_id: "pub-2230723027927371",
  seller_network_id: 989,
  url: "https://m.example.com",
  detected_language: [en],
  google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
  auction_type: "SECOND_PRICE",
  device: {
    device_type: "HIGHEND_PHONE",
    platform: "android",
    brand: "coolpad",
    model: "cp8298_i00",
    os_version: {
      major: 5,
      minor: 1
    },
    carrier_id: 70210,
    screen_width: 360,
    screen_height: 640,
    screen_pixel_ratio_millis: 2000
  },
  mobile: {
    is_app: false,
    is_mobile_web_optimized: true,
    DEPRECATED_platform: "android",
    DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
    DEPRECATED_brand: "coolpad",
    DEPRECATED_model: "cp8298_i00",
    DEPRECATED_os_version: {
      os_version_major: 5,
      os_version_minor: 1
    },
    DEPRECATED_screen_width: 360,
    DEPRECATED_screen_height: 640,
    DEPRECATED_carrier_id: 70210,
    DEPRECATED_device_pixel_ratio_millis: 2000
  },
  publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
  adslot: [{
    id: 1,
    ad_block_key: 2882274820,
    width:   [300,250],
    height:   [250,250],
    excluded_attribute:   [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
    allowed_vendor_type:   [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
    excluded_sensitive_category:   [36,27,19,4,23,30,10,3,31,5,8,37,18],
    excluded_product_category:   [10031,11669,13423,13525,13566,13589,13612,13740],
    excluded_creatives:   [{
      buyer_creative_id: "1234567.1234567890-ssl"
    }],
    matching_ad_data:   [{
      billing_id:     [6629616415,51386650457],
      minimum_cpm_micros: 1380000,
      direct_deal:     [{
        direct_deal_id: 410401,
        fixed_cpm_micros: 1360000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      },{
        direct_deal_id: 240644,
        fixed_cpm_micros: 1500000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      }]
    },{
      billing_id:     [1234567890],
      minimum_cpm_micros: 1380000
    }],
    publisher_settings_list_id:   [12109930661871909476,11138951146123409010],
    slot_visibility: "BELOW_THE_FOLD",
    viewability: 30,
    click_through_rate: 0.0010072842,
    iframing_state: "UNKNOWN_IFRAME_STATE",
    native_ad_template:   [{
      required_fields: 1065,
      recommended_fields: 4,
      headline_max_safe_length: 25,
      body_max_safe_length: 90,
      call_to_action_max_safe_length: 15,
      advertiser_max_safe_length: 25,
      logo_width: 100,
      logo_height: 100,
      style_id: 199892,
      style_height: 250,
      style_width: 300
    }],
    sticky_settings: {

    },
    renderer: "GOOGLE",
    is_amp_page: "DIALECT_HTML",
    amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
    allowed_ad_types:   [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
    session_depth: 1,
    internal_data: {

    }
  }],
  response_deadline_ms: 122,
  is_test: false
}

Exemples de réponses aux enchères

Réponses aux enchères non vidéo

OpenRTB ProtobufOpenRTB JSONGoogle
Réponse sérialisée
id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"
 
{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}
Réponse sérialisée
ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254 225"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

Réponses aux enchères vidéo

bid_response {
  ad {
    ...
    click_through_url: "https://www.exampleDomain.com"
    impression_tracking_url: "https://my_impression_tracking_url.com/"
    ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
    ...
    native_ad {
      headline: "Lowest mortgage rates"
      video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
      call_to_action: "Get a quote"
      advertiser: "NY Mortgage Inc."
      image {
        url: "https://www.example.net/mypromoimage.png"
        width: 1200
        height: 700
      }
      logo {
        url: "https://www.example.net/mylogo.png"
        width: 200
        height: 200
      }
      click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
      click_tracking_urls: "https://my_click_tracking_url.com/"
    }
  }
}