Build the Response

After your application processes the bid request from Google, it must build and send a response. This guide explains how to code your application to build the response.

Create BidResponse message

Authorized Buyers sends out the BidRequest as the message body of an HTTP POST. The response your application sends must have the Content-Type header set to application/octet-stream and a message body consisting of a serialized protocol buffer. The protocol buffer is a BidResponse message as defined in realtime-bidding.proto. Your application must return a parsable BidResponse in response to every BidRequest. Timeouts and responses that cannot be parsed are considered errors and Google throttles back bidders with high error rates.

If you do not want to bid on an impression, you can set the processing_time_ms field alone, and leave all other fields empty. You can obtain realtime-bidding.proto from the reference data page.

Creative ID

Your BidResponse specifies a creative through the buyer_creative_id field (64 byte limit). Even similar creatives must have unique values for buyer_creative_id if they differ in any notable characteristics, including but not limited to: size, declared URL, creative attributes, and vendor types. In other words, you must give different creative IDs to any two ads which:

• Look or behave differently.
• Render to different images.
• Render by different means (for example, one ad consists of an image, while the other contains Flash).

As you design your application, you should decide on a systematic way of generating identifiers that makes sense for the kinds of creatives you plan to submit.

Ad attributes

You must declare the creative attributes which describe fully the ad's characteristics and its targeting in BidResponse.Ad.attribute. The attributes that must be declared are (see also the full list of supported attributes at buyer-declarable-creative-attributes.txt):

• 7 Tagging: IsTagged
  The ad contains within it a pixel or web-beacon for the purpose of creating a list of cookie IDs for subsequent re-marketing.
• 8 Remarketing: IsRemarketing
  The ad targets consumers based on their cookie ID or Device ID where the list of cookie IDs or Device IDs represent a set of consumers that previously interacted with a site owned or represented by the buyer.
• 9 UserInterestTargeting: IsUserInterestTargeted
  The ad targets consumers based on their cookie ID or Device ID where the list of cookie IDs or Device ID represent a set of consumers the buyer defined as a common interest group.
• 30 InstreamVastVideoType: Vpaid
  The ad requires VPAID support to render.
• 32 MraidType: MRAID
  The ad requires the MRAID API to render.

In addition, the following attributes are supported but their declaration is not required, because Authorized Buyers automatically detects them, and will block (or allow) your creatives based on the detected values, rather than your declaration. See Creatives API for explanation on how to get feedback regarding the detected properties of your creatives.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  The ad requires Flash support to render.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  The ad does not require Flash to render.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  The ad has the ability to render on an SSL page. Note that Authorized Buyers treats creatives with different declared values of this attribute as distinct (they will be reviewed separately and have distinct approval status). Therefore, if you bid with both SSL and non-SSL versions of the same creative, you should declare this attribute accordingly, so that this distinction is properly reflected in AdX.

Open Bidding fields

Bid responses sent by exchange and network bidders participating in Open Bidding are similar to those of Authorized Buyers participating in standard real-time bidding. Open Bidding customers can specify a small number of additional fields, and a few existing fields may have alternative uses. These include the following:

OpenRTB	Authorized Buyers	Details
BidResponse.imp[].pmp.deals[].id	BidResponse.ad[].adslot[].exchange_deal_id	The deal ID from the exchange's namespace that is associated with this bid and reported to publishers. Note: This field is currently only sent to closed beta participants.
BidResponse.seatbid[].bid[].ext.exchange_deal_type	BidResponse.ad[].adslot[].exchange_deal_type	The type of deal reported to publishers, affecting how the deal is treated in the auction. Note: This field is currently only sent to closed beta participants.
BidResponse.seatbid[].bid[].ext.third_party_buyer_token	BidResponse.ad[].adslot[].third_party_buyer_token	Token used to identify end third-party buyer information if the exchange as an Open Bidder is an intermediary. This is obtained from the third-party buyer and must be passed to Google unaltered in the bid response.

Recommendations

• Enable persistent HTTPS connections (also known as "keep-alive" or "connection reuse") on your servers. Set the timeout to 10 seconds at minimum—higher values are beneficial in many cases. Google verifies this during the initial latency tests of your application, because Authorized Buyers sends requests at a high rate and needs to avoid the latency overhead of establishing a separate TCP connection for each request.

• Include the optional impression tracking URL to track when the impression renders rather than when the bidder wins. Because of the dropoff between wins and renderings, this yields more accurate tracking statistics.

  Note: When using OpenRTB 2.5 or higher, the standard field for this is BidResponse.seatbid[].bid[].burl.
• Keep your bidder code free of dependencies on deprecated fields, which can cause your bids to fail with errors.
• Include BidResponse.Ad.width and BidResponse.Ad.height in your BidResponse. A BidResponse to a request that includes multiple ad sizes must include the width and height values or it will be dropped from the auction.
• Limit your response size to under 8K. Very large responses may increase network latency and cause timeouts.
• Follow the guidelines for bids on iOS inventory that require SKAdNetwork attribution.

Example bid response

The following examples represent human-readable samples of the Protobuf and JSON requests.

Google

Show me the example

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

OpenRTB JSON

Show me the example

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

OpenRTB Protobuf

Show me the example

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

Important: The Protobuf messages depicted in the samples are represented here as human-readable text. However, that is not how the messages are sent over the wire. When using the Google or OpenRTB Protobuf format, only serialized BidResponse messages will be accepted.

You can create and serialize a BidResponse message using the following C++ code:

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

Specify creative

Your bid response specifies the creative to serve if your bid wins. Your bid must include one of the supported ad formats (AMP, video, native). In this example, we specify the creative using the html_snippet field.

Alternatively, you can specify your creative using one of the following fields, based on ad format:

• SDK rendered ad
  • BidResponse.Ad.sdk_rendered_ad
• AMP
  • BidResponse.Ad.amp_ad_url
• Video
  • BidResponse.Ad.video_url or
  • BidResponse.Ad.video_vast_xml
• Native
  • BidResponse.Ad.native_ad

Specify an ad that is hosted on your own server(s) using an HTML snippet in the html_snippet field of the BidResponse. The snippet is enclosed in an iFrame inserted in the web page, resulting in the ad being retrieved and rendered when the page is loaded. You must craft the HTML snippet so that the ad (banner or interstitial) renders correctly inside an iFrame, and at an appropriate size for the ad slot you are bidding on.

In addition, the ad size declared in the bid response must match exactly one of the size combinations in the bid request when:

• An ad is a regular banner (not video, native, or interstitial).
• The bidder has declared the size in the bid response. Size declaration is required whenever more than one size is present in the request.
• An exception is made for interstitial ads. For interstitials the width must be at least 50% of the screen width and the height to at least 40% of the screen height.

The html_snippet field supports any valid HTML code that renders properly, but keep in mind the restrictions on specifying the buyer_creative_id field in the Create BidResponse message section. One use for this is to put extra information into arguments of the URLs that are fetched from your servers as part of rendering the ad. This enables you to pass arbitrary data about the impression back to your own servers.

Most policies for HTML snippets returned in bid responses are the same as for third-party ads. See Authorized Buyers Program Guidelines, Requirements for third-party ad serving, and Declare click-through URLs in ads for more information.

Specify macros

The HTML snippet that defines a creative can include one or more special constructs called macros. At ad serving time, values are substituted for macros. For example, your client bidding application could use the WINNING_PRICE macro to determine how much it paid for the ad, if it wins the auction. To parse this macro, you will need to implement an application that decrypts price confirmations. Refer to the Decrypting Price Confirmations page for more information.

Specify a macro as part of an HTML snippet in the format %%MACRO%%, where MACRO is one of the supported macros listed in the table below.

Note: For AMP ad bid responses (amp_ad_url), only WINNING_PRICE and WINNING_PRICE_ESC macros are supported.

Google requires that you use use either the CLICK_URL_UNESC or CLICK_URL_ESC macro within the creative of the third-party served ad. Google uses the CLICK_URL macros for click tracking.

To use a macro, include it in the ad so that the URL gets fetched when someone clicks on it. The return value of the fetch is a redirect to another URL that you append to the CLICK_URL.

Note: In addition to these DoubleClick macros, we also support OpenRTB macros. See the OpenRTB specification for more information about OpenRTB macros.

Macro	Description
ADVERTISING_IDENTIFIER	Allows buyers to receive iOS IDFA or Android's Advertising ID on impression rendering. See Decrypting Advertiser Identifiers for details.
CACHEBUSTER	A string representation of a random, unsigned, four-byte integer.
CLICK_URL_UNESC	The unescaped click URL for the ad. In the snippet, an escaped version of the third party click URL should directly follow the macro. For example, if the third-party click URL is http://my.adserver.com/some/path/handleclick?click=clk, then the following code could be used with the single-escaped version of the third party click URL following the macro invocation: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> At ad serving time, this is expanded to: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> The URL will first register the click with Google, and then redirect to the third party click URL.
CLICK_URL_ESC	The escaped click URL for the ad. Use this instead of CLICK_URL_UNESC if you need to first pass the value through another server that will then return a redirect. For example, the following code could be used in an HTML snippet: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> At ad serving time, this is expanded to: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> This will register the click with my.adserver.com which will then be responsible for redirecting to the URL passed in the google_click_url parameter. This assumes that my.adserver.com unescapes the google_click_url parameter. You can append a double-escaped URL after %%CLICK_URL_ESC%%. After the unescaping is done by my.adserver.com, that leaves a single-escaped version of the URL appended to the google_click_url. When the google_click_url is fetched, it will unescape once more and then redirect.
CLICK_URL_ESC_ESC	The double-escaped URL for the ad. Use this instead of CLICK_URL_UNESC if you need to first pass the value through another server that will then return a redirect. For example, the following code could be used in an HTML snippet: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> At ad serving time, this is expanded to: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
SCHEME	Expanded to http: if the bid request does not require SSL or to https: if the bid request requires SSL.
SITE	The url-escaped domain of the content URL or the anonymous ID for anonymous inventory.
SITE_URL	Deprecated. Replaced by the SITE macro which provides identical functionality.
TZ_OFFSET	The time-zone offset.
VERIFICATION	The different values for production and when the creative is scanned in the verification pipeline. The format is: %%?VERIFICATION:true-val:false-val%% where any values except macros can be used for true-val and false-val, including empty strings. For Open Bidding, we recommend that exchanges use this macro; once they do so, demand-side platforms do not need to make changes. For example if a creative were to include %%?VERIFICATION:-1:5000%% then the text replacement would be 5000 on serving and -1 in the verification pipeline. This is to help differentiate between these two sets of pings.
WINNING_PRICE	The encoded impression cost (that is, CPI rather than CPM) in micros of the account currency. For example, a winning CPM of $5 USD corresponds to 5,000,000 micros CPM, or 5,000 micros CPI. The decoded value of WINNING_PRICE in this case would be 5,000. The winning price is specified in CPI.
WINNING_PRICE_ESC	URL-escaped WINNING_PRICE.

URL escaping in macros uses the following scheme:

• The space character is replaced by a plus sign (+).
• Alphanumeric characters (0-9, a-z, A-Z) and characters from the set !()*,-./:_~ remain unchanged.
• All other characters are replaced by %XX, where XX is the hexadecimal number representing the character.

Publisher restrictions

Publishers use the BidRequest to pass restrictions on what ads they will allow. You are required to enforce the restrictions in these fields:

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

One field specifies allowed features of the ad and the other specifies disallowed features. Never return an ad with a disallowed feature. For allowed features such as vendor type, return an ad only if its vendor type is in the allowed_vendor_type list in the BidRequest. See the comments for these fields in the BidRequest protocol buffer definition for more details.

If an HTML snippet is returned in BidResponse, you are required to accurately set the attribute, category, and click_through_url fields in the BidResponse. If an ad has multiple applicable values for these fields, then you must include every value. See the comments for these fields in the BidResponse protocol buffer definition for more details. Responses that do not have these fields set are discarded.

The possible values of BidRequest.excluded_attribute are (see publisher-excludable-creative-attributes.txt):

• 7 Tagging: IsTagged
  Ads are disallowed if they contain a pixel or web-beacon for the purpose of creating a list of cookie IDs for subsequent re-marketing.
• 8 CookieTargeting: IsCookieTargeted
  Ads are disallowed if they target consumers based on their cookie ID where the list of cookie IDs represents a set of consumers that previously interacted with a site owned or represented by the buyer.
• 9 UserInterestTargeting: IsUserInterestTargeted
  Ads are disallowed if they target consumers based on their cookie ID where the list of cookie IDs represents a set of consumers the buyer defined as a common interest group.
• 21 CreativeType: Html
  Ads are disallowed to use the html_snippet or snippet_template field in BidResponse.Ad.
• 22 CreativeType: VastVideo
  Ads are disallowed to use the video_url field in BidResponse.Ad.
• 30 InstreamVastVideoType: Vpaid
  Ads are disallowed to require VPAID support to render.
• 32 MraidType: MRAID
  Ads are disallowed to require the MRAID API to render.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  Ads are disallowed to require Flash support to render.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  Ads are disallowed to require HTML5 features to render.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  Ads are disallowed to make non-SSL requests.

Therefore, if the excluded_attribute field contains the value 7, then you should not return an ad that uses a pixel or web-beacon for creating a list. Note that if an ad does this, then it must set the value 7 in the attribute field of the BidResponse. Similarly, if the excluded_attribute field contains the value 48, then you should only return ads that can render on an SSL page (and accordingly declare attribute 47 RichMediaCapabilityType: RichMediaCapabilitySSL).

Also the excluded_sensitive_category field in the BidRequest uses codes from the ad-sensitive-categories.txt file available on the reference data page. Here are extended descriptions of some of these codes:

• 3 Politics
  Includes politics or controversial social issues; does not include ads for news organizations that are not generally associated with a partisan viewpoint on issues.
• 4 Dating
  Includes dating services and online dating communities.
• 5 Religion
  Includes religious ads and ads advocating for or against religious views; does not include astrology or non-denominational spirituality.
• 7 Video Games (Casual & Online)
  Includes video games, online games and downloadable games; does not include video game consoles.
• 8 Ringtones & Downloadables
  Mobile add-ons including ringtones, and other downloadable goodies such as screensavers and wallpapers for desktop PCs and profile layouts and graphics for social networks.
• 10 Get Rich Quick
  Schemes promising rapid earnings.
• 18 Weight Loss
  Includes weight loss, dieting, and related products and programs; does not include healthy eating or general fitness ads.
• 19 Cosmetic Procedures & Body Modification
  Includes lifts, suctions, lasers, hair removal and restoration, tattoos, and body modification.
• 23 Drugs & Supplements:
  Includes pharmaceuticals, vitamins, supplements, and related retailers; does not include resources providing information about drugs.
• 24 Sexual & Reproductive Health
  Includes sexual function and fertility ads; does not include normal pregnancy resources.
• 35 Social Casino Games
  Includes simulated gambling games (including, without limitation, poker, slots, bingo, lotteries, sports betting, betting on races, as well as other card games and casino games) where there is no opportunity to win anything of value (such as money or prizes).
• 36 Significant Skin Exposure
  Ad images where any part of the human body from the sternum to the mid-thigh is not clothed; or the body is clothed in underwear, swimwear, lingerie, or other see-through clothes or non-clothing items such as a towel or bed sheet.
• 37 Sensationalism
  Ads that aim to induce users to click them by appealing to their curiosity, often using a teaser message with hyperbolic language or imagery. Includes ads that center around sensationalistic subjects (such as celebrity arrests, deaths, or divorces) or aim for shock value.

Open Measurement

Open Measurement lets you specify third-party vendors that provide independent measurement and verification services for ads served to mobile app environments.

Supported ad formats currently include video, banner, and interstitial ads. For more information on how to use Open Measurement in a bid response containing these formats, refer to the Open Measurement SDK Help Center article.

Sample bid responses

The following sections show sample bid responses for different ad types.

App banner

Google

Show me the example

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

OpenRTB JSON

Show me the example

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

OpenRTB Protobuf

Show me the example

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

App Interstitial

Google

Show me the example

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

OpenRTB JSON

Show me the example

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

OpenRTB Protobuf

Show me the example

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

App interstitial video

Google

Show me the example

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

OpenRTB Protobuf

Show me the example

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

App native

Google

Show me the example

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

OpenRTB JSON

Show me the example

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

OpenRTB Protobuf

Show me the example

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

Web video

Google

Show me the example

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Mobile web banner for exchange bidder

OpenRTB Protobuf

Show me the example

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}