Configurare un'integrazione di Open Bidding

Open Bidding consente alle piattaforme di scambio pubblicitario e ad altri acquirenti di sfruttare l'infrastruttura delle offerte in tempo reale di Google per fare offerte sull'inventario di Google Ad Manager e AdMob.

Per partecipare a Open Bidding, configura un'integrazione di offerte in tempo reale personalizzata per il tuo caso d'uso di Open Bidding e invia gli endpoint dello strumento di offerta al tuo account manager Google in modo che il test possa verificare che l'integrazione funzioni correttamente. Si tratta di una procedura che dovrai svolgere solo una volta.

Limitare l'integrazione a publisher selezionati

L'integrazione di Open Bidding può rimanere in"modalità privata" finché non è disponibile per accettare richieste da qualsiasi publisher. In modalità privata, puoi collaborare con il team dell'account per entrare in contatto con publisher selezionati e rimanere in questo stato finché non è tutto pronto per iniziare a scalare. Una volta che esci dalla modalità privata, il tuo account sarà visibile a tutti i publisher.

Protocolli e codifica supportati

Puoi utilizzare OpenRTB in formato JSON o Protobuf. Ulteriori informazioni.

Implementazione di Google OpenRTB

L'implementazione di OpenRTB di Google non supporta tutte le funzionalità della specifica OpenRTB e aggiunge estensioni per Authorized Buyers e funzionalità specifiche di Open Bidding. Per saperne di più, consulta la guida OpenRTB.

Gestire le richieste di offerta in arrivo

Open Bidding utilizza la stessa struttura BidRequest di Authorized Buyers, ma alcuni campi vengono inviati esclusivamente ai partecipanti a Open Bidding. Consulta la guida alle richieste per scoprire di più sui campi specifici di Open Bidding inviati nella richiesta di offerta.

Rispondere con un'offerta

Open Bidding utilizza anche una struttura BidResponse simile a quella di Authorized Buyers, con alcuni campi esclusivi inviati ai partecipanti a Open Bidding. Consulta la guida alle risposte per scoprire di più sui campi specifici di Open Bidding con cui puoi rispondere.

A seconda del formato dell'annuncio preferito con cui intendi fare offerte, la struttura della risposta può variare in modo significativo. Consulta le seguenti guide per configurare la tua applicazione di offerente in modo che risponda con offerte per i formati degli annunci più comuni:

Monitorare le impressioni per ridurre le discrepanze

Ti consigliamo vivamente di utilizzare il campo facoltativoBidResponse.seatbid.bid.ext.impression_tracking_url per recuperare i dati a livello di impressione su quando Google registra gli eventi fatturabili per i quali ti verrà addebitato l'importo.

Risoluzione delle discrepanze nella domanda di Google (beta)

Questa funzionalità ha lo scopo di garantire che il numero di impressioni fatturate da una piattaforma di scambio sia in linea con il numero di impressioni pagate da Google Display & Video 360 (DV360).

Identificando con precisione le impressioni DV360 pubblicate da Open Bidding, Google può quindi correggere le impressioni spam e le discrepanze relative agli eventi fatturabili in modo da non ricevere addebiti per le impressioni non corrisposte.

Propagare google_query_id nelle richieste di offerta.

Per garantire che il numero di impressioni valide corrisponda tra la domanda di Google, google_query_id deve essere propagato così com'è dalle richieste Open Bidding alle piattaforme di domanda di Google. Si tratta di un prerequisito per la risoluzione delle discrepanze di Open Bidding. La lunghezza prevista corrente del google_query_id è di circa 64 byte.

Propagare third_party_buyer_token nelle risposte all'offerta.

Nel caso in cui la piattaforma di domanda di Google vinca l'asta interna di una piattaforma di scambio pubblicitario, il campo third_party_buyer_token deve essere propagato così com'è nella risposta all'offerta tramite l'impressione Open Bidding. In questo modo, le piattaforme per publisher di Google possono stabilire che l'offerta vincente di un partner Open Bidding è un'offerta per conto della domanda di Google per la stessa opportunità di impressione. La lunghezza massima attuale di questo campo dovrebbe essere di 150 byte.

Trasmettere il markup della creatività Google così com'è nelle risposte all'offerta

Per garantire che la risoluzione delle discrepanze si applichi alle offerte della domanda di Google, è necessario che una piattaforma di scambio propaghi il markup delle creatività di Google senza wrapper (tag script, iframe o wrapper VAST). A causa della risoluzione della discrepanza, Google potrebbe annullare e non fatturare le impressioni di Open Bidding che non sono state conteggiate dalle piattaforme di domanda di Google. Google esaminerà periodicamente il markup delle creatività per confermare che le offerte con third_party_buyer_token sono state inviate per conto della domanda di Google e non di nessun altro acquirente.

Creatività HTML5

Una piattaforma di scambio pubblicitario è tenuta a inviare il markup HTML di Google così com'è, con le espansioni delle macro specifiche della piattaforma che normalmente si applicano e, facoltativamente, con pixel o script di tracker aggiuntivi che la piattaforma di scambio pubblicitario aggiunge normalmente.

Google non è in grado di applicare la risoluzione delle discrepanze se una piattaforma di scambio pubblicitario inserisce la creatività HTML di Google in un tag (script, iframe o altre tecniche) che successivamente carica o esegue il rendering del codice HTML di Google.

Creatività video VAST

Per essere idoneo alla risoluzione della discrepanza, una piattaforma di scambio pubblicitario deve utilizzare uno dei seguenti approcci per compilare VASTTagURI nelle risposte XML VAST:

  1. Una piattaforma di scambio pubblicitario può conservare il valore dell'elemento VASTTagURI come parte del documento XML VAST restituito da Google nel campo BidResponse.seatbid.bid.adm così com'è, con le espansioni delle macro specifiche della piattaforma di scambio pubblicitario che normalmente si applicano.
  2. DV360 può compilare il campo BidResponse.seatbid.bid.adm.nurl con un URL del documento VAST nelle risposte all'offerta a una piattaforma di scambio pubblicitario. Una piattaforma di scambio pubblicitario può quindi trasmettere questo valore con il tag VASTTagURI, con le macro specifiche della piattaforma di scambio pubblicitario espanse normalmente in base alle esigenze.

Se necessario, una piattaforma di scambio pubblicitario può specificare ulteriori tracker di errori ed eventi VAST all'interno del documento XML VAST.

Offerte

Le piattaforme di scambio pubblicitario che partecipano a Open Bidding possono utilizzare preferred deal (PD), aste private (AP) con Open Bidding. L'ID e il tipo di deal devono essere specificati come segue:

Campo Descrizione
BidResponse.seatbid.bid.dealid L'ID deal dello spazio dei nomi della piattaforma di scambio associato all'offerta e segnalato ai publisher. Si tratta di un testo UTF8 arbitrario e non deve superare i 64 byte.
BidResponse.seatbid.bid.ext.exchange_deal_type Un enum che specifica il tipo di deal. Questo viene segnalato ai publisher e influisce sul modo in cui il deal viene trattato nell'asta. I valori possibili sono:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Di seguito è riportato un esempio di risposta all'offerta per PD/PA.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Per compilare le tabelle di corrispondenza ospitate da Google, i partecipanti a Open Bidding possono utilizzare una delle opzioni riportate di seguito più adatta alle loro esigenze:

  • Corrispondenza dei cookie: corrispondenza avviata dall'acquirente o dalla piattaforma di scambio pubblicitario Scopri di più.
  • Corrispondenza Pixel: corrispondenza avviata da Google Scopri di più.
  • Cookie Match Assist: corrispondenza avviata dalla piattaforma di scambio pubblicitario con i relativi offerenti. Scopri di più.

Gestione della latenza

Devi utilizzare le località di scambio indicate nella Guida al peering per stimare la latenza che avranno gli endpoint dell'offerente quando risponderanno alle richieste di offerta in arrivo.

Le piattaforme di scambio pubblicitario di grandi dimensioni che ricevono un volume elevato di richieste di offerta dovrebbero valutare la possibilità di stipulare un contratto di peering con Google per ridurre la latenza e la volatilità della latenza. Scopri di più sul peering.

Macro di clic

Ti consigliamo di implementare le macro dei clic. In questo modo, potrai generare report che includono i clic e le metriche generate dai clic per il tuo account e per i publisher con cui collabori. Ulteriori informazioni.

API

I clienti Open Bidding possono utilizzare le API REST di Authorized Buyers per accedere ai dati che potrebbero essere utili per la risoluzione dei problemi. Al momento sono accessibili solo le seguenti risorse API:

Puoi contattare il tuo Technical Account Manager per configurare il tuo account per accedere a queste API e per recuperare l'ID account necessario per effettuare chiamate alle API. Per assistenza tecnica sull'utilizzo di queste API, puoi contattare l'alias di assistenza adxbuyerapi-support@google.com.

Risorse aggiuntive

Richieste di offerta e risposte di esempio

Esempi di richieste e risposte all'offerta per tutti i protocolli supportati sono disponibili nelle guide Richiesta e Risposta.