Diese Seite wurde von der Cloud Translation API übersetzt.

Antwort erstellen

Nachdem Ihre Anwendung die Gebotsanfrage von Google verarbeitet hat, muss sie eine Antwort erstellen und senden. In dieser Anleitung wird erläutert, wie Sie Ihre Anwendung für das Erstellen der Antwort codieren.

BidResponse-Nachricht erstellen

Authorized Buyers sendet die BidRequest als Nachrichtentext eines HTTP-POST. Für die von Ihrer Anwendung gesendete Antwort muss der Header Content-Type auf application/octet-stream gesetzt sein und der Nachrichtentext aus einem serialisierten Protokollpuffer bestehen. Der Protokollpuffer ist eine BidResponse-Nachricht, wie in realtime-bidding.proto definiert. Ihre Anwendung muss als Antwort auf jeden BidRequest eine analysierbare BidResponse zurückgeben. Zeitüberschreitungen und Antworten, die nicht geparst werden können, werden als Fehler betrachtet. Bieter mit hohen Fehlerraten werden von Google gedrosselt.

Wenn Sie nicht auf eine Impression bieten möchten, legen Sie nur einen Wert im Feld processing_time_ms fest und lassen Sie die anderen Felder leer. Sie können realtime-bidding.proto auf der Seite Referenzdaten abrufen.

Creative-ID

In BidResponse wird ein Creative über das Feld buyer_creative_id angegeben (maximal 64 Byte). Auch ähnliche Creatives müssen eindeutige Werte für buyer_creative_id haben, wenn sie sich in wichtigen Merkmalen unterscheiden, einschließlich, aber nicht beschränkt auf Größe, deklarierte URL, Creative-Attribute und Anbietertypen. Sie müssen also zwei Anzeigen unterschiedliche Creative-IDs zuweisen, die:

Aussehen oder Verhalten variieren.
Mit verschiedenen Bildern rendern.
Sie werden auf unterschiedliche Weise gerendert. So besteht eine Anzeige beispielsweise aus einem Bild, die andere enthält Flash.

Beim Entwerfen Ihrer Anwendung sollten Sie sich für eine systematische Methode zur Generierung von Kennungen entscheiden, die für die Arten von Creatives, die Sie senden möchten, sinnvoll ist.

Anzeigenattribute

Die Creative-Attribute, mit denen die Anzeigeneigenschaften und die Ausrichtung umfassend beschrieben werden, müssen in BidResponse.Ad.attribute deklariert werden. Folgende Attribute müssen deklariert werden. Eine vollständige Liste der unterstützten Attribute finden Sie unter buyer-declarable-creative-attributes.txt:

7 Tagging: IsTagged
Die Anzeige enthält ein Pixel oder ein Web-Beacon, um eine Liste von Cookie-IDs für ein nachfolgendes Remarketing zu erstellen.
8 Remarketing: IsRemarketing
Die Anzeige wird anhand ihrer Cookie-ID oder Geräte-ID auf Nutzer ausgerichtet. Die Liste der Cookie-IDs oder Geräte-IDs steht für eine Gruppe von Nutzern, die bereits mit einer Website interagiert haben, die der Käufer besitzt oder die er repräsentiert.
9 UserInterestTargeting: IsUserInterestTargeted
Die Anzeige wird anhand ihrer Cookie-ID oder Geräte-ID auf Nutzer ausgerichtet, wobei die Liste der Cookie-IDs oder Geräte-IDs eine Nutzergruppe darstellt, die vom Käufer als Gruppe mit gemeinsamen Interessen definiert wurde.
30 InstreamVastVideoType: Vpaid
Zum Rendern der Anzeige ist VPAID-Unterstützung erforderlich.
32 MraidType: MRAID
Zum Rendern der Anzeige ist die MRAID API erforderlich.

Außerdem werden die folgenden Attribute unterstützt, ihre Deklaration ist jedoch nicht erforderlich, da Authorized Buyers sie automatisch erkennt und Ihre Creatives auf Grundlage der erkannten Werte blockiert (oder zugelassen) und nicht auf Grundlage Ihrer Deklaration. Informationen dazu, wie Sie Feedback zu den erkannten Eigenschaften Ihrer Creatives erhalten, finden Sie unter Creatives API.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
Zum Rendern der Anzeige ist Flash-Unterstützung erforderlich.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
Für die Darstellung der Anzeige ist kein Flash erforderlich.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
Die Anzeige kann auf einer SSL-Seite gerendert werden. In Authorized Buyers werden Creatives mit unterschiedlichen deklarierten Werten für dieses Attribut als unterschiedlich behandelt. Sie werden separat geprüft und haben einen unterschiedlichen Freigabestatus. Wenn Sie für dieselbe Anzeige sowohl SSL- als auch Nicht-SSL-Versionen verwenden, sollten Sie dieses Attribut entsprechend deklarieren, damit diese Unterscheidung in AdX korrekt widergespiegelt wird.

Open Bidding-Felder

Gebotsantworten, die von Bietern auf Anzeigenplattform und Netzwerken gesendet werden, die Open Bidding nutzen, ähneln denen von Authorized Buyers, die standardmäßige Echtzeitgebote nutzen. Open Bidding-Kunden können eine kleine Anzahl zusätzlicher Felder angeben. Einige der vorhandenen Felder können für andere Zwecke genutzt werden. 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 gemeldet wurde. Hinweis:Dieses Feld wird derzeit nur an Teilnehmer der geschlossenen Betaphase gesendet.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Die Art des Deals, der den Publishern gemeldet wird und sich darauf auswirkt, wie der Deal in der Auktion behandelt wird. Hinweis:Dieses Feld wird derzeit nur an Teilnehmer der geschlossenen Betaphase gesendet.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Token zur Identifizierung von Drittanbieter-Käuferinformationen, wenn die Anzeigenplattform als Open Bidding-Bieter fungiert. Diese wird vom Drittanbieterkäufer abgerufen und muss in der Gebotsantwort unverändert an Google übergeben werden.

Empfehlungen

Aktivieren Sie dauerhafte HTTPS-Verbindungen auf Ihren Servern. Diese werden auch als „Keep-Alive“ oder „Wiederverwendung von Verbindungen“ bezeichnet. Legen Sie das Zeitlimit auf mindestens 10 Sekunden fest. Höhere Werte sind in vielen Fällen vorteilhaft. Google überprüft dies während der anfänglichen Latenztests Ihrer Anwendung, da Authorized Buyers Anfragen mit einer hohen Rate sendet und der Latenz-Overhead zum Herstellen einer separaten TCP-Verbindung für jede Anfrage vermieden werden muss.
Geben Sie die optionale Impressions-Tracking-URL an, damit erfasst wird, wann die Impression gerendert wird und nicht, wann der Bieter gewinnt. Aufgrund der Abfallrate zwischen Gewinnen und Renderings liefert dies genauere Tracking-Statistiken.

Hinweis: Wenn Sie OpenRTB 2.5 oder höher verwenden, ist das Standardfeld dafür BidResponse.seatbid[].bid[].burl.
Halten Sie Ihren Bietercode frei von Abhängigkeiten von veralteten Feldern, da Ihre Gebote andernfalls möglicherweise fehlschlagen.
Nimm BidResponse.Ad.width und BidResponse.Ad.height in deine BidResponse auf. Eine BidResponse zu einer Anfrage mit mehreren Anzeigengrößen muss die Werte width und height enthalten. Andernfalls wird sie aus der Auktion ausgeschlossen.
Beschränken Sie die Antwortgröße auf weniger als 8 KB. Sehr große Antworten können die Netzwerklatenz erhöhen und Zeitüberschreitungen verursachen.
Beachten Sie die Richtlinien für Gebote für iOS-Inventar, für die eine SKAdNetwork-Attribution erforderlich ist.

Beispiel für eine Gebotsantwort

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

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: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "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"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    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: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

Wichtig:Die in den Beispielen dargestellten Protobuf-Meldungen werden hier als menschenlesbarer Text dargestellt. Dies ist jedoch nicht die Art und Weise, wie die Nachrichten über die Leitung gesendet werden. Bei Verwendung des Google- oder OpenRTB-Protobuf-Formats werden nur serialisierte BidResponse-Nachrichten akzeptiert.

Mit dem folgenden C++-Code können Sie eine BidResponse-Nachricht erstellen und serialisieren:

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 das Creative an, das ausgeliefert werden soll, wenn Ihr Gebot gewinnt. Ihr Gebot muss eines der unterstützten Anzeigenformate enthalten (AMP, Video, nativ). In diesem Beispiel wird das Creative im Feld html_snippet angegeben.

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

Vom SDK gerenderte Anzeige
- BidResponse.Ad.sdk_rendered_ad
AMP
- BidResponse.Ad.amp_ad_url
Video
- BidResponse.Ad.video_url oder
- BidResponse.Ad.video_vast_xml
Nativ
- BidResponse.Ad.native_ad

Geben Sie eine Anzeige, die auf Ihren eigenen Servern gehostet wird, mithilfe eines HTML-Snippets im Feld html_snippet der Datei BidResponse an. Das Snippet ist in einem in die Webseite eingefügten iFrame enthalten. Dadurch wird die Anzeige abgerufen und gerendert, wenn die Seite geladen wird. Sie müssen das HTML-Snippet so gestalten, dass die Anzeige (Banner oder Interstitial) in einem iFrame korrekt und in einer für die Anzeigenfläche, auf die Sie bieten, geeigneten Größe gerendert wird.

Außerdem muss die in der Gebotsantwort angegebene Anzeigengröße genau mit einer der Größenkombinationen in der Gebotsanfrage übereinstimmen, wenn

Eine Anzeige ist ein normales Banner (keine Video-, nativen oder Interstitial-Anzeigen).
Der Bieter hat die Größe in der Gebotsantwort deklariert. Eine Größendeklaration ist immer erforderlich, wenn in der Anfrage mehr als eine Größe angegeben ist.
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.

Das Feld html_snippet unterstützt jeden gültigen HTML-Code, der korrekt gerendert wird. Beachten Sie jedoch die Einschränkungen bei der Angabe des Felds buyer_creative_id im Abschnitt BidResponse-Nachricht erstellen. Eine Möglichkeit besteht darin, zusätzliche Informationen in die Argumente der URLs aufzunehmen, die von Ihren Servern im Rahmen des Renderings der Anzeige abgerufen werden. So können Sie beliebige Daten über die Impression zurück an Ihre eigenen Server übergeben.

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

Makros angeben

Das HTML-Snippet, mit dem ein Creative definiert wird, kann ein oder mehrere spezielle Konstrukte, sogenannte Makros, enthalten. Bei der Anzeigenbereitstellung werden Makros durch Werte ersetzt. Ihre Client-Gebotsanwendung könnte beispielsweise mit dem Makro WINNING_PRICE ermitteln, wie viel sie für die Anzeige bezahlt hat, wenn sie die Auktion gewinnt. Zum Parsen dieses Makros müssen Sie eine Anwendung implementieren, die Preisbestätigungen entschlüsselt. Weitere Informationen finden Sie auf der Seite Preisbestätigungen entschlüsseln.

Geben Sie ein Makro als Teil eines HTML-Snippets im Format %%MACRO%% an, wobei MACRO eines der unterstützten Makros ist, die in der folgenden Tabelle aufgeführt sind.

Hinweis:Für Gebotsantworten auf AMP-Anzeigen (amp_ad_url) werden nur die Makros WINNING_PRICE und WINNING_PRICE_ESC unterstützt.

Im Creative der von einem Drittanbieter ausgelieferten Anzeige muss das Makro CLICK_URL_UNESC oder CLICK_URL_ESC verwendet werden. Google verwendet die CLICK_URL-Makros für das Klick-Tracking.

Wenn Sie ein Makro verwenden möchten, fügen Sie es in die Anzeige ein, sodass die URL abgerufen wird, wenn jemand darauf klickt. Der Rückgabewert des Abrufs ist eine Weiterleitung zu einer anderen URL, die Sie an die CLICK_URL anhängen.

Makro	Beschreibung
`ADVERTISING_IDENTIFIER`	Damit erhalten Käufer beim Impressions-Rendering die IDFA von iOS oder die Werbe-ID von Android. Weitere Informationen finden Sie unter Werbetreibenden-IDs entschlüsseln.
`CACHEBUSTER`	Stringdarstellung einer zufälligen, vorzeichenlosen Vier-Byte-Ganzzahl.
`CLICK_URL_UNESC`	Die Klick-URL ohne Escape-Zeichen für die Anzeige. Im Snippet sollte direkt auf das Makro eine maskierte Version der Klick-URL des Drittanbieters folgen. Wenn die Drittanbieter-Klick-URL beispielsweise `http://my.adserver.com/some/path/handleclick?click=clk` lautet, kann der folgende Code mit der einfach maskierten Version der Drittanbieter-Klick-URL nach dem 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> Die URL registriert den Klick zuerst bei Google und leitet ihn dann an die Klick-URL des Drittanbieters weiter.
`CLICK_URL_ESC`	Die Klick-URL mit Escape-Zeichen für die Anzeige. Verwenden Sie dieses anstelle von `CLICK_URL_UNESC`, wenn der Wert zuerst über einen anderen Server übergeben werden muss, der dann eine Weiterleitung zurückgibt. Beispielsweise könnte der folgende Code 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 bei `my.adserver.com` registriert, der dann für die Weiterleitung an die im `google_click_url`-Parameter übergebene URL verantwortlich ist. Dies setzt voraus, dass `my.adserver.com` den Parameter `google_click_url` decodiert. Sie können eine URL mit doppelter Escape-Angabe nach `%%CLICK_URL_ESC%%` anhängen. Nach der Decodierung durch `my.adserver.com` bleibt eine einfach maskierte Version der URL an `google_click_url` angehängt. Wenn das `google_click_url` abgerufen wird, wird es noch einmal decodiert und dann weitergeleitet.
`CLICK_URL_ESC_ESC`	Die doppelt maskierte URL der Anzeige. Verwenden Sie dieses anstelle von `CLICK_URL_UNESC`, wenn der Wert zuerst über einen anderen Server übergeben werden muss, der dann eine Weiterleitung zurückgibt. Beispielsweise könnte der folgende Code 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 dies wie folgt 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`	Es wird auf `http:` erweitert, wenn für die Gebotsanfrage kein SSL erforderlich ist, bzw. auf `https:`, wenn für die Gebotsanfrage SSL erforderlich ist.
`SITE`	Die URL-Escaping-Domain der Content-URL oder die anonyme ID bei anonymem Inventar.
`SITE_URL`	Veraltet. Dieses Makro wird durch das Makro SITE ersetzt, das identische Funktionen bietet.
`TZ_OFFSET`	Die Zeitverschiebung.
`VERIFICATION`	Die verschiedenen Werte für die Produktion und den Zeitpunkt, zu dem das Creative in der Überprüfungspipeline gescannt wird Das Format ist `%%?VERIFICATION:true-val:false-val%%`, wobei für `true-val` und `false-val` alle Werte außer Makros verwendet werden können, auch leere Strings. Für Open Bidding wird empfohlen, dieses Makro für Anzeigenplattformen zu verwenden. Danach müssen auf Demand-Side-Plattformen keine Änderungen vorgenommen werden. Wenn ein Creative beispielsweise `%%?VERIFICATION:-1:5000%%` enthält, würde der Textersatz bei der Auslieferung `5000` und bei der Überprüfung `-1` lauten. Dies soll helfen, zwischen diesen beiden Arten von Pings zu unterscheiden.
`WINNING_PRICE`	Die codierten Kosten der Impressionen (d. h. CPI statt CPM) in millionstel Einheiten der Kontowährung. Ein erfolgreiches CPM-Gebot von 5 $entspricht beispielsweise einem CPM von 5.000.000 micros. Der CPI liegt bei 5.000 micros. Der decodierte Wert von `WINNING_PRICE` wäre in diesem Fall 5.000. Der Preis für das erfolgreiche Gebot ist als CPI angegeben.
`WINNING_PRICE_ESC`	`WINNING_PRICE` mit URL-Escaping.

Die URL-Escaping-Funktion in Makros verwendet das folgende Schema:

Das Leerzeichen wird durch ein Pluszeichen (+) ersetzt.
Alphanumerische Zeichen (0–9, a–z, A–Z) und die Zeichen !()*,-./:_~ bleiben unverändert.
Alle anderen Zeichen werden durch %XX ersetzt, wobei XX der Hexadezimalzahl entspricht, die das Zeichen darstellt.

Beschränkungen durch den Publisher

Publisher verwenden das BidRequest, um Einschränkungen für zugelassene Anzeigen zu übergeben. Sie müssen die Einschränkungen in den folgenden Feldern erzwingen:

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

Das eine Feld gibt die zulässigen Funktionen der Anzeige an, das andere gibt die unzulässigen Merkmale an. Geben Sie keine Anzeige mit einer nicht zugelassenen Funktion zurück. Für zulässige Features wie den Anbietertyp wird nur dann eine Anzeige zurückgegeben, wenn der entsprechende Anbietertyp in der Liste allowed_vendor_type im BidRequest enthalten ist. Weitere Informationen finden Sie in den Kommentaren zu diesen Feldern in der Protokollpufferdefinition BidRequest.

Wenn in BidResponse ein HTML-Snippet zurückgegeben wird, müssen die Felder attribute, category und click_through_url in BidResponse richtig festgelegt werden. Wenn eine Anzeige mehrere anwendbare Werte für diese Felder hat, muss jeder Wert angegeben werden. Weitere Informationen finden Sie in den Kommentaren zu diesen Feldern in der BidResponse-Protokollpufferdefinition. Antworten, für die diese Felder nicht festgelegt sind, werden verworfen.

Für BidRequest.excluded_attribute sind folgende Werte möglich (siehe publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
Anzeigen sind nicht zulässig, wenn sie ein Pixel oder ein Web-Beacon enthalten, um eine Liste von Cookie-IDs für ein späteres Remarketing zu erstellen.
8 CookieTargeting: IsCookieTargeted
Anzeigen sind nicht zulässig, wenn sie basierend auf ihrer Cookie-ID auf Nutzer ausgerichtet sind. Die Liste der Cookie-IDs steht für eine Gruppe von Nutzern, die bereits mit einer Website interagiert haben, die dem Käufer gehört oder von ihm repräsentiert wird.
9 UserInterestTargeting: IsUserInterestTargeted
Anzeigen sind nicht zulässig, wenn sie basierend auf ihrer Cookie-ID auf Nutzer ausgerichtet werden. Die Liste der Cookie-IDs steht für eine Nutzergruppe, die vom Käufer als Gruppe mit gemeinsamen Interessen definiert wurde.
21 CreativeType: Html
Anzeigen dürfen das Feld html_snippet oder snippet_template in BidResponse.Ad nicht verwenden.
22 CreativeType: VastVideo
Anzeigen dürfen das Feld video_url in BidResponse.Ad nicht verwenden.
30 InstreamVastVideoType: Vpaid
Für das Rendering von Anzeigen darf keine VPAID-Unterstützung erforderlich sein.
32 MraidType: MRAID
Anzeigen dürfen kein Rendering über die MRAID API erfordern.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
Anzeigen dürfen nur mit Flash-Unterstützung gerendert werden.
39 RichMediaCapabilityType: RichMediaCapabilityHTML5
Für das Rendern von Anzeigen dürfen keine HTML5-Funktionen erforderlich sein.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Anzeigen dürfen keine Nicht-SSL-Anfragen stellen.

Wenn das Feld excluded_attribute also den Wert 7 enthält, sollten Sie keine Anzeige zurückgeben, die ein Pixel oder ein Web-Beacon zum Erstellen einer Liste verwendet. In diesem Fall muss eine Anzeige den Wert 7 im Attributfeld von BidResponse festlegen. Wenn das Feld excluded_attribute den Wert 48 enthält, sollten Sie nur Anzeigen zurückgeben, die auf einer SSL-Seite gerendert werden können. Deklarieren Sie entsprechend das Attribut 47 RichMediaCapabilityType: RichMediaCapabilitySSL.

Außerdem verwendet das Feld excluded_sensitive_category in BidRequest Codes aus der Datei ad-sensitive-categories.txt, die auf der Seite Referenzdaten verfügbar ist. Im Folgenden finden Sie ausführliche Beschreibungen einiger dieser Codes:

3 Politics
Umfasst politische und kontroverse soziale Themen; beinhaltet keine Anzeigen für Nachrichtenagenturen, die im Allgemeinen nicht mit voreingenommenen Ansichten zu Themen in Verbindung gebracht werden.
4 Dating
Umfasst Dating-Services und Onlinedating-Communities.
5 Religion
Umfasst religiöse Anzeigen und Anzeigen, die sich für oder gegen religiöse Ansichten aussprechen; beinhaltet keine astrologischen Anzeigen oder Anzeigen mit nichtkonfessionellen, spirituellen Aussagen.
7 Video Games (Casual & Online)
Umfasst Videospiele, Onlinespiele und herunterladbare Spiele; beinhaltet keine Videospielkonsolen.
8 Ringtones & Downloadables
Add-ons für Mobilgeräte (z. B. Klingeltöne) und andere Downloads, etwa Bildschirmschoner und -hintergründe für Desktop-PCs oder Profillayouts und Grafiken für soziale Netzwerke
10 Get Rich Quick
Modelle, die schnelle Einnahmen versprechen
18 Weight Loss
Umfasst Gewichtsabnahme, Diäten und damit verbundene Produkte und Programme; beinhaltet keine Anzeigen, die sich auf gesunde Ernährung oder allgemeine Fitness beziehen.
19 Cosmetic Procedures & Body Modification
Umfasst Lifting, Fettabsaugung, Lasern, Haarentfernung und -transplantation, Tätowierungen und Körpermodifikationen.
23 Drugs & Supplements:
Umfasst Arzneimittel, Vitamine, Nahrungsergänzungsmittel und damit verbundene Händler; beinhaltet keine Ressourcen, die Informationen zu Drogen enthalten.
24 Sexual & Reproductive Health
Umfasst Anzeigen, die sich mit der sexuellen Funktion und der Fruchtbarkeit befassen; beinhaltet keine herkömmlichen Schwangerschaftsressourcen.
35 Social Casino Games
Umfasst Glücksspielsimulationen, darunter Poker, Spielautomaten, Bingo, Lotterien, Sportwetten, Wetten auf Rennen, sonstige Kartenspiele und Casinospiele, bei denen es nichts Werthaltiges wie Geld oder Preise zu gewinnen gibt.
36 Significant Skin Exposure
Anzeigenbilder, auf denen ein menschlicher Körper zwischen Brustbein und Oberschenkel nicht oder nur mit Unterwäsche, Badebekleidung, Dessous, durchsichtiger Kleidung oder Stoff wie einem Handtuch oder Bettlaken bekleidet ist
37 Sensationalism
Anzeigen, mit denen die Neugier von Nutzern geweckt werden soll, damit sie auf die Anzeige klicken. Hierzu wird oft ein Teaser mit effekthaschendem Text oder entsprechenden Bildern verwendet. Dazu gehören Anzeigen zu reißerischen Themen (z. B. Verhaftungen, Todesfälle oder Scheidungen von Prominenten) oder Anzeigen, die schockieren sollen.

Offene Messung

Mit Open Measurement können Sie Drittanbieter angeben, die unabhängige Mess- und Verifizierungsdienste für Anzeigen bereitstellen, die in mobilen App-Umgebungen ausgeliefert werden.

Derzeit werden Video-, Banner- und Interstitial-Anzeigen unterstützt. Weitere Informationen zur Verwendung von Open Measurement in einer Gebotsantwort mit diesen Formaten finden Sie im Hilfeartikel Open Measurement SDK.

Beispiele für Gebotsantworten

In den folgenden Abschnitten sehen Sie Beispiele für Gebotsantworten für verschiedene Anzeigentypen.

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: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "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>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    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: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

App-Interstitial

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: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "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": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    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: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

App-Interstitial-Video

Google

Beispiel anzeigen

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

OpenRTB-Protokollzwischenspeicher

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"

App-nativ

Google

Beispiel anzeigen

ad {
  adslot {
    id: 1
    max_cpm_micros: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  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: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    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"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

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-Protokollzwischenspeicher

Beispiel anzeigen

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    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: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}

Antwort erstellen

BidResponse-Nachricht erstellen

Creative-ID

Anzeigenattribute

Open Bidding-Felder

Empfehlungen

Beispiel für eine Gebotsantwort

Google

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

Creative angeben

Makros angeben

Beschränkungen durch den Publisher

Offene Messung

Beispiele für Gebotsantworten

App-Banner

Google

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

App-Interstitial

Google

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

App-Interstitial-Video

Google

Beispiel anzeigen

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

App-nativ

Google

Beispiel anzeigen

OpenRTB-JSON

Beispiel anzeigen

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

Webvideo

Google

Beispiel anzeigen

Mobiles Web-Banner für Anzeigenplattform-Bieter

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen