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:

  1. 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.
  2. Käufer erhalten eine RTB-Gebotsanfrage von Google mit einer Liste der angeforderten Felder.
  3. Interessierte Käufer antworten mit den angeforderten Feldern.
  4. 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.
  5. 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:

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

Vorlage für App-Installationsanzeigen

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

Natives Video

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.

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.

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.

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

Gebotsanfragen ohne Video

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

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