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 erläutert, wie Sie Ihre Anwendung für die Erstellung auf die Antwort.

Gebotsantwort-Nachricht erstellen

Authorized Buyers sendet die BidRequest als Nachrichtentext von ein HTTP-POST. Die von Ihrer Anwendung gesendete Antwort muss Der Header Content-Type ist auf application/octet-stream festgelegt und einen Nachrichtentext, der aus einem serialisierten Protokollpuffer besteht. Das Protokoll Der Zwischenspeicher ist eine BidResponse-Nachricht gemäß Definition in realtime-bidding.proto. Ihre Anwendung muss eine analysierbare BidResponse als Antwort auf alle BidRequest. Zeitüberschreitungen Antworten, die nicht geparst werden können, werden als Fehler betrachtet und von Google gedrosselt. Bieter mit hohen Fehlerraten zurück.

Wenn Sie nicht auf eine Impression bieten möchten, können Sie processing_time_ms unverändert lassen und alle anderen Felder beibehalten. leer. Sie erhalten realtime-bidding.proto von der Referenzdaten.

Creative-ID

In BidResponse wird ein Creative über die buyer_creative_id-Feld (max. 64 Byte). Sogar ähnliche Creatives müssen eindeutige Werte für buyer_creative_id haben, wenn sie sich in folgenden Punkten unterscheiden: Alle nennenswerten Merkmale, einschließlich, aber nicht beschränkt auf: Größe, deklarierte URL, Creative-Attribute und Anbietertypen. Anders ausgedrückt: Sie müssen unterschiedlichen Creative-IDs zu zwei Anzeigen hinzufügen, die:

Aussehen oder Verhalten ändern.
In verschiedenen Bildern rendern.
Wird auf unterschiedliche Weise gerendert, z. B. wenn eine Anzeige aus einem Bild, während die andere Flash enthält).

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 noch zu senden.

Anzeigenattribute

Anzeigenattribute müssen deklariert werden, die die Eigenschaften der Anzeige vollständig beschreiben. Eigenschaften und Ausrichtung in BidResponse.Ad.attribute. Die Attribute, die deklariert werden müssen, sind (siehe vollständige Liste der unterstützten Attribute unter buyer-declarable-creative-attributes.txt):

7 Tagging: IsTagged
Die Anzeige enthält ein Pixel oder ein Web-Beacon zur Erstellung eine Liste von Cookie-IDs für nachfolgendes Remarketing
8 Remarketing: IsRemarketing
Die Anzeige wird anhand der 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 mit einer Website interagiert haben, die der Käufer besitzt oder die er repräsentiert.
9 UserInterestTargeting: IsUserInterestTargeted
Die Anzeige wird anhand der Cookie-ID oder Geräte-ID auf Nutzer ausgerichtet. Die Liste der Cookie-IDs oder Geräte-IDs stellt eine Gruppe von Nutzern dar, die der Käufer Gruppe mit gemeinsamen Interessen.
30 InstreamVastVideoType: Vpaid
Zum Rendern der Anzeige ist VPAID-Unterstützung erforderlich.
32 MraidType: MRAID
Zum Rendern der Anzeige ist die MRAID API erforderlich.

Darüber hinaus werden die folgenden Attribute unterstützt, ihre Deklaration ist jedoch sind nicht erforderlich, da sie in Authorized Buyers automatisch erkannt und nicht auf Ihrer Deklaration, sondern auf den erkannten Werten. Weitere Informationen finden Sie unter Creatives API um zu erfahren, wie Sie Feedback zu den erkannten Eigenschaften Ihres Creatives.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
Zum Rendern der Anzeige ist Flash-Unterstützung erforderlich.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
Zum Rendern der Anzeige ist kein Flash erforderlich.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
Die Anzeige kann auf einer SSL-Seite gerendert werden. In Authorized Buyers werden Creatives mit unterschiedlich deklarierten Werten dieses Attributs als unterschiedlich (sie werden überprüft, getrennt und haben einen eigenen Freigabestatus. Wenn Sie also sowohl SSL als auch nicht-SSL-Versionen desselben Creatives, sollten Sie dieses Attribut entsprechend deklarieren. sodass diese Unterscheidung in AdX korrekt widergespiegelt wird.

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. Diese umfassen Folgendes:

OpenRTB	Authorized Buyers	Details
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	Die Deal-ID aus dem Namespace der Anzeigenplattform, die diesem Gebot abgeben und an Publisher gemeldet werden. Hinweis:Dieses Feld wird derzeit nur an eine geschlossene Betaversion gesendet. Teilnehmende.
`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 derzeit nur an eine geschlossene Betaversion gesendet. Teilnehmende.
`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 dauerhafte HTTPS-Verbindungen (auch bekannt als „Keep-alive“ oder „Wiederverwendung von Verbindungen“) auf Ihren Servern. Legen Sie das Zeitlimit auf 10 Sekunden fest: minimal – höhere Werte sind in vielen Fällen von Vorteil. Google überprüft dies 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
Geben Sie die optionale Impressions-Tracking-URL an, die erfasst werden soll, wenn der die Impression gerendert wird und nicht, wenn der Bieter den Zuschlag erhält. Aufgrund der Abbruchrate zwischen Siegen und Renderings zu erkennen, ermöglicht ein genaueres Tracking Statistik.

Hinweis:Bei Verwendung von OpenRTB 2.5 oder höher wird das Standardfeld BidResponse.seatbid[].bid[].burl.
Sorgen Sie dafür, dass Ihre Gebotsanwendung keine Abhängigkeiten von veralteten Feldern enthält. Dies kann dazu führen, dass Ihre Gebote fehlerhaft sind.
BidResponse.Ad.width und BidResponse.Ad.height in deinem BidResponse. A BidResponse zu einer Anfrage mit mehreren Anzeigengrößen muss die Werte width und height enthalten, andernfalls wird es aus der Auktion entfernt wurden.
Begrenzen Sie Ihre Antwortgröße auf unter 8 KB. 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.

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

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

OpenRTB-Protokollzwischenspeicher

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
}

Wichtig:Die Protobuf-Nachrichten in den Beispiele als visuell lesbarer Text dargestellt. Das ist jedoch nicht die werden die Nachrichten über das Kabel gesendet. Bei Verwendung des Protokollzwischenspeichers von Google oder OpenRTB Format handelt, werden nur serialisierte Gebotsantwort-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 enthalten (AMP, Video, nativ). In dieser das Creative mithilfe des Felds html_snippet angeben.

Alternativ können Sie Ihr Creative mit einer der folgenden Feldern, je nach Anzeigenformat:

Über SDK gerenderte Anzeige <ph type="x-smartling-placeholder">
- BidResponse.Ad.sdk_rendered_ad
AMP-Seiten <ph type="x-smartling-placeholder">
- BidResponse.Ad.amp_ad_url
Video
- BidResponse.Ad.video_url oder
- BidResponse.Ad.video_vast_xml
Nativ <ph type="x-smartling-placeholder">
- BidResponse.Ad.native_ad

Geben Sie eine Anzeige, die auf Ihren eigenen Servern gehostet wird, mithilfe eines HTML-Snippets in Das Feld html_snippet von BidResponse. Die in einem in die Webseite eingefügten iFrame eingebunden, sodass die Anzeige abgerufen und gerendert, wenn die Seite geladen wird. Sie müssen den HTML-Code damit die Anzeige (Banner oder Interstitial) innerhalb eines iFrame und die Größe der Anzeigenfläche, auf die Sie bieten, angemessen sind.

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, also keine Video-, nativen oder Interstitial-Anzeigen.
Der Bieter hat die Größe in der Gebotsantwort deklariert. Angegebene Größe ist erforderlich, wenn die Anfrage mehr als eine Größe enthält.
Eine Ausnahme gilt für Interstitial-Anzeigen. Bei Interstitials entspricht die Breite muss mindestens 50% der Bildschirmbreite und die Höhe mindestens 40% der Bildschirmhöhe betragen Bildschirmhöhe.

Das Feld html_snippet unterstützt jeden gültigen HTML-Code, der korrekt gerendert wird. Beachten Sie jedoch die Einschränkungen beim Angeben des buyer_creative_id im Bereich Create BidResponse message (Gebotsantwort-Nachricht erstellen). Eins besteht darin, zusätzliche Informationen in die Argumente der URLs aufzunehmen, die im Rahmen des Anzeigen-Renderings 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

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

Geben Sie ein Makro als Teil eines HTML-Snippets im Format %%MACRO%%, wobei MACRO einer der unterstützten Werte ist in der Tabelle unten.

Hinweis:Nur bei Gebotsantworten für AMP-Anzeigen (amp_ad_url) Die Makros WINNING_PRICE und WINNING_PRICE_ESC sind unterstützt.

Sie müssen entweder CLICK_URL_UNESC oder CLICK_URL_ESC-Makro im vom Drittanbieter ausgelieferten Creative Anzeige. Google verwendet die CLICK_URL-Makros für das Klick-Tracking.

Um ein Makro zu verwenden, nehmen Sie es in die Anzeige auf, sodass die URL abgerufen wird, wenn wenn jemand darauf klickt. Der Rückgabewert des Abrufs ist eine Weiterleitung zu einer anderen URL, die an CLICK_URL angehängt wird.

Makro	Beschreibung
`ADVERTISING_IDENTIFIER`	Mit dieser Einstellung können Käufer beim Rendern von Impressionen die iOS-IDFA oder die Werbe-ID von Android erhalten. Siehe Werbetreibenden-IDs entschlüsseln .
`CACHEBUSTER`	Stringdarstellung einer zufälligen 4-Byte-Ganzzahl ohne Vorzeichen.
`CLICK_URL_UNESC`	Die Klick-URL ohne Escaping der Anzeige. Im Snippet ist eine maskierte Version des die Klick-URL des Drittanbieters muss direkt auf das Makro folgen. Lautet die Klick-URL des Drittanbieters beispielsweise `http://my.adserver.com/some/path/handleclick?click=clk`, kann der folgende Code mit der einfach maskierten Version der dritten Klick-URL der Partei nach dem Makroaufruf folgt: <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 maskierte 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. Dies setzt voraus, dass `my.adserver.com` hebt die Escape-Angabe von `google_click_url` auf . Sie können eine doppelt codierte URL anhängen, `%%CLICK_URL_ESC%%` Nach der Entschlüsselung `my.adserver.com`, die eine einfach maskierte Version der URL übrig lässt an `google_click_url` angehängt wird. Wenn der Parameter `google_click_url` wurde abgerufen, die Maskierung wird noch einmal aufgehoben und danach Weiterleitung.
`CLICK_URL_ESC_ESC`	Die doppelt maskierte 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_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`	Wird auf `http:` erweitert, wenn die Gebotsanfrage kein SSL erfordert oder `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`	Verworfen. Dieses Makro wurde durch das Makro SITE ersetzt, das identische Funktionen bietet.
`TZ_OFFSET`	Der Zeitzonenversatz.
`VERIFICATION`	Die unterschiedlichen Werte für Produktion und den Zeitpunkt, an dem das Creative bei der Überprüfung gescannt wird zu erstellen. Das Format ist `%%?VERIFICATION:true-val:false-val%%`. Dabei gilt: außer Makros können für `true-val` und `false-val` verwendet werden, einschließlich leerer Strings. Für Open Bidding empfehlen wir Anzeigenplattformen, dieses Makro zu verwenden: Anschließend müssen Demand-Side-Plattformen keine Änderungen vornehmen. Wenn ein Creative z. B. `%%?VERIFICATION:-1:5000%%` würde die Textersetzung `5000` bei der Auslieferung und `-1` im zu überprüfen. Dies soll helfen, zwischen diesen beiden Arten von Pings zu unterscheiden.
`WINNING_PRICE`	Die codierten Impressionskosten (das heißt CPI statt CPM) in micros der Kontowährung. Beispiel: Ein erfolgreicher CPM von 5 € entspricht 5.000.000 Millionstel CPM oder 5.000 Millionstel CPI. Die decodierte Wert von `WINNING_PRICE` wäre in diesem Fall 5.000. Der Preis für das erfolgreiche Gebot wird in CPI angegeben.
`WINNING_PRICE_ESC`	`WINNING_PRICE` mit URL-Escaping.

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 die Zeichen !()*,-./:_~ bleiben unverändert.
Alle anderen Zeichen werden durch %XX ersetzt, wobei XX der Hexadezimalwert ist Zahl, die das Zeichen darstellt.

Beschränkungen durch den Publisher

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

allowed_vendor_type
excluded_attribute
excluded_sensitive_category

Mit einem Feld werden die zulässigen Funktionen der Anzeige angegeben, mit dem anderen Feld unzulässigen Funktionen. Geben Sie niemals eine Anzeige mit einer unzulässigen Funktion zurück. Zugelassene wie Anbietertyp, gibt eine Anzeige nur zurück, wenn ihr Anbietertyp in der Liste allowed_vendor_type in BidRequest. Weitere Informationen finden Sie in der Kommentare für diese Felder im Protokollzwischenspeicher BidRequest für weitere Informationen.

Wenn in BidResponse ein HTML-Snippet zurückgegeben wird, erforderlich, um attribute, category, und click_through_url in BidResponse. Wenn eine Anzeige über mehrere anwendbare Werte für diese Felder verfügt, müssen Sie jeden Wert enthalten. Kommentare zu diesen Feldern finden Sie in der BidResponse-Protokollpufferdefinition. Antworten, für die diese Felder nicht festgelegt sind, werden verworfen.

Die möglichen Werte für BidRequest.excluded_attribute sind (siehe publisher-excludable-creative-attributes.txt):

7 Tagging: IsTagged
Anzeigen sind nicht zulässig, wenn sie ein Pixel oder ein Web-Beacon zum Erstellen einer Liste von Cookie-IDs für nachfolgendes Remarketing.
8 CookieTargeting: IsCookieTargeted
Anzeigen sind nicht zulässig, wenn sie auf Nutzer basierend auf ihrer Cookie-ID ausgerichtet sind. Die Liste der Cookie-IDs steht für diese ID. Eine Gruppe von Nutzern, die bereits mit einer Website interagiert haben, die der Käufer besitzt oder die er repräsentiert.
9 UserInterestTargeting: IsUserInterestTargeted
Anzeigen sind nicht zulässig, wenn sie auf Nutzer basierend auf ihrer Cookie-ID ausgerichtet sind. Die Liste der Cookie-IDs steht für diese ID. Gruppe von Nutzern, die vom Käufer als gemeinsame Interessengruppe definiert wurden
21 CreativeType: Html
Anzeigen dürfen die html_snippet oder snippet_template nicht verwenden in BidResponse.Ad.
22 CreativeType: VastVideo
Anzeigen dürfen das Feld video_url in BidResponse.Ad nicht verwenden.
30 InstreamVastVideoType: Vpaid
Für das Rendern von Anzeigen ist keine VPAID-Unterstützung erforderlich.
32 MraidType: MRAID
Zum Rendern von Anzeigen darf die MRAID API nicht erforderlich sein.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
Für das Rendern von Anzeigen ist keine Flash-Unterstützung erforderlich.
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 senden.

Wenn das Feld excluded_attribute den Wert 7, dann sollten Sie keine Anzeige zurückgeben, die ein Pixel oder Web-Beacon für Erstellen einer Liste. Beachten Sie, dass in diesem Fall der Wert 7 in Attributfeld von BidResponse Wenn das Feld excluded_attribute den Wert 48 enthält, sollten Sie nur Anzeigen zurückgeben, die auf einer SSL-Seite dargestellt werden können. Deklarieren Sie Attribut 47 (RichMediaCapabilityType: RichMediaCapabilitySSL).

Auch das Feld excluded_sensitive_category im BidRequest verwendet Codes aus dem ad-sensitive-categories.txt-Datei auf der Seite Referenzdaten verfügbar. Hier sind unsere erweiterten Beschreibungen einiger dieser Codes:

3 Politics
Umfasst politische und kontroverse soziale Themen. umfasst keine Anzeigen für Nachrichtenanbieter, die im Allgemeinen nicht mit voreingenommenen Ansichten zu Themen in Verbindung gebracht werden.
4 Dating
Umfasst Dating-Services und Online-Dating-Communitys.
5 Religion
Umfasst religiöse Anzeigen und Anzeigen, die sich für oder gegen religiöse Ansichten aussprechen; umfasst keine Astrologie oder nichtkonfessionelle Spiritualität.
7 Video Games (Casual & Online)
Umfasst Videospiele, Onlinespiele und herunterladbare Spiele; umfasst 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
Programme, die schnelle Einnahmen versprechen
18 Weight Loss
Umfasst Gewichtsabnahme, Diäten und ähnliche Produkte und Programme; umfasst keine Anzeigen für gesunde Ernährung oder allgemeine Fitness.
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 entsprechende Händler enthält keine Ressourcen mit Informationen zu Drogen.
24 Sexual & Reproductive Health
Umfasst Anzeigen, die sich mit der sexuellen Funktion und der Fruchtbarkeit befassen beinhaltet keine normalen Schwangerschaftsressourcen.
35 Social Casino Games
Umfasst Glücksspielsimulationen, einschließlich, aber nicht beschränkt auf 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, vom Brustbein bis zum Oberschenkel nicht bekleidet ist oder der Körper mit Unterwäsche, Badebekleidung, Dessous oder anderen durchsichtigen Kleidungsstücken oder anderen Stoffen wie einem Handtuch oder Bettlaken bekleidet ist.
37 Sensationalism
Anzeigen, mit denen die Neugier von Nutzern geweckt werden soll, damit sie darauf klicken. Dazu wird oft ein Teaser mit übertriebenen Formulierungen oder Bildern verwendet. Umfasst Anzeigen zu reißerischen Themen wie Verhaftungen, Todesfälle oder Scheidungen von Prominenten oder Anzeigen, die Nutzer schockieren sollen.

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.

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

Beispiele für Gebotsantworten

In den folgenden Abschnitten finden 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: 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

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

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"

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

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

OpenRTB-Protokollzwischenspeicher

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"

App-Interstitial-Video

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

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

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

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"

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: "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

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

Open Measurement

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 Webbanner für Anzeigenplattform-Bieter

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen