Open Bidding-Integration konfigurieren

Mit Open Bidding können Anzeigenplattformen und andere Käufer die Infrastruktur von Google für Echtzeitgebote nutzen, um auf Google Ad Manager- und AdMob-Inventar zu bieten.

Damit Sie Open Bidding nutzen können, müssen Sie eine auf Ihren Open Bidding-Anwendungsfall zugeschnittene Integration von Echtzeitgeboten konfigurieren und Endpunkte der Gebotsfunktion an Ihren Google Account Manager senden, damit er testen kann, ob die Integration korrekt funktioniert. Hierbei handelt es sich um einen einmaligen Vorgang.

Integration auf ausgewählte Publisher beschränken

Ihre Open Bidding-Integration kann im privaten Modus bleiben, bis Sie Anfragen von einem beliebigen Publisher annehmen können. Im privaten Modus können Sie in Zusammenarbeit mit Ihrem Account-Management-Team eine Verbindung zu ausgewählten Publishern herstellen und diesen Status beibehalten, bis Sie zur Skalierung bereit sind. Nachdem Sie den privaten Modus beendet haben, ist Ihr Konto für alle Publisher sichtbar.

Unterstützte Protokolle und Codierung

Für Open Bidding werden die proprietären RTB-Protokolle von Authorized Buyers und OpenRTB-Echtzeitgeboten verwendet. Weitere Informationen

OpenRTB-Implementierung von Google

Die OpenRTB-Implementierung von Google unterstützt nicht alle Funktionen der OpenRTB-Spezifikation und fügt Erweiterungen für Authorized Buyers- und Open Bidding-spezifische Funktionen hinzu. Weitere Informationen zur OpenRTB-Implementierung von Google und deren Verbindung mit dem proprietären Protokoll für Echtzeitgebote von Authorized Buyers finden Sie im Leitfaden zu OpenRTB.

Eingehende Gebotsanfragen bearbeiten

Open Bidding nutzt dieselbe BidRequest-Struktur wie Authorized Buyers, einige Felder werden jedoch ausschließlich an Open Bidding-Teilnehmer gesendet. Weitere Informationen zu Open Bidding-spezifischen Feldern, die in der Gebotsanfrage gesendet werden, finden Sie im Leitfaden für Anfragen.

Mit einem Gebot antworten

Für Open Bidding wird außerdem eine BidResponse-Struktur verwendet, die der von Authorized Buyers ähnlich ist, wobei einige exklusive Felder an Open Bidding-Teilnehmer gesendet werden. Im Antwortleitfaden finden Sie weitere Informationen zu Open Bidding-spezifischen Feldern, mit denen Sie antworten können.

Je nach dem bevorzugten Anzeigenformat, für das Sie Gebote abgeben möchten, kann sich die Antwortstruktur erheblich unterscheiden. In den folgenden Anleitungen wird erläutert, wie Sie Ihre Gebotsanwendung konfigurieren, um mit Geboten für gängige Anzeigenformate zu reagieren:

Impressionen erfassen, um Abweichungen zu reduzieren

Es wird dringend empfohlen, das optionale Feld impression_tracking_url zu verwenden, um Daten auf Impressionsebene abzurufen, wann Google abrechnungsfähige Ereignisse erfasst, die Ihnen in Rechnung gestellt werden. Für OpenRTB wird er im Google-Protokoll als BidResponse.seatbid[].bid[].ext.impression_tracking_url und als BidResponse.ad[].impression_tracking_url angegeben.

Behebung von Google-Nachfragediskrepanzen (Beta)

Mit dieser Funktion wird dafür gesorgt, dass die Anzahl der Impressionen, für die eine Anzeigenplattform in Rechnung gestellt wird, der Anzahl der Impressionen entspricht, die über Google Display & Video 360 (DV360) bezahlt werden.

Durch die genaue Identifizierung der DV360-Impressionen, die über Open Bidding erzielt wurden, kann Google Anzeigenspam und Abweichungen bei abrechenbaren Ereignissen korrigieren, damit Ihnen keine Impressionen in Rechnung gestellt werden, für die Sie nicht bezahlt werden.

„google_query_id“ in Gebotsanfragen weitergeben

Damit die Anzahl der gültigen Impressionen der Google-Nachfrage übereinstimmt, muss google_query_id wie besehen von Open Bidding-Anfragen an die Google-Nachfrageplattformen weitergegeben werden. Das ist eine Voraussetzung für die Behebung von Open Bidding-Diskrepanzen. Die aktuell erwartete Länge von google_query_id beträgt etwa 64 Byte.

Das third_party_buyer_token in Gebotsantworten weitergeben

Falls die Google-Nachfrageplattform die interne Auktion einer Anzeigenplattform gewinnt, muss das Feld third_party_buyer_token wie besehen in der Gebotsantwort über die Open Bidding-Impression zurückgeschickt werden. So können Google-Publisher-Plattformen feststellen, dass das erfolgreiche Gebot eines Open Bidding-Partners ein Gebot im Auftrag der Google-Nachfrage für dieselbe Impressionsmöglichkeit ist. Die aktuelle maximale Länge dieses Felds beträgt voraussichtlich 150 Byte.

Google-Creative-Markup wie in Gebotsantworten übergeben

Damit die Behebung von Diskrepanzen auch für Gebote aus der Google-Nachfrage gilt, muss eine Anzeigenplattform das Google-Creative-Markup ohne Wrapper (Skript-Tags, iFrames oder VAST-Wrapper) weitergeben. Aufgrund der Behebung von Diskrepanzen kann Google Open Bidding-Impressionen, die von Google-Nachfrageplattformen nicht gezählt wurden, möglicherweise ungültig machen und nicht in Rechnung stellen. Google überprüft regelmäßig das Creative-Markup, um festzustellen, ob Gebote mit third_party_buyer_token im Namen der Google-Nachfrage und nicht von anderen Käufern eingereicht wurden.

HTML5-Creatives

Ein Austausch ist verpflichtet, das Google-HTML-Markup in der vorliegenden Form einzureichen, mit plattformspezifischen Makroerweiterungen, die normalerweise gelten, und optional mit zusätzlichen Tracker-Pixeln oder Skripts, die ein Austausch normalerweise hinzufügt.

Google kann die Diskrepanz nicht beheben, wenn eine Anzeigenplattform ein Google-HTML-Creative in ein Tag einbindet (script, iframe oder andere Methoden), das anschließend den HTML-Code von Google lädt oder rendert.

VAST-Video-Creatives

Damit die Abweichungen beseitigt werden können, muss ein Austausch einen der folgenden Ansätze verwenden, um VASTTagURI in VAST-XML-Antworten auszufüllen:

  1. Auf einer Anzeigenplattform kann der Wert des Elements VASTTagURI als Teil des VAST-XML-Dokuments beibehalten werden, das von Google im Feld adm unverändert zurückgegeben wird. Normalerweise gelten plattformspezifische Makroerweiterungen.
  2. In DV360 kann in Gebotsantworten auf eine Anzeigenplattform in das Feld nurl die URL eines VAST-Dokuments eingefügt werden. Eine Anzeigenplattform kann dann den Wert von nurl, mit dem Google (DV360) antwortet, in einem VASTTagURI-Tag übergeben. Die plattformspezifischen Makros werden nach Bedarf normal erweitert.

Bei Bedarf können von einer Anzeigenplattform zusätzliche VAST-Ereignis- und Fehler-Tracker im VAST-XML-Dokument angegeben werden.

Angebote

Anzeigenplattformen, die Open Bidding nutzen, können Preferred Deals oder private Auktionen mit Open Bidding verwenden. Die Deal-ID und der Dealtyp müssen so angegeben werden:

Feld Beschreibung
OpenRTB-Protokoll:
BidResponse.seatbid[].bid[].dealid

Google-Protokoll:
BidResponse.ad[].adslot[].exchange_deal_id		 Die Deal-ID aus dem Namespace der Anzeigenplattform, die mit dem Gebot verknüpft ist und an Publisher gemeldet wird. Dies ist beliebiger UTF8-Text und darf nicht mehr als 64 Byte umfassen.
OpenRTB-Protokoll:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Google-Protokoll:
BidResponse.ad[].adslot[].exchange_deal_type		 Eine Aufzählung, die den Dealtyp angibt. Die Publisher erhalten diese Informationen und wirken sich darauf aus, wie der Deal in der Auktion behandelt wird. Mögliche Werte sind:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Unten sehen Sie ein Beispiel für eine OpenRTB-Gebotsantwort für PD/PA.

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

Zum Füllen von von Google gehosteten Match-Tables können Open Bidding-Teilnehmer eine der folgenden Optionen verwenden, die ihren Anforderungen am besten entsprechen:

Latenz verwalten

Schätzen Sie anhand der Media-Einkaufszentralen im Peering-Leitfaden die Latenz Ihrer Bieterendpunkte bei der Beantwortung eingehender Gebotsanfragen.

Große Anzeigenplattformen, die ein hohes Volumen an Gebotsanfragen erhalten, sollten eine Peering-Vereinbarung mit Google in Betracht ziehen, um Latenz und Latenzschwankungen zu reduzieren. Weitere Informationen zum Peering

Klick-Makros

Wir empfehlen die Implementierung von Klick-Makros. So können Sie Berichte erstellen, die Klicks und von Klicks abgeleitete Messwerte für Ihr Konto und die Publisher enthalten, mit denen Sie zusammenarbeiten. Weitere Informationen

APIs

Open Bidding-Kunden können die Authorized Buyers REST APIs verwenden, um auf Daten zuzugreifen, die für die Fehlerbehebung hilfreich sein können. Derzeit kann nur auf die folgenden API-Ressourcen zugegriffen werden:

Wenden Sie sich an Ihren Technical Account Manager, um Ihr Konto für den Zugriff auf diese APIs zu konfigurieren und die für API-Aufrufe erforderliche Konto-ID abzurufen. Technischen Support bei der Verwendung dieser APIs erhalten Sie unter dem Support-Alias adxbuyerapi-support@google.com.

Weitere Ressourcen

Beispiele für Gebotsanfragen und -antworten

Beispiele für Gebotsanfragen und -antworten für alle unterstützten Protokolle finden Sie in den Leitfäden zu Anfragen und Antworten.