Native Anzeigen

Native Anzeigen werden so formatiert, dass sie in den umgebenden Content und die visuellen Elemente passen. Design, wodurch die Wahrscheinlichkeit steigt, dass sie von den Nutzenden gesehen und angeklickt werden. Native Anzeige ist in mobilen Apps sowie auf Desktop- und mobilen Websites verfügbar. Weitere Informationen zu nativen Anzeigen Anzeigen.

Native Anzeigen werden sowohl in Authorized Buyers als auch Open Bidding

So funktioniert der Workflow für native Anzeigen:

1. Ein Aufruf für eine native Anzeige wird an Google gesendet. Der Aufruf gibt an, eine oder beide der folgenden nativen Anzeigenvorlagen, die jeweils die bevorzugte native Felder.
2. Google sendet Käufern eine Gebotsanfrage für Echtzeitgebote mit einer Liste der Felder, die angefordert werden.
3. Interessierte Käufer antworten mit den angeforderten Feldern.
4. Google führt eine Auktion durch, um das erfolgreiche Gebot festzulegen, und sendet das vom Käufer bereitgestellte Creative-Assets erstellen.
5. Der Publisher erstellt aus den Assets eine native Anzeige und gestaltet sie. an das Design der Website anzupassen.

Nachrichtenformate

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

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

JSON-Spezifikation (PROTOCOL_OPENRTB_2_4)	JSON-Typ	OpenRTB-Implementierung (PROTOCOL_OPENRTB_PROTOBUF_2_4)	OpenRTB-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-Felder sind Protobuf-Nachrichten und keine Strings.

Wenn Sie die OpenRTB-Protokollpuffer-Implementierung verwenden, erhalten Sie keine BidRequest.imp[].native.request und muss mit BidResponse.seatbid[].bid[].adm_native. Gebotsantworten mit BidResponse.seatbid[].bid[].adm werden gefiltert. Für OpenRTB sind keine Asset-IDs erforderlich Protokollzwischenspeicher-Gebotsantworten.

Wenn Sie native Anzeigen mit einem Käufer-SDK rendern, müssen Sie ein Bild type in die declared_ad einfügen, wenn Sie Creatives zur Überprüfung einreichen.

Vorlagen für native Anzeigen

Google unterstützt die beiden gängigsten Vorlagen für native Anzeigen für Nicht-Video- und native Videoanzeigen:

• Vorlage für App-Installationsanzeigen – bewerben und App-Installationen zu steigern.
• Vorlage für Contentanzeigen – allgemeiner eine Kombination aus Text und Bildern für Marken- oder Webanzeigen.
• Vorlage für App-Installations-Videoanzeigen
• Vorlage für Videocontentanzeigen

Es sind weitere Vorlagen vorhanden, für die möglicherweise andere Anforderungen Dimensionen und Größen festlegen.

Vorlage für App-Installationsanzeigen

Erforderliche und empfohlene Felder

Die folgenden Tabellen enthalten Felder mit den Labels Erforderlich oder Empfohlen. 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 den Bieter nicht erforderlich und die kann der Publisher sie anzeigen, sofern sie zur Verfügung gestellt werden (z. B. durch Markieren eines Bewertung).
• Der Call-to-Action (CTA) ist immer als Empfohlen gekennzeichnet, weil ein Wird kein Wert vom Bieter gesendet, wird eine Standardvorgabe zugewiesen. wird angezeigt, wenn die Nachricht gesendet wurde.

In der folgenden Tabelle sind die Felder einer Vorlage für App-Installationsanzeigen aufgeführt. In mobilen Apps werden diese Felder verwendet, um native App-Installationsanzeigen zu erstellen.

Feld	Beschreibung	Erforderlich oder empfohlen?	Immer angezeigt?	Empfohlene Bildgröße/maximale Anzahl von Zeichen	Beispiel
Anzeigentitel	Titel der App	Erforderlich	Ja	25 Zeichen	Flood-It!
Bild	Screenshot aus der App oder ein anderes relevantes Bild	Erforderlich	Nein	1.200 x 627 Pixel oder 600 x 600 Pixel,je nach erforderlichem Seitenverhältnis vom Publisher festgelegt wurden.	<Screenshot aus dem Spiel Flood-It!>
Text	Haupttext der App	Erforderlich	Nein	90 Zeichen	Täuschend einfach + verlockend herausfordernd = herrlich süchtig machen!
App-Symbol	Das App-Symbol	Erforderlich	Nein	128 x 128 px	<Flood-it! App-Symbol >
Call-to-Action	Bevorzugte Nutzeraktion	Empfohlen	Ja	15 Zeichen	Installieren
Bewertung	Anzahl der Sterne (0–5), die die Bewertung der App im App Store	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. Text) sendet, der länger ist als der Maximale Anzahl von Zeichen vorgeschlagen hat, wird der Text möglicherweise gekürzt und von Google oder dem Publisher mit Ellipsenformat versehen werden. Die Kürzung bei Chinesisch, Japanisch und Koreanisch nur halb so groß sind. Beispiel: Der Parameter Für Englisch sind 90 Anzeigentitel und für Chinesisch 45 Anzeigentitel zulässig.

Hinweise zur Bildgröße

Publisher dürfen:

• Schneiden Sie das Hauptbild symmetrisch um bis zu 20% in einer Dimension (Höhe oder Breite).
• Skalieren Sie das Bild, ohne sein Seitenverhältnis zu ändern.
• Bilder, deren Seitenverhältnisse stark von den beabsichtigten abweichen nach Höhe und Breite gefiltert werden.

Vorlage für Contentanzeigen

In der folgenden Tabelle sind die Felder einer Vorlage für eine Contentanzeige aufgeführt. Publisher verwenden Sie diese Felder, um native Contentanzeigen zu erstellen.

Feld	Beschreibung	Erforderlich oder empfohlen?	Immer angezeigt?	Empfohlene Bildgröße/maximale Anzahl von Zeichen *	Beispiel
Anzeigentitel	Der Anzeigen-Header	Erforderlich	Ja	25 Zeichen	Niedrigste Hypothekenzinsen
Bild	Hauptbild der Anzeige	Erforderlich	Nein	1.200 x 627 Pixel oder 600 x 600 Pixel,je nach erforderlichem Seitenverhältnis vom Publisher festgelegt wurden.	<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 x 128 px	<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	New York Mortgage Inc.

Vorlage für App-Installations-Videoanzeigen

Feld	Beschreibung	Erforderlich oder empfohlen?	Immer angezeigt?	Empfohlene Bildgröße/maximale Anzahl von Zeichen*	Beispiel
Video	Die Video-VAST-Antwort, die alle erforderlichen Assets zur Wiedergabe einer Videoanzeige enthält.	Erforderlich	Nein	-	Eine URL zu VAST-XML mit einem Flood-It! Videoanzeige
Anzeigentitel	Titel der App	Erforderlich	Ja	25 Zeichen	Flood-It!
Bild	Das Bild (Miniaturansicht), das im Player zu sehen ist, bevor auf die Videoanzeige geklickt oder während sie geladen wird.	Erforderlich	Nein	Muss dem Seitenverhältnis des Videos entsprechen (z. B. 1280 x 720 für 16:9-Videos, 4 : 3 für 640 x 480-Videos).	Ein Screenshot aus dem Spiel Flood-It! Oder aus dem Video
Text	Haupttext der App	Erforderlich	Nein	90 Zeichen	Täuschend einfach + verlockend herausfordernd = herrlich süchtig machen!
App-Symbol	Das App-Symbol	Erforderlich	Nein	128 x 128 px	Flut-It! App-Symbol
Call-to-Action	Bevorzugte Nutzeraktion	Erforderlich	Ja	15 Zeichen	Installieren
Bewertung	Anzahl der Sterne (0–5), die für die Bewertung der App im App-Shop stehen	Empfohlen	Nein	0–5	4,5
Preis	Kosten der App	Empfohlen	Nein	15 Zeichen	Kostenlos

Einschränkungen

• Video: Alle Videos müssen das Format einer VAST-URL haben. oder ein VAST-Tag. Eine Rohvideodatei wie WebM, MP4 usw. kann nicht angegeben werden.

• Textlänge: Wenn ein Käufer ein Text-Asset angibt, z. B. das body in der Antwort enthält, wird sie möglicherweise gekürzt und Google oder dem Verlag oder Webpublisher. Beachten Sie, dass die maximale Größe Chinesisch, Japanisch und Koreanisch. Für Englisch sind z. B. 90 Anzeigentitel zulässig. und 45 für Chinesisch.

• Bildgröße: Publisher dürfen

  • Hauptbild symmetrisch um bis zu 20% in einer Dimension (Höhe) zuschneiden oder Breite auswählen.
  • Skalieren Sie das Bild, ohne sein Seitenverhältnis zu ändern.

Beispiel für eine App-Installationsanzeige

Vorlage für Videoanzeigen

Feld	Beschreibung	Erforderlich oder empfohlen?	Immer angezeigt?	Empfohlene Bildgröße/maximale Anzahl von Zeichen*	Beispiel
Video	Die Video-VAST-Antwort, die alle erforderlichen Assets zur Wiedergabe einer Videoanzeige enthält.	Erforderlich	Ja	-	Eine URL zu VAST-XML mit einem Flood-It! Videoanzeige
Anzeigentitel	Der Anzeigen-Header	Erforderlich	Ja	25 Zeichen	Niedrigste Hypothekenzinsen
Bild	Das Bild (Miniaturansicht), das im Player zu sehen ist, bevor auf die Videoanzeige geklickt oder während sie geladen wird.	Erforderlich	Nein	Muss dem Seitenverhältnis des Videos entsprechen (z. B. 1280 x 720 für 16:9-Videos, 4 : 3 für 640 x 480-Videos).	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 x 128 px	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	New York Mortgage Inc.

Metafelder

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

Autorisiert Echtzeit-Protokollzwischenspeicher für Käufer	Autorisiert OpenRTB-Gebot für Käufer-Äquivalent	Beschreibung
NativeAd.click_link_url	Link.url	Die URL, die vom Browser aufgerufen wird, wenn der Nutzer auf die Anzeige klickt. Dies kann der erste Schritt in der Weiterleitungskette sein, der schließlich zur Landingpage. Für native Anzeigen empfehlen wir die Verwendung von click_link_url als Feld zum Festlegen das Ziel, auf das die Nutzenden letztendlich navigieren werden. Dieses Feld muss im Fall verwendet werden, von dynamischen Landingpages aus.
Ad.click_through_url	Bid.adomain	Muss festgelegt werden, wenn der Bieter ein Gebot abgeben möchte. Dies ist die Gruppe von Zielen URLs für das Snippet, einschließlich der URLs, auf die der Nutzer weitergeleitet wird, wenn er auf die angezeigte Anzeige und alle URLs, die im gerenderten Anzeige. Nehmen Sie keine Zwischenaufrufe an den Ad-Server auf, die nichts mit auf die Landingpage gelangen. Eine Gebotsantwort, die ein Snippet oder eine Videoanzeige zurückgibt gibt jedoch an, dass kein click_through_url verworfen wird. Nur festgelegt dieses Feld, wenn html_snippet, video_url oder native_ad sind festgelegt. Diese Daten werden als Ziel-URL verwendet. zum Beispiel für die Nachfilterung von URLs, die vom Publisher blockiert wurden, Kategorisierung. Weitere Informationen zur Verwendung nativer Anzeigen finden Sie oben im Abschnitt NativeAd.click_link_url. Bei nicht nativen Anzeigen werden sie nicht für Klick-Tracking oder andere Anzeigen verwendet. Funktionalität wird er nur zur Angabe der Ziel-URL verwendet. Wenn bei nativen Anzeigen NativeAd.click_link_url nicht festgelegt ist, Der erste Wert von click_through_url wird verwendet, um den Nutzer zu folgender URL weiterzuleiten: auf die Landingpage gelangen. Darüber hinaus werden alle Werte als Ziel-URL verwendet. (ähnlich wie bei nicht nativen Deklarationen).
NativeAd.click_tracking_urls	Link.clicktrackers	Optional. Zusätzliche URLs, mit denen Werbetreibende Nutzerklicks auf der Anzeige.
Ad.ad_choices_destination_url	BidExt.ad_choices_destination_url	Link zu einer Anzeigenvorgaben oder einer Seite zur Deaktivierung Falls vorhanden, wird ein Standard- Das Datenschutzinfo-Symbol wird dem nativen Creative hinzugefügt und mit dieser URL verknüpft. Dieses wird für native Anzeigen unterstützt, ist aber nicht Teil der nativen Nachricht im Gebotsantwort.
Ad.impression_tracking_url	NativeResponse.imptrackers	Die native Impression sollte mit impression_tracking_url bei Authorized Buyers-Echtzeitgeboten Proto- oder native Impr.-Tracker in OpenRTB.

Erforderliche und empfohlene Felder

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

Ein Bitfeld verwendet jedes Bit eines Binärwerts, um einen wahren oder einen falschen Wert zu speichern. -Anweisung, die dem Senden vieler boolescher Signale wie is_logo_required, is_header_required usw., aber alle in einem Paket.

Beispiel

In diesem Beispiel verwenden wir den required_fields-Wert 1085.

Ermitteln Sie zuerst den äquivalenten Binärwert: 10000111101

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

In der folgenden Tabelle werden die Felder ihrer Position im Binärwert zugeordnet. Lesen Sie die von rechts nach links, wobei das 1-Bit der ganz rechten Stelle entspricht im Binärwert.

Feld	Platzierung des binären Werts (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 Beispielbinärwert 10000111101 zeigt der 1-Bit-Wert (ganz rechts) ist 1 und steht für einen erforderlichen Wert. Gemäß den entspricht das 1-Bit HEADLINE.

Das 2-Bit (zweiter Wert von rechts) bedeutet 0, nicht erforderlich. Das 2-Bit entspricht BODY.

Hier sind alle interpretierten Pflichtfelder in unserem Beispiel:

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

NativeAdTemplate-Nachricht

Wenn Sie eine Gebotsanfrage mit nativem Inventar erhalten, enthält sie einen BidRequest.adSlot[].native_ad_template ausgefüllt. Die NativeAdTemplate-Nachricht enthält Spezifikationen für:

• Felder, die erforderlich oder empfohlen sind.
• Größe von Bildern, Logos und App-Symbolen
• Spezifikationen für den Stil, in dem die Anzeige gerendert wird.

Hinweis:Für das Feld style_layout_type PIXEL gibt an, dass der native Anzeigenblock eine feste Größe hat, während FLUID bedeutet, dass es so skaliert wird, dass es die Breite der umschließenden Spalte ausfüllt und passt die Höhe so an, dass das Seitenverhältnis beibehalten wird. Wenn FLUID gleich angegeben ist, können Höhe und Breite als 1 x 1 angegeben werden.

message BidRequest {
  //...
  message AdSlot {
    //...

    message NativeAdTemplate {
      // Defines the bits used in required_fields and recommended_fields.
      // There is one bit for each of the fields in BidResponse.Ad.NativeAd
      enum Fields {
        NO_FIELDS = 0x0;
        HEADLINE = 0x1;
        BODY = 0x2;
        CALL_TO_ACTION = 0x4;
        ADVERTISER = 0x8;
        IMAGE = 0x10;
        LOGO = 0x20;
        APP_ICON = 0x40;
        STAR_RATING = 0x80;
        PRICE = 0x100;
        DEPRECATED_STORE = 0x200;
        VIDEO = 0x400;
      }

      // Bitfield describing which fields are required by the publisher. Bid
      // responses with no value for these fields will be rejected. Click
      // and view tracking urls are always implicitly required.
      optional int64 required_fields = 1;

      // Bitfield describing which fields are recommended by the publisher.
      // All recommended field are supported, but not all recommended fields
      // are required.
      optional int64 recommended_fields = 2;

      // max_safe_length indicates the maximum number of Unicode characters that
      // are guaranteed to be shown without truncation. Longer strings may be
      // truncated and ellipsized by Ad Exchange or the publisher during
      // rendering.
      optional int32 headline_max_safe_length = 3;
      optional int32 body_max_safe_length = 4;
      optional int32 call_to_action_max_safe_length = 5;
      optional int32 advertiser_max_safe_length = 6;
      optional int32 price_max_safe_length = 15;

      // The width and height from which to calculate the required aspect ratio.
      // You can provide a larger image in the response. Images that have aspect
      // ratios substantially different than those implied by the height and
      // width may be filtered.
      optional int32 image_width = 7;
      optional int32 image_height = 8;
      optional int32 logo_width = 9;
      optional int32 logo_height = 10;
      optional int32 app_icon_width = 11;
      optional int32 app_icon_height = 12;

      // Globally distinct id for the specific style, HTML, and CSS with which
      // the native ad is rendered.
      optional int32 style_id = 16;

      // Type of style layout for each native ad template.
      enum LayoutType {
        PIXEL = 0;
        FLUID = 1;
      }
      optional LayoutType style_layout_type = 17 [default = PIXEL];

      // If the style_layout_type is Pixel, width and height of the
      // entire native ad after rendering. If the style_layout_type is
      // Fluid, the style_height and style_width may optionally
      // not be populated.
      optional int32 style_height = 18;
      optional int32 style_width = 19;
    }
    repeated NativeAdTemplate native_ad_template = 51;
  }

    // NativePlacementType describes placement of native ad slot with respect to
    // surrounding context.
    enum NativePlacementType {
      PLACEMENT_UNKNOWN = 0;
      // In the feed of content - for example as an item inside the organic
      // feed/grid/listing/carousel.
      PLACEMENT_IN_FEED = 1;
      // In the atomic unit of the content - for example, in the article page or single
      // image page.
      PLACEMENT_ATOMIC_UNIT = 2;
      // Outside the core content - for example in the ads section on the right
      // rail, as a banner-style placement near the content, etc.
      PLACEMENT_OUTSIDE = 3;
      // Recommendation widget, most commonly presented below the article
      // content.
      PLACEMENT_RECOMMENDATION = 4;
    }

    optional NativePlacementType native_placement_type = 45;

  // ...
}

NativeAd-Nachricht

Wenn ein Käufer auf natives Inventar bietet, BidResponse.ad[].native_ad mit Pflichtfeldern, die in der entsprechenden BidRequest.adSlot[].native_ad_template deklariert sind.

Hinweis: Einige zusätzliche Felder in BidResponse.Ad sind weil sie für native Anzeigen relevant sind.

message BidResponse {
  //...
  message Ad {
    //...

    message NativeAd {
      // A short title for the ad.
      optional string headline = 1;

      // A long description of the ad.
      optional string body = 2;

      // A label for the button that the user is supposed to click.
      optional string call_to_action = 3;

      // The name of the advertiser or sponsor, to be displayed in the ad
      // creative.
      optional string advertiser = 4;

      // Next tag to use: 4
      message Image {
        optional string url = 1;

        // Image width and height are specified in pixels. You may provide a
        // larger image than was requested, so long as the aspect ratio is
        // preserved.
        optional int32 width = 2;
        optional int32 height = 3;
      }

      // A large image.
      optional Image image = 5;

      // A smaller image, for the advertiser's logo.
      optional Image logo = 6;

      // The app icon, for app download ads.
      optional Image app_icon = 7;

      // The video file. Only set this field if the video field is requested.
      oneof video {
        // The URL to fetch a video ad. The URL should return an XML response
        // that conforms to VAST standards.
        string video_url = 13;

        // The VAST document to be returned.
        string video_vast_xml = 16;
      }

      // The app rating in the app store. Must be in the range [0-5].
      optional double star_rating = 8;

      // The URL that the browser/SDK will load when the user clicks the ad.
      // This can be the landing page directly, or the first step of a redirect
      // chain that eventually leads to it. For backward compatibility, if this
      // is not set, the first Ad.click_through_url is used.
      optional string click_link_url = 14;

      // The URL to use for click tracking. The SDK pings click tracking url on
      // a background thread. When resolving the url, HTTP 30x redirects are
      // followed. The SDK ignores the contents of the response; this URL
      // has no effect on the landing page for the user.
      // This field is planned to be deprecated and we are moving to the
      // repeated click_tracking_urls field.
      optional string click_tracking_url = 11;

      // The URLs to use for click tracking. This will be used throughout the
      // serving stack and will incorporate any URL in click_tracking_urls.
      repeated string click_tracking_urls = 15;

      // The price of the promoted app including the currency info.
      optional string price = 10;

    };
    optional NativeAd native_ad = 18;

    // The set of destination URLs for the snippet. This includes the URLs that
    // the user will go to if they click on the displayed ad, and any URLs that
    // are visible in the rendered ad. Do not include intermediate calls to the
    // adserver that are unrelated to the final landing page. A BidResponse that
    // returns a snippet or video ad but declares no click_through_url will be
    // discarded. Only set this field if html_snippet or video_url or native_ad
    // are set. This data is used as a destination URL declaration, for example
    // for post-filtering of publisher-blocked URLs or ad categorization.
    //
    // For non-native ads, it is not used for click tracking or any
    // other ad functionality; it is only used as a destination URL
    // declaration.
    //
    // For native ads, if NativeAd.click_link_url is not set, the first
    // value of click_through_url is used to direct the user to the landing
    // page. In addition, all values are used as destination
    // URL declarations (similar to the non-native case).
    repeated string click_through_url = 4;

    //...

    // The URLs to call when the impression is rendered. The SDK pings
    // impression urls on a background thread and ignores the contents
    // of the response.
    repeated string impression_tracking_url = 19;

    // Link to ad preferences page. This is only supported for native ads.
    // If present, a standard AdChoices icon is added to the native ad creative and
    // linked to this URL.
    optional string ad_choices_destination_url = 21;
    // ...
  }
}

Beispiele für Gebotsanfragen

Hinweis: Welche Angaben in der Antwort erforderlich und optional sind, erfahren Sie in den unten in der Google-Anfrage an BidRequest.adslot.native_ad_template. Die Anforderungen für OpenRTB-JSON finden Sie im Feld request der BidRequest.imp.native. Informationen zum OpenRTB-Protokollzwischenspeicher finden Sie im Feld request_native des BidRequest.imp.native

Gebotsanfragen ohne Video

Google

Beispiel anzeigen

id: "\020?|;\324c\013\010b\323\321A\277]\017\3643\232.<\230?b"
ip: "\300\250"
user_agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0"
url: "https://www.google.com"
detected_language: "pl"
adslot {
  id: 1
  excluded_attribute: 95
  excluded_attribute: 16
  allowed_vendor_type: 3
  allowed_vendor_type: 42
  excluded_sensitive_category: 4
  excluded_sensitive_category: 23
  matching_ad_data {
    billing_id: 63548360940
    billing_id: 73058881203
    minimum_cpm_micros: 210000
  }
  matching_ad_data {
    billing_id: 47396933418
    billing_id: 29288464031
    minimum_cpm_micros: 1000000
  }
  slot_visibility: BELOW_THE_FOLD
  excluded_product_category: 13680
  ad_block_key: 7661032520
  publisher_settings_list_id: 3957665107521501273
  publisher_settings_list_id: 2660288298851198176
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  excluded_creatives {
    buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
  }
  iframing_state: UNKNOWN_IFRAME_STATE
  viewability: 49
  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: PDj94L0qm9"
    source: "OMITTED"
  }
  consented_providers_settings {
    consented_providers: 1186
    consented_providers: 1301
    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: 800
    image_height: 800
    style_id: 536714
    style_layout_type: FLUID
    style_height: 1
    style_width: 1
  }
  creative_enforcement_settings {
    policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_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
postal_code: "10011"
geo_criteria_id: 20858
encrypted_hyperlocal_set: "!\363\260\353\204l\255n\216\215\201G\261e/\t\305\350=\220\034\220\\J\310\305\247\266\247\027\347\212_\211\363\332\370baL\226\312\375\007}\017\0140\000\262\363\373Y\243\223d\022d=\342\257\340b]\367\356\304\357 \302\204\rC\000|\245\312\235\321\323\265\357K`\307vL\354\220V\346"
publisher_type: PUBLISHER_OWNED_AND_OPERATED
hyperlocal_set {
  hyperlocal {
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
    corners {
      latitude: 0.0
      longitude: 0.0
    }
  }
  center_point {
    latitude: 0.0
    longitude: 0.0
  }
}
device {
  device_type: PERSONAL_COMPUTER
  platform: "Windows"
  os_version {
  }
  screen_pixel_ratio_millis: 1000
  limit_ad_tracking: false
}
publisher_country: "PL"
publisher_id: "pub-1111111111111111"
response_deadline_ms: 300
google_query_id: "ANy-z31Byn-43v7X648f48t464c0VJ47168b3x66Lz451VGsHXp58L9O1o135IzD1F09ZZGb"
auction_type: FIRST_PRICE
geo {
  lat: 50.72
  lon: 21.32
  country: "POL"
  region: "PL-SK"
  zip: "27-570"
  utcoffset: 120
  accuracy: 4730
}
user_agent_data {
  platform {
    brand: "Windows NT"
    version: "10"
    version: "0"
  }
  mobile: false
  browsers {
    brand: "Mozilla"
    version: "5"
    version: "0"
  }
  browsers {
    brand: "Gecko"
    version: "20100101"
  }
  source: USER_AGENT_STRING
}
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"

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "05nylT967i314zc0550QIR",
  "imp": [
    {
      "id": "1",
      "tagid": "9635174525",
      "bidfloor": 0.01,
      "bidfloorcur": "USD",
      "secure": 1,
      "native": {
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":1,\"len\":25}},{\"id\":3,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"ext\":{\"style_id\":221281,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}",
        "ver": "1.2"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "viewability",
          "value": 0.02,
          "vendor": "EXCHANGE"
        },
        {
          "type": "session_depth",
          "value": 7,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          97677444075
        ],
        "publisher_settings_list_id": [
          2939393531484090288,
          7076809137765332725
        ],
        "allowed_vendor_type": [
          42,
          144
        ],
        "ampad": 3,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          32,
          33
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "livestream": 0,
      "language": "ja"
    },
    "mobile": 1,
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "inventorypartnerdomain": "OMITTED"
    }
  },
  "device": {
    "ua": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Mobile Safari/537.36",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "JPN",
      "region": "JP-21",
      "city": "Ogaki",
      "type": 2,
      "utcoffset": 540,
      "accuracy": 1485
    },
    "ipv6": "2402:6b00:f311::",
    "make": "Sharp",
    "model": "shg05",
    "os": "android",
    "osv": "13",
    "devicetype": 4,
    "lmt": 0,
    "w": 320,
    "h": 721,
    "pxratio": 3.375,
    "sua": {
      "browsers": [
        {
          "brand": "Chromium",
          "version": [
            "124",
            "0"
          ]
        },
        {
          "brand": "Google Chrome",
          "version": [
            "124",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Android",
        "version": [
          "13",
          "0"
        ]
      },
      "mobile": 1,
      "model": "SHG05",
      "source": 2
    }
  },
  "user": {
    "id": "RMnq2980sl68Ha7b7TUd4clG7ab",
    "buyeruid": "nc79n59R0Ubi1zrgc9X923Oe72M34CfD",
    "customdata": "I2P0IGi7dhNG943Ecm6436198j178K6v4nP3s99456bUbc27"
  },
  "at": 1,
  "tmax": 300,
  "cur": [
    "USD"
  ],
  "bcat": [
    "IAB9",
    "IAB26"
  ],
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        },
        {
          "asi": "testssp2.com",
          "sid": "pub-1111111111111112",
          "hp": 1
        }
      ],
      "ver": "1.0"
    },
    "ext": {
      "schain": {
        "complete": 1,
        "nodes": [
          {
            "asi": "testssp.com",
            "sid": "pub-1111111111111111",
            "hp": 1
          },
          {
            "asi": "testssp2.com",
            "sid": "pub-1111111111111112",
            "hp": 1
          }
        ],
        "ver": "1.0"
      }
    }
  },
  "ext": {
    "google_query_id": "ANy-ze18lg-8rEH89k518130b8zL5N4Lm590d756ONF330Yg8zoqpisuOv2m5YH2o4712Z0A",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 0
    }
  }
}

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "4vO3ESnZs7gsbNlU3LHL56"
imp {
  id: "1"
  tagid: "4199517334"
  bidfloor: 1.88
  bidfloorcur: "USD"
  pmp {
    deals {
      id: "21043453"
      bidfloor: 1.88
      bidfloorcur: "USD"
      [com.google.doubleclick.deal] {
        deal_type: AUCTION_PACKAGE
      }
    }
  }
  secure: true
  native {
    ver: "1.2"
    api: VPAID_1
    api: VPAID_2
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 90
        }
      }
      assets {
        id: 2
        data {
          type: CTATEXT
          len: 15
        }
      }
      assets {
        id: 3
        required: true
        data {
          type: SPONSORED
          len: 25
        }
      }
      assets {
        id: 4
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      [com.google.doubleclick.native_ext] {
        style_id: 775009
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0011545843444764614
    vendor: "EXCHANGE"
  }
  metric {
    type: "session_depth"
    value: 1.0
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 85753840376
    publisher_settings_list_id: 5097279519468003913
    publisher_settings_list_id: 4840342404554094271
    allowed_vendor_type: 3
    allowed_vendor_type: 42
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 32
    allowed_restricted_category: 33
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    livestream: false
    language: "en"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 Edg/124.0.0.0"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "KY"
    metro: "659"
    city: "Russellville"
    zip: "42276"
    type: IP
    utcoffset: -300
    accuracy: 2548
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9014733
    }
  }
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  lmt: false
  pxratio: 1.0
  sua {
    browsers {
      brand: "Chromium"
      version: "124"
      version: "0"
    }
    browsers {
      brand: "Microsoft Edge"
      version: "124"
      version: "0"
    }
    platform {
      brand: "Windows"
      version: "10"
      version: "0"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  id: "83b9429Xl4Xh2aj6j098Ep3qM0K"
}
at: FIRST_PRICE
tmax: 300
cur: "USD"
bcat: "IAB23-1"
bcat: "IAB23-10"
regs {
  gpp: "OMITTED"
}
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-z2S2lv-WNT3r7KS3S939181y04U9RrC4mv4669j3v5FJ3F823683vd9W3j4q7T3hZr1P"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

Gebotsanfragen für Videoanzeigen

<ph type="x-smartling-placeholder">

</ph> Einblenden

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

Beispiele für Gebotsantworten

Beachten Sie, dass die Werte in dieser Antwort nicht mit dem entsprechenden Anfragen oben. Wenn die Vorlage in der Anfrage jedoch erforderliche/optionale entsprechen die Antworten diesen Anforderungen.

Gebotsantworten ohne Video

Google

Beispiel anzeigen

ad {
  adslot {
    id: 1
    max_cpm_micros: 14161
    billing_id: 63548360940
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_374241"
  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: "213,99 z\305\202"
    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: 21

OpenRTB-JSON

Beispiel anzeigen

{
  "id": "Z8TDDaW77DBY91rct559D3",
  "seatbid": [
    {
      "bid": [
        {
          "id": "20g178F1nO1U81rq3l6",
          "impid": "1",
          "price": 0.12127,
          "adid": "test_creative_id_879318",
          "adm": "{\"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Galactic Luxury Cruises\"}}, {\"id\": 3, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 1200, \"h\": 628}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adomain": [
            "google.com"
          ],
          "cid": "97677444075",
          "crid": "test_creative_id_879318",
          "ext": {
            "app_promotion_type": "INSTALLS",
            "ad_choices_destination_url": "https://test.com/preferences"
          }
        }
      ],
      "seat": "9714:3611:768318"
    }
  ],
  "bidid": "V2drbz93-w5w09453-0766-pLu36cYs0I91"
}

OpenRTB-Protokollzwischenspeicher

Beispiel anzeigen

id: "Z1ooz319AuluM78c9gs382"
seatbid {
  bid {
    id: "27Zv77s98G1G6j81vg2"
    impid: "1"
    price: 1.9337624810013911
    adid: "test_creative_id_425686"
    adomain: "google.com"
    cid: "85753840376"
    crid: "test_creative_id_425686"
    dealid: "21043453"
    cat: "IAB7-5"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        data {
          value: "Book today"
        }
      }
      assets {
        id: 3
        data {
          value: "Galactic Luxury Cruises"
        }
      }
      assets {
        id: 4
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      link {
        url: "https://www.google.com"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
  }
  seat: "1287:1720:806996"
}
cur: "USD"

Videogebotsantworten

<ph type="x-smartling-placeholder">

</ph> Einblenden

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