Configurare un'integrazione di Open Bidding

Open Bidding consente alle piattaforme di scambio pubblicitario e ad altri acquirenti di sfruttare 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'offerta in tempo reale integrazione personalizzata per il tuo caso d'uso di Open Bidding e invia lo strumento di offerta al tuo account manager Google per eseguire test al fine di verificare che funzioni correttamente. Si tratta di una procedura che dovrai svolgere solo una volta.

Limita l'integrazione a determinati publisher

L'integrazione di Open Bidding può rimanere in "modalità privata" fino a quando pronti ad accettare richieste di qualsiasi publisher. In modalità privata, puoi collaborerai con il team dedicato all'account per entrare in contatto con publisher selezionati e rimanere in in questo stato finché non è tutto pronto per la scalabilità. Una volta uscito dalla modalità privata, sarà visibile a tutti i publisher.

Protocolli supportati e codifica

Consigliamo di utilizzare l'implementazione OpenRTB di Google. Il protocollo delle offerte in tempo reale di Google è deprecato. Ulteriori informazioni.

Implementazione di Google OpenRTB

L'implementazione di OpenRTB di Google non supporta tutte le funzioni presenti nella della specifica OpenRTB e aggiunge estensioni per Authorized Buyers e OpenRTB Funzionalità specifica per le offerte. Per scoprire di più su OpenRTB di Google e della relazione con gli acquirenti Authorized Buyers di proprietà Consulta il protocollo delle offerte in tempo reale nella guida di OpenRTB.

Gestire le richieste di offerta in arrivo

Open Bidding utilizza la stessa struttura di BidRequest di Authorized ma alcuni campi vengono inviati esclusivamente ai partecipanti di Open Bidding. Consulta la Guida alla richiesta per saperne di più sui campi specifici di Open Bidding inviati nella richiesta di offerta.

Rispondere con un'offerta

Anche Open Bidding utilizza una struttura BidResponse simile a quella di Authorized Buyers, con alcuni campi esclusivi inviati a Open Bidding partecipanti. Consulta la Guida alle risposte. per saperne 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 risposta struttura può variare in modo significativo. Consulta le seguenti guide per aiutarti a configurare il tuo Domanda dello strumento di offerta di rispondere con offerte per 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 su quando Google registra la fatturazione eventi che ti verranno addebitati. Per OpenRTB, questo valore viene esposto come BidResponse.seatbid[].bid[].ext.impression_tracking_url, e come BidResponse.ad[].impression_tracking_url nel team protocollo.

Risoluzione delle discrepanze nella domanda di Google (beta)

Questa funzione ha lo scopo di garantire che il numero di impressioni per cui un la piattaforma di scambio pubblicitario è in linea con il numero di impressioni pagate Display di Google e Video 360 (DV360).

Identificando con precisione le impressioni DV360 pubblicate da Open Con l'asta, Google può quindi intervenire sulla presenza di spam negli annunci e discrepanze negli eventi fatturabili in modo che non ti vengano fatturate impressioni che non ti vengono pagate.

Propagare google_query_id nelle richieste di offerta.

Per garantire che il numero di impressioni valide corrisponda a della domanda di Google, il valore google_query_id deve essere propagato così com'è da Richieste di Open Bidding alle piattaforme di domanda di Google. Questo è un prerequisito Risoluzione delle discrepanze di Open Bidding. L'attuale lunghezza prevista google_query_id contiene circa 64 byte.

Propagare third_party_buyer_token nelle risposte all'offerta.

Nel caso in cui la piattaforma di domanda di Google si aggiudichi il servizio interno di in un'asta, il campo third_party_buyer_token deve essere propagato così com'è in la risposta all'offerta tramite l'impressione Open Bidding. Ciò consente le piattaforme per i publisher di Google per stabilire che l'offerta vincente Il partner di offerta è un'offerta per conto della domanda di Google per la stessa impressione l'opportunità. La lunghezza massima attuale di questo campo dovrebbe essere pari a 150 byte.

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

Per garantire che la risoluzione delle discrepanze venga applicata alle offerte di Domanda di Google, è necessaria una piattaforma di scambio per propagare il markup delle creatività di Google senza wrapper (tag di script, iframe o wrapper VAST). A causa delle risoluzione delle discrepanze, Google potrebbe invalidare e non fatturare per Impressioni di offerta non conteggiate dalle piattaforme di domanda di Google. Google controlla periodicamente il markup delle creatività per verificare che le offerte con third_party_buyer_token sono state inviate per conto della domanda di Google e nessun altro acquirente.

Creatività HTML5

Una piattaforma di scambio pubblicitario deve inviare il markup HTML di Google così com'è, con espansioni di macro specifiche della piattaforma di scambio pubblicitario che normalmente si applicano e, facoltativamente, i pixel tracker o gli script aggiuntivi normalmente aggiunti da una piattaforma di scambio pubblicitario.

Google non è in grado di applicare la risoluzione delle discrepanze se una piattaforma di scambio aggrega Google HTML in un tag (script, iframe o altro tecniche) che caricano o mostrano successivamente il codice HTML di Google.

Creatività video VAST

Per l'idoneità alla risoluzione delle discrepanze, una piattaforma di scambio deve utilizza uno dei seguenti approcci per compilare VASTTagURI in 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 adm così com'è, con espansioni di macro specifiche della piattaforma di scambio pubblicitario che normalmente si applicano.
  2. DV360 può completare il campo nurl con un URL del documento VAST in risposte all'offerta di una piattaforma di scambio pubblicitario. Una piattaforma di scambio pubblicitario può quindi passare il valore nurl con cui Google (DV360) risponde in VASTTagURI con le macro specifiche della piattaforma di scambio pubblicitario espanse normalmente in base alle necessità.

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

Offerte

Le piattaforme di scambio che partecipano a Open Bidding possono utilizzare Preferred deal (DP), Aste private 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 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'enumerazione che specifica il tipo di deal. Questo viene segnalato ai publisher e influisce sulle modalità di trattati 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 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 i campi tabelle delle corrispondenze, I partecipanti a Open Bidding possono utilizzare tutte le opzioni tra quelle riportate di seguito che meglio si adattano alle loro esigenze:

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

Gestione della latenza

Devi utilizzare le sedi di scambio presenti nei Guida al peering per stimare la latenza che avranno gli endpoint degli offerenti quando rispondono richieste di offerta in arrivo.

Le piattaforme di scambio pubblicitario di grandi dimensioni che ricevono un volume elevato di richieste di offerta dovrebbero prendere in considerazione stipulare un accordo di peering con Google per ridurre latenza e latenza volatilità. Scopri di più sul peering.

Macro di clic

Ti consigliamo di implementare le macro clic. Consentono di generare report che include i clic e le metriche derivate dai clic per il tuo account e per i publisher con cui collabori. Ulteriori informazioni.

API

I clienti di Open Bidding possono utilizzare le API REST di Authorized Buyers per accedere a dati che potrebbero essere utili per la risoluzione dei problemi. Solo il le seguenti risorse API sono attualmente accessibili:

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 rendere chiamate. Per assistenza tecnica sull'utilizzo di queste API, puoi contattare il adxbuyerapi-support@google.com alias di supporto.

Risorse aggiuntive

Esempi di richieste di offerta e risposte

Sono disponibili esempi di richieste di offerta e risposte per tutti i protocolli supportati in la Richiesta e Risposta guide.