Questa pagina è stata tradotta dall'API Cloud Translation.

Annunci nativi

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

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

Ecco il flusso di lavoro per gli annunci nativi:

Google riceve una chiamata per un annuncio nativo. La chiamata specifica uno o entrambi i seguenti modelli di annunci nativi, ciascuno dei quali specifica i campi nativi preferiti.
Google invia agli acquirenti una richiesta di offerta RTB che contiene un elenco dei campi richiesti.
Gli acquirenti interessati rispondono con i campi richiesti.
Google avvia un'asta per selezionare l'offerta vincente e invia al publisher gli asset della creatività forniti dall'acquirente.
Il publisher assembla gli asset in un annuncio nativo e li personalizza in base al design del sito.

Formati dei messaggi

Google supporta la specifica OpenRTB sia in JSON che in Protobuf.

Per gli annunci nativi OpenRTB Protobuf, i seguenti campi sono diversi rispetto alle specifiche:

JSON	Tipo JSON	Protobuf	Tipo Protobuf
`BidRequest.imp[].native.request`	`string`	`BidRequest.imp[].native.request_native`	`NativeRequest`
`BidResponse.seatbid[].bid[].adm`	`string`	`BidResponse.seatbid[].bid[].adm_native`	`NativeResponse`

I campi Protobuf di OpenRTB sono messaggi Protobuf anziché stringhe.

Se utilizzi l'implementazione di Protobuf OpenRTB, l'endpoint riceve richieste di offerta contenenti BidRequest.imp.native.request_native anziché BidRequest.imp.native.request. Inoltre, l'endpoint deve restituire risposte all'offerta che compilano BidResponse.seatbid.bid.adm_native anziché BidResponse.seatbid.bid.adm, altrimenti verrà filtrato dall'asta.

Se utilizzi un SDK per gli acquirenti per visualizzare gli annunci nativi, devi includere un'immagine type in declared_ad quando invii le creatività per la revisione.

Modelli di annunci nativi

I modelli di annunci nativi descrivono i componenti di un annuncio nativo e determinano i contenuti e la struttura di NativeRequest di OpenRTB o di NativeAdTemplate del protocollo Google RTB ritirato nella richiesta di offerta. Google supporta i due modelli di annunci nativi più comuni per gli annunci nativi video e non video:

Modello di annuncio per l'installazione di app: promuovi e aumenta le installazioni di app mobile.
Modello di annuncio di contenuti: combinazione più generica di testo e immagini per annunci di brand o web.
Modello di annuncio per l'installazione di app video
Modello di annuncio di contenuti video

Esistono altri modelli che possono avere un insieme di requisiti diverso per quanto riguarda campi, dimensioni e misure.

Modello di annuncio per l'installazione di app

Campi obbligatori e consigliati

Le tabelle seguenti mostrano i campi contrassegnati come Obbligatorio o Consigliato. Valgono le seguenti regole:

I campi contrassegnati come Obbligatorio sono obbligatori per l'offerente.
I campi contrassegnati come Consigliati non sono obbligatori per l'offerente e il editore può decidere se mostrarli o meno, se forniti (ad es. la valutazione a stelle).
L'invito all'azione (CTA) è sempre contrassegnato come Consigliato perché viene assegnata un'impostazione predefinita se non viene inviata dall'offerente, ma verrà sempre visualizzata se inviata.

La tabella seguente elenca i campi di un modello di annuncio di installazione di app. Le app mobile utilizzano questi campi per creare annunci di installazione di app nativi.

Campo	Descrizione	Obbligatorio o consigliato?	Sempre visualizzata?	Dimensioni consigliate dell'immagine/numero massimo di caratteri	Esempio
Titolo	Il titolo dell'app	Obbligatorio	Sì	25 caratteri	Flood-It!
Immagine	Uno screenshot dell'app o un'altra immagine pertinente	Obbligatorio	No	1200 x 627 px o 600 x 600 px,a seconda delle proporzioni richieste dal publisher.	<Uno screenshot del gioco Flood-It!>
Corpo	Testo principale dell'app	Obbligatorio	No	90 caratteri	Apparentemente semplice e allo stesso tempo stimolante = incredibilmente avvincente.
Icona dell'app	L'icona dell'app	Obbligatorio	No	128 x 128 px	<icona dell'app Flood-it!>
Call to action	Azione utente preferita	Consigliato	Sì	15 caratteri	Installa
Valutazione a stelle	Numero di stelle (da 0 a 5) che rappresentano la valutazione dell'app nell'app store	Consigliato	No	0 - 5	4,5
Prezzo	Il costo dell'app	Consigliato	No	15 caratteri	Gratis

Note sulla lunghezza del testo

Se un acquirente invia un asset di testo (ad es. il testo del corpo) più lungo del numero massimo di caratteri suggerito, il testo potrebbe essere troncato e aggiungere puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento si dimezzano per le lingue cinese, giapponese e coreano. Ad esempio, il limite per i titoli è pari a 90 per l'inglese e a 45 per il cinese.

Note sulle dimensioni delle immagini

I publisher sono autorizzati a:

Ritaglia l'immagine principale simmetricamente fino al 20% in una dimensione (altezza o larghezza).
Modificare le dimensioni dell'immagine senza modificarne le proporzioni.
Le immagini con proporzioni notevolmente diverse da quelle implicite per altezza e larghezza potrebbero essere filtrate.

Modello di annuncio di contenuti

La tabella seguente 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 visualizzata?	Dimensioni consigliate delle immagini/numero massimo di caratteri *	Esempio
Titolo	L'intestazione dell'annuncio	Obbligatorio	Sì	25 caratteri	I tassi di mutuo più bassi
Immagine	L'immagine principale dell'annuncio	Obbligatorio	No	1200 x 627 px o 600 x 600 px,a seconda delle proporzioni richieste dal publisher.	<Immagine principale dell'annuncio>
Corpo	Il contenuto dell'annuncio	Obbligatorio	No	90 caratteri	La tua casa a Brooklyn, più economica e prima di quanto pensi.
Logo	Logo dell'inserzionista o un'altra immagine piccola pertinente	Consigliato	No	128 x 128 px	<Logo di NY Mortgage Inc.>
Call to action	Azione preferita dall'utente	Consigliato	No	15 caratteri	Richiedi un preventivo
Inserzionista	Testo che identifica l'inserzionista o il brand	Obbligatorio	No	25 caratteri	NY Mortgage Inc.

Modello di annuncio video per l'installazione di app

Campo	Descrizione	Obbligatorio o consigliato?	Sempre visualizzata?	Dimensioni consigliate delle immagini/numero massimo di caratteri *	Esempio
Video	La risposta VAST video contenente tutti gli asset necessari per riprodurre un annuncio video.	Obbligatorio	No	-	Un URL a un file VAST XML contenente un'esperienza Flood-It! Annuncio video
Titolo	Il titolo dell'app	Obbligatorio	Sì	25 caratteri	Flood-It!
Immagine	L'immagine (miniatura) mostrata nel video player prima che venga fatto clic sull'annuncio video o durante il caricamento dell'annuncio.	Obbligatorio	No	Dovrebbe avere le stesse proporzioni del video (ad esempio: 1280 x 720 per i video 16:9, 4:3 per i video 640 x 480).	Uno screenshot del gioco Flood-It! In alternativa, dal video
Corpo	Testo principale dell'app	Obbligatorio	No	90 caratteri	Apparentemente semplice e allo stesso tempo stimolante = incredibilmente avvincente.
Icona dell'app	L'icona dell'app	Obbligatorio	No	128 x 128 px	Icona dell'app Flood-It!
Call to action	Azione utente preferita	Obbligatorio	Sì	15 caratteri	Installa
Valutazione a stelle	Numero di stelle (da 0 a 5) che rappresentano la valutazione dell'app nell'app store	Consigliato	No	0 - 5	4,5
Prezzo	Il costo dell'app	Consigliato	No	15 caratteri	Gratis

Restrizioni

Video: tutti i video devono essere sotto forma di URL VAST o di 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 aggiungere puntini di sospensione da Google o dal publisher. Tieni presente che i limiti di troncamento si dimezzano per le lingue cinese, giapponese e coreano. Ad esempio, il limite per i titoli è pari a 90 in inglese e a 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).
- Modificare le dimensioni dell'immagine senza modificarne le proporzioni.

Esempio di annuncio per l'installazione di app

Modello di annuncio di contenuti video

Campo	Descrizione	Obbligatorio o consigliato?	Sempre visualizzata?	Dimensioni consigliate delle immagini/numero massimo di caratteri *	Esempio
Video	La risposta VAST video contenente tutti gli asset necessari per riprodurre un annuncio video.	Obbligatorio	Sì	-	Un URL a un file VAST XML contenente un'esperienza Flood-It! Annuncio video
Titolo	L'intestazione dell'annuncio	Obbligatorio	Sì	25 caratteri	I tassi di mutuo più bassi
Immagine	L'immagine (miniatura) mostrata nel video player prima che venga fatto clic sull'annuncio video o durante il caricamento dell'annuncio.	Obbligatorio	No	Dovrebbe avere le stesse proporzioni del video (ad esempio: 1280 x 720 per i video 16:9, 4:3 per i video 640 x 480).	Uno screenshot del video
Corpo	Il contenuto dell'annuncio	Obbligatorio	No	90 caratteri	La tua casa a Brooklyn, più economica e prima di quanto pensi.
Logo	Logo dell'inserzionista o un'altra immagine piccola pertinente	Consigliato	No	128 x 128 px	Logo di NY Mortgage Inc.
Call to action	Azione preferita dall'utente	Obbligatorio	No	15 caratteri	Richiedi un preventivo
Inserzionista	Testo che identifica l'inserzionista o il brand	Obbligatorio	No	25 caratteri	NY Mortgage Inc.

Campi meta

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

Protocollo RTB di Google	Equivalente OpenRTB	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 reindirizzamenti che porta alla pagina di destinazione. Per gli annunci nativi, ti consigliamo di utilizzare `click_link_url` come campo per impostare la destinazione finale dell'utente. L'utilizzo di questo campo è obbligatorio nel caso di pagine di destinazione dinamiche.
`Ad.click_through_url`	`Bid.adomain`	Deve essere impostato se l'offerente intende fare un'offerta. Si tratta dell'insieme degli URL di destinazione per lo snippet, inclusi gli URL a cui l'utente viene indirizzato se fa clic sull'annuncio visualizzato e tutti gli URL visibili nell'annuncio visualizzato. Non includere chiamate intermedie all'ad server non correlate alla pagina di destinazione finale. Un BidResponse che restituisce uno snippet o un annuncio video ma non dichiara `click_through_url` verrà ignorato. 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 la classificazione degli annunci. Consulta `NativeAd.click_link_url` quando utilizzi gli annunci nativi. Per gli annunci non nativi, non viene utilizzato per il monitoraggio dei clic o per qualsiasi altra funzionalità dell'annuncio; viene utilizzato solo come dichiarazione dell'URL di destinazione. Per gli annunci nativi, se `NativeAd.click_link_url` non è impostato, viene utilizzato il primo valore di `click_through_url` per indirizzare l'utente alla pagina di destinazione. Inoltre, tutti i valori vengono utilizzati come dichiarazioni di URL di destinazione (in modo simile al caso non nativo).
`NativeAd.click_tracking_urls`	`Link.clicktrackers`	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 di disattivazione o delle preferenze relative agli annunci. Se presente, alla creatività nativa viene aggiunta un'icona Scegli Tu! standard che viene 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 delle offerte in tempo reale di Authorized Buyers o con gli imptracker nativi in OpenRTB.

Campi obbligatori e consigliati del protocollo RTB di Google

required_fields e recommended_fields sono specificati dall'editore. Ti mostriamo come tradurre questi campi di bit per determinare se un campo è obbligatorio o consigliato.

Un campo di bit utilizza ogni bit di un valore binario per memorizzare un'istruzione true o false, equivalente all'invio di molti indicatori booleani come is_logo_required o is_header_required, ma tutti imballati insieme.

Nota: in OpenRTB, il campo BidRequest.imp.native.request_native.assets.required determina se un determinato campo è obbligatorio o consigliato.

Esempio

Per questo esempio utilizzeremo un valore required_fields di 1085.

Innanzitutto, trova il valore binario equivalente: 10000111101

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

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

Campo	Posizionamento del 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`

Se osserviamo il valore binario di esempio 10000111101, il bit 1 (all'estrema destra) è 1, che indica un valore obbligatorio. In base alla tabella, il bit 1 corrisponde a HEADLINE.

Il valore di 2 bit (secondo valore da destra) è 0, il che significa che non è obbligatorio. Il 2-bit corrisponde a BODY.

Di seguito sono riportati tutti i campi obbligatori interpretati nel nostro esempio:

Valore	Descrizione	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ì

Rappresentazione del modello di annuncio nativo nella richiesta di offerta

Quando ricevi una richiesta di offerta contenente inventario nativo, il modello di annuncio nativo sarà presente in forme diverse a seconda del protocollo utilizzato. Ti consigliamo di utilizzare OpenRTB perché il protocollo Google è deprecato.

In OpenRTB, il modello di annuncio nativo è descritto con il messaggio NativeRequest. Nel protocollo Google RTB, è descritto con NativeAdTemplate. Questi messaggi forniscono i seguenti dettagli sull'inventario degli annunci nativi:

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

Nota: per il campo style_layout_type, PIXEL indica che l'unità nativa è di dimensioni fisse, mentre FLUID indica che viene ridimensionata per riempire la larghezza della colonna di contenimento e regola l'altezza per mantenere le proporzioni. Quando viene specificato FLUID, l'altezza e la larghezza potrebbero essere 1 x 1.

ID risorsa OpenRTB

OpenRTB passa un array di asset nella richiesta di offerta che descrivono la struttura dell'annuncio nativo da restituire nella risposta. Ogni asset nella richiesta avrà un ID che deve essere specificato per l'asset corrispondente nella risposta. Per un esempio di come questi ID corrispondono tra la richiesta e la risposta, consulta l'esempio di richiesta di offerta nativa e l'esempio di risposta di offerta nativa.

Rappresentazione di un annuncio nativo nella risposta all'offerta

Quando fa offerte per l'inventario nativo, un acquirente deve compilare i campi obbligatori identificati nella richiesta di offerta. In OpenRTB, puoi farlo con BidResponse.seatbid.bid.adm_native se utilizzi Protobuf o BidResponse.seatbid.bid.adm per JSON. Per il protocollo Google ritirato, questa operazione viene eseguita con il campo BidResponse.ad.native_ad.

Esempi di richieste di offerta

Nota: per capire cosa è obbligatorio o facoltativo nella risposta, consulta il modello di annuncio nativo nella richiesta di offerta. Per OpenRTB, puoi trovarlo in BidRequest.imp.native. Per il protocollo Google ritirato, puoi trovarlo in BidRequest.adslot.native_ad_template.

Richieste di offerta non video

Protobuf OpenRTB

Mostrami l'esempio

Richiesta serializzata

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
}

JSON OpenRTB

Mostrami l'esempio

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

Google

Mostrami l'esempio

Richiesta serializzata

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"

Richieste di offerta video

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

Risposte all'offerta di esempio

Risposte all'offerta non video

OpenRTB Protobuf

Mostrami l'esempio

Risposta serializzata

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"

JSON OpenRTB

Mostrami l'esempio

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

Google

Mostrami l'esempio

Risposta serializzata

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

Risposte all'offerta video

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