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 delle offerte in tempo reale personalizzata in base al tuo caso d'uso di Open Bidding e invia gli endpoint dello strumento di offerta al tuo account manager Google per i test e verificare che l'integrazione funzioni correttamente. Si tratta di una procedura che dovrai svolgere solo una volta.

Limitare l'integrazione a determinati publisher

L'integrazione di Open Bidding può rimanere in"modalità privata" finché non potrai accettare le richieste di qualsiasi publisher. Quando è attiva la modalità privata, puoi collaborare con il team dedicato al tuo account per entrare in contatto con publisher selezionati e rimanere in questo stato finché non è tutto pronto per la scalabilità. Quando esci dalla modalità privata, il tuo account sarà visibile a tutti i publisher.

Protocolli e codifica supportati

Open Bidding utilizza i protocolli proprietari di Authorized Buyers e OpenRTB RTB in tempo reale. Scopri di più.

Implementazione di Google OpenRTB

L'implementazione OpenRTB di Google non supporta tutte le funzionalità presenti nella specifica OpenRTB e aggiunge estensioni per le funzionalità specifiche di Authorized Buyers e Open Bidding. Per scoprire di più sull'implementazione di OpenRTB di Google e sulla sua correlazione con il protocollo proprietario delle offerte in tempo reale di Authorized Buyers, consulta la guida di 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 di Open Bidding. Per saperne di più sui campi specifici di Open Bidding inviati nella richiesta di offerta, consulta la guida alle richieste.

Rispondere con un'offerta

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

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

Monitorare le impressioni per ridurre le discrepanze

Ti consigliamo vivamente di utilizzare il campo facoltativo impression_tracking_url per recuperare i dati a livello di impressione relativi alla registrazione degli eventi fatturabili che ti verranno addebitati da Google. Per OpenRTB, questo viene indicato come BidResponse.seatbid[].bid[].ext.impression_tracking_url e BidResponse.ad[].impression_tracking_url nel protocollo Google.

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 di Open Bidding alle piattaforme di domanda di Google. Questo è un prerequisito per la risoluzione delle discrepanze di Open Bidding. L'attuale lunghezza prevista di 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 vince l'asta interna di una piattaforma di scambio, il campo third_party_buyer_token deve essere propagato così com'è nella risposta all'offerta tramite l'impressione di 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. L'attuale lunghezza massima 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 venga applicata alle offerte provenienti dalla domanda di Google, è necessaria una piattaforma di scambio per propagare il markup delle creatività Google senza wrapper (tag script, iframe o wrapper VAST). A causa della risoluzione della discrepanza, Google potrebbe invalidare e non fatturare le impressioni di Open Bidding che non sono state conteggiate dalle piattaforme di domanda di Google. Google controllerà 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

È necessaria una piattaforma di scambio per inviare il markup HTML di Google così com'è, con espansioni di macro specifiche della piattaforma di scambio pubblicitario che normalmente si applicano e, facoltativamente, pixel di tracker o script aggiuntivi che una piattaforma di scambio pubblicitario normalmente aggiunge.

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

Creatività video VAST

Per essere idonea alla risoluzione delle discrepanze, 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 nell'ambito del documento XML VAST restituito da Google nel campo adm così com'è, con espansioni macro specifiche della piattaforma che normalmente si applicano.
  2. DV360 può completare il campo nurl con un URL documento VAST nelle risposte alle offerte per una piattaforma di scambio pubblicitario. Una piattaforma di scambio pubblicitario può quindi passare il valore nurl con cui Google (DV360) risponde nel tag VASTTagURI, con le macro specifiche della piattaforma espanse normalmente secondo necessità.

Una piattaforma di scambio pubblicitario può specificare ulteriori tracker degli eventi e degli errori VAST all'interno del documento VAST XML, se necessario.

Offerte

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

Campo Descrizione
Protocollo OpenRTB:
BidResponse.seatbid[].bid[].dealid

Protocollo Google:
BidResponse.ad[].adslot[].exchange_deal_id		 L'ID deal dello spazio dei nomi della piattaforma di scambio pubblicitario associato all'offerta e riportato ai publisher. Si tratta di testo UTF8 arbitrario e non deve superare i 64 byte.
Protocollo OpenRTB:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Protocollo Google:
BidResponse.ad[].adslot[].exchange_deal_type		 Un'enum che specifica il tipo di deal. Questo viene segnalato ai publisher e influisce sul trattamento del deal 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 OpenRTB per DP/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 delle corrispondenze ospitate da Google, i partecipanti a Open Bidding possono utilizzare una delle opzioni riportate di seguito più adatte alle loro esigenze:

  • Corrispondenza dei cookie: corrispondenza avviata dall'acquirente o dalla piattaforma di scambio Scopri di più.
  • Corrispondenza dei 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 disponibili nella Guida al peering per stimare la latenza che avranno gli endpoint dello strumento di offerta quando rispondono alle richieste di offerta in arrivo.

Le grandi piattaforme di scambio pubblicitario che ricevono un volume elevato di richieste di offerta dovrebbero considerare 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

Consigliamo di implementare le macro clic. In questo modo sarà possibile generare report che includono metriche derivate da clic e clic per il tuo account e per i publisher con cui collabori. Scopri di più.

API

I clienti di Open Bidding possono utilizzare le API REST di Authorized Buyers per accedere a dati che possono essere utili per la risoluzione dei problemi. Al momento sono accessibili solo le seguenti risorse dell'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 dell'assistenza di adxbuyerapi-support@google.com.

Risorse aggiuntive

Richieste di offerta e risposte di esempio

Esempi di richieste di offerta e risposte per tutti i protocolli supportati sono disponibili nelle guide alle richieste e alle risposte.