Annonces natives

Les annonces natives sont mises en forme pour s'adapter au contenu et à l'aspect visuels environnants, ce qui augmente les chances que les utilisateurs les voient et cliquent dessus. L'inventaire d'annonces natives est disponible dans les applications mobiles, ainsi que sur les sites Web mobiles et pour ordinateur. Pour en savoir plus sur les annonces natives, consultez 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 annonce native est appelée auprès de Google. L'appel spécifie l'un des modèles d'annonces natives ou les deux ci-dessous, chacun spécifiant ses champs natifs préférés.
2. Google envoie aux acheteurs une demande d'enchère RTB contenant une liste des champs demandés.
3. Les acheteurs intéressés répondent en fournissant les champs demandés.
4. Google lance une mise aux enchères pour sélectionner l'enchère gagnante, puis envoie à l'éditeur les assets de création fournis par l'acheteur.
5. L'éditeur assemble les assets dans une annonce native et les met en forme pour les adapter au style du site.

Formats des messages

Google accepte la spécification OpenRTB à la fois dans JSON et dans Protobuf.

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

Spécification JSON (PROTOCOL_OPENRTB_2_4)	Type JSON	Implémentation OpenRTB (PROTOCOL_OPENRTB_PROTOBUF_2_4)	Type OpenRTB
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 sont des messages Protobuf et non des chaînes.

Si vous utilisez l'implémentation du protocole OpenRTB, vous ne recevrez pas BidRequest.imp[].native.request et devrez répondre avec BidResponse.seatbid[].bid[].adm_native. Les réponses aux enchères avec BidResponse.seatbid[].bid[].adm sont filtrées. Les ID d'élément ne sont pas nécessaires pour les réponses aux enchères Protobuf OpenRTB.

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

Modèles d'annonces natives

Google accepte les deux modèles d'annonces natives les plus courants pour les annonces natives non vidéo et vidéo:

• Modèle d'annonce incitant à installer une application : permet de promouvoir et de générer des installations d'application mobile.
• Modèle d'annonce de contenu : combinaison plus générique de texte et d'images pour les annonces axées sur la marque ou le Web.
• Modèle d'annonce vidéo incitant à installer une application
• Modèle d'annonce de contenu vidéo

Il existe d'autres modèles, et ils peuvent présenter des exigences différentes en termes de champs, de dimensions et de tailles.

Modèle d'annonce incitant à installer une application

Champs obligatoires et recommandés

Les tableaux ci-dessous présentent les champs obligatoires ou recommandés. Les règles suivantes s'appliquent :

• Les champs marqués comme Obligatoires sont obligatoires pour l'enchérisseur.
• Les champs marqués comme Recommandé ne sont pas obligatoires pour l'enchérisseur. L'éditeur peut ou non les afficher s'ils en fournissent (par exemple, une note).
• L'incitation à l'action est toujours marquée comme Recommended (Recommandé), car une valeur par défaut est attribuée si une incitation à l'action n'est pas envoyée par l'enchérisseur, mais elle sera toujours affichée le cas échéant.

Le tableau suivant répertorie 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!>
Body	Texte principal de l'application	Obligatoire	Non	90 caractères	Simplement simple, mais aussi stimulant = 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 souhaitée de l'utilisateur	Recommandé	Oui	15 caractères	Installer
Star rating [Note]	Nombre d'étoiles (0 à 5) représentant la note de l'application sur la plate-forme de téléchargement d'applications	Recommandé	Non	0 – 5	4.5
Prix	Le coût de l'application	Recommandé	Non	15 caractères	Sans frais

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 recadré par Google ou l'éditeur. Notez que les limites de troncation sont de moitié de taille en chinois, en coréen et en japonais. Par exemple, la limite de titres est de 90 pour l'anglais et de 45 pour le chinois.

Remarques sur la taille des images

Les éditeurs sont autorisés à:

