Diese Seite wurde von der Cloud Translation API übersetzt.

Antwort erstellen

Nachdem Ihre Anwendung die Gebotsanfrage von Google verarbeitet hat, muss sie und eine Antwort senden. In diesem Leitfaden wird beschrieben, wie Sie Ihre Anwendung so programmieren, dass die Antwort erstellt wird.

Protobuf-BidResponse-Nachricht erstellen

Authorized Buyers sendet die BidRequest als Nachrichtentext einer HTTP-POST. Wenn Ihr Gebotsendepunkt für das Protobuf-Format konfiguriert ist, muss Ihre Anwendung eine Antwort mit dem Content-Type-Header senden, der auf application/octet-stream festgelegt ist, und einen Nachrichtentext mit einem serialisierten Protokoll-Zwischenspeicher. Das Protokoll Der Zwischenspeicher ist eine BidResponse-Nachricht gemäß Definition in openrtb.proto. Ihre Anwendung muss einen analysierbaren BidResponse als Antwort auf alle BidRequest. Zeitüberschreitungen Antworten, die nicht geparst werden können, werden als Fehler betrachtet und von Google gedrosselt. von Bietern mit hohen Fehlerraten unterstützt.

Wenn Sie nicht auf eine Impression bieten möchten, können Sie BidResponse.ext.processing_time_ms-Feld unverändert lassen und alle andere Felder leer. openrtb.proto finden Sie auf der Seite Referenzdaten.

Creative-ID

In Ihrem BidResponse wird ein Creative über das Feld BidResponse.seatbid.bid.crid angegeben (64 Byte). Ähnlich Creatives müssen eindeutige Werte für dieses Feld haben, wenn sie sich in Bezug auf Alle nennenswerten Merkmale, einschließlich, aber nicht beschränkt auf: Größe, deklarierte URL, Creative-Attribute und Anbietertypen. Mit anderen Worten: Sie müssen unterschiedlichen Creative-IDs zu zwei Anzeigen hinzufügen, die:

anders aussehen oder sich anders verhalten.
In verschiedenen Bildern rendern.
Wird auf unterschiedliche Weise gerendert, z. B. wenn eine Anzeige aus einem Bild, während das andere ein Video ist).

Bei der Entwicklung Ihrer Anwendung sollten Sie sich für eine systematische Kennungen generieren, die für die Art der Creatives, die Sie planen, sinnvoll sind die Sie einreichen möchten.

Anzeigenattribute

Google empfiehlt, Creative-Attribute zu deklarieren, um die Merkmale und Ausrichtung mithilfe einer Kombination aus BidResponse.seatbid.bid.apis und BidResponse.seatbid.bid.attr oder der BidResponse.seatbid.bid.ext.attribute. Die folgenden wird beschrieben, wie Sie Attribute deklarieren:

VPAID
Legen Sie BidResponse.seatbid.bid.apis auf VPAID_1 oder VPAID_2 fest. Für das JSON-Format kann dies auf 1 oder 2 festgelegt werden.
MRAID
BidResponse.seatbid.bid.apis festlegen auf MRAID_1 oder 3 für das JSON-Format.
SIZELESS
BidResponse.seatbid.bid.attr festlegen auf RESPONSIVE oder 18 für JSON Format.
PLAYABLE
Legen Sie dazu für BidResponse.seatbid.bid.attr den Wert USER_INTERACTIVE oder 13 für das JSON-Format fest.

Hinweis: Wenn Sie die BidResponse.seatbid.bid.ext.attribute-Erweiterung verwenden, können Sie die Werte in der Datei buyer-declarable-creative-attributes.txt verwenden, um diese Attribute anzugeben.

Weitere Informationen finden Sie in der Ressource vom Typ „Creatives“ finden Sie eine Erläuterung, wie Sie Feedback zu den erkannten Eigenschaften eines für Ihre Creatives.

Open Bidding-Felder

Gebotsantworten, die von Anzeigenplattform- und Netzwerkbietenden gesendet werden, die an Open Bidding teilnehmen Die Gebote ähneln denen von Authorized Buyers, Echtzeitgebote nutzen. Open Bidding-Kunden können eine geringe Anzahl von zusätzliche Felder. Für einige vorhandene Felder gibt es möglicherweise alternative Verwendungsmöglichkeiten. Dazu gehören:

OpenRTB	Authorized Buyers	Details
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	Die Deal-ID aus dem Namespace der Anzeigenplattform, die mit diesem Gebot verknüpft und an Publisher gesendet wird. Hinweis:Dieses Feld wird nur an Teilnehmer des geschlossenen Betatests gesendet.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Die Art des Deals, der den Publishern gemeldet wird und der sich auf den Deal auswirkt die in der Auktion behandelt werden. Hinweis:Dieses Feld wird nur an Teilnehmer des geschlossenen Betatests gesendet.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Token zur Identifizierung von Drittanbieterkäuferinformationen, falls das der Open Bidding-Plattform als Vermittler fungiert. Diese ergibt sich aus dem und muss unverändert im Gebot an Google übergeben werden. Antwort.

Empfehlungen

Aktivieren Sie persistente HTTPS-Verbindungen (auch als „Keep-Alive“ oder „Verbindungswiederverwendung“ bezeichnet) auf Ihren Servern. Legen Sie das Zeitlimit auf mindestens 10 Sekunden fest. Höhere Werte sind in vielen Fällen von Vorteil. Google überprüft während der anfänglichen Latenztests Ihrer Anwendung, Über Authorized Buyers werden häufig Anfragen gesendet. Latenz-Overhead beim Aufbau einer separaten TCP-Verbindung für jedes
Fügen Sie die optionale Impressions-Tracking-URL hinzu, um zu erfassen, wann die Impression gerendert wird, anstatt wann der Bieter den Zuschlag erhält. Aufgrund des Rückgangs zwischen Impressionen und Conversions lassen sich so genauere Tracking-Statistiken erstellen.

Hinweis:Bei Verwendung von OpenRTB lautet das Standardfeld dafür BidResponse.seatbid.bid.burl
Der Gebotscode darf keine Abhängigkeiten von veralteten Feldern haben, da dies zu Fehlern bei Geboten führen kann.
Fügen Sie BidResponse.seatbid.bid.w und BidResponse.seatbid.bid.h in Ihre BidResponse ein. A BidResponse zu einer Anfrage mit mehreren Anzeigengrößen muss diese Felder enthalten, sonst wird es aus der Auktion entfernt.
Begrenzen Sie die Antwortgröße auf unter 8 K. Sehr große Antworten können zunehmen Netzwerklatenz und Zeitüberschreitungen verursachen.
Befolgen Sie die Richtlinien für Gebote für iOS-Inventar abgeben, für das eine SKAdNetwork-Attribution erforderlich ist.

Beispiel für eine Gebotsantwort

Die folgenden Beispiele stellen für Menschen lesbare Beispiele des Protobuf- und JSON-Anfragen.

OpenRTB Protobuf

Beispiel anzeigen

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

Google

Beispiel anzeigen

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

Wichtig: Die in den Beispielen dargestellten Protobuf-Nachrichten sind hier als visuell lesbarer Text dargestellt. Das ist jedoch nicht die werden die Nachrichten über das Kabel gesendet. Wenn Sie das Google- oder OpenRTB-Protobuf-Format verwenden, werden nur serialisierte BidResponse-Nachrichten akzeptiert.

Sie können eine BidResponse-Nachricht mithilfe der Methode folgenden C++ Code:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Creative angeben

Ihre Gebotsantwort gibt die Anzeige an, die ausgeliefert werden soll, wenn Ihr Gebot den Zuschlag erhält. Ihr Gebot muss eines der unterstützten Anzeigenformate (AMP, Video, nativ) enthalten. In dieser das Creative mithilfe des Felds html_snippet angeben.

Alternativ können Sie Ihr Creative mit einem der folgenden Felder angeben, je nach Anzeigenformat:

SDK-gerenderte Anzeige
- BidResponse.seatbid.bid.ext.sdk_rendered_ad
AMP-Seiten
- BidResponse.seatbid.bid.amp_ad_url
Video
- BidResponse.seatbid.bid.adm
Nativ
- BidResponse.seatbid.bid.adm_native

Geben Sie im Feld BidResponse.seatbid.bid.adm eine Anzeige an, die auf Ihren eigenen Servern gehostet wird. Verwenden Sie dazu ein HTML-Snippet. Das Snippet ist in einem iFrame eingeschlossen, der in die Webseite eingefügt wird. Dadurch wird die Anzeige beim Laden der Seite abgerufen und gerendert. Das HTML-Snippet muss so gestaltet werden, dass der Eine Anzeige (Banner oder Interstitial) wird innerhalb eines iFrames korrekt und bei einer die für die Anzeigenfläche geeignet ist, auf die Sie bieten.

Außerdem muss die in der Gebotsantwort angegebene Anzeigengröße genau einem der Größenkombinationen in der Gebotsanfrage, wenn

Eine Anzeige ist ein normales Banner (kein Video-, natives oder Interstitial-Anzeigenformat).
Der Bieter hat die Größe in der Gebotsantwort angegeben. Angeben der Größe ist erforderlich, wenn die Anfrage mehr als eine Größe enthält.
Eine Ausnahme gilt für Interstitial-Anzeigen. Bei Interstitials muss die Breite mindestens 50 % der Bildschirmbreite und die Höhe mindestens 40 % der Bildschirmhöhe betragen.

Sie können ein HTML-Snippet-Creative mit jedem gültigen HTML-Code angeben, der korrekt gerendert wird. Beachten Sie jedoch die Einschränkungen beim Angeben des Feld crid im Bereich Create BidResponse message (Gebotsantwort-Nachricht erstellen): So können Sie beispielsweise zusätzliche Informationen in Argumente der URLs einfügen, die beim Rendern der Anzeige von Ihren Servern abgerufen werden. So können Sie zur Impression zurück an Ihre eigenen Server senden.

Die meisten Richtlinien für HTML-Snippets, die in Gebotsantworten zurückgegeben werden, entsprechen den für Drittanbieteranzeigen. Weitere Informationen finden Sie unter Authorized Buyers Programmrichtlinien, Anforderungen für Drittanbieter Anzeigenbereitstellung und Deklarieren Klick-URLs in Anzeigen.

Makros angeben

Makros sind formatierter Text, der in einige Felder für Gebotsanfragen eingebettet ist und URLs enthält, die bei der Anzeigenbereitstellung durch einen relevanten Wert ersetzt werden. Wenn Ihr erfolgreiches Gebot beispielsweise das Makro AUCTION_PRICE im HTML-Snippet-Creative enthielt, das mit Ihrem Gebot gesendet wurde, wird das Makro durch einen Wert ersetzt, den Sie entschlüsseln können, um den Betrag zu ermitteln, den Sie für die Impression in der Auktion bezahlt haben.

Sie können Makros in die folgenden Felder einfügen:

BidResponse.seatbid.bid.adm

Makros werden für HTML-Snippets, native Formate, Video-URLs und VAST-XML-Videoformate unterstützt.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

Nur die Google-spezifischen WINNING_PRICE und WINNING_PRICE_ESC-Makros werden für AMP-Creatives unterstützt.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

Verwenden Sie diese URL anstelle von BidResponse.seatbid.bid.burl, wenn Sie mehr als eine Abrechnungs-URL benötigen.

Sie können ein Makro zum Beispiel in ein HTML-Snippet einfügen, indem Sie Einbetten von ${MACRO} in die zum Abrufen des Creatives verwendete URL Dabei ist MACRO eines der unterstützten Makros, die im OpenRTB-Spezifikation

Google RTB-Makros

Neben den im OpenRTB enthaltenen Makros unterstützt Google weitere Makros. Spezifikation. Sie sind unterschiedlich formatiert und erscheinen %%MACRO%%, wenn in einer URL eingebettet. In der folgenden Tabelle wird beschrieben, diese Makros:

Makro	Beschreibung
`ADVERTISING_IDENTIFIER`	Ermöglicht Käufern, die iOS-IDFA oder die Werbe-ID von Android über Impressions-Rendering. Siehe Werbetreibenden-IDs entschlüsseln .
`CACHEBUSTER`	Stringdarstellung einer zufälligen 4-Byte-Ganzzahl ohne Vorzeichen.
`CLICK_URL_UNESC`	Die nicht maskierte Klick-URL für die Anzeige. Im Snippet wird ein mit Escape-Zeichen Version der Drittanbieter-Klick-URL direkt auf den . Wenn die Klick-URL des Drittanbieters beispielsweise `http://my.adserver.com/some/path/handleclick?click=clk` lautet, könnte der folgende Code mit der einmal ent escapeten Version der Klick-URL des Drittanbieters nach der Makroaufruf verwendet werden: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Bei der Anzeigenbereitstellung wird dies wie folgt erweitert: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Über die URL wird der Klick zuerst bei Google registriert und dann an die Klick-URL des Drittanbieters weitergeleitet.
`CLICK_URL_ESC`	Die entkommentierte Klick-URL für die Anzeige. Verwenden Sie dieses anstelle von `CLICK_URL_UNESC`, wenn der Wert zuerst übergeben werden muss der eine Weiterleitung zurückgibt. Der folgende Code könnte beispielsweise in einem HTML-Snippet verwendet werden: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Bei der Anzeigenbereitstellung wird dies wie folgt erweitert: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Dadurch wird der Klick mit `my.adserver.com` registriert, ist dann für die Weiterleitung an die im `google_click_url`-Parameter. Dabei wird davon ausgegangen, dass `my.adserver.com` den Parameter `google_click_url` entwirft. Sie können nach `%%CLICK_URL_ESC%%` eine doppelte URL-Escaping-Zeichenfolge anhängen. Nach der Entschlüsselung `my.adserver.com`, das eine einfache maskierte Version von Die an `google_click_url` angehängte URL. Wenn die `google_click_url` abgerufen wird, wird sie noch einmal entescaped und dann weitergeleitet.
`CLICK_URL_ESC_ESC`	Die doppelt maskierte URL für die Anzeige. Verwenden Sie dieses Makro anstelle von `CLICK_URL_UNESC`, wenn der Wert zuerst an einen anderen Server übergeben werden muss, der dann eine Weiterleitung zurückgibt. Der folgende Code könnte beispielsweise in einem HTML-Snippet verwendet werden: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> Bei der Anzeigenbereitstellung wird der Creative-Code folgendermaßen erweitert: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
`SCHEME`	Wird auf `http:` erweitert, wenn die Gebotsanfrage kein SSL erfordert oder `https:`, wenn für die Gebotsanfrage SSL erforderlich ist.
`SITE`	Die Domain mit maskierter URL der Content-URL oder bei anonymem Inventar die anonyme ID.
`SITE_URL`	Verworfen. Dieses Makro wurde durch das Makro SITE ersetzt, das identische Funktionen bietet.
`TZ_OFFSET`	Die Zeitzonenverschiebung.
`VERIFICATION`	Die verschiedenen Werte für die Produktion und für das Scannen des Creatives in der Bestätigungspipeline. Das Format ist: `%%?VERIFICATION:true-val:false-val%%`, wobei beliebige Werte außer Makros können für `true-val` und `false-val`, einschließlich leerer Strings. Für Open Bidding empfehlen Anzeigenplattformen, dieses Makro zu verwenden. ist die Nachfrageseite müssen keine Änderungen vorgenommen werden. Wenn ein Creative beispielsweise `%%?VERIFICATION:-1:5000%%` enthält, ist der Textersatz beim Ausliefern `5000` und in der Überprüfungspipeline `-1`. So können Sie diese beiden Pings unterscheiden.
`WINNING_PRICE`	Die codierten Kosten für die Impression (das heißt CPI statt CPM) in millionstel Einheiten der Kontowährung. Ein erfolgreiches CPM-Gebot von 5 US-Dollar entspricht 5.000.000 Millionstel CPM oder 5.000 Millionstel CPI. Der decodierte Wert von `WINNING_PRICE` wäre in diesem Fall 5.000. Der Preis für das erfolgreiche Gebot wird in CPI angegeben. Zum Parsen dieses Makros müssen Sie eine Anwendung implementieren, die entschlüsselt Preisbestätigungen. Weitere Informationen finden Sie im Preisbestätigungen entschlüsseln finden Sie weitere Informationen.
`WINNING_PRICE_ESC`	URL-entfernte `WINNING_PRICE`.

Google verlangt, dass Sie im Creative der vom Drittanbieter ausgelieferten Anzeige entweder das CLICK_URL_UNESC- oder das CLICK_URL_ESC-Makro verwenden. Google verwendet die CLICK_URL-Makros für das Klick-Tracking.

Für die URL-Escaping in Makros wird folgendes Schema verwendet:

Das Leerzeichen wird durch ein Pluszeichen (+) ersetzt.
Alphanumerische Zeichen (0–9, a–z, A–Z) und Zeichen aus dem Satz !()*,-./:_~ bleiben unverändert.
Alle anderen Zeichen werden durch %XX ersetzt, wobei XX die Hexadezimalzahl ist, die für das Zeichen steht.

Einschränkungen und Anforderungen für Publisher

Die Gebotsanfrage enthält Informationen zu den Einschränkungen und Anforderungen, die Publisher an Creatives in der Auktion stellen.

BidRequest.bcat
- Sie können die in diesem Feld angegebenen blockierten Kategorien mit denjenigen vergleichen, die für Ihre eingereichten Creatives im Feld detectedCategories der Real-time Bidding API erkannt wurden.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- In der Praxis ist dies immer auf true gesetzt, Google benötigt SSL-Unterstützung für alle Creatives.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes

Geben Sie niemals Gebote für Anzeigen ab, die eine eingeschränkte Funktion enthalten. Für zulässige Funktionen wie Anbietertyp, geben Sie eine Anzeige nur zurück, wenn der entsprechende Anbietertyp in der Liste allowed_vendor_type in BidRequest. Nur Anzeigenformate, die in der Gebotsanfrage durch Ausfüllen von Feldern wie BidRequest.imp.banner angegeben sind, sollten in Ihr Gebot aufgenommen werden. Weitere Informationen finden Sie in den Kommentaren zu diesen Feldern in der BidRequest-Protokoll-Bufferdefinition.

Wenn eine Anzeige in BidResponse zurückgegeben wird, müssen Sie BidResponse.seatbid.bid.attr genau festlegen, BidResponse.seatbid.bid.cat und entweder BidResponse.seatbid.bid.adomain oder BidResponse.seatbid.bid.adm_native.link.url-Felder im BidResponse Wenn eine Anzeige über mehrere anwendbare Werte für diese müssen Sie jeden Wert angeben. Kommentare zu diesen Feldern finden Sie unter Weitere Informationen finden Sie in der Protokollpufferdefinition BidResponse. Antworten, für die diese Felder nicht festgelegt sind, werden verworfen.

Open Measurement

Mit Open Measurement können Sie Drittanbieter angeben, die unabhängige Analyse- und Überprüfungsdienste für Anzeigen, die in mobilen Apps ausgeliefert werden Umgebungen.

Unterstützte Anzeigenformate sind Video-, Banner- und Interstitial-Anzeigen. Weitere Informationen zur Verwendung von Open Measurement in einer Gebotsantwort, die diese Formate enthält, finden Sie im Hilfeartikel Open Measurement SDK.

Beispiel für Gebotsantworten

In den folgenden Abschnitten finden Sie Beispielgebotsantworten für verschiedene Anzeigentypen.

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

Google

Beispiel anzeigen

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

App-Interstitial

OpenRTB Protobuf

Beispiel anzeigen

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

Google

Beispiel anzeigen

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

Video-Interstitial in Apps

OpenRTB Protobuf

Beispiel anzeigen

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Google

Beispiel anzeigen

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

Native App

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Google

Beispiel anzeigen

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

Webvideo

Google

Beispiel anzeigen

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

OpenRTB Protobuf

Beispiel anzeigen

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

Antwort erstellen

Protobuf-BidResponse-Nachricht erstellen

Creative-ID

Anzeigenattribute

Open Bidding-Felder

Empfehlungen

Beispiel für eine Gebotsantwort

OpenRTB Protobuf

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

Google

Beispiel anzeigen

Creative angeben

Makros angeben

Google RTB-Makros

Einschränkungen und Anforderungen für Publisher

Open Measurement

Beispiel für Gebotsantworten

App-Banner

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

Google

Beispiel anzeigen

App-Interstitial

OpenRTB Protobuf

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

Google

Beispiel anzeigen

Video-Interstitial in Apps

OpenRTB Protobuf

Beispiel anzeigen

Google

Beispiel anzeigen

Native App

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

Google

Beispiel anzeigen

Webvideo

Google

Beispiel anzeigen

Mobiles Webbanner für Bieter auf Anzeigenplattformen

OpenRTB Protobuf

Beispiel anzeigen