Configurare un'integrazione di Open Bidding

Open Bidding consente alle piattaforme di scambio e ad altri acquirenti di sfruttare l'infrastruttura per le offerte in tempo reale di Google per fare offerte per l'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 per il test per verificare che l'integrazione funzioni correttamente. Si tratta di una procedura che dovrai svolgere solo una volta.

Limitare l'integrazione a editori selezionati

L'integrazione di Open Bidding può rimanere in"modalità privata" finché non sei pronto ad accettare richieste da qualsiasi editore. In modalità privata, puoi collaborare con il team dell'account per entrare in contatto con publisher selezionati e rimanere in questo stato finché non sei pronto per la scalabilità. Una volta uscito 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à presenti nelle specifiche 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 di 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 a 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 l'applicazione del bidder in modo che risponda con offerte per i formati dell'annuncio comuni:

Monitorare le impressioni per ridurre le discrepanze

Ti consigliamo vivamente di utilizzare il campo facoltativo BidResponse.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 un costo.

Risoluzione della discrepanza 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 alla domanda di Google, il google_query_id deve essere propagato così com'è dalle richieste Open Bidding alle piattaforme della domanda di Google. Questo è un prerequisito per la risoluzione delle discrepanze di Open Bidding. La lunghezza prevista attuale di google_query_id è di circa 64 byte.

Propagare third_party_buyer_token nelle risposte all'offerta.

Nel caso in cui la piattaforma della domanda di Google vinca l'asta interna di un exchange, il campo third_party_buyer_token deve essere propagato così com'è nella risposta all'offerta tramite l'impressione Open Bidding. Ciò consente alle piattaforme per publisher di Google di 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 delle creatività Google così com'è nelle risposte all'offerta

Per garantire che la risoluzione delle discrepanze si applichi alle offerte della domanda di Google, una piattaforma di scambio deve propagare il markup delle creatività di Google senza wrapper (tag script, iframe o wrapper VAST). A causa della risoluzione delle discrepanze, Google potrebbe invalidare e non fatturare le impressioni Open Bidding che non sono state conteggiate dalle piattaforme della domanda di Google. Google controlla periodicamente il markup delle creatività per verificare che le offerte con third_party_buyer_token siano state inviate per conto della domanda di Google e non di altri acquirenti.

Creatività HTML5

È necessario uno scambio per inviare il markup HTML di Google così com'è, con le espansioni delle macro specifiche dello scambio che normalmente si applicano e, facoltativamente, pixel o script di monitoraggio aggiuntivi che uno scambio aggiunge normalmente.

Google non è in grado di applicare la risoluzione delle discrepanze se un exchange racchiude 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 avere diritto alla risoluzione della discrepanza, un exchange deve utilizzare uno dei seguenti approcci per compilare VASTTagURI nelle risposte XML VAST:

  1. Un exchange 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 dell'exchange 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 un exchange. Un exchange può quindi trasmettere questo valore con il tag VASTTagURI, con le macro specifiche dell'exchange espandibili normalmente in base alle esigenze.

Se necessario, un exchange può specificare ulteriori tracker di eventi ed errori VAST all'interno del documento XML VAST.

Offerte

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

Campo Descrizione
BidResponse.seatbid.bid.dealid L'ID deal dello spazio dei nomi dell'exchange associato all'offerta e comunicato ai publisher. Si tratta di testo UTF8 arbitrario e non deve superare i 64 byte.
BidResponse.seatbid.bid.ext.exchange_deal_type Un'enumerazione che specifica il tipo di deal. Queste informazioni vengono comunicate ai publisher e influiscono sul modo in cui l'accordo 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 popolare le tabelle di corrispondenza ospitate da Google, i partecipanti a Open Bidding possono utilizzare una delle opzioni riportate di seguito che meglio si adatta alle loro esigenze:

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

Gestione della latenza

Per stimare la latenza degli endpoint del tuo offerente quando rispondono alle richieste di offerta in entrata, devi utilizzare le località di trading indicate nella Guida al peering.

Le piattaforme di scambio di grandi dimensioni che ricevono un volume elevato di richieste di offerta devono valutare la possibilità di stipulare un accordo 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 per i clic. Questi consentiranno di generare report che includono clic e metriche derivate dai clic per il tuo account e per gli editori 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 l'accesso a queste API e per recuperare l'ID account necessario per effettuare chiamate API. Per assistenza tecnica sull'utilizzo di queste API, puoi contattare l'alias di assistenza adxbuyerapi-support@google.com.

Risorse aggiuntive

Esempi di richieste di offerta e risposte

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