• Recadrez l'image principale de façon symétrique jusqu'à 20% dans une seule dimension (hauteur ou largeur).
• Permet de mettre l'image à l'échelle sans modifier ses proportions.
• Les images dont les proportions sont très différentes de celles impliquées par la hauteur et la largeur peuvent être filtrées.

Modèle d'annonce du réseau de contenu

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

Champ	Description	Obligatoire ou recommandé ?	Toujours affiché ?	Taille d'image recommandée/nombre maximal de caractères*	Exemple
Titre	En-tête d'annonce	Obligatoire	Oui	25 caractères	Taux de prêt 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>
Body	Le contenu de l'annonce	Obligatoire	Non	90 caractères	Votre maison à Brooklyn : moins chère et plus vite que vous ne le pensez !
Logo	Logo de l'annonceur ou toute 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 VAST vidéo contenant tous les éléments nécessaires à la lecture d'une annonce vidéo.	Obligatoire	Non	-	Une URL vers un fichier XML VAST contenant une image 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 un clic sur l'annonce vidéo ou pendant son chargement.	Obligatoire	Non	Elle doit correspondre au format de la vidéo (par exemple, 1 280 x 720 pour une vidéo au format 16:9, 4:3 pour une vidéo en 640 x 480).	Capture d'écran du jeu Flood-It! Ou à partir de la vidéo
Body	Texte principal de l'application	Obligatoire	Non	90 caractères	Simplement simple, mais aussi stimulant = 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 souhaitée de l'utilisateur	Obligatoire	Oui	15 caractères	Installer
Star rating [Note]	Nombre d'étoiles (0 à 5) représentant la note de l'application sur la plate-forme de téléchargement d'applications	Recommandé	Non	0 – 5	4.5
Prix	Le coût de l'application	Recommandé	Non	15 caractères	Sans frais

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 un fichier vidéo brut (WebM, MP4, etc.).

• Longueur du texte: si un acheteur spécifie un élément texte tel que body dans la réponse, il peut être tronqué et sélectionné par l'éditeur ou par Google. Notez que les limites de troncation sont deux fois moins réduites en chinois, en coréen et en japonais. Par exemple, le nombre maximal de titres est 90 en anglais et 45 en chinois.

• Taille de l'image: les éditeurs sont autorisés à:

  • Recadrez l'image principale de façon symétrique jusqu'à 20% dans une seule dimension (hauteur ou largeur).
  • Permet de mettre l'image à l'échelle sans modifier ses proportions.

Exemple d'annonce incitant à installer une application

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 VAST vidéo contenant tous les éléments nécessaires à la lecture d'une annonce vidéo.	Obligatoire	Oui	-	Une URL vers un fichier XML VAST contenant une image Flood-It! annonce vidéo
Titre	En-tête d'annonce	Obligatoire	Oui	25 caractères	Taux de prêt les plus bas
Image	Image (vignette) affichée dans le lecteur avant un clic sur l'annonce vidéo ou pendant son chargement.	Obligatoire	Non	Elle doit correspondre au format de la vidéo (par exemple, 1 280 x 720 pour une vidéo au format 16:9, 4:3 pour une vidéo en 640 x 480).	Une capture d'écran de la vidéo
Body	Le contenu de l'annonce	Obligatoire	Non	90 caractères	Votre maison à Brooklyn : moins chère et plus vite que vous ne le pensez !
Logo	Logo de l'annonceur ou toute 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 de métadonnées

Les métadonnées de champs suivantes sont partagées par tous les modèles d'annonces compatibles:

Tampon de protocole en temps réel Authorized Buyers	Équivalent Authorized Buyers OpenRTB	Description
NativeAd.click_link_url	Link.url	URL qui est appelée par le navigateur lorsque l'utilisateur clique sur l'annonce. Il peut s'agir de 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 le champ click_link_url afin de définir la destination vers laquelle l'utilisateur sera redirigé. Il est obligatoire dans le cas de 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 auxquelles l'utilisateur accédera 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 au serveur publicitaire qui sont sans rapport avec la page de destination finale. Si une réponse à l'enchère renvoie un extrait ou une annonce vidéo, mais ne déclare aucune click_through_url, elle 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 en tant que déclaration d'URL de destination, par exemple pour le post-filtrage des URL bloquées par l'éditeur ou pour la catégorisation des annonces. Reportez-vous au NativeAd.click_link_url ci-dessus lorsque vous utilisez des annonces natives. Pour les annonces non natives, il n'est pas utilisé pour le suivi des clics ou toute autre fonctionnalité publicitaire. Il sert uniquement à déclarer l'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. En outre, toutes les valeurs sont utilisées comme déclarations pour l'URL de destination (comme pour les valeurs non natives).
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 ou de désactivation pour les annonces. Le cas échéant, une icône AdChoices standard est ajoutée à la création native et associée à cette URL. Cette option 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 dans les outils de suivi natifs dans OpenRTB.

Champs obligatoires et recommandés

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, is_header_required, etc., mais tous empaquetés.

Exemple

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

Commencez par déterminer la valeur binaire équivalente : 10000111101

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

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

Champ	Emplacement de la valeur binaire (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 1 bit (le plus à droite) correspond à 1, ce qui signifie qu'il s'agit d'une valeur requise. D'après le tableau, le bit de 1 bit correspond à HEADLINE.

Les 2 bits (deuxième valeur en partant de la droite) correspondent à 0, ce qui signifie qu'ils ne sont pas obligatoires. Le 2 bits 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

Message NativeAdTemplate

Lors de la réception d'une demande d'enchère contenant un inventaire natif, celle-ci contiendra un champ BidRequest.adSlot[].native_ad_template. Le message NativeAdTemplate fournit des spécifications pour:

• Champs obligatoires ou recommandés.
• les dimensions des images, logos et icônes d'applications ;
• Spécifications concernant le style dans lequel l'annonce est affichée.

Remarque:Pour le champ style_layout_type, PIXEL indique que l'unité native est de taille fixe, tandis que FLUID signifie qu'elle s'adapte à la largeur de la colonne d'accueil et ajuste la hauteur pour conserver les proportions. Lorsque FLUID est spécifié, la hauteur et la largeur peuvent être de 1 x 1.

message BidRequest {
  //...
  message AdSlot {
    //...

    message NativeAdTemplate {
      // Defines the bits used in required_fields and recommended_fields.
      // There is one bit for each of the fields in BidResponse.Ad.NativeAd
      enum Fields {
        NO_FIELDS = 0x0;
        HEADLINE = 0x1;
        BODY = 0x2;
        CALL_TO_ACTION = 0x4;
        ADVERTISER = 0x8;
        IMAGE = 0x10;
        LOGO = 0x20;
        APP_ICON = 0x40;
        STAR_RATING = 0x80;
        PRICE = 0x100;
        DEPRECATED_STORE = 0x200;
        VIDEO = 0x400;
      }

      // Bitfield describing which fields are required by the publisher. Bid
      // responses with no value for these fields will be rejected. Click
      // and view tracking urls are always implicitly required.
      optional int64 required_fields = 1;

      // Bitfield describing which fields are recommended by the publisher.
      // All recommended field are supported, but not all recommended fields
      // are required.
      optional int64 recommended_fields = 2;

      // max_safe_length indicates the maximum number of Unicode characters that
      // are guaranteed to be shown without truncation. Longer strings may be
      // truncated and ellipsized by Ad Exchange or the publisher during
      // rendering.
      optional int32 headline_max_safe_length = 3;
      optional int32 body_max_safe_length = 4;
      optional int32 call_to_action_max_safe_length = 5;
      optional int32 advertiser_max_safe_length = 6;
      optional int32 price_max_safe_length = 15;

      // The width and height from which to calculate the required aspect ratio.
      // You can provide a larger image in the response. Images that have aspect
      // ratios substantially different than those implied by the height and
      // width may be filtered.
      optional int32 image_width = 7;
      optional int32 image_height = 8;
      optional int32 logo_width = 9;
      optional int32 logo_height = 10;
      optional int32 app_icon_width = 11;
      optional int32 app_icon_height = 12;

      // Globally distinct id for the specific style, HTML, and CSS with which
      // the native ad is rendered.
      optional int32 style_id = 16;

      // Type of style layout for each native ad template.
      enum LayoutType {
        PIXEL = 0;
        FLUID = 1;
      }
      optional LayoutType style_layout_type = 17 [default = PIXEL];

      // If the style_layout_type is Pixel, width and height of the
      // entire native ad after rendering. If the style_layout_type is
      // Fluid, the style_height and style_width may optionally
      // not be populated.
      optional int32 style_height = 18;
      optional int32 style_width = 19;
    }
    repeated NativeAdTemplate native_ad_template = 51;
  }

    // NativePlacementType describes placement of native ad slot with respect to
    // surrounding context.
    enum NativePlacementType {
      PLACEMENT_UNKNOWN = 0;
      // In the feed of content - for example as an item inside the organic
      // feed/grid/listing/carousel.
      PLACEMENT_IN_FEED = 1;
      // In the atomic unit of the content - for example, in the article page or single
      // image page.
      PLACEMENT_ATOMIC_UNIT = 2;
      // Outside the core content - for example in the ads section on the right
      // rail, as a banner-style placement near the content, etc.
      PLACEMENT_OUTSIDE = 3;
      // Recommendation widget, most commonly presented below the article
      // content.
      PLACEMENT_RECOMMENDATION = 4;
    }

    optional NativePlacementType native_placement_type = 45;

  // ...
}

Message NativeAd

Lorsqu'il définit une enchère sur un inventaire natif, l'acheteur doit renseigner des champs obligatoires dans le fichier BidRequest.adSlot[].native_ad_template correspondant dans BidResponse.ad[].native_ad.

Remarque: Certains champs supplémentaires trouvés dans BidResponse.Ad sont également inclus ci-dessous, car ils sont pertinents pour les annonces natives.

message BidResponse {
  //...
  message Ad {
    //...

    message NativeAd {
      // A short title for the ad.
      optional string headline = 1;

      // A long description of the ad.
      optional string body = 2;

      // A label for the button that the user is supposed to click.
      optional string call_to_action = 3;

      // The name of the advertiser or sponsor, to be displayed in the ad
      // creative.
      optional string advertiser = 4;

      // Next tag to use: 4
      message Image {
        optional string url = 1;

        // Image width and height are specified in pixels. You may provide a
        // larger image than was requested, so long as the aspect ratio is
        // preserved.
        optional int32 width = 2;
        optional int32 height = 3;
      }

      // A large image.
      optional Image image = 5;

      // A smaller image, for the advertiser's logo.
      optional Image logo = 6;

      // The app icon, for app download ads.
      optional Image app_icon = 7;

      // The video file. Only set this field if the video field is requested.
      oneof video {
        // The URL to fetch a video ad. The URL should return an XML response
        // that conforms to VAST standards.
        string video_url = 13;

        // The VAST document to be returned.
        string video_vast_xml = 16;
      }

      // The app rating in the app store. Must be in the range [0-5].
      optional double star_rating = 8;

      // The URL that the browser/SDK will load when the user clicks the ad.
      // This can be the landing page directly, or the first step of a redirect
      // chain that eventually leads to it. For backward compatibility, if this
      // is not set, the first Ad.click_through_url is used.
      optional string click_link_url = 14;

      // The URL to use for click tracking. The SDK pings click tracking url on
      // a background thread. When resolving the url, HTTP 30x redirects are
      // followed. The SDK ignores the contents of the response; this URL
      // has no effect on the landing page for the user.
      // This field is planned to be deprecated and we are moving to the
      // repeated click_tracking_urls field.
      optional string click_tracking_url = 11;

      // The URLs to use for click tracking. This will be used throughout the
      // serving stack and will incorporate any URL in click_tracking_urls.
      repeated string click_tracking_urls = 15;

      // The price of the promoted app including the currency info.
      optional string price = 10;

    };
    optional NativeAd native_ad = 18;

    // The set of destination URLs for the snippet. This includes the URLs that
    // the user will go to if they click on the displayed ad, and any URLs that
    // are visible in the rendered ad. Do not include intermediate calls to the
    // adserver that are unrelated to the final landing page. A BidResponse that
    // returns a snippet or video ad but declares no click_through_url will be
    // discarded. Only set this field if html_snippet or video_url or native_ad
    // are set. This data is used as a destination URL declaration, for example
    // for post-filtering of publisher-blocked URLs or ad categorization.
    //
    // For non-native ads, it is not used for click tracking or any
    // other ad functionality; it is only used as a destination URL
    // declaration.
    //
    // For native ads, if NativeAd.click_link_url is not set, the first
    // value of click_through_url is used to direct the user to the landing
    // page. In addition, all values are used as destination
    // URL declarations (similar to the non-native case).
    repeated string click_through_url = 4;

    //...

    // The URLs to call when the impression is rendered. The SDK pings
    // impression urls on a background thread and ignores the contents
    // of the response.
    repeated string impression_tracking_url = 19;

    // Link to ad preferences page. This is only supported for native ads.
    // If present, a standard AdChoices icon is added to the native ad creative and
    // linked to this URL.
    optional string ad_choices_destination_url = 21;
    // ...
  }
}

Exemples de demandes d'enchères

Remarque: Pour comprendre ce qui est obligatoire ou facultatif pour apparaître dans la réponse, reportez-vous à BidRequest.adslot.native_ad_template dans la requête Google ci-dessous. Pour le code JSON OpenRTB, les exigences se trouvent dans le champ request de BidRequest.imp.native. Pour les tampons OpenRTB, reportez-vous au champ request_native de BidRequest.imp.native.

Demandes d'enchères non vidéo

Google

Afficher l'exemple

id: "\226M\242\204\324\r\2019\256\362F\020[\323\205n\320\003\257\0179\274\034"
ip: "\300\250"
user_agent: "Mozilla/5.0 (Linux; Android 13; Pixel 6a) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.127 Mobile Safari/537.36 RakutenWebsearch/5.100.08"
url: "https://www.google.com"
detected_language: "ja"
adslot {
  id: 1
  excluded_attribute: 20
  excluded_attribute: 21
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  matching_ad_data {
    billing_id: 34438877165
    minimum_cpm_micros: 1000000
  }
  slot_visibility: NO_DETECTION
  excluded_product_category: 10015
  excluded_product_category: 10611
  ad_block_key: 4801919744
  publisher_settings_list_id: 9565076710629580954
  publisher_settings_list_id: 9122016041291349488
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 0
  allowed_restricted_category_for_deals: 33
  allowed_restricted_category_for_deals: 32
  click_through_rate: 0.00012890543
  sticky_settings {
    bottom_horizontal_stickiness: IS_STICKY
  }
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  session_depth: 19
  native_placement_type: PLACEMENT_IN_FEED
  native_ad_template {
    required_fields: 25
    recommended_fields: 0
    headline_max_safe_length: 25
    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: 221281
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
}
is_test: false
cookie_version: 1
google_user_id: "F6U2fpw3K08HSZGB73seQ5Pbk31"
mobile {
  is_app: false
  is_mobile_web_optimized: true
}
cookie_age_seconds: 12960000
hosted_match_data: "\312B\314fj@}h\3168\373\376D\335B\007\362\245\253"
geo_criteria_id: 1009637
encrypted_hyperlocal_set: "\\\253\006\362\017\201L\262\200\255z\2076g,\346\304\0279\273(\314\303\2402\3667\004\215W\353\225i\316\3302\035\t\273\220\330Eu\3106\337\352\331\'AX\377[\022\302\3254rtI\025W\316V\336\366\260\177_\355:QU\225t\300\315E\036\220\r\214\360\206\030\230\332HW\362&"
seller_network_id: 10468
publisher_type: PUBLISHER_REPRESENTED
partner_id: 6586746035199562167
hyperlocal_set {
  hyperlocal {
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
  }
  center_point {
    latitude: 0.0
    longitude: 0.0
  }
}
device {
  device_type: HIGHEND_PHONE
  platform: "android"
  brand: "google"
  model: "pixel 6a"
  os_version {
    major: 13
  }
  carrier_id: 0
  screen_width: 376
  screen_height: 835
  screen_pixel_ratio_millis: 2875
  limit_ad_tracking: false
}
publisher_country: "JP"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-z65c3V-K51171Fi2prC2Yn4f0X1I970y576HVOU2BXJn0lf2XSziKevRK1vpMGHD153A"
auction_type: FIRST_PRICE
geo {
  lat: 34.59
  lon: 133.89
  country: "JPN"
  region: "JP-33"
  city: "Okayama"
  accuracy: 19507
}
user_agent_data {
  platform {
    brand: "Android"
    version: "13"
    version: "0"
  }
  mobile: true
  model: "Pixel 6a"
  browsers {
    brand: "(Not(A:Brand"
    version: "8"
    version: "0"
  }
  browsers {
    brand: "Chromium"
    version: "100"
    version: "0"
  }
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "i-mobile.co.jp"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  nodes {
    advertising_system_identifier: "google.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
privacy_treatments {
  allow_user_data_collection: false
}
inventory_partner_domain: "OMITTED"

JSON OpenRTB

Afficher l'exemple

{
  "id": "8C7058U3s20928AGBP5Yij",
  "imp": [
    {
      "id": "1",
      "tagid": "9593912945",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":600,\"hmin\":313}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}]}",
        "ver": "1.2",
        "api": [
          1,
          2
        ]
      },
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          19693706542
        ],
        "publisher_settings_list_id": [
          3575046024785253379,
          8093493698074697754
        ],
        "allowed_vendor_type": [
          331,
          4680
        ],
        "ampad": 2,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1,
          "is_default": 1
        },
        "auction_environment": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "VN"
      }
    },
    "content": {
      "livestream": 0,
      "language": "en"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 15_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Mobile/15E148 Safari/604.1",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "USA",
      "region": "FL",
      "metro": "539",
      "city": "Bradenton",
      "zip": "34207",
      "type": 2,
      "accuracy": 2905
    },
    "ipv6": "2603:9000:a403::",
    "make": "apple",
    "model": "iphone",
    "os": "iOS",
    "osv": "15.4.4",
    "devicetype": 4,
    "lmt": 0,
    "w": 428,
    "h": 926,
    "pxratio": 3,
    "ext": {
      "user_agent_data": {
        "platform": {
          "brand": "iPhone",
          "version": [
            "15",
            "4"
          ]
        },
        "mobile": 1,
        "browsers": [
          {
            "brand": "Safari",
            "version": [
              "15",
              "4"
            ]
          },
          {
            "brand": "Mozilla",
            "version": [
              "5",
              "0"
            ]
          },
          {
            "brand": "AppleWebKit",
            "version": [
              "605",
              "1"
            ]
          }
        ],
        "bitness": "64"
      }
    }
  },
  "user": {
    "ext": {}
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "source": {
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "google.com",
            "sid": "pub-1028650221795432",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zfKua9-G5R316N638Mn0xgl3iu68F0u72M7r0aT9dMS24U7VNy3D391xb7K41155r533",
    "fcap_scope": 5,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Protobuf OpenRTB

Afficher l'exemple

id: "CW335Jn7Z9302AoiHaJ457"
imp {
  id: "1"
  tagid: "6556451022"
  bidfloor: 0.01
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    api: VPAID_1
    api: VPAID_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
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      [com.google.doubleclick.native_ext] {
        style_id: 476037
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006219408242031932
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.11
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 43493646043
    dfp_ad_unit_code: "/4297145/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    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
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "BR"
    }
  }
  content {
    livestream: false
    language: "pt"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_HIDDEN
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/109.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "BRA"
    region: "BR-SP"
    city: "Sao Paulo"
  }
  ipv6: "2804:7f0:b1c0::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    platform {
      brand: "Firefox"
      version: "5"
      version: "0"
    }
  }
  [com.google.doubleclick.device] {
  }
}
user {
  [com.google.doubleclick.user] {
  }
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
regs {
  [com.google.doubleclick.regs] {
    lgpd: true
  }
}
source {
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "google.com"
        sid: "pub-6330791094260149"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z1n1nk-p8G11E7E4Mg3tk38VNZWB88ijTr0zpZ22Lg363603SMcty7L78211J0e34Mc3"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_SITE
  privacy_treatments {
  }
}

Demandes d'enchères pour les annonces vidéo

Démonstration

{
  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

Notez que les valeurs de ces réponses ne sont pas destinées à correspondre aux requêtes correspondantes ci-dessus. Toutefois, si le modèle de la requête suggère des champs obligatoires/facultatifs, les réponses ici respectent ces exigences.

Réponses aux enchères non vidéo

Google

Afficher l'exemple

ad {
  adslot {
    id: 1
    max_cpm_micros: 3000000
    billing_id: 34438877165
    deal_id: 1
    buyer_reporting_id: "DjA6yW8"
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_845142"
  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: 1200
      height: 627
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 200
      height: 200
    }
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 5

JSON OpenRTB

Afficher l'exemple

{
  "id": "j53Z8GLLnSq8N97uXu029T",
  "seatbid": [
    {
      "bid": [
        {
          "id": "0kcWm8o4Q44BV54eOX8",
          "impid": "1",
          "price": 0.0612,
          "adid": "test_creative_id_838714",
          "adm": "{\"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Galactic Luxury Cruises\"}}, {\"id\": 3, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 1200, \"h\": 627}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adomain": [
            "google.com"
          ],
          "cid": "19693706542",
          "crid": "test_creative_id_838714",
          "ext": {
            "ad_choices_destination_url": "https://test.com/preferences"
          }
        }
      ],
      "seat": "8710:9087:596625"
    }
  ],
  "bidid": "50x4472o-qpci0H0b-Ovbp-6C470CnUTyA2"
}

Protobuf OpenRTB

Afficher l'exemple

id: "W4E2PD2Vr8Gl4Eq70eoT6v"
seatbid {
  bid {
    id: "uz3aH5W5Tzvc42GkuXT"
    impid: "1"
    price: 0.04632
    adomain: "google.com"
    cid: "43493646043"
    crid: "test_creative_id_877701"
    cat: "IAB13-7"
    adm_native {
      ver: "1.0"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      ad_choices_destination_url: "https://test.com/preferences"
      billing_id: 43493646043
    }
  }
  bid {
    id: "19794j5G3x4mpfzvr4m"
    impid: "1"
    price: 0.032292
    adomain: "google.com"
    cid: "43493646043"
    crid: "test_creative_id_877701"
    cat: "IAB7-44"
    adm_native {
      ver: "1.0"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      ad_choices_destination_url: "https://test.com/preferences"
      billing_id: 43493646043
    }
  }
  seat: "6718:8545:950241"
  group: false
}
bidid: "ah128WV2-1j995674-5243-f57Et5RtZLF7"
cur: "USD"

Réponses aux enchères par vidéo

Démonstration

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/"
    }
  }
}