Diese Seite wurde von der Cloud Translation API übersetzt.

Native Anzeigen

Native Anzeigen sind Anzeigen, die an den Content und das Design der Umgebung angepasst werden. Dadurch erhöht sich die Wahrscheinlichkeit, dass Nutzer sie ansehen und darauf klicken. Natives Anzeigeninventar ist in mobilen Apps sowie auf Desktop- und Mobilwebsites verfügbar. Weitere Informationen zu nativen Anzeigen finden Sie unter Native Anzeigen.

Native Anzeigen werden sowohl für Authorized Buyers als auch für Open Bidding unterstützt.

So funktioniert der Workflow für native Anzeigen:

Bei Google wird eine Anfrage nach einer nativen Anzeige gestellt. In der Anfrage werden eine oder beide der folgenden nativen Anzeigenvorlagen angegeben, wobei jeweils die bevorzugten nativen Felder angegeben werden.
Käufer erhalten eine RTB-Gebotsanfrage von Google mit einer Liste der angeforderten Felder.
Interessierte Käufer antworten mit den angeforderten Feldern.
Dann wird eine Auktion durchgeführt und das beste Gebot ausgewählt. Anschließend werden die vom Käufer zur Verfügung gestellten Creative-Assets an den Publisher gesendet.
Der Publisher erstellt aus den Assets eine native Anzeige und gestaltet sie passend zum Design seiner Website.

Nachrichtenformate

Google unterstützt die OpenRTB-Spezifikation sowohl in JSON als auch in Protobuf.

Bei nativen Anzeigen im OpenRTB Protobuf-Format unterscheiden sich die folgenden Felder von der Spezifikation:

JSON	JSON-Typ	Protobuf	Protobuf-Typ
`BidRequest.imp[].native.request`	`string`	`BidRequest.imp[].native.request_native`	`NativeRequest`
`BidResponse.seatbid[].bid[].adm`	`string`	`BidResponse.seatbid[].bid[].adm_native`	`NativeResponse`

Die OpenRTB-Protobuf-Felder sind Protobuf-Nachrichten und keine Strings.

Wenn Sie die OpenRTB-Protobuf-Implementierung verwenden, erhält Ihr Endpunkt Gebotsanfragen, die BidRequest.imp.native.request_native anstelle von BidRequest.imp.native.request enthalten. Außerdem muss Ihr Endpunkt Gebotsantworten zurückgeben, die BidResponse.seatbid.bid.adm_native und nicht BidResponse.seatbid.bid.adm enthalten. Andernfalls wird er aus der Auktion herausgefiltert.

Wenn Sie ein Käufer-SDK zum Rendern nativer Anzeigen verwenden, müssen Sie ein Bild type in das declared_ad einfügen, wenn Sie Creatives zur Überprüfung einreichen.

Vorlagen für native Anzeigen

In Vorlagen für native Anzeigen werden die Komponenten einer nativen Anzeige beschrieben und der Inhalt und die Struktur von NativeRequest in OpenRTB oder NativeAdTemplate im eingestellten Google RTB-Protokoll in der Gebotsanfrage festgelegt. Google unterstützt die beiden gängigsten Vorlagen für native Anzeigen, die nicht auf Videos basieren, und native Videoanzeigen:

Vorlage für App-Installationsanzeigen: Mit diesen Anzeigen können Sie für Apps werben und die Installationszahlen steigern.
Vorlage für Contentanzeigen: Allgemeinere Kombination aus Text und Bildern für Marken- oder Webanzeigen.
Vorlage für Video-App-Installationsanzeigen
Vorlage für Video-Contentanzeigen

Es gibt weitere Vorlagen, bei denen die Anforderungen in Bezug auf Felder, Abmessungen und Größen abweichen können.

Vorlage für App-Installationsanzeigen

Pflicht- und empfohlene Felder

In den folgenden Tabellen sind Felder mit der Kennzeichnung Erforderlich oder Empfohlen zu sehen. Es gelten die folgenden Regeln:

Felder, die mit Erforderlich gekennzeichnet sind, müssen vom Bieter ausgefüllt werden.
Felder, die mit Empfohlen gekennzeichnet sind, sind für Bieter nicht erforderlich. Der Publisher kann sie bei Bedarf anzeigen lassen oder nicht (z. B. die Bewertung mit Sternen).
„Call-to-Action“ (CTA) ist immer als Empfohlen gekennzeichnet, da ein Standard-CTA zugewiesen wird, wenn der Bieter keinen CTA sendet. Wird ein CTA gesendet, wird er immer angezeigt.

In der folgenden Tabelle sind die Felder einer Vorlage für Anzeigen für App-Installationen aufgeführt. In mobilen Apps werden diese Felder zum Erstellen von nativen App-Installationsanzeigen verwendet.

Feld	Beschreibung	Erforderlich oder empfohlen?	Wird sie immer angezeigt?	Empfohlene Bildgröße/maximale Anzahl von Zeichen	Beispiel
Anzeigentitel	Der App-Titel	Erforderlich	Ja	25 Zeichen	Flood-It!
Bild	Screenshot aus der App oder ein anderes relevantes Bild	Erforderlich	Nein	1.200 × 627 Pixel oder 600 × 600 Pixel,je nach dem vom Publisher benötigten Seitenverhältnis.	<Screenshot aus dem Spiel Flood-It!>
Text	Haupttext der App	Erforderlich	Nein	90 Zeichen	Täuschend einfach und verführerisch herausfordernd = herrlich süchtig machend!
App-Symbol	Das App-Symbol	Erforderlich	Nein	128 × 128 Pixel	<App-Symbol von Flood-it!>
Call-to-Action	Bevorzugte Nutzeraktion	Empfohlen	Ja	15 Zeichen	Installieren
Bewertung	Anzahl der Sterne (0–5), die die Bewertung der App im App-Shop darstellen	Empfohlen	Nein	0–5	4,5
Preis	Kosten der App	Empfohlen	Nein	15 Zeichen	Kostenlos

Hinweise zur Textlänge

Wenn ein Käufer ein Text-Asset (z. B. Textkörper) sendet, das länger als die vorgeschlagene maximale Zeichenanzahl ist, wird der Text möglicherweise von Google oder dem Publisher abgeschnitten und mit einer Ellipse abgekürzt. Bei Chinesisch, Japanisch und Koreanisch gilt für die Kürzungsgrenze die halbe Zeichenbeschränkung. So können deutsche Anzeigentitel beispielsweise 90 Zeichen lang sein, während die Länge chinesischer Anzeigentitel auf 45 Zeichen begrenzt ist.

Hinweise zur Bildgröße

Publisher dürfen:

Das Hauptbild kann symmetrisch um bis zu 20% in einer Dimension (Höhe oder Breite) zugeschnitten werden.
Das Bild kann skaliert werden, ohne dass sich das Seitenverhältnis ändert.
Bilder mit einem Seitenverhältnis, das sich wesentlich von dem durch Höhe und Breite implizierten unterscheidet, werden möglicherweise herausgefiltert.

Vorlage für Anzeigen mit Inhalten

In der folgenden Tabelle sind die Felder einer Vorlage für Anzeigen mit Inhalten aufgeführt. Publisher verwenden diese Felder, um native Anzeigen zu erstellen.

Feld	Beschreibung	Erforderlich oder empfohlen?	Wird sie immer angezeigt?	Empfohlene Bildgröße/maximale Zeichenanzahl *	Beispiel
Anzeigentitel	Anzeigentitel	Erforderlich	Ja	25 Zeichen	Niedrigste Hypothekenzinsen
Bild	Hauptbild der Anzeige	Erforderlich	Nein	1.200 × 627 Pixel oder 600 × 600 Pixel,je nach dem vom Publisher benötigten Seitenverhältnis.	<Hauptbild der Anzeige>
Text	Anzeigeninhalt	Erforderlich	Nein	90 Zeichen	Ihr Zuhause in Brooklyn – günstiger und schneller als Sie denken!
Logo	Logo des Werbetreibenden oder ein anderes relevantes kleines Bild	Empfohlen	Nein	128 × 128 Pixel	<Logo von NY Mortgage Inc.>
Call-to-Action	Bevorzugte Aktion des Nutzers	Empfohlen	Nein	15 Zeichen	Angebot einholen
Advertiser	Text, der den Werbetreibenden oder die Marke identifiziert	Erforderlich	Nein	25 Zeichen	NY Mortgage Inc.

Vorlage für App-Installations-Videoanzeigen

Feld	Beschreibung	Erforderlich oder empfohlen?	Wird sie immer angezeigt?	Empfohlene Bildgröße/maximale Zeichenanzahl *	Beispiel
Video	Die Video-VAST-Antwort, die alle notwendigen Assets zur Wiedergabe einer Videoanzeige enthält	Erforderlich	Nein	-	Eine URL zu einer VAST-XML-Datei mit einem Flood-It! Videoanzeige
Anzeigentitel	Der App-Titel	Erforderlich	Ja	25 Zeichen	Flood-It!
Bild	Das Bild (Thumbnail), das im Player zu sehen ist, bevor auf die Videoanzeige geklickt wird oder während sie geladen wird.	Erforderlich	Nein	Es muss dasselbe Seitenverhältnis wie das Video haben (z. B. 1280 × 720 für ein Video mit 16 : 9 oder 4 : 3 für ein Video mit 640 × 480).	Screenshot aus dem Spiel „Flood-It!“ Oder über das Video
Text	Haupttext der App	Erforderlich	Nein	90 Zeichen	Täuschend einfach und verführerisch herausfordernd = unwiderstehlich süchtig machend!
App-Symbol	Das App-Symbol	Erforderlich	Nein	128 × 128 Pixel	App-Symbol für Flood-It!
Call-to-Action	Bevorzugte Nutzeraktion	Erforderlich	Ja	15 Zeichen	Installieren
Bewertung	Anzahl der Sterne (0–5), die die Bewertung der App im App-Shop darstellen	Empfohlen	Nein	0–5	4,5
Preis	Kosten der App	Empfohlen	Nein	15 Zeichen	Kostenlos

Einschränkungen

Video: Alle Videos müssen in Form einer VAST-URL oder eines VAST-Tags vorliegen. Eine Rohvideodatei wie WebM oder MP4 kann nicht angegeben werden.
Textlänge: Wenn ein Käufer ein Text-Asset wie die body in der Antwort angibt, kann es von Google oder dem Publisher abgeschnitten oder mit einer Ellipse abgekürzt werden. Bei Chinesisch, Japanisch und Koreanisch gilt für die Kürzungsgrenze die halbe Zeichenbeschränkung. So können deutsche Anzeigentitel beispielsweise 90 Zeichen lang sein, während die Länge chinesischer Anzeigentitel auf 45 Zeichen begrenzt ist.
Bildgröße: Publisher dürfen:
- Das Hauptbild kann symmetrisch um bis zu 20% in einer Dimension (Höhe oder Breite) zugeschnitten werden.
- Das Bild kann skaliert werden, ohne dass sich das Seitenverhältnis ändert.

Beispiel für eine App-Installationsanzeige

Vorlage für Videoanzeigen

Feld	Beschreibung	Erforderlich oder empfohlen?	Wird sie immer angezeigt?	Empfohlene Bildgröße/maximale Zeichenanzahl *	Beispiel
Video	Die Video-VAST-Antwort, die alle notwendigen Assets zur Wiedergabe einer Videoanzeige enthält	Erforderlich	Ja	-	Eine URL zu einer VAST-XML-Datei mit einem Flood-It! Videoanzeige
Anzeigentitel	Anzeigentitel	Erforderlich	Ja	25 Zeichen	Niedrigste Hypothekenzinsen
Bild	Das Bild (Thumbnail), das im Player zu sehen ist, bevor auf die Videoanzeige geklickt wird oder während sie geladen wird.	Erforderlich	Nein	Es muss dasselbe Seitenverhältnis wie das Video haben (z. B. 1280 × 720 für ein Video mit 16 : 9 oder 4 : 3 für ein Video mit 640 × 480).	Screenshot aus dem Video
Text	Anzeigeninhalt	Erforderlich	Nein	90 Zeichen	Ihr Zuhause in Brooklyn – günstiger und schneller als Sie denken!
Logo	Logo des Werbetreibenden oder ein anderes relevantes kleines Bild	Empfohlen	Nein	128 × 128 Pixel	Logo von NY Mortgage Inc.
Call-to-Action	Bevorzugte Aktion des Nutzers	Erforderlich	Nein	15 Zeichen	Angebot einholen
Advertiser	Text, der den Werbetreibenden oder die Marke identifiziert	Erforderlich	Nein	25 Zeichen	NY Mortgage Inc.

Metafelder

Die folgenden Metafelder werden von allen unterstützten Anzeigenvorlagen verwendet:

Google RTB-Protokoll	OpenRTB-Entsprechung	Beschreibung
`NativeAd.click_link_url`	`Link.url`	Die URL, die vom Browser aufgerufen wird, wenn der Nutzer auf die Anzeige klickt. Kann der erste Schritt einer Weiterleitungskette sein, die letztendlich zur Landingpage führt. Bei nativen Anzeigen empfehlen wir, `click_link_url` als Feld zu verwenden, um das Ziel festzulegen, zu dem der Nutzer weitergeleitet wird. Bei dynamischen Landingpages ist die Verwendung dieses Felds erforderlich.
`Ad.click_through_url`	`Bid.adomain`	Muss festgelegt werden, wenn der Bieter ein Gebot abgeben möchte. Dies ist die Gruppe der Ziel-URLs für das Snippet. Dazu gehören die URLs, zu denen der Nutzer weitergeleitet wird, wenn er auf die angezeigte Anzeige klickt, sowie alle URLs, die in der gerenderten Anzeige sichtbar sind. Fügen Sie keine Zwischenaufrufe an den Adserver ein, die nichts mit der finalen Landingpage zu tun haben. BidResponse-Objekte, die ein Snippet oder eine Videoanzeige zurückgeben, aber keinen `click_through_url`-Wert angeben, werden verworfen. Legen Sie dieses Feld nur fest, wenn `html_snippet`, `video_url` oder `native_ad` festgelegt ist. Diese Daten werden als Deklaration der Ziel-URL verwendet, z. B. für die Nachfilterung von vom Publisher blockierten URLs oder die Anzeigenkategorisierung. Weitere Informationen finden Sie unter `NativeAd.click_link_url`. Bei nicht nativen Anzeigen wird sie nicht für Klick-Tracking oder andere Anzeigenfunktionen verwendet, sondern nur als Deklaration der Ziel-URL. Wenn für native Anzeigen `NativeAd.click_link_url` nicht festgelegt ist, wird der erste Wert von `click_through_url` verwendet, um den Nutzer zur Landingpage weiterzuleiten. Außerdem werden alle Werte als Ziel-URL-Deklarationen verwendet (ähnlich wie bei nicht nativen Anzeigen).
`NativeAd.click_tracking_urls`	`Link.clicktrackers`	Optional. Zusätzliche URLs, mit denen Werbetreibende Nutzerklicks auf die Anzeige erfassen können.
`Ad.ad_choices_destination_url`	`BidExt.ad_choices_destination_url`	Link zu einer Seite mit Anzeigeneinstellungen oder Deaktivierungsseite Sofern vorhanden, wird dem nativen Creative ein standardmäßiges AdChoices-Symbol hinzugefügt und mit dieser URL verknüpft. Diese Funktion wird für native Anzeigen unterstützt, ist aber nicht Teil der nativen Nachricht in der Gebotsantwort.
`Ad.impression_tracking_url`	`NativeResponse.imptrackers`	Die native Impression sollte mit `impression_tracking_url` im Authorized Buyers-Protokoll für Echtzeitgebote oder mit Native Imp-Trackern in OpenRTB erfasst werden.

Erforderliche und empfohlene Felder im Google RTB-Protokoll

required_fields und recommended_fields werden vom Publisher angegeben. Wir zeigen Ihnen, wie Sie diese Bitfelder übersetzen, um festzustellen, ob ein Feld erforderlich oder empfohlen ist.

In einem Bitfeld wird jedes Bit eines Binärwerts verwendet, um eine „wahr“- oder „falsch“-Anweisung zu speichern. Das entspricht dem Senden vieler boolescher Signale wie is_logo_required oder is_header_required, die aber alle zusammen verpackt sind.

Hinweis:In OpenRTB wird im Feld BidRequest.imp.native.request_native.assets.required festgelegt, ob ein bestimmtes Feld erforderlich oder empfohlen ist.

Beispiel

In diesem Beispiel verwenden wir den Wert 1085 für required_fields.

Berechnen Sie zuerst den entsprechenden Binärwert: 10000111101

Sobald Sie den Binärwert haben, können Sie anhand der Bits prüfen, ob ein Feld erforderlich ist (1) oder nicht (0).

In der folgenden Tabelle sind die Felder ihrem Platz im Binärwert zugeordnet. Lesen Sie das Binärformat von rechts nach links, wobei das 1‑Bit der rechten Stelle im Binärwert entspricht.

Feld	Platzierung von Binärwerten (von rechts nach links)
`HEADLINE`	`1`
`BODY`	`2`
`CALL_TO_ACTION`	`4`
`ADVERTISER`	`8`
`IMAGE`	`16`
`LOGO`	`32`
`APP_ICON`	`64`
`STAR_RATING`	`128`
`PRICE`	`256`
`STORE`	`512`
`VIDEO`	`1024`

Im Beispiel für den Binärwert 10000111101 ist das 1‑Bit (rechts) 1, was einen erforderlichen Wert bedeutet. Laut Tabelle entspricht das 1‑Bit HEADLINE.

Das 2‑Bit (zweiter Wert von rechts) ist 0, was bedeutet, dass es nicht erforderlich ist. Das 2‑Bit entspricht BODY.

Hier sind alle in unserem Beispiel erkannten Pflichtfelder:

Wert	Beschreibung	Erforderlich?
`1`	`VIDEO`	Ja
`0`	`STORE`	Nein
`0`	`PRICE`	Nein
`0`	`STAR_RATING`	Nein
`0`	`APP_ICON`	Nein
`1`	`LOGO`	Ja
`1`	`IMAGE`	Ja
`1`	`ADVERTISER`	Ja
`1`	`CALL_TO_ACTION`	Ja
`0`	`BODY`	Nein
`1`	`HEADLINE`	Ja

Darstellung der nativen Anzeigenvorlage in der Gebotsanfrage

Wenn Sie eine Gebotsanfrage mit nativem Inventar erhalten, enthält sie je nach verwendetem Protokoll die native Anzeigenvorlage in verschiedenen Formen. Wir empfehlen die Verwendung von OpenRTB, da das Google-Protokoll eingestellt wird.

In OpenRTB wird die native Anzeigenvorlage mit der Nachricht NativeRequest beschrieben. Im Google RTB-Protokoll wird sie mit NativeAdTemplate beschrieben. Diese Nachrichten enthalten die folgenden Details zum Inventar für native Anzeigen:

Pflicht- oder empfohlene Felder
Abmessungen für Bilder, Logos und App-Symbole
Spezifikationen für den Stil, in dem die Anzeige gerendert wird.

Hinweis:Im Feld style_layout_type gibt PIXEL an, dass die native Einheit eine feste Größe hat, während FLUID bedeutet, dass sie so skaliert wird, dass sie die Breite der umschließenden Spalte ausfüllt, und die Höhe so angepasst wird, dass das Seitenverhältnis beibehalten wird. Wenn FLUID angegeben ist, werden Höhe und Breite möglicherweise als 1x1 angezeigt.

OpenRTB-Asset-IDs

OpenRTB übergibt in der Gebotsanfrage eine Reihe von Assets, die die Struktur der nativen Anzeige beschreiben, die Sie in der Antwort zurückgeben sollten. Jedem Asset in der Anfrage wird eine ID zugewiesen, die für das entsprechende Asset in der Antwort angegeben werden muss. Ein Beispiel dafür, wie diese IDs in Anfrage und Antwort übereinstimmen, finden Sie in den Beispielen für native Gebotsanfragen und Beispielen für native Gebotsanfragen.

Darstellung einer nativen Anzeige in der Gebotsantwort

Wenn ein Käufer auf natives Inventar bietet, muss er die erforderlichen Felder ausfüllen, die in der Gebotsanfrage angegeben wurden. In OpenRTB können Sie dies mit BidResponse.seatbid.bid.adm_native tun, wenn Sie Protobuf verwenden, oder mit BidResponse.seatbid.bid.adm für JSON. Beim eingestellten Google-Protokoll geschieht dies über das Feld BidResponse.ad.native_ad.

Beispiel-Gebotsanfragen

Hinweis: Informationen dazu, was in der Antwort erforderlich oder optional ist, finden Sie in der Vorlage für native Anzeigen in der Gebotsanfrage. Bei OpenRTB finden Sie dieses Feld unter BidRequest.imp.native. Für das eingestellte Google-Protokoll finden Sie diese Informationen unter BidRequest.adslot.native_ad_template.

Gebotsanfragen ohne Video

OpenRTB Protobuf

Beispiel anzeigen

Serialisierte Anfrage

id: "l6210s8bS8Uc726V81B821"
imp {
  id: "1"
  tagid: "3019814809"
  bidfloor: 0.06
  bidfloorcur: "USD"
  secure: true
  native {
    ver: "1.2"
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        data {
          type: DESC
          len: 90
        }
      }
      assets {
        id: 3
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      assets {
        id: 5
        img {
          type: LOGO
          wmin: 100
          hmin: 100
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_id: 497439
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0006697923527099192
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.05
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 50577321529
    dfp_ad_unit_code: "/3711494/google/test"
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    open_bidding {
      is_open_bidding: true
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "FR"
    }
  }
  content {
    livestream: false
    language: "fr"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: ""
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "FRA"
    region: "FR-C"
    zip: "63120"
    type: IP
    utcoffset: 120
    accuracy: 6948
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9112278
    }
  }
  ipv6: "2a01:cb14:8183::"
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "130"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "130"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "15"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1712
      consented_providers: 2316
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED"
      uids {
        id: "12JD92JD8078S8J29SDOAKC0EF230337"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 350
cur: "USD"
regs {
  gpp: "OMITTED"
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
}

OpenRTB JSON

Beispiel anzeigen

{
  "id": "l6210s8bS8Uc726V81B821",
  "imp": [
    {
      "id": "1",
      "tagid": "3019814809",
      "bidfloor": 0.06,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0006697923527099192,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.05,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "50577321529"
        ],
        "dfp_ad_unit_code": "/3711494/google/test",
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "open_bidding": {
          "is_open_bidding": 1
        },
        "creative_enforcement_settings": {
          "policy_enforcement": 1,
          "publisher_blocks_enforcement": 2
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "FR"
      }
    },
    "content": {
      "livestream": 0,
      "language": "fr"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED",
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "FRA",
      "region": "FR-C",
      "zip": "63120",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 6948,
      "ext": {
        "geo_criteria_id": 9112278
      }
    },
    "ipv6": "2a01:cb14:8183::",
    "os": "Windows",
    "devicetype": 2,
    "lmt": 0,
    "pxratio": 1.0,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "130",
            "0"
          ]
        },
        {
          "brand": "Microsoft Edge",
          "version": [
            "130",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Windows",
        "version": [
          "15",
          "0"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1712",
          "2316"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED",
          "uids": [
            {
              "id": "12JD92JD8078S8J29SDOAKC0EF230337"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "USD"
  ],
  "regs": {
    "gpp": "OMITTED",
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v",
    "fcap_scope": 1
  }
}

Google

Beispiel anzeigen

Serialisierte Anfrage

id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx"
ip: "\300\250"
user_agent: "OMITTED"
url: "https://www.google.com"
detected_language: "it"
adslot {
  id: 1
  excluded_attribute: 14
  excluded_attribute: 32
  allowed_vendor_type: 42
  allowed_vendor_type: 144
  excluded_sensitive_category: 36
  excluded_sensitive_category: 19
  matching_ad_data {
    billing_id: 74792558829
    billing_id: 11204117851
    minimum_cpm_micros: 390000
  }
  matching_ad_data {
    billing_id: 44428418146
    billing_id: 91112044263
    minimum_cpm_micros: 110000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 10366
  excluded_product_category: 11504
  ad_block_key: 8767661977
  publisher_settings_list_id: 7807286827624818876
  publisher_settings_list_id: 8186380472781289268
  allowed_restricted_category: 32
  allowed_restricted_category: 33
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 6
  allowed_restricted_category_for_deals: 32
  allowed_restricted_category_for_deals: 33
  click_through_rate: 0.0010397299
  allowed_ad_types: ALLOWED_AD_TYPE_NATIVE
  is_amp_page: DIALECT_HTML
  amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
  secure_signals {
    data: "Test Data: bw44G12BFZ"
    source: "OMITTED"
  }
  consented_providers_settings {
    tcf_consent_string: "OMITTED"
    additional_consent_string: "OMITTED"
  }
  regs_gdpr: true
  native_ad_template {
    required_fields: 17
    recommended_fields: 0
    headline_max_safe_length: 90
    body_max_safe_length: 90
    call_to_action_max_safe_length: 15
    advertiser_max_safe_length: 25
    image_width: 1200
    image_height: 627
    style_id: 749853
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY
    publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
  }
  auction_environment: SERVER_SIDE_AUCTION
  impression_expiration_seconds: 3600
  supported_auction_environment: SERVER_SIDE_AUCTION
}
is_test: false
timezone_offset: 120
geo_criteria_id: 1008463
bid_response_feedback {
  request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301"
  creative_status_code: 1
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 220000
  feedback_type: BID_FEEDBACK
}
bid_response_feedback {
  request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G"
  creative_status_code: 80
  event_notification_token: "token"
  buyer_creative_id: "test_creative_id_744913"
  minimum_bid_to_win: 3450000
  feedback_type: BID_FEEDBACK
}
publisher_type: PUBLISHER_OWNED_AND_OPERATED
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "IT"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 350
google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6"
auction_type: FIRST_PRICE
geo {
  lat: 0.0
  lon: 0.0
  country: "ITA"
  region: "IT-MI"
  city: "Milan"
  utcoffset: 120
  accuracy: 6821
}
user_agent_data {
  platform {
    brand: "Windows"
    version: "10"
    version: "0"
  }
  mobile: false
  architecture: "x86"
  browsers {
    brand: "Chromium"
    version: "128"
    version: "0"
  }
  browsers {
    brand: "Not;A=Brand"
    version: "24"
    version: "0"
  }
  bitness: "64"
  source: CLIENT_HINTS_HIGH_ENTROPY
}
page_visibility: VISIBILITY_STATE_VISIBLE
supply_chain {
  complete: true
  nodes {
    advertising_system_identifier: "testdomain.com"
    seller_identifier: "pub-1111111111111111"
    handles_payment: true
  }
  version: "1.0"
}
frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE
privacy_treatments {
  allow_user_data_collection: true
}
inventory_partner_domain: "OMITTED"

Gebotsanfragen für Videoanzeigen

{
  id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123",
  ip: "\0338\355",
  google_user_id: "CAESEJ1ur2l94_8ruuu",
  cookie_version: 1,
  cookie_age_seconds: 5184000,
  hosted_match_data: "W9ABDAAAAGR67nl0",
  user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36",
  publisher_country: "IN",
  geo_criteria_id: 1007796,
  timezone_offset: 330,
  publisher_id: "pub-2230723027927371",
  seller_network_id: 989,
  url: "https://m.example.com",
  detected_language: [en],
  google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q",
  auction_type: "SECOND_PRICE",
  device: {
    device_type: "HIGHEND_PHONE",
    platform: "android",
    brand: "coolpad",
    model: "cp8298_i00",
    os_version: {
      major: 5,
      minor: 1
    },
    carrier_id: 70210,
    screen_width: 360,
    screen_height: 640,
    screen_pixel_ratio_millis: 2000
  },
  mobile: {
    is_app: false,
    is_mobile_web_optimized: true,
    DEPRECATED_platform: "android",
    DEPRECATED_mobile_device_type: "HIGHEND_PHONE",
    DEPRECATED_brand: "coolpad",
    DEPRECATED_model: "cp8298_i00",
    DEPRECATED_os_version: {
      os_version_major: 5,
      os_version_minor: 1
    },
    DEPRECATED_screen_width: 360,
    DEPRECATED_screen_height: 640,
    DEPRECATED_carrier_id: 70210,
    DEPRECATED_device_pixel_ratio_millis: 2000
  },
  publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED",
  adslot: [{
    id: 1,
    ad_block_key: 2882274820,
    width:   [300,250],
    height:   [250,250],
    excluded_attribute:   [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22],
    allowed_vendor_type:   [42,144,575,698,704,743,776,785,793,797,808,828,832,885],
    excluded_sensitive_category:   [36,27,19,4,23,30,10,3,31,5,8,37,18],
    excluded_product_category:   [10031,11669,13423,13525,13566,13589,13612,13740],
    excluded_creatives:   [{
      buyer_creative_id: "1234567.1234567890-ssl"
    }],
    matching_ad_data:   [{
      billing_id:     [6629616415,51386650457],
      minimum_cpm_micros: 1380000,
      direct_deal:     [{
        direct_deal_id: 410401,
        fixed_cpm_micros: 1360000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      },{
        direct_deal_id: 240644,
        fixed_cpm_micros: 1500000,
        deal_type: "PREFERRED_DEAL",
        publisher_blocks_overridden: true
      }]
    },{
      billing_id:     [1234567890],
      minimum_cpm_micros: 1380000
    }],
    publisher_settings_list_id:   [12109930661871909476,11138951146123409010],
    slot_visibility: "BELOW_THE_FOLD",
    viewability: 30,
    click_through_rate: 0.0010072842,
    iframing_state: "UNKNOWN_IFRAME_STATE",
    native_ad_template:   [{
      required_fields: 1065,
      recommended_fields: 4,
      headline_max_safe_length: 25,
      body_max_safe_length: 90,
      call_to_action_max_safe_length: 15,
      advertiser_max_safe_length: 25,
      logo_width: 100,
      logo_height: 100,
      style_id: 199892,
      style_height: 250,
      style_width: 300
    }],
    sticky_settings: {

    },
    renderer: "GOOGLE",
    is_amp_page: "DIALECT_HTML",
    amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED",
    allowed_ad_types:   [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE],
    session_depth: 1,
    internal_data: {

    }
  }],
  response_deadline_ms: 122,
  is_test: false
}

Beispiel für Gebotsantworten

Gebotsantworten ohne Video

OpenRTB Protobuf

Beispiel anzeigen

Serialisierte Antwort

id: "22i22S9494PQl819H7Ld5K"
seatbid {
  bid {
    id: "2GTnPXOn76gg1C6574T"
    impid: "1"
    price: 0.24
    adid: "test_creative_id_713312"
    adomain: "google.com"
    crid: "test_creative_id_713312"
    exp: 300
    language: "xx"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 1200
          h: 1200
        }
      }
      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"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
      privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED"
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 50577321529
      third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
    }
  }
  seat: "5249:9218:332606"
}
cur: "USD"

OpenRTB JSON

Beispiel anzeigen

{
  "id": "22i22S9494PQl819H7Ld5K",
  "seatbid": [
    {
      "bid": [
        {
          "id": "2GTnPXOn76gg1C6574T",
          "impid": "1",
          "price": 0.24,
          "adid": "test_creative_id_713312",
          "adomain": [
            "google.com"
          ],
          "crid": "test_creative_id_713312",
          "exp": 300,
          "language": "xx",
          "ext": {
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "50577321529",
            "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7"
          },
          "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\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}"
        }
      ],
      "seat": "5249:9218:332606"
    }
  ],
  "cur": "USD"
}

Google

Beispiel anzeigen

Serialisierte Antwort

ad {
  adslot {
    id: 1
    max_cpm_micros: 110734
    min_cpm_micros: 0
    billing_id: 74792558829
    deal_id: 0
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_907643"
  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\254 225"
    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"
  dsa_transparency {
    buyer_render: true
  }
}
processing_time_ms: 27

Gebotsantworten für Videoanzeigen

bid_response {
  ad {
    ...
    click_through_url: "https://www.exampleDomain.com"
    impression_tracking_url: "https://my_impression_tracking_url.com/"
    ad_choices_destination_url: "https://my_ad_choices_destination_url.com/"
    ...
    native_ad {
      headline: "Lowest mortgage rates"
      video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast"
      call_to_action: "Get a quote"
      advertiser: "NY Mortgage Inc."
      image {
        url: "https://www.example.net/mypromoimage.png"
        width: 1200
        height: 700
      }
      logo {
        url: "https://www.example.net/mylogo.png"
        width: 200
        height: 200
      }
      click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1"
      click_tracking_urls: "https://my_click_tracking_url.com/"
    }
  }
}