Open Bidding-Integration konfigurieren

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

Wenn Sie Open Bidding nutzen möchten, müssen Sie eine Echtzeitgebotsintegration konfigurieren, die für Ihren Open Bidding-Anwendungsfall angepasst ist. Senden Sie außerdem die Endpunkte (Codes) für die Gebotsfunktion an Ihren Google Account Manager, damit er sie testen und überprüfen kann, ob die Integration richtig 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 bereit sind, Anfragen von allen Publishern anzunehmen. Im privaten Modus können Sie mit Ihrem Account-Management-Team ausgewählte Publisher kontaktieren und diesen Status beibehalten, bis Sie bereit sind, zu skalieren. Sobald Sie den privaten Modus verlassen, ist Ihr Konto für alle Publisher sichtbar.

Unterstützte Protokolle und Codierung

Sie können OpenRTB im JSON- oder Protobuf-Format verwenden. Weitere Informationen

OpenRTB-Implementierung von Google

Die OpenRTB-Implementierung von Google unterstützt nicht alle Funktionen der OpenRTB-Spezifikation. Außerdem werden Erweiterungen für Authorized Buyers und Open Bidding-spezifische Funktionen hinzugefügt. Weitere Informationen finden Sie im OpenRTB-Leitfaden.

Eingehende Gebotsanfragen verarbeiten

Bei Open Bidding wird dieselbe BidRequest-Struktur wie bei Authorized Buyers verwendet. 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

Open Bidding verwendet auch eine BidResponse-Struktur, die der von Authorized Buyers ähnelt. Einige Felder werden ausschließlich an Open Bidding-Teilnehmer gesendet. Weitere Informationen zu Open Bidding-spezifischen Feldern, mit denen Sie antworten können, finden Sie im Leitfaden für Antworten.

Je nach bevorzugtem Anzeigenformat, mit dem Sie bieten möchten, kann sich die Antwortstruktur erheblich unterscheiden. In den folgenden Anleitungen erfahren Sie, wie Sie Ihre Bidder-Anwendung so konfigurieren, dass sie mit Geboten für gängige Anzeigenformate antwortet:

Impressionen erfassen, um Abweichungen zu verringern

Wir empfehlen Ihnen dringend, das optionale Feld BidResponse.seatbid.bid.ext.impression_tracking_url zu verwenden, um Daten auf Impressionsebene abzurufen, die Aufschluss darüber geben, wann Google abrechenbare Ereignisse erfasst, die Ihnen in Rechnung gestellt werden.

Behebung von Nachfragediskrepanzen durch Google (Beta)

Mit dieser Funktion soll dafür gesorgt werden, dass die Anzahl der Impressionen, die einer Anzeigenplattform in Rechnung gestellt werden, mit der Anzahl der Impressionen übereinstimmt, die über Google Display & Video 360 (DV360) bezahlt werden.

Die korrekte Ermittlung der DV360-Impressionen, die über Open Bidding erzielt wurden, ermöglicht Google, Anpassungen für Diskrepanzen infolge von Anzeigenspam und abrechenbaren Ereignissen vorzunehmen. So soll dafür gesorgt werden, dass Ihnen keine Impressionen in Rechnung gestellt werden, für die Sie nicht bezahlt werden.

Die google_query_id in Gebotsanfragen weitergeben

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

Das third_party_buyer_token in Gebotsantworten weitergeben

Wenn die Nachfrageplattform von Google die interne Auktion einer Anzeigenplattform gewinnt, muss das Feld third_party_buyer_token unverändert in der Gebotsanfrage zurück über die Open Bidding-Impression weitergegeben werden. So können Publisher-Plattformen von Google feststellen, ob das höchste Gebot eines Open Bidding-Partners ein Gebot im Namen der Google-Nachfrage für dieselbe mögliche Impression ist. Die aktuelle maximale Länge dieses Felds beträgt voraussichtlich 150 Byte.

Google-Creative-Markup unverändert in Gebotsantworten übergeben

Damit die Behebung von Diskrepanzen auf Gebote aus der Google-Nachfrage angewendet werden kann, muss eine Anzeigenplattform das Google-Creative-Markup ohne Wrapper (Script-Tags, Iframes oder VAST-Wrapper) weitergeben. Aufgrund der Behebung der Abweichungen werden Impressionen aus offenen Geboten, die von den Nachfrageplattformen von Google nicht gezählt wurden, möglicherweise von Google ungültig gemacht und nicht in Rechnung gestellt. Google prüft regelmäßig das Creative-Markup, um sicherzustellen, dass Gebote mit third_party_buyer_token im Namen der Google-Nachfrage und nicht im Namen eines anderen Käufers abgegeben wurden.

HTML5-Creatives

Eine Anzeigenplattform muss das Google-HTML-Markup in unveränderter Form mit den normalerweise anwendbaren plattformspezifischen Makroerweiterungen und optional zusätzlichen Tracker-Pixeln oder Scripts einreichen, die normalerweise von der Anzeigenplattform hinzugefügt werden.

Google kann die Behebung von Diskrepanzen nicht vornehmen, wenn ein Anzeigennetzwerk das Google-HTML-Creative in ein Tag (script, iframe oder andere Techniken) einbettet, über das der Google-HTML-Code anschließend geladen oder gerendert wird.

VAST-Video-Creatives

Damit die Diskrepanz behoben werden kann, muss eine Anzeigenplattform einen der folgenden Ansätze verwenden, um VASTTagURI in VAST-XML-Antworten anzugeben:

  1. Eine Anzeigenplattform kann den Wert des VASTTagURI-Elements als Teil des von Google zurückgegebenen VAST-XML-Dokuments im Feld BidResponse.seatbid.bid.adm unverändert beibehalten, einschließlich der normalerweise anwendbaren plattformspezifischen Makroerweiterungen.
  2. In DV360 kann das Feld BidResponse.seatbid.bid.adm.nurl in Gebotsanfragen an eine Anzeigenplattform mit einer VAST-Dokument-URL ausgefüllt werden. Eine Anzeigenplattform kann diesen Wert dann mit dem VASTTagURI-Tag übergeben. Anzeigenplattform-spezifische Makros werden bei Bedarf wie gewohnt erweitert.

Eine Anzeigenplattform kann bei Bedarf zusätzliche VAST-Ereignis- und Fehler-Tracker im VAST-XML-Dokument angeben.

Angebote

Anzeigenplattformen, die Open Bidding verwenden, können Preferred Deals (PD) und Private Auktionen (PA) mit Open Bidding kombinieren. Deal-ID und -Typ müssen so angegeben werden:

Feld Beschreibung
BidResponse.seatbid.bid.dealid Die Deal-ID aus dem Namespace der Anzeigenplattform, die mit dem Gebot verknüpft und an Publisher gesendet wird. Dies ist beliebiger UTF-8-Text und darf maximal 64 Byte lang sein.
BidResponse.seatbid.bid.ext.exchange_deal_type Ein Enum, das den Dealtyp angibt. Dieser Wert wird Publishern gemeldet und wirkt 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;

Im Folgenden finden Sie ein Beispiel für eine Gebotsantwort für 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"
    }
  }
}

Um von Google gehostete Abgleichstabellen zu füllen, können Open Bidding-Teilnehmer eine der folgenden Optionen verwenden, die ihren Anforderungen am besten entspricht:

Latenz verwalten

Sie sollten die Handelsstandorte im Peering-Leitfaden verwenden, um die Latenz zu schätzen, die Ihre Bieterendpunkte bei der Beantwortung eingehender Gebotsanfragen haben.

Große Anzeigenplattformen, die eine große Anzahl von Gebotsanfragen erhalten, sollten ein Peering-Abkommen mit Google abschließen, um Latenz und Latenzschwankungen zu reduzieren. Weitere Informationen zum Peering

Klick-Makros

Wir empfehlen die Implementierung von Klickmakros. So können Sie Berichte mit Klicks und auf Klicks basierenden Messwerten für Ihr Konto und die Publisher erstellen, mit denen Sie zusammenarbeiten. Weitere Informationen

APIs

Open Bidding-Kunden können über die Authorized Buyers REST APIs auf Daten zugreifen, die für die Fehlerbehebung nützlich sein können. Derzeit ist 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 Konto-ID abzurufen, die für API-Aufrufe erforderlich ist. Wenn Sie technischen Support bei der Verwendung dieser APIs benötigen, können Sie sich an den Support-Alias adxbuyerapi-support@google.com wenden.

Zusätzliche Ressourcen

Beispiel-Gebotsanfragen und ‑antworten

Beispiele für Gebotsanfragen und -antworten für alle unterstützten Protokolle finden Sie in den Leitfäden Anfrage und Antwort.