Open Bidding-Integration konfigurieren

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

Wenn Sie an Open Bidding teilnehmen möchten, konfigurieren Sie eine Echtzeitgebotsintegration, die auf Ihren Open Bidding-Anwendungsfall zugeschnitten 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 beliebigen Publishern anzunehmen. Im privaten Modus können Sie mit Ihrem Account-Management-Team zusammenarbeiten, um eine Verbindung zu ausgewählten Publishern herzustellen. Sie bleiben in diesem Modus, bis Sie bereit sind, Ihr Geschäft auszuweiten. Sobald Sie den privaten Modus beenden, 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

Google OpenRTB-Implementierung

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 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 Anfrageleitfaden.

Mit einem Gebot antworten

Bei Open Bidding wird ebenfalls eine BidResponse-Struktur verwendet, die der von Authorized Buyers ähnelt. Einige exklusive Felder werden 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, für das Sie Gebote abgeben möchten, kann sich die Antwortstruktur erheblich unterscheiden. In den folgenden Anleitungen finden Sie Informationen zum Konfigurieren Ihrer Bieteranwendung, damit Gebote für gängige Anzeigenformate zurückgegeben werden:

Impressionen erfassen, um Abweichungen zu verringern

Es wird dringend empfohlen, das optionale Feld BidResponse.seatbid.bid.ext.impression_tracking_url zu verwenden, um Daten auf Impressionsebene dazu abzurufen, wann Google abrechenbare Ereignisse erfasst, für die Ihnen Kosten 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 für die Google-Nachfrage übereinstimmt, muss die google_query_id unverändert von Open Bidding-Anfragen an Google-Nachfrageplattformen weitergegeben werden. Dies 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 Google-Demand-Plattform die interne Auktion einer Exchange gewinnt, muss das Feld third_party_buyer_token unverändert in der Gebotsantwort über die Open Bidding-Impression weitergegeben werden. So können Google-Publisher-Plattformen feststellen, dass das Gewinnergebot 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 150 Bytes.

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

Damit die Diskrepanzbehebung für Gebote aus der Google-Nachfrage gilt, muss eine Anzeigenplattform das Google-Creative-Markup ohne Wrapper (Script-Tags, iFrames oder VAST-Wrapper) weitergeben. Aufgrund der Behebung der Abweichung kann Google diese Open Bidding-Impressionen, die nicht von Google-Nachfrageplattformen gezählt wurden, ungültig machen und nicht in Rechnung stellen. Google prüft regelmäßig das Creative-Markup, um zu bestätigen, dass Gebote mit third_party_buyer_token im Namen der Google-Nachfrage und nicht im Namen eines anderen Käufers eingereicht wurden.

HTML5-Creatives

Für die Einreichung von Google-HTML-Markup wie es ist ist ein Austausch erforderlich. Dabei werden die normalerweise angewendeten austauschspezifischen Makroerweiterungen und optional zusätzliche Tracker-Pixel oder ‑Scripts, die ein Austausch normalerweise hinzufügt, verwendet.

Google kann keine Diskrepanzbehebung vornehmen, wenn eine Exchange das Google-HTML-Creative in ein Tag (script, iframe oder andere Techniken) einbettet, das anschließend Google-HTML-Code lädt oder rendert.

VAST-Video-Creatives

Damit eine Börse für die Behebung von Diskrepanzen infrage kommt, muss sie eine der folgenden Methoden verwenden, um VASTTagURI in VAST-XML-Antworten einzufügen:

  1. Bei einem Exchange kann der Wert des VASTTagURI-Elements als Teil des von Google zurückgegebenen VAST-XML-Dokuments im Feld BidResponse.seatbid.bid.adm unverändert beibehalten werden, wobei die normalerweise geltenden Exchange-spezifischen Makroerweiterungen angewendet werden.
  2. In DV360 kann das Feld BidResponse.seatbid.bid.adm.nurl mit einer VAST-Dokument-URL in Gebotsantworten an eine Exchange ausgefüllt werden. Die Börse kann diesen Wert dann mit dem VASTTagURI-Tag übergeben. Börsenspezifische Makros werden bei Bedarf wie gewohnt erweitert.

Bei Bedarf kann eine Exchange zusätzliche VAST-Ereignis- und Fehler-Tracker im VAST-XML-Dokument angeben.

Angebote

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

Feld Beschreibung
BidResponse.seatbid.bid.dealid Die Deal-ID aus dem Namespace der Exchange, die dem Gebot zugeordnet und Publishern gemeldet wird. Dies ist beliebiger UTF8-Text, der nicht länger als 64 Byte sein darf.
BidResponse.seatbid.bid.ext.exchange_deal_type Ein Enum, das den Dealtyp angibt. Dies wird Publishern gemeldet und wirkt sich darauf aus, wie der Deal in der Auktion behandelt wird. Mögliche Werte:
OPEN_AUCTION = 0;
PRIVATE_AUCTION = 1;
PREFERRED_DEAL = 2;
EXCHANGE_AUCTION_PACKAGE = 3;

Hier ist 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

Anhand der Handelsstandorte im Peering Guide können Sie die Latenz schätzen, die Ihre Bieterendpunkte bei der Reaktion auf eingehende Gebotsanfragen haben.

Größere Exchanges, die eine hohe Anzahl von Gebotsanfragen erhalten, sollten eine Peering-Vereinbarung mit Google in Betracht ziehen, um die Latenz und die Latenzvolatilität zu verringern. Weitere Informationen zum Peering

Klick-Makros

Wir empfehlen, Klickmakros zu implementieren. So können Sie Berichte erstellen, die Klicks und aus 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 nützlich sein können. Derzeit sind nur die folgenden API-Ressourcen zugänglich:

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, wenden Sie sich bitte an den Support-Alias adxbuyerapi-support@google.com.

Zusätzliche Ressourcen

Beispiel für Gebotsanfragen und ‑antworten

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