Annunci nativi

Gli annunci nativi sono annunci formattati in modo da adattarsi al design visivo e ai contenuti circostanti, aumentando le probabilità che vengano visualizzati e selezionati dagli utenti. L'inventario di annunci nativi è disponibile nelle app mobile, nonché sui siti web per computer desktop e dispositivi mobili. Per ulteriori informazioni sugli annunci nativi, consulta la Panoramica degli annunci nativi.

Gli annunci nativi sono supportati sia per Authorized Buyers che per Open Bidding.

Ecco il flusso di lavoro per gli annunci nativi:

1. Viene effettuata una chiamata per un annuncio nativo a Google. La chiamata specifica uno o entrambi i modelli di annunci nativi riportati di seguito, ciascuno specificando i campi nativi preferiti.
2. Google invia agli acquirenti una richiesta di offerta RTB contenente un elenco dei campi richiesti.
3. Gli acquirenti interessati rispondono con i campi richiesti.
4. Google esegue un'asta per selezionare l'offerta vincente e invia gli asset della creatività forniti dall'acquirente al publisher.
5. Il publisher assembla gli asset in un annuncio nativo e li applica stili per adattarli al design del sito.

Formati dei messaggi

Google supporta la specifica OpenRTB in formato JSON e Protobuf.

Per gli annunci nativi Protobuf OpenRTB, i seguenti campi sono diversi dalla specifica:

Specifica JSON (PROTOCOL_OPENRTB_2_4)	Tipo JSON	Implementazione di OpenRTB (PROTOCOL_OPENRTB_PROTOBUF_2_4)	Tipo OpenRTB
BidRequest.imp[].native.request	string	BidRequest.imp[].native.request_native	NativeRequest
BidResponse.seatbid[].bid[].adm	string	BidResponse.seatbid[].bid[].adm_native	NativeResponse

I campi OpenRTB sono messaggi Protobuf e non stringhe.

Se utilizzi l'implementazione Protobuf OpenRTB, non riceverai BidRequest.imp[].native.request e dovrai rispondere con BidResponse.seatbid[].bid[].adm_native. Le risposte all'offerta con BidResponse.seatbid[].bid[].adm vengono filtrate. Gli ID asset non sono obbligatori per le risposte alle offerte Protobuf di OpenRTB.

Se utilizzi un SDK acquirente per eseguire il rendering degli annunci nativi, devi includere un'immagine type nella sezione declared_ad quando invii le creatività per la revisione.

Modelli di annunci nativi

Google supporta i due modelli di annunci nativi più comuni per gli annunci nativi non video e video:

• Modello di annuncio per l'installazione di app: promuovi e incrementa le installazioni di app mobile.
• Modello di annuncio della rete di contenuti: una combinazione più generica di testo e immagini per annunci web o correlati al brand.
• Modello di annuncio video per l'installazione di app
• Modello di annuncio di contenuti video

Esistono altri modelli che potrebbero avere un insieme diverso di requisiti per campi, dimensioni e dimensioni.

Modello di annuncio per l'installazione di app

Campi obbligatori e consigliati

Le tabelle riportate di seguito mostrano i campi etichettati come Obbligatorio o Consigliato. Valgono le seguenti regole:

• I campi contrassegnati con Obbligatorio sono obbligatori per l'offerente.
• I campi contrassegnati con Consigliati non sono obbligatori per l'offerente e il publisher potrebbe visualizzarli o meno se vengono forniti (ad esempio, valutazione a stelle).
• L'invito all'azione è sempre contrassegnato come Consigliato perché, se non viene inviato dall'offerente, viene assegnato un valore predefinito, ma viene sempre visualizzato se inviato.

Nella tabella seguente sono elencati i campi di un modello di annuncio per l'installazione di app. Le app mobile utilizzano questi campi per creare annunci nativi per l'installazione di app.

Campo	Descrizione	Obbligatorio o Consigliato?	Sempre visualizzato?	Dimensioni consigliate per le immagini/numero massimo di caratteri	Esempio
Titolo	Il titolo dell'app	Obbligatorie	Sì	25 caratteri	Flood-It!
Immagine	Uno screenshot dell'app o un'altra immagine pertinente.	Obbligatorie	No	1200 px x 627 px o 600 x 600 px a seconda delle proporzioni richieste dal publisher.	<Uno screenshot del gioco Flood-It!>
Body	Testo principale dell'app	Obbligatorie	No	90 caratteri	Ingannevolmente semplice e allettantemente impegnativo = piacevolmente coinvolgente!
Icona dell'app	L'icona dell'app	Obbligatorie	No	128 x 128 px	<Icona dell'app Flood-it!>
Call to action	Azione dell'utente preferita	Recommended	Sì	15 caratteri	Installa
Star rating	Numero di stelle (0-5) che rappresentano la valutazione dell'app nello store	Recommended	No	0 - 5	4.5
Prezzo	Il costo dell'app	Recommended	No	15 caratteri	Senza costi

Note sulla lunghezza del testo

Se un acquirente invia un asset di testo (ad esempio il corpo del testo) più lungo del numero massimo suggerito di caratteri, il testo potrebbe essere troncato e ridimensionato con puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento sono la metà delle dimensioni in cinese, giapponese e coreano. Ad esempio, il limite dei titoli è 90 per l'inglese e 45 per il cinese.

Note sulle dimensioni delle immagini

I publisher possono:

• Ritaglia l'immagine principale in modo simmetrico fino al 20% in una dimensione (altezza o larghezza).
• Ridimensionare l'immagine senza modificare le proporzioni.
• Le immagini con proporzioni sostanzialmente diverse da quelle implicite per altezza e larghezza possono essere filtrate.

Modello di annuncio della rete di contenuti

La seguente tabella elenca i campi di un modello di annuncio di contenuti. I publisher utilizzano questi campi per creare annunci di contenuti nativi.

Campo	Descrizione	Obbligatorio o Consigliato?	Sempre visualizzato?	Dimensioni consigliate per le immagini/numero massimo di caratteri *	Esempio
Titolo	Intestazione annuncio	Obbligatorie	Sì	25 caratteri	Tassi mutui più bassi
Immagine	L'immagine principale dell'annuncio	Obbligatorie	No	1200 px x 627 px o 600 x 600 px a seconda delle proporzioni richieste dal publisher.	<Immagine principale dell'annuncio>
Body	Il contenuto dell'annuncio	Obbligatorie	No	90 caratteri	La tua dolce casa di Brooklyn, più economica e prima di quanto pensi!
Logo	Il logo dell'inserzionista o un'altra immagine piccola pertinente	Recommended	No	128 x 128 px	<Logo di NY Mortgage Inc.>
Call to action	Azione preferita dell'utente	Recommended	No	15 caratteri	Richiedi un preventivo
Advertiser	Testo che identifica l'inserzionista o il brand	Obbligatorie	No	25 caratteri	Ipoteca di Roma

Modello di annuncio video per l'installazione di app

Campo	Descrizione	Obbligatorio o Consigliato?	Sempre visualizzato?	Dimensioni consigliate per le immagini/numero massimo di caratteri*	Esempio
Video	La risposta VAST video contenente tutti gli asset necessari per riprodurre un annuncio video.	Obbligatorie	No	-	Un URL a VAST XML contenente un oggetto Flood-It! Annuncio video
Titolo	Il titolo dell'app	Obbligatorie	Sì	25 caratteri	Flood-It!
Immagine	Immagine (miniatura) mostrata nel player prima che l'utente faccia clic sull'annuncio video o durante il caricamento.	Obbligatorie	No	Deve corrispondere alle proporzioni del video (ad esempio: 1280 x 720 per video 16 x 9, 4 x 3 per video 640 x 480).	Uno screenshot del gioco Flood-It! O dal video
Body	Testo principale dell'app	Obbligatorie	No	90 caratteri	Ingannevolmente semplice e allettantemente impegnativo = piacevolmente coinvolgente!
Icona dell'app	L'icona dell'app	Obbligatorie	No	128 x 128 px	Icona dell'app Flood-it!
Call to action	Azione dell'utente preferita	Obbligatorie	Sì	15 caratteri	Installa
Star rating	Numero di stelle (0-5) che rappresentano la valutazione dell'app nello store	Recommended	No	0 - 5	4.5
Prezzo	Il costo dell'app	Recommended	No	15 caratteri	Senza costi

Restrizioni

• Video: tutti i video devono essere sotto forma di URL VAST o tag VAST. Non è possibile specificare un file video non elaborato, ad esempio WebM, MP4 e così via.

• Lunghezza del testo: se un acquirente specifica un asset di testo come body nella risposta, questo potrebbe essere troncato e con puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento sono dimezzati in cinese, giapponese e coreano. Ad esempio, il limite per i titoli è 90 per l'inglese e 45 per il cinese.

• Dimensioni delle immagini. I publisher possono:

  • Ritaglia l'immagine principale in modo simmetrico fino al 20% in una dimensione (altezza o larghezza.
  • Ridimensionare l'immagine senza modificare le proporzioni.

Esempio di annuncio per l'installazione di app

Modello di annuncio di contenuti video

Campo	Descrizione	Obbligatorio o Consigliato?	Sempre visualizzato?	Dimensioni consigliate per le immagini/numero massimo di caratteri*	Esempio
Video	La risposta VAST video contenente tutti gli asset necessari per riprodurre un annuncio video.	Obbligatorie	Sì	-	Un URL a VAST XML contenente un oggetto Flood-It! Annuncio video
Titolo	Intestazione annuncio	Obbligatorie	Sì	25 caratteri	Tassi mutui più bassi
Immagine	Immagine (miniatura) mostrata nel player prima che l'utente faccia clic sull'annuncio video o durante il caricamento.	Obbligatorie	No	Deve corrispondere alle proporzioni del video (ad esempio: 1280 x 720 per video 16 x 9, 4 x 3 per video 640 x 480).	Uno screenshot del video
Body	Il contenuto dell'annuncio	Obbligatorie	No	90 caratteri	La tua dolce casa di Brooklyn, più economica e prima di quanto pensi!
Logo	Il logo dell'inserzionista o un'altra immagine piccola pertinente	Recommended	No	128 x 128 px	Logo di NY Mortgage Inc.
Call to action	Azione preferita dell'utente	Obbligatorie	No	15 caratteri	Richiedi un preventivo
Advertiser	Testo che identifica l'inserzionista o il brand	Obbligatorie	No	25 caratteri	Ipoteca di Roma

Metacampi

I seguenti metacampi sono condivisi da tutti i modelli di annuncio supportati:

Buffer del protocollo in tempo reale di Authorized Buyers	Equivalente di OpenRTB di Authorized Buyers	Descrizione
NativeAd.click_link_url	Link.url	L'URL che verrà chiamato dal browser quando l'utente fa clic sull'annuncio. Può essere il primo passaggio di una catena di reindirizzamento che rimanda alla pagina di destinazione. Per gli annunci nativi, ti consigliamo di utilizzare click_link_url come campo per impostare la destinazione a cui verrà indirizzato l'utente. È obbligatorio utilizzare questo campo nel caso di pagine di destinazione dinamiche.
Ad.click_through_url	Bid.adomain	Deve essere impostato se l'offerente intende fare offerte. Si tratta dell'insieme di URL di destinazione per lo snippet, inclusi gli URL a cui l'utente verrà reindirizzato se fa clic sull'annuncio mostrato e gli eventuali URL visibili nell'annuncio sottoposto a rendering. Non includere chiamate intermedie all'ad server non correlate alla pagina di destinazione finale. Una risposta all'offerta che restituisce uno snippet o un annuncio video ma non dichiara click_through_url verrà ignorata. Imposta questo campo solo se sono impostati html_snippet, video_url o native_ad. Questi dati vengono utilizzati come dichiarazione dell'URL di destinazione, ad esempio per il post-filtro degli URL bloccati dal publisher o per la categorizzazione degli annunci. Consulta la sezione NativeAd.click_link_url sopra quando utilizzi gli annunci nativi. Per gli annunci non nativi, non viene utilizzato per il monitoraggio dei clic o altre funzionalità pubblicitarie; viene utilizzato solo come dichiarazione dell'URL di destinazione. Per gli annunci nativi, se il criterio NativeAd.click_link_url non è impostato, il primo valore di click_through_url viene utilizzato per indirizzare l'utente alla pagina di destinazione. Inoltre, tutti i valori vengono utilizzati come dichiarazioni dell'URL di destinazione (in modo simile al caso non nativo).
NativeAd.click_tracking_urls	Link.clicktrackers	Campo facoltativo. URL aggiuntivi che consentono agli inserzionisti di monitorare i clic degli utenti sull'annuncio.
Ad.ad_choices_destination_url	BidExt.ad_choices_destination_url	Link a una pagina delle preferenze annunci o di disattivazione. Se presente, un'icona Scegli Tu! standard viene aggiunta alla creatività nativa e collegata a questo URL. Questa funzionalità è supportata per gli annunci nativi, ma non fa parte del messaggio nativo nella risposta all'offerta.
Ad.impression_tracking_url	NativeResponse.imptrackers	L'impressione nativa deve essere monitorata con impression_tracking_url nel protocollo per le offerte in tempo reale di Authorized Buyers o con gli imptracker nativi in OpenRTB.

Campi obbligatori e consigliati

required_fields e recommended_fields sono specificati dal publisher. Mostriamo come tradurre questi campi di bit per determinare se un campo è obbligatorio o consigliato.

Un campo bit utilizza ogni bit di un valore binario per archiviare un'istruzione vera o falsa, equivalente all'invio di molti segnali booleani come is_logo_required, is_header_required e così via, ma tutti inclusi insieme.

Esempio

Per questo esempio utilizzeremo un valore required_fields pari a 1085.

Innanzitutto, trova il valore binario equivalente: 10000111101

Una volta ottenuto il valore binario, puoi controllare i bit per vedere se un campo è obbligatorio (1) o non obbligatorio (0).

La tabella seguente mappa i campi alla loro posizione nel valore binario. Leggi il file binario da destra a sinistra, con il bit 1 corrispondente alla posizione più a destra nel valore binario.

Campo	Posizionamento valore binario (da destra a sinistra)
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

Osservando il valore binario di esempio 10000111101, il bit a 1 bit (più a destra) è 1, a indicare un valore obbligatorio. In base alla tabella, a 1 bit corrisponde a HEADLINE.

Il valore a 2 bit (secondo valore da destra) è 0 e significa non obbligatorio. Il formato a 2 bit corrisponde a BODY.

Ecco tutti i campi obbligatori interpretati nel nostro esempio:

Valore	Descrizione	Campo obbligatorio?
1	VIDEO	Sì
0	STORE	No
0	PRICE	No
0	STAR_RATING	No
0	APP_ICON	No
1	LOGO	Sì
1	IMAGE	Sì
1	ADVERTISER	Sì
1	CALL_TO_ACTION	Sì
0	BODY	No
1	HEADLINE	Sì

Messaggio NativeAdTemplate

Quando ricevi una richiesta di offerta contenente inventario nativo, questa conterrà un elemento BidRequest.adSlot[].native_ad_template compilato. Il messaggio NativeAdTemplate fornisce specifiche per:

• Campi obbligatori o consigliati.
• Dimensioni di immagini, loghi e icone di app.
• Specifiche per lo stile in cui viene visualizzato l'annuncio.

Nota: per il campo style_layout_type, PIXEL indica che l'unità nativa ha una dimensione fissa, mentre FLUID si ridimensiona per riempire la larghezza della colonna che lo contiene e regola l'altezza per mantenere le proporzioni. Quando specifichi FLUID, l'altezza e la larghezza possono risultare 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;

  // ...
}

Messaggio NativeAd

Quando fa offerte su un inventario nativo, un acquirente deve compilare BidResponse.ad[].native_ad con i campi obbligatori dichiarati nel corrispondente BidRequest.adSlot[].native_ad_template.

Nota: di seguito sono inclusi anche alcuni campi aggiuntivi che si trovano in BidResponse.Ad perché sono pertinenti agli annunci nativi.

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;
    // ...
  }
}

Esempi di richieste di offerta

Nota: per capire cosa è obbligatorio o facoltativo per comparire nella risposta, fai riferimento a BidRequest.adslot.native_ad_template nella richiesta Google di seguito. Per JSON OpenRTB, i requisiti sono disponibili nel campo request di BidRequest.imp.native. Per Protobuf OpenRTB, fai riferimento al campo request_native di BidRequest.imp.native.

Richieste di offerta non video

Google

Mostrami l'esempio

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

Mostrami l'esempio

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

Mostrami l'esempio

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

Richieste di offerta video

Procedura

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

Esempi di risposte alle offerte

Tieni presente che i valori in questa risposta non sono destinati a corrispondere alle richieste corrispondenti sopra. Tuttavia, se il modello nella richiesta suggerisce campi obbligatori/facoltativi, le risposte qui rispettano questi requisiti.

Risposte alle offerte non video

Google

Mostrami l'esempio

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

Mostrami l'esempio

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

Mostrami l'esempio

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"

Risposte alle offerte video

Procedura

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