Authorized Buyers Real-time Bidding Protocol Buffer

View raw content Back to Reference page

// Protocol version: v.331
import "google/protobuf/struct.proto";

// This is the message that Google uses to request bids. A BidRequest
// includes the ad slot from a single impression.
message BidRequest {
  // Unique request id generated by Google. This is 16 bytes long.
  required bytes id = 2;

  // -----------------------------------------------------------
  // This section lists information that we know about the user.
  //
  // The first 3 bytes of the IP address in network byte order for IPv4, or the
  // first 6 bytes for IPv6. Note that the number and position of the bytes
  // included from IPv6 addresses may change later.
  optional bytes ip = 4;

  // Reasons for special treatment of user data (google_user_id,
  // hosted_match_data, IDFA, etc).
  enum UserDataTreatment {
    // The current request should be treated as child-directed for purposes of
    // the Children's Online Privacy Protection Act. See
    // https://support.google.com/admanager/answer/4442399 for more information.
    TAG_FOR_CHILD_DIRECTED_TREATMENT = 0;
  }

  // Deprecated. This will be removed in March 2024.
  // When user_data_treatment is set, the user's cookie/id data is cleared from
  // the request and is not sent in callout.
  // The impacted fields are:
  //  * google_user_id
  //  * hosted_match_data
  //  * mobile.encrypted_advertising_id
  //  * mobile.encrypted_hashed_idfa
  //  * session_id
  repeated UserDataTreatment user_data_treatment = 49 [deprecated = true];

  // The Google ID for the user. This field is the unpadded web-safe base64
  // encoded version of a binary cookie id. See the "Base 64 Encoding with URL
  // and Filename Safe Alphabet" section in RFC 3548 for encoding details. This
  // field may be the same as the Google ID returned by the cookie matching
  // service. Not set if there is one or more user_data_treatment value.
  optional string google_user_id = 21;

  // The version number of the google_user_id. We may sometimes change the
  // mapping from cookie to google_user_id. In this case the version will be
  // incremented.
  optional uint32 cookie_version = 20;

  // The time in seconds since the google_user_id was created.
  // This number may be quantized.
  optional int32 cookie_age_seconds = 31;

  // Match data stored for this google_user_id through the cookie matching
  // service. If a match exists, then this field holds the decoded data that
  // was passed in the google_hm parameter.
  // Not set if there is one or more user_data_treatment value.
  optional bytes hosted_match_data = 37;

  // Represents a short-lived user session on CTV/OTT devices,
  // with a maximum session duration of 6 hours.
  // The use of session_id is never allowed for ads personalization.
  // session_id may only be used for frequency capping, competitive exclusions
  // or related purposes.
  optional string session_id = 65;

  // Time in seconds since the first ad request in a given app or site session.
  // The session is reset after a sufficiently long break in user activity.
  // Currently, the field is only supported for mobile app requests.
  optional int32 session_duration_seconds = 83;

  // A pseudonymized identifier created and controlled by the publisher for use
  // in frequency capping, audience segmentation and targeting, and sequential
  // ad rotation. See https://support.google.com/admanager/answer/2880055.
  optional string publisher_provided_id = 79;

  // Publisher first-party identifier scoped to a single site, app or vendor.
  message PublisherFirstPartyId {
    // Specifies how an ID is scoped and the type of requests it is used with.
    enum IdType {
      // A default value that should not be used.
      UNKNOWN = 0;

      // A site-scoped cookie for requests from web browsers.
      SITE_SCOPED_COOKIE = 1;
    }

    // The type of the ID. This specifies how it is scoped and the type of
    // requests it is used with.
    optional IdType id_type = 1;

    // The value of the ID.
    optional string id = 2;
  }
  optional PublisherFirstPartyId publisher_first_party_id = 85;

  // A string that identifies the browser and type of device that sent the
  // request. Certain data may be redacted or replaced.
  optional string user_agent = 6;

  // Information about privacy treatments that apply to an ad opportunity
  // offered through this request.
  message PrivacyTreatments {
    // Generalization that can be applied to the BidRequest.ip field.
    enum IpGeneralization {
      // The BidRequest.ip field is truncated, /24 for IPv4 and /48 for IPv6.
      // IPv4 addresses are truncated to 3-byte strings, representing the
      // first three octets of an IP address. IPv6 addresses are truncated to
      // 6-byte strings, representing the first 6 octets of an IP address.
      IP_TRUNCATED = 0;

      // The BidRequest.ip field is redacted.
      IP_REDACTED = 2;
    }

    // Generalization for the BidRequest.ip field.
    optional IpGeneralization ip = 1;

    // Generalization that can be applied to the user_agent and user_agent_data
    // fields.
    enum UserAgentGeneralization {
      // The user_agent and user_agent_data fields are both provided in full.
      USER_AGENT_FULL = 0;

      // The user_agent and user_agent_data fields are generalized, which can
      // include limiting browser and OS version information to major versions
      // only and other changes to protect user privacy.
      USER_AGENT_COARSE = 1;
    }

    // Generalization that was applied to the user_agent and user_agent_data
    // fields, if any.
    optional UserAgentGeneralization user_agent = 2;

    // Specifies the reasons that ads returned in response to this request
    // should not be personalized. This signal does not reflect user decisions
    // on surfaces including iOS App Tracking Transparency
    // (https://developer.apple.com/documentation/apptrackingtransparency) or
    // Android advertising ID
    // (https://support.google.com/googleplay/android-developer/answer/6048248).
    // See BidRequest.device.limit_ad_tracking and
    // BidRequest.device.app_tracking_authorization_status fields for more
    // information.
    enum NonPersonalizedAdsReason {
      UNKNOWN = 0;

      // The publisher has declared that this request should serve
      // non-personalized ads independent of other signals.
      // https://support.google.com/admanager/answer/9005435#npa
      PUBLISHER_DECLARED_NPA = 1;

      // The publisher has requested restricted data processing for this
      // request. https://support.google.com/authorizedbuyers/answer/11121285
      RESTRICT_DATA_PROCESSING = 2;

      // The user has opted out of ads personalization.
      USER_OPT_OUT = 3;
    }
    repeated NonPersonalizedAdsReason non_personalized_ads_reason = 6 [packed =
      true];

    // True if publisher grants the permission to allow the bidder to use bid
    // request data to build user profiles for uses such as interest-based ads
    // and remarketing. To use this data to build user profiles, a bidder must
    // also win a given impression.
    // Learn more about data collection controls:
    // https://support.google.com/admanager/answer/11956152
    optional bool allow_user_data_collection = 7;

    // Reasons why on-device storage access could be restricted during the
    // delivery of a winning ad.
    enum DeviceStorageRestrictionReason {
      DEVICE_STORAGE_RESTRICTION_UNKNOWN = 0;

      // This request is subject to user consent requirements to allow for
      // device storage access for advertising use cases such as ads
      // measurement, frequency capping, or profiling, but consent was
      // insufficient or not provided.
      INSUFFICIENT_USER_CONSENT = 1;
    }

    // Indicates the reason why access of local device storage during winning ad
    // rendering and measurement is restricted.
    optional DeviceStorageRestrictionReason device_storage_restriction_reason =
      8;
  }
  optional PrivacyTreatments privacy_treatments = 71;

  // Data segments that describe the content or audience.
  message SegmentData {
    // The Google assigned ID of the data provider. For the list of data
    // providers, see
    // https://storage.googleapis.com/adx-rtb-dictionaries/data_providers.txt.
    optional string id = 5;

    // Exchange-specific name for the signal provider.
    optional string name = 1;

    // Segment objects contain segment IDs that can be used with the taxonomy
    // type to access first party data.
    message Segment {
      // ID of the data segment specific to the signal provider.
      optional string id = 1;
    }
    repeated Segment segment = 2;

    // Identifies the taxonomy that the segment IDs belong to.
    enum TaxonomyType {
      TAXONOMY_TYPE_UNKNOWN = 0;

      // https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv
      IAB_AUDIENCE_1_1 = 4;

      // https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv
      IAB_CONTENT_2_2 = 6;

      // https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%203.0.tsv
      IAB_CONTENT_3_0 = 7;
    }

    // The taxonomy in use for segment IDs.
    optional TaxonomyType type = 3;
  }

  // Data segments for Publisher Provided Signals:
  // https://support.google.com/admanager/answer/12451124
  repeated SegmentData segment_data = 75;

  // Structured user agent information, which can be used when a client
  // supports User-Agent Client Hints: https://wicg.github.io/ua-client-hints/
  //
  // Note: When available, fields are sourced from Client Hints HTTP headers
  // or equivalent JavaScript accessors from the NavigatorUAData interface.
  // For agents that have no support for User-Agent Client Hints, an exchange
  // can also extract information from the parsed User-Agent header, so this
  // object can always be used as the source of the user agent information.
  message UserAgent {
    // Identifies a device's browser or similar software component, and the
    // user agent's execution platform or operating system.
    message BrandVersion {
      // A brand identifier, for example, "Chrome" or "Windows". The value may
      // be sourced from the User-Agent Client Hints headers, representing
      // either the user agent brand (from the Sec-CH-UA-Full-Version header)
      // or the platform brand (from the Sec-CH-UA-Platform header).
      optional string brand = 1;

      // A sequence of version components, in descending hierarchical order
      // (major, minor, micro, ...).
      repeated string version = 2;
    }

    // Each BrandVersion object identifies a browser or similar software
    // component. Exchanges should send brands and versions derived from
    // the Sec-CH-UA-Full-Version-List header.
    repeated BrandVersion browsers = 8;

    // Identifies the user agent's execution platform / OS. Exchanges should
    // send a brand derived from the Sec-CH-UA-Platform header, and version
    // derived from the Sec-CH-UAPlatform-Version header.
    optional BrandVersion platform = 2;

    // True if the agent prefers a "mobile" version of the content if
    // available, meaning optimized for small screens or touch input. False
    // if the agent prefers the "desktop" or "full" content. Exchanges should
    // derive this value from the Sec-CH-UAMobile header.
    optional bool mobile = 3;

    // Device's major binary architecture, for example, "x86" or "arm".
    // Exchanges should retrieve this value from the Sec-CH-UA-Arch header.
    optional string architecture = 4;

    // Device's bitness, for example, "64" for 64-bit architecture. Exchanges
    // should retrieve this value from the Sec-CH-UA-Bitness header.
    optional string bitness = 9;

    // Device model. Exchanges should retrieve this value from the
    // Sec-CH-UAModel header.
    optional string model = 5;

    // Possible sources for User-Agent data. In the case of Client Hints headers
    // the source also distinguishes between requests that are restricted to
    // the low-entropy headers and requests that don't have that restriction;
    // see wicg.github.io/client-hints-infrastructure/#low-entropy-hint-table.
    enum Source {
      UNKNOWN_SOURCE = 0;

      // User-Agent Client Hints (only low-entropy headers were available).
      CLIENT_HINTS_LOW_ENTROPY = 1;

      // User-Agent Client Hints (with high-entropy headers available).
      CLIENT_HINTS_HIGH_ENTROPY = 2;

      // Parsed from User-Agent header.
      USER_AGENT_STRING = 3;
    }

    // The source of data for the User Agent information.
    optional Source source = 10;
  }

  // Structured user agent information. If both BidRequest.ua and
  // BidRequest.sua are present, BidRequest.sua should be considered the
  // more accurate representation of the device attributes. This is because
  // BidRequest.ua may contain a frozen or reduced user agent string.
  optional UserAgent user_agent_data = 63;

  // The billing address country of the publisher. This may be different from
  // the detected country of the user in geo_criteria_id or the hosting country
  // of the website. For a complete list of country codes, refer to
  // https://developers.google.com/google-ads/api/data/codes-formats#country_codes
  optional string publisher_country = 55;

  // The ID of the host publisher. When populated, indicates that the host
  // publisher participated in revenue sharing, and the ID can be used to
  // authorize ads.txt.
  optional string host_publisher_id = 73;

  // The domain of the partner (of the site/app owner) with ownership
  // of some portion of ad inventory on the site/app. The partner's ads.txt or
  // app-ads.txt file will be hosted here. More detail at
  // http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
  optional string inventory_partner_domain = 72;

  // Location of the end user. Uses a subset of the codes used in the Google
  // Ads API. See the geo-table.csv table in the technical documentation for a
  // list of IDs. The geo_criteria_id field replaces the deprecated country,
  // region, city, and metro fields.
  // It is recommended that BidRequest.geo be used instead of this field.
  // See Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  optional int32 geo_criteria_id = 39;

  // The user's approximate geographic location. All location information is
  // IP geolocation-derived. The lat/lon fields may be a reference position
  // (for example, centroid) for the IP geolocation-derived location that's also
  // carried by the other fields (for example, a city), and accuracy will be the
  // radius of a circle with the approximate area of that location. Location and
  // its accuracy will be fuzzified as necessary to protect user privacy. See
  // Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  message Geo {
    // Latitude from -90.0 to +90.0, where negative is south.
    optional double lat = 1;

    // Longitude from -180.0 to +180.0, where negative is west.
    optional double lon = 2;

    // Country using ISO-3166-1 Alpha-3.
    optional string country = 3;

    // Region code using ISO-3166-2; 2-letter state code if USA.
    optional string region = 4;

    // Google metro code; similar to but not exactly Nielsen DMAs.
    optional string metro = 6;

    // City using United Nations Code for Trade & Transport Locations.
    // (https://www.unece.org/cefact/locode/service/location.htm).
    optional string city = 7;

    // Zip/postal code.
    optional string zip = 8;

    // Estimated location accuracy in meters.
    optional int32 accuracy = 11;

    // Local time as the number +/- of minutes from UTC.
    optional int32 utcoffset = 10;
  }
  optional Geo geo = 62;

  // Deprecated. This field will be removed in Q3 2023. It is recommended that
  // BidRequest.geo.zip be used instead. See Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  // Detected postal code of the appropriate type for the country of the end
  // user (for example, zip code if the country is "US"). The postal_code_prefix
  // field is set when accuracy is too low to imply a full code, otherwise the
  // postal_code field is set.
  optional string postal_code = 33 [deprecated = true];

  // Deprecated. This field will be removed in Q3 2023. It is recommended that
  // BidRequest.geo.zip be used instead. See Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  optional string postal_code_prefix = 34 [deprecated = true];

  // Deprecated. This field will be removed in Q3 2023. It is recommended that
  // BidRequest.geo is used instead. See Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  // Encrypted hyperlocal targeting signals.
  optional bytes encrypted_hyperlocal_set = 40 [deprecated = true];

  // Coarse geolocation information approximated based on the IP address of the
  // device the ad request originated from.
  message Hyperlocal {
    // A location on the Earth's surface.
    message Point {
      optional float latitude = 1;
      optional float longitude = 2;
    }

    // The device can be at any point inside the geofence polygon defined by a
    // list of corners. Currently, the polygon is always a parallelogram with 4
    // corners.
    repeated Point corners = 1;
  }

  message HyperlocalSet {
    // This field currently contains at most one hyperlocal polygon.
    repeated Hyperlocal hyperlocal = 1;

    // The approximate geometric center of a geofence area. It is calculated
    // exclusively based on the geometric shape of the geofence area and in no
    // way indicates the mobile device's actual location within the geofence
    // area. If multiple hyperlocal polygons are specified above then
    // center_point is the geometric center of all hyperlocal polygons.
    optional Hyperlocal.Point center_point = 2;
  }

  // Deprecated. This field will be removed in Q3 2023. It is recommended that
  // BidRequest.geo is used instead. See Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  // Unencrypted version of encrypted_hyperlocal_set. This field is only set
  // when using an SSL connection.
  optional HyperlocalSet hyperlocal_set = 53 [deprecated = true];

  // Deprecated. This field will be removed in Q3 2023. It is recommended that
  // BidRequest.geo is used instead. See Geotargeting Guide:
  // https://developers.google.com/authorized-buyers/rtb/geotargeting
  // The offset of the user's time from GMT in minutes. For example, GMT+10 is
  // timezone_offset = 600.
  optional int32 timezone_offset = 25 [deprecated = true];

  // This field is not populated by default. We recommend that bidders instead
  // store and look up list ids using either google_user_id or hosted_match_data
  // as keys.
  message UserList {
    // The user list id.
    optional int64 id = 1;

    // The time in seconds since the user was added to the list.
    optional int32 age_seconds = 2;
  }
  repeated UserList user_list = 32;

  // -----------------------------------------------------------
  // This section lists information that we know about the web page or mobile
  // application where the impression originates.
  //
  // The publisher ID as defined by the publisher code suffix of
  // the web property code. For instance, "pub-123" is the publisher code of web
  // property code "ca-pub-123" (ca- is the product specific prefix of the web
  // property).
  optional string publisher_id = 56;

  // Deprecated. This field will be removed in Q2 2024.
  // The seller network id. See seller-network-ids.txt file in the technical
  // documentation for a list of ids. This is only set if the site is not
  // anonymous and the publisher allows site targeting.
  optional int32 seller_network_id = 41 [deprecated = true];

  // Id for the partner that provides this inventory. This is only set when
  // seller_network_id is also set and further partner information beyond the
  // seller_network_id is also available. The value of the partner_id is not
  // meaningful beyond providing a stable identifier.
  optional fixed64 partner_id = 52;

  // The URL of the page with parameters removed. This is only set if the
  // publisher allows site targeting. This always starts with a protocol (either
  // http or https).
  optional string url = 11;

  // Indicates that the request is using semi-transparent branding,
  // which means only a truncated version of the request URL will
  // be provided. This decision is made by the publisher, see
  // https://support.google.com/admanager/answer/4584891#urls for context.
  optional bool is_semi_transparent_request = 67;

  // Detected user languages, based on the language of the web page, the browser
  // settings, and other signals. The order is arbitrary. The codes are 2 or 5
  // characters and are documented at
  // https://developers.google.com/google-ads/api/data/codes-formats#languages
  repeated string detected_language = 12;

  // One or more detected verticals for the page as determined by Google.
  message Vertical {
    // The vertical id. See the publisher-verticals.txt file in the technical
    // documentation for a list of ids.
    required int32 id = 1;

    // Weight for this vertical, in the (0.0, 1.0] range. More relevant
    // verticals have higher weights.
    required float weight = 2;
  }

  // Unordered list of detected content verticals. See the
  // publisher-verticals.txt file in the technical documentation for a list of
  // ids.
  repeated Vertical detected_vertical = 13;

  // List of detected content labels. See content-labels.txt file in the
  // technical documentation for a list of ids.
  repeated int32 detected_content_label = 26 [packed = true];

  // The production quality of the content. See
  // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--production-qualities-
  // for details.
  enum ProductionQuality {
    QUALITY_UNKNOWN = 0;

    // Content that is usually created or produced by media and entertainment
    // companies using professional-grade equipment, talent, and production
    // crews that hold or maintain the rights for distribution and syndication.
    PROFESSIONAL = 1;

    // Consumer or user-generated content that has professional or industrial
    // qualities (e.g. shot with professional-grade equipment, using
    // professional talent, etc.).
    PROSUMER = 2;

    // Publicly available video content that is created or produced by
    // end users.
    USER_GENERATED = 3;
  }

  // The production quality of the content where an ad can be shown, as
  // determined by the publisher.
  optional ProductionQuality production_quality = 80 [default =
    QUALITY_UNKNOWN];

  // The rating of the content. See
  // https://support.google.com/admanager/answer/12451124#content-rating for
  // details.
  enum ContentRating {
    RATING_UNKNOWN = 0;

    // Content suitable for general audiences.
    GENERAL_AUDIENCES = 1;

    // Content suitable for most audiences with parental guidance.
    PARENTAL_GUIDANCE = 2;

    // Content suitable for teen and older audiences.
    TEEN = 3;

    // Content suitable only for mature audiences.
    MATURE_AUDIENCES = 4;
  }

  // The rating of the content where an ad can be shown.
  optional ContentRating content_rating = 84 [default = RATING_UNKNOWN];

  // This represents a unique ID for the overall query. In the event
  // that there are multiple callouts for a query, all callout requests for that
  // query will contain the same google_query_id.
  optional string google_query_id = 59;

  // The type of auction that will be run for this query.
  enum AuctionType {
    UNKNOWN_AUCTION_TYPE = 0;
    FIRST_PRICE = 1;
    SECOND_PRICE = 2;
    FIXED_PRICE = 3;
  }
  optional AuctionType auction_type = 60 [default = SECOND_PRICE];

  // Information about the device.
  message Device {
    // The type of device on which the ad will be shown.
    enum DeviceType {
      UNKNOWN_DEVICE = 0;
      HIGHEND_PHONE = 1;
      TABLET = 2;

      // Desktop or laptop devices.
      PERSONAL_COMPUTER = 3;

      // Both connected TVs (that is, smart TVs) and connected devices
      // (such as Roku and Apple TV).
      CONNECTED_TV = 4;
      GAME_CONSOLE = 5;
      SET_TOP_BOX = 6;
    }
    optional DeviceType device_type = 1 [default = UNKNOWN_DEVICE];

    // The platform of the device. Examples: android, iphone, palm
    optional string platform = 2 [default = ""];

    // The brand of the device (for example, "Apple" or "Samsung").
    optional string brand = 3 [default = ""];

    // Device model (for example, "pixel 7 pro"). For iPhone/iPad, this
    // field contains Apple's model identifier string (such as "iPhone12,1" and
    // "iPad13,8") if available. Otherwise this field contains the generic
    // model (either "iphone" or "ipad").
    optional string model = 4 [default = ""];

    // Contains the OS version of the platform. For instance, for Android 2,
    // major=2, minor=0. For iPhone 3.3.1, major=3 and minor=3.
    message OsVersion {
      optional int32 major = 1 [default = -1];
      optional int32 minor = 2 [default = -1];
      optional int32 micro = 3 [default = -1];
    }

    // The OS version; for example, 2 for Android 2.1, or 3.3 for iOS 3.3.1.
    optional OsVersion os_version = 5;

    // Unique identifier for the mobile carrier if the device is connected to
    // the internet through a carrier (as opposed to through WiFi). To look up
    // carrier name from carrier ID, refer to:
    // https://storage.googleapis.com/adx-rtb-dictionaries/mobile-carriers.csv.
    optional int64 carrier_id = 6 [default = 0];

    // The width of the device screen in pixels.
    optional int32 screen_width = 7 [default = 0];

    // The height of the device screen in pixels.
    optional int32 screen_height = 8 [default = 0];

    // Used for high-density devices (for example, iOS retina displays). A
    // non-default value indicates that the nominal screen size (with pixels as
    // the unit) does not describe the actual number of pixels in the screen.
    // For example, nominal width and height may be 320x640 for a screen that
    // actually has 640x1280 pixels, in which case screen_width=320,
    // screen_height=640, and screen_pixel_ratio_millis=2000, since each axis
    // has twice as many pixels as its dimensions would indicate.
    optional int32 screen_pixel_ratio_millis = 9 [default = 0];
    enum ScreenOrientation {
      UNKNOWN_ORIENTATION = 0;
      PORTRAIT = 1;
      LANDSCAPE = 2;
    }

    // The screen orientation of the device when the ad request is sent.
    optional ScreenOrientation screen_orientation = 10 [default =
      UNKNOWN_ORIENTATION];

    // Hardware version of the device. For iPhone/iPad, this field contains
    // Apple's model identifier string (such as "iPhone12,1" and "iPad13,8") if
    // available.
    optional string hardware_version = 11;

    // "Limit Ad Tracking" is a commercially endorsed signal based on the
    // operating system or device settings, where `false` indicates that
    // tracking is unrestricted and `true` indicates that tracking must be
    // limited per commercial guidelines.
    //
    // This signal reflects user decisions on surfaces including iOS App
    // Tracking Transparency:
    // https://developer.apple.com/documentation/apptrackingtransparency
    // See also lmt and App Tracking Transparency guidance:
    // https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/community_extensions/skadnetwork.md#dnt-lmt-and-app-tracking-transparency-guidance
    // and Android advertising ID:
    // https://support.google.com/googleplay/android-developer/answer/6048248
    optional bool limit_ad_tracking = 12;

    // The possible app tracking authorization statuses that could be applicable
    // for bid requests from iOS devices. For more information about iOS's app
    // tracking authorization status, see:
    // https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus
    enum AuthorizationStatus {
      // User has not yet received a request to authorize access to app-related
      // data that can be used for tracking the user or the device.
      NOT_DETERMINED = 0;

      // Authorization to access app-related data that can be used for tracking
      // the user or the device is restricted.
      RESTRICTED = 1;

      // User denies authorization to access app-related data that can be used
      // for tracking the user or the device.
      DENIED = 2;

      // User authorizes access to app-related data that can be used for
      // tracking the user or the device.
      AUTHORIZED = 3;
    }

    // This field is only populated for iOS devices. Indicates the app tracking
    // authorization status. This value is retrieved from ATTrackingManager
    // and provided as is. For more information about iOS's app tracking
    // authorization status, see:
    // https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus
    optional AuthorizationStatus app_tracking_authorization_status = 13;

    // Possible types of the device's network connection.
    enum ConnectionType {
      CONNECTION_UNKNOWN = 0;

      // Ethernet; Wired Connection
      ETHERNET = 1;

      // WiFi
      WIFI = 2;

      // Mobile Network - Unknown Generation
      CELL_UNKNOWN = 3;

      // Mobile Network - 2G
      CELL_2G = 4;

      // Mobile Network - 3G
      CELL_3G = 5;

      // Mobile Network - 4G
      CELL_4G = 6;

      // Mobile Network - 5G
      CELL_5G = 7;
    }

    // The type of network to which the user's device is connected.
    //
    // For 5G connection type, we send CELL_4G instead of CELL_5G.
    optional ConnectionType connection_type = 15 [default = CONNECTION_UNKNOWN];
  }
  optional Device device = 54;

  // Additional key-value attributes. Currently unused.
  message KeyValue {
    optional string key = 1;
    optional string value = 2;
  }
  repeated KeyValue key_value = 38;

  // Information for ad queries coming from mobile devices. A mobile device is
  // either a mobile phone or a tablet. This is present for ad queries both from
  // mobile devices browsing the web and from mobile apps.
  message Mobile {
    // If true, then this request is from a mobile application. For branded
    // requests, app_id will also be filled in. If the request is from a mobile
    // web page contained inside an app, is_app will still be false, but app_id
    // could be filled in with the app identifier. For SDK-less requests (mostly
    // from connected TVs), this will be true if an app ID is provided directly
    // in the request.
    optional bool is_app = 7 [default = false];

    // The identifier of the mobile app when this ad query comes from a mobile
    // app, or from a mobile web page contained inside an app. If the app was
    // downloaded from the Apple iTunes app store, then this is the app-store
    // id, for example, 343200656. For Android devices, this is the fully
    // qualified package name, for example, com.rovio.angrybirds. For Windows
    // devices it's the App ID, for example,
    // f15abcde-f6gh-47i0-j3k8-37l93817mn3o. For SDK-less requests (mostly from
    // connected TVs), the app ID provided by the publisher directly in the
    // request.
    optional string app_id = 6;

    // If true, then this is a mobile full screen ad request.
    optional bool is_interstitial_request = 10 [default = false];

    // This field contains the IDs of categories to which the current mobile app
    // belongs. This field will be empty if is_app is false. The mapping between
    // mobile apps and categories is defined by the Google Play Store for
    // Android apps, or the Apple iTunes Store for iOS apps. To look up category
    // name from category ID, refer to
    // https://developers.google.com/google-ads/api/data/codes-formats#mobile_app_categories
    repeated int32 app_category_ids = 11;

    // For a mobile web request, this field indicates whether the page is
    // optimized for mobile browsers on high-end mobile phones.
    optional bool is_mobile_web_optimized = 17 [default = false];

    // Indicates whether a mobile app bid request is for an app open ad.
    // See App open ad guidance at
    // https://support.google.com/admob/answer/9341964 for more information.
    optional bool is_app_open_ad = 36 [default = false];

    // This field is used for advertising identifiers for
    // 1) iOS devices (This is called Identifier for Advertising, or IDFA, as
    // described at https://support.google.com/authorizedbuyers/answer/3221407),
    // 2) Android devices,
    // 3) Roku devices,
    // 4) Microsoft Xbox devices,
    // 5) Amazon devices (for example, Amazon Fire).
    //
    // When the encrypted_advertising_id is an IDFA, the plaintext after
    // decrypting the ciphertext is the IDFA (16 byte UUID) returned by iOS's
    // [ASIdentifierManager advertisingIdentifier]. For encrypted_hashed_idfa,
    // the plaintext is the 16 byte MD5 hash of the IDFA. Only one of the two
    // fields will be available, depending on the version of the SDK making the
    // request. Later SDKs provide unhashed values. They are not set if there is
    // one or more user_data_treatment value in the BidRequest.
    optional bytes encrypted_advertising_id = 20;

    // Unencrypted version of encrypted_advertising_id. This field is only set
    // when using an SSL connection. This field is a 16 byte UUID (binary form)
    // or a 32 byte alphanumeric id (such as Samsung ID).
    optional bytes advertising_id = 27;
    optional bytes encrypted_hashed_idfa = 21;

    // Unencrypted version of encrypted_hashed_idfa. This field is only set
    // when using an SSL connection. This field is a 16 byte MD5.
    optional bytes hashed_idfa = 28;

    // App names for Android apps are from the Google Play store.
    // App names for iOS apps are provided by App Annie
    // (https://www.appannie.com). App names for SDK-less requests (mostly from
    // connected TVs) are provided by the publisher directly in the request.
    optional string app_name = 24;

    // Average user rating for the app. The range of user rating is between 1.0
    // and 5.0. Currently only available for apps in Google Play store.
    optional float app_rating = 25;

    // Identification of and information about an SDK installed in the
    // publisher's app that the bidder has access to, often because it's the
    // bidder's SDK.
    message InstalledSdk {
      // Identifier for the installed SDK.
      optional string id = 1;

      // Semantic version of the installed SDK and the adapter that communicates
      // between the installed SDK and Google's SDK.
      message Version {
        optional int32 major = 1 [default = -1];
        optional int32 minor = 2 [default = -1];
        optional int32 micro = 3 [default = -1];
      }

      // The version of the installed SDK.
      optional Version sdk_version = 2;

      // The version of the adapter that communicates with the installed SDK.
      optional Version adapter_version = 3;
    }
    repeated InstalledSdk installed_sdk = 32;

    // Publisher's SKAdNetwork information to support app installation
    // attribution for iOS 14 and later. Apple's SKAdNetwork API helps
    // advertisers measure ad-driven app installation by sending a postback
    // to the ad network after a successful install. Publishers will need
    // to configure supported ad networks in their app's property list
    // (Info.plist) to allow an install to be attributed to the ad impression.
    // For more info visit:
    // https://developer.apple.com/documentation/storekit/skadnetwork
    message SKAdNetworkRequest {
      // List of all SKAdNetwork versions supported by the request, depending on
      // the OS version and the SDK version.
      repeated string versions = 4;

      // ID of publisher app in Apple's App Store.
      optional string sourceapp = 2;

      // SKAdNetworkIdentifier entries in the publisher app's Info.plist.
      repeated string skadnetids = 3;

      // List of fidelity types supported, depending on the SKAdNetwork API
      // version supported by the operating system and SDK as well as ad slot
      // properties.
      repeated SKAdNetworkFidelityType supported_fidelity_types = 5 [packed =
        true];

      // Indicates if this request supports SKOverlay for video ads.
      optional bool skoverlay = 6;
    }
    optional SKAdNetworkRequest skadn = 34;
  }
  optional Mobile mobile = 28;

  // Information about the video if this is an in-video ad request.
  message Video {
    // Describes where the video ad will play.
    enum Placement {
      UNKNOWN_PLACEMENT = 0;

      // Instream means the ad plays before, during, or after other video
      // content. This is similar to a traditional TV commercial. The video
      // content the user is watching does not play while the ad is playing.
      INSTREAM = 1;

      // Interstitial means the video ad plays in front of non-video content,
      // (for example, a news article or video game). The ad covers all or
      // nearly all of the space on the screen occupied by the content and the
      // user is not able to proceed to the content until the ad has finished or
      // been skipped.
      INTERSTITIAL = 2;

      // The in-feed video format is a video creative that shows within a feed
      // of content, typically a social app feed, a list of editorial content
      // items, etc, as the user is scrolling. It renders centered and not to
      // the side.
      IN_FEED = 3;

      // Audio is a request for an ad that is an audio stream. It is distinct
      // from INSTREAM above as that is exclusive to video requests.
      AUDIO = 4;

      // The in-article video format is a video creative that loads and plays
      // between paragraphs of editorial content as a standalone video player.
      IN_ARTICLE = 5;
    }

    // Deprecated. This will be removed in January 2025 per the IAB here:
    // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list--placement-subtypes---video-
    optional Placement placement = 16 [deprecated = true, default =
      UNKNOWN_PLACEMENT];

    // Possible video placement types. See:
    // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--plcmt-subtypes---video-
    enum Plcmt {
      PLCMT_UNKNOWN = 0;

      // Pre-roll, mid-roll, and post-roll ads that are played before, during or
      // after the streaming video content that the consumer has requested.
      // Instream video must be set to sound on by default at player start, or
      // have explicitly clear user intent to watch the video content. While
      // there may be other content surrounding the player, the video content
      // must be the focus of the users visit. It should remain the primary
      // content on the page and the only video player in-view capable of audio
      // when playing. If the player converts to floating/sticky, subsequent ad
      // calls should accurately convey the updated player size.
      PLCMT_INSTREAM = 1;

      // Pre-roll, mid-roll, and post-roll ads that are played before, during,
      // or after streaming video content. The video player loads and plays
      // before, between, or after paragraphs of text or graphical content, and
      // starts playing only when it enters the viewport. Accompanying content
      // should only start playback upon entering the viewport. It may convert
      // to a floating/sticky player as it scrolls off the page.
      PLCMT_ACCOMPANYING_CONTENT = 2;

      // Video ads that are played without video content. During playback, it
      // must be the primary focus of the page and take up the majority of the
      // viewport and cannot be scrolled out of view. This can be in placements
      // like in-app video or slideshows.
      PLCMT_INTERSTITIAL = 3;

      // Video ads that are played without streaming video content. This can be
      // in placements like slideshows, native feeds, in-content or
      // sticky/floating.
      PLCMT_NO_CONTENT_STANDALONE = 4;
    }

    // Video placement type declared by the publisher for this impression.
    // Equivalent to the Video.plcmt field introduced in OpenRTB 2.6 to reflect
    // updated industry definitions around different types of video ad
    // placements. This field supersedes the Video.placement field. May be unset
    // if the publisher did not declare a video placement type.
    optional Plcmt plcmt = 23 [default = PLCMT_UNKNOWN];

    // Video placement type inferred by Google for this impression. This field
    // is always filled and can be different from BidRequest.video.plcmt (the
    // publisher-declared placement type).
    optional Plcmt inferred_plcmt = 24 [default = PLCMT_UNKNOWN];

    // The URL of the page that the publisher gives Google to describe the video
    // content, with parameters removed.
    optional string description_url = 10;

    // If true, the video is embedded on a page outside the publisher's domain.
    // When this is set, description_url points to a description of the video
    // (as it always does), and the url field in BidRequest is the page in which
    // the video is embedded. For example, a request for an in-stream ad in a
    // Vimeo video shared on Facebook has is_embedded_offsite set. The url field
    // is for a Facebook page and the description_url points to the video on
    // Vimeo.
    optional bool is_embedded_offsite = 11 [default = false];

    // Describes how the video ad will be played. The playback method is
    // determined to be auto-play, click-to-play or mouse-over based on the best
    // measurement available. This includes things like how recently the user
    // interacted with a web page. For auto-play, ads can start playing with the
    // sound on or off. Some ads (for example, in-feed ads) are muted until the
    // user interacts with the ad. Alternatively, if an ad would normally play
    // with the sound on but the device is muted then the value will be set to
    // sound off. For devices where it is not possible to determine if the
    // device is muted (for example, desktop), we assume that sound is on.
    enum VideoPlaybackMethod {
      METHOD_UNKNOWN = 0;
      AUTO_PLAY_SOUND_ON = 1;
      AUTO_PLAY_SOUND_OFF = 2;
      CLICK_TO_PLAY = 3;
      MOUSE_OVER = 4;
      INITIATE_ON_ENTERING_VIEWPORT_SOUND_ON = 5;
      INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF = 6;
    }
    optional VideoPlaybackMethod playback_method = 14 [default =
      METHOD_UNKNOWN];

    // Whether the inventory allows clicking on the video ad to take the user to
    // an advertiser site. Some platforms, notably connected TVs, do not
    // support clicking on video ads, in which case this field is set to false.
    optional bool is_clickable = 15;

    // The time in milliseconds from the start of the video when the ad will be
    // displayed. 0 means pre-roll and -1 means post-roll. The value is valid
    // only if this param is set. When not set, the display position is unknown.
    optional int32 videoad_start_delay = 1;

    // The maximum duration in milliseconds of the ad that you should return.
    // If this is not set or has value <= 0, any duration is allowed.
    optional int32 max_ad_duration = 2;

    // The minimum duration in milliseconds of the ad that you should return.
    // If this is not set or has value <= 0, there is no minimum duration.
    optional int32 min_ad_duration = 8;

    // The maximum number of ads in an Adx video pod. A non-zero value indicates
    // that the current ad slot is a video pod that can show multiple video
    // ads. Actual number of video ads shown can be less than or equal to this
    // value but cannot exceed it.
    optional int32 max_ads_in_pod = 12;

    // The maximum duration of a pod in seconds.
    optional int32 max_pod_duration_seconds = 20;

    // Does the publisher allow/require/block skippable video ads?
    enum SkippableBidRequestType {
      ALLOW_SKIPPABLE = 0;
      REQUIRE_SKIPPABLE = 1;
      BLOCK_SKIPPABLE = 2;
    }
    optional SkippableBidRequestType video_ad_skippable = 4 [default =
      ALLOW_SKIPPABLE];

    // The maximum duration in milliseconds for the ad you should return, if
    // this ad is skippable (this generally differs from the maximum duration
    // allowed for non-skippable ads). If this is not set or has value <= 0, any
    // duration is allowed.
    optional int32 skippable_max_ad_duration = 5;

    // Supported video protocols.
    enum VideoProtocol {
      UNKNOWN_VIDEO_PROTOCOL = 0;
      VAST_1_0 = 1;
      VAST_2_0 = 2;
      VAST_3_0 = 3;
      VAST_1_0_WRAPPER = 4;
      VAST_2_0_WRAPPER = 5;
      VAST_3_0_WRAPPER = 6;
      VAST_4_0 = 7;
      VAST_4_0_WRAPPER = 8;
      DAAST_1_0 = 9;
      DAAST_1_0_WRAPPER = 10;
    }

    // Array of supported video bid response protocols.
    repeated VideoProtocol protocols = 17 [packed = true];

    // The video file formats that are allowed for this request. The response
    // should support at least one of them.
    enum VideoFormat {
      UNKNOWN_VIDEO_FORMAT = -1;

      // Flash video files are accepted (FLV).
      VIDEO_FLV = 0;
      VIDEO_MP4 = 1;

      // Valid VAST ads with at least one media file hosted on youtube.com.
      YT_HOSTED = 2;

      // Flash VPAID (SWF).
      VPAID_FLASH = 3;

      // JavaScript VPAID.
      VPAID_JS = 4;
      AUDIO_MP3 = 5;
      AUDIO_OGG = 6;

      // Requires both MP3 & OGG as Google does not know
      // which codecs are installed on the player.
      AUDIO_MP3_OGG = 7;
      VIDEO_WEBM = 8;
      VIDEO_MOV = 9;
      VIDEO_3GPP = 10;
      VIDEO_HLS = 11;
      VIDEO_DASH = 12;

      // Audio version of MP4.
      AUDIO_MP4A = 13;
    }
    repeated VideoFormat allowed_video_formats = 6;

    // Information about the companion ad slots that can be shown with the
    // video. While this is a repeated field there will only be one value in
    // most cases. If there are no companion ads available this field will not
    // be set.
    message CompanionSlot {
      // These fields represent the available heights and widths in this slot.
      // There will always be the same number heights and widths fields.
      repeated int32 height = 1 [packed = true];
      repeated int32 width = 2 [packed = true];

      // These are the formats of the creatives allowed in this companion ad
      // slot.
      enum CreativeFormat {
        UNKNOWN_CREATIVE_FORMAT = -1;
        IMAGE_CREATIVE = 0;
        FLASH_CREATIVE = 1;
        HTML_CREATIVE = 2;
      }
      repeated CreativeFormat creative_format = 3;
    }
    repeated CompanionSlot companion_slot = 7;

    // End cap support. When enabled, the companion ad can be picked to be
    // rendered as an end cap (info card) in the video slot after the video
    // ad finishes playing. If multiple companion ads are returned, IMA SDK
    // chooses one which best matches the device screen size. End cap is
    // supported only on mobile video interstitial inventory.
    enum EndCapSupport {
      // Companion ad won't be rendered as end cap.
      END_CAP_NOT_ENABLED = 0;

      // End cap will be rendered if response contains
      // eligible companion banner, but companion
      // banner is not required.
      END_CAP_OPTIONAL = 1;

      // Not used at this time.
      // Response with companion ad is filtered.
      END_CAP_FORBIDDEN = 2;

      // Not used at this time.
      // Response without companion ad is filtered.
      END_CAP_REQUIRED = 3;
    }
    optional EndCapSupport end_cap_support = 13 [default = END_CAP_NOT_ENABLED];

    // Attributes of the video that the user is viewing, not the video ad.
    // These fields are based on the availability of the video metadata from the
    // video publisher and may not always be populated.
    message ContentAttributes {
      // The duration of the video, in seconds.
      optional int32 duration_seconds = 2;
    }
    optional ContentAttributes content_attributes = 9;

    // Identify whether or not the ad request is being served from a live video
    // stream (0 = is not live, 1 = is live).
    optional bool is_livestream = 18 [default = false];

    // The event that causes playback to end. This will only be filled
    // for non-instream video formats.
    enum PlaybackCessationMode {
      PLAYBACK_CESSATION_MODE_UNKNOWN = 0;

      // On video completion or when terminated by user
      COMPLETION_OR_USER = 1;

      // On leaving viewport or when terminated by user
      LEAVING_OR_USER = 2;

      // On leaving viewport continues as a floating/slider unit until
      // video completion or when terminated by user
      LEAVING_CONTINUES_OR_USER = 3;
    }
    optional PlaybackCessationMode playback_cessation_mode = 19 [default =
      PLAYBACK_CESSATION_MODE_UNKNOWN];

    // Types of feed for audio content. See
    // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list--feed-types-
    // for details.
    enum FeedType {
      FEED_TYPE_UNKNOWN = 0;

      // Music streaming service.
      MUSIC_SERVICE = 1;

      // Live content broadcast over the air but also available through online
      // streaming.
      FM_AM_BROADCAST = 2;

      // Original, pre-recorded content distributed as episodes in a series.
      PODCAST = 3;
    }

    // Type of audio content feed where an audio ad can be played.
    optional FeedType feed_type = 21 [default = FEED_TYPE_UNKNOWN];

    // Options for delivery of audio or video content. See
    // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/AdCOM%20v1.0%20FINAL.md#list_deliverymethods
    // for details.
    enum ContentDeliveryMethod {
      CONTENT_DELIVERY_METHOD_UNKNOWN = 0;

      // Content is transferred continuously by the network; clients receive
      // real-time content for playback while connected. Example: broadcast TV.
      STREAMING = 1;

      // Content is transferred incrementally as client's playback requires.
      // Example: on-demand movies, podcasts, or music.
      PROGRESSIVE = 2;

      // Content should be transferred completely prior to use/playback.
      // Example: content downloaded to the user's device for offline
      // consumption.
      DOWNLOAD = 3;
    }

    // Supported delivery methods for the video or audio content where an ad can
    // be shown.
    repeated ContentDeliveryMethod delivery_method = 22 [packed = true];
  }
  optional Video video = 29;

  // The publisher settings list id that applies to this page.
  // See the RTB Publisher Settings guide at
  // https://developers.google.com/authorized-buyers/rtb/pub-settings-guide
  // for details.
  optional fixed64 publisher_settings_list_id = 42;

  // Publisher type of the inventory where the ad will be shown. For a given
  // request, publisher inventory can be either owned and operated (O&O),
  // represented by the publisher, or of unknown status.
  enum PublisherType {
    UNKNOWN_PUBLISHER_TYPE = 0;
    PUBLISHER_OWNED_AND_OPERATED = 1;
    PUBLISHER_REPRESENTED = 2;
  }
  optional PublisherType publisher_type = 51 [default = UNKNOWN_PUBLISHER_TYPE];
  enum VisibilityState {
    VISIBILITY_STATE_UNKNOWN = 0;

    // The page is at least partially visible. For example, in the foreground
    // tab of a non-minimized window.
    VISIBILITY_STATE_VISIBLE = 1;

    // The page is not visible to users. For example, when the page is in a
    // background browser tab, or in a minimized window.
    VISIBILITY_STATE_HIDDEN = 2;
  }

  // The visibility state of the web page containing the ad slots.
  // See https://www.w3.org/TR/page-visibility/.
  optional VisibilityState page_visibility = 66 [default =
    VISIBILITY_STATE_UNKNOWN];

  // Information about a browser window's user activation state. See
  // https://html.spec.whatwg.org/multipage/interaction.html#the-useractivation-interface
  message UserActivation {
    // Indicates whether a user has completed an interaction since page load.
    optional bool has_been_active = 1;

    // Indicates whether a user is currently interacting with the page.
    optional bool is_active = 2;
  }

  // User activation information from the browser for the current request, if
  // the request is for a web page.
  optional UserActivation user_activation = 76;

  // The set of possible web navigation types that predicate a page load. Each
  // of these types may have different performance characteristics. For example,
  // users going back and forth might experience a faster site than users
  // performing navigation for the first time or submitting forms. See
  // https://w3c.github.io/navigation-timing/#dom-performancenavigationtiming-type.
  enum NavigationType {
    NAVIGATION_TYPE_UNKNOWN = 0;

    // Navigation started by clicking a link, entering the URL in the browser's
    // address bar, form submission, or initializing through a script operation
    // other than reload and back_forward.
    NAVIGATION_TYPE_NAVIGATE = 1;

    // Navigation is through the browser's reload operation, location.reload(),
    // or a Refresh pragma directive like
    // <meta http-equiv="refresh" content="300">.
    NAVIGATION_TYPE_RELOAD = 2;

    // Navigation is through the browser's history traversal operation.
    NAVIGATION_TYPE_BACK_FORWARD = 3;

    // Navigation is initiated by a prerender hint (deprecated). See
    // https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/prerender.
    NAVIGATION_TYPE_PRERENDER = 4;
  }

  // The type of browser navigation that led to the current page. Unset for
  // non-web ad requests.
  optional NavigationType navigation_type = 77;

  // -----------------------------------------------------------
  // Information about the adslots on the page.
  message AdSlot {
    // An arbitrarily assigned slot id that is unique on a given page and
    // usually starts counting from 1. You use this to identify which slot to
    // bid on in the BidResponse.
    required int32 id = 1;

    // A stable identifier for the combination of publisher, ad slot, and page.
    optional uint64 ad_block_key = 14;

    // The width and height in pixels of the allowed ad sizes. Most requests
    // allow only a single size, but some allow more than one. Widths and
    // heights are at the same index. For example, if the width values are
    // [728, 300, 468] and the height values are [90, 250, 60], then the allowed
    // formats are 728x90, 300x250, and 468x60.
    //
    // For VAST video ad requests a single width/height pair specifies the
    // Google-detected video player size. If Google cannot detect the player
    // size the publisher-provided player size, if available, is used. For
    // VAST video ads, this size is informational; there is no restriction on
    // the size of the video ad that you can return.
    //
    // For mobile interstitial ads (including ones where video ads are eligible)
    // the first width height pair is the slot size (this is also the video
    // player size for VAST video ads). For many interstitials, this is the
    // screen size. Subsequent pairs are recommended interstitial ad sizes that
    // also meet the requirements for this interstitial.
    repeated int32 width = 2;
    repeated int32 height = 3;

    message FlexibleAdSlotSettings {
      optional int32 max_width = 1;
      optional int32 max_height = 2;
      optional int32 min_width = 3;
      optional int32 min_height = 4;
    }

    // If the adslot is flexible, this contains settings on how the slot
    // may be resized.
    optional FlexibleAdSlotSettings flexible_adslot_settings = 50;

    // The disallowed attribute ids for the ads that can show in this slot. See
    // the publisher-excludable-creative-attributes.txt file in the technical
    // documentation for a list of ids.
    repeated int32 excluded_attribute = 4 [packed = true];

    // The allowed vendor types. See the vendors.txt file in the technical
    // documentation for a list of ids. This field does not apply to deals with
    // block overrides (see
    // https://support.google.com/authorizedbuyers/answer/6114194).
    repeated int32 allowed_vendor_type = 6 [packed = true];

    message ConsentedProvidersSettings {
      // Set of IDs corresponding to ad tech providers (ATPs) for whom the
      // publisher has specified to Google that its EEA users have given legally
      // valid consent to: 1) the use of cookies or other local storage where
      // legally required; and 2) the collection, sharing, and use of personal
      // data for personalization of ads by an ATP in accordance with Google's
      // EU User Consent Policy.
      //
      // If a publisher is using the IAB Transparency and Consent Framework
      // (TCF) v2 to manage user consent, this is the set of ATPs consented
      // through the Additional Consent string (see
      // https://support.google.com/admanager/answer/9681920 for details about
      // Google's Additional Consent mode). ATPs consented through the TCF v2
      // consent string are represented in the
      // ConsentedProvidersSettings.tcf_consent_string field.
      //
      // A mapping of ATP ID to ATP name is posted at providers.csv.
      repeated int64 consented_providers = 2 [packed = true];

      // The web-safe base64-encoded IAB Transparency and Consent Framework
      // (TCF) v2 consent string fetched from the publisher's IAB Consent
      // Management Platform (CMP). The structure of the string is defined by
      // the IAB TCF v2. This field will be populated if the publisher has
      // integrated with a CMP for TCF v2 and that CMP indicates that GDPR
      // applies to this ad request and provides a valid consent string. See
      // https://support.google.com/authorizedbuyers/answer/9789378 for
      // additional information about the Google TCF v2 integration.
      //
      // See the IAB Global Vendor List at
      // https://vendor-list.consensu.org/v2/vendor-list.json for details about
      // the vendors listed in the consent string.
      optional string tcf_consent_string = 3;

      // The raw Additional Consent string, which contains a list of certain
      // Google Ad Tech Providers (ATPs). These ATPs are not registered with IAB
      // TCF v2, but publishers or their Consent Management Providers (CMPs)
      // have ensured that certain disclosures are given to, and consents are
      // obtained from, end users, as required by Google's EU User Consent
      // Policy. This field is only populated with the use of CMPs that are
      // integrated with IAB TCF v2. Such CMPs use the raw Additional Consent
      // string to indicate vendors that are not registered with IAB, and
      // communicate end users' CMP choices to those vendors. The
      // consented_providers field contains the set of vendors that mirrors the
      // one represented by the additional_consent_string field, which is in the
      // raw form. Vendors or any other third-party service providers must not
      // create AC strings themselves.
      //
      // See https://support.google.com/admanager/answer/9681920 for more
      // details about this field.
      optional string additional_consent_string = 4;
    }

    // Information about the ad tech providers for whom the publisher has
    // specified to Google that its EEA user has consented to the use of their
    // personal data for ads personalization in accordance with Google's EU User
    // Consent Policy. This field will only be populated when regs_gdpr is true.
    optional ConsentedProvidersSettings consented_providers_settings = 42;

    // This field will be set to true in either of the two following cases:
    //   1. Google receives a valid IAB Transparency and Consent Framework (TCF)
    //      v2 consent string and the Consent Management Platform indicates that
    //      GDPR applies to this ad request.
    //   2. Google does not receive an IAB TCF v2 consent string and, based on
    //      information available to Google, this impression will serve to an
    //      EEA user.
    // It does not constitute legal guidance on GDPR. This field is equivalent
    // to Regs.ext.gdpr in Google OpenRTB.
    optional bool regs_gdpr = 43;

    // This field will be set to true when, based on information available to
    // Google, this impression will serve to a user in Brazil. See
    // https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv
    // for the list of ad tech providers that are allowed to
    // serve on LGPD-enforced requests.
    //
    // See https://support.google.com/authorizedbuyers/answer/9928204 for more
    // information on LGPD.
    optional bool regs_lgpd = 54;

    // Contains the Global Privacy Platform's consent string. See the Global
    // Privacy Platform specification for more details:
    // https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform
    optional string gpp_consent_string = 81;

    // Array of the section(s) of the GPP string which should be applied for
    // this transaction. Generally will contain one and only one value, but
    // there are edge cases (e.g. a CMP cannot determine a single section ID)
    // where more than one may apply. GPP Section 3 (Header) and 4 (Signal
    // Integrity) do not need to be included. See IAB-GPP spec for details:
    // https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform/blob/main/Sections/Section%20Information.md#section-ids
    repeated int32 gpp_section_ids = 82 [packed = true];

    // The disallowed sensitive ad categories. See the
    // ad-sensitive-categories.txt file in the technical documentation for a
    // list of ids. You should enforce these exclusions if you have the ability
    // to classify ads into the listed categories. This field does not apply to
    // deals with block overrides (see
    // https://support.google.com/authorizedbuyers/answer/6114194).
    repeated int32 excluded_sensitive_category = 7 [packed = true];

    // The allowed restricted ad categories for private and open auctions. See
    // the ad-restricted-categories.txt file in the technical documentation for
    // a list of ids. These only apply for private and open auction bids. See
    // the allowed_restricted_category_for_deals field for preferred deals or
    // programmatic guarantees. If you bid with an ad in a restricted category,
    // you MUST ALWAYS declare the category in the bid response regardless of
    // the values in this field.
    repeated int32 allowed_restricted_category = 16 [packed = true];

    // The allowed restricted ad categories for preferred deals or programmatic
    // guarantees. See the ad-restricted-categories.txt file in the technical
    // documentation for a list of ids. These only apply for preferred deals or
    // programmatic guarantees. See the allowed_restricted_category field for
    // private and open auctions. In some cases, restricted categories are only
    // allowed on preferred deals or programmatic guarantees, so this field
    // lists all categories in allowed_restricted_category, and additionally,
    // restricted categories that are only allowed for preferred deals or
    // programmatic guarantees. If you bid with an ad in a restricted category,
    // you MUST ALWAYS declare the category in the bid response regardless of
    // the values in this field.
    repeated int32 allowed_restricted_category_for_deals = 22 [packed = true];

    // List of creative languages allowed by the publisher. The order is
    // arbitrary. The codes are 2 or 5 characters and are documented at
    // https://developers.google.com/google-ads/api/data/codes-formats#languages.
    // When not set, all languages are allowed.
    repeated string allowed_languages = 27;

    // The disallowed ad product categories. See the ad-product-categories.txt
    // file in the technical documentation for a list of ids. You should enforce
    // these exclusions if you have the ability to classify ads into the listed
    // categories. This field does not apply to deals with block overrides (see
    // https://support.google.com/authorizedbuyers/answer/6114194).
    repeated int32 excluded_product_category = 13 [packed = true];

    // Block list of applications by their platform-specific exchange
    // independent application identifiers. On Android, these should
    // be bundle or package names (for example, com.foo.mygame).
    // On iOS, these are numeric IDs.
    // Bids with ads that advertise any app from this list will be filtered
    // out before the auction.
    repeated string excluded_app_ids = 66;

    // A creative that is disallowed to bid on this impression due to Ad
    // Exchange policies or creative disapproval, excluded creative attributes,
    // excluded product or sensitive categories, allowed vendor types,
    // restricted categories or languages applicable to the bid request.
    message ExcludedCreative {
      // Buyer creative ID of the disallowed creative.
      optional string buyer_creative_id = 1;
    }

    // Creatives that are disallowed for the impression. Submitting a bid with
    // one of the creatives in this list will result in such bid being filtered
    // before the auction. Contact your account manager if you would like
    // to enable this feature.
    repeated ExcludedCreative excluded_creatives = 18;

    // Whether the adslot is only eligible for deals bids. Bids for the open
    // auction will be filtered when this field is set to true. Bidders can bid
    // on the open auction or deals when this field is set to false.
    optional bool only_deal_bids_accepted = 49;

    // Information about the pre-targeting configs that matched.
    message MatchingAdData {
      // The billing ids corresponding to the pretargeting configs that matched.
      repeated int64 billing_id = 2 [packed = false];

      // The minimum CPM value that you can bid to not be filtered before the
      // auction. This may be a global minimum, or it may be a minimum set by
      // the publisher. The value is in micros of the bidding currency.
      // The bidding currency is determined by:
      // 1. The bidder-level currency, if configured.
      // 2. Otherwise, the currency of the buyer accounts indicated by the
      // billing IDs in the billing_id field.
      optional int64 minimum_cpm_micros = 5;

      // Information about any deals that matched for this inventory.
      message DirectDeal {
        // An id identifying the deal.
        optional int64 direct_deal_id = 1;

        // For deal_type=PREFERRED_DEAL or deal_type=PROGRAMMATIC_GUARANTEED,
        // you must bid at least fixed_cpm_micros (in micros of the bidding
        // currency) in order to participate in the deal. If you win, you will
        // be charged fixed_cpm_micros. For deal_type=PRIVATE_AUCTION or
        // deal_type=AUCTION_PACKAGE or deal_type=MARKETPLACE_PACKAGE, you must
        // bid at least fixed_cpm_micros. Bidding higher CPM than
        // fixed_cpm_micros will increase your chance to win when
        // deal_type=PRIVATE_AUCTION or deal_type=AUCTION_PACKAGE or
        // deal_type=MARKETPLACE_PACKAGE, however it will not increase your
        // chance to win for other types of deals. The bidding currency is
        // determined by:
        // 1. The bidder-level currency, if configured.
        // 2. Otherwise, the currency of the buyer accounts indicated by the
        // billing IDs in the billing_id field.
        optional int64 fixed_cpm_micros = 2;

        // The type of the deal. Note that Authorized Buyers policy overrides
        // apply to all Programmatic Guaranteed and Preferred Deal bids, and do
        // not apply to bids for other deal types.
        enum DealType {
          UNKNOWN_DEAL_TYPE = 0;

          // Bids are fixed-price and evaluated before the Open Auction. Bidders
          // are not required to bid with Preferred Deals when they are present
          // on the bid request. See
          // https://support.google.com/authorizedbuyers/answer/2604595 for more
          // information.
          PREFERRED_DEAL = 1;

          // Bids participate in a Private Auction against a select list of
          // buyers with specific floors. See
          // https://support.google.com/authorizedbuyers/answer/2839853 for more
          // information.
          PRIVATE_AUCTION = 2;

          // Bids are fixed-price and evaluated before the Open Auction. Bidders
          // are expected to bid with Programmatic Guaranteed deals whenever
          // they are present on a bid request in order to ensure that the
          // number of impressions agreed upon for a given deal are served. See
          // https://support.google.com/authorizedbuyers/answer/7174589 for more
          // information.
          PROGRAMMATIC_GUARANTEED = 3;

          // The deal ID is an identifier for a collection of Open Auction
          // inventory matching a given set of targeting criteria. See
          // https://support.google.com/authorizedbuyers/answer/7516884 for more
          // information.
          AUCTION_PACKAGE = 4;

          // Package of inventory that a publisher makes available to either all
          // buyers or selected bidders. Bids participate in auction in the same
          // way as private auction candidates. See
          // https://support.google.com/authorizedbuyers/answer/12817370 for
          // more information.
          MARKETPLACE_PACKAGE = 5;
        }
        optional DealType deal_type = 3 [default = UNKNOWN_DEAL_TYPE];

        // Whether the publisher has exempted this deal from configured blocks.
        // This setting does not override AdX policies or Ad Review Center
        // decisions.
        optional bool publisher_blocks_overridden = 4 [default = false];

        // Experimental field; subject to change.
        // An enum declaring the host of the creative, which will only be
        // populated for Programmatic Guaranteed deals.
        // Currently, this field should only ever be set to
        // CREATIVE_SOURCE_ADVERTISER.
        enum CreativeSourceType {
          CREATIVE_SOURCE_UNKNOWN = 0;

          // The creative is hosted by the advertiser, which means the bidder
          // is required to provide a creative in the bid response.
          CREATIVE_SOURCE_ADVERTISER = 1;

          // The creative is hosted by the publisher, which means the bidder
          // does not need to include a creative in the bid response.
          // For more information on publisher-hosted creatives, see
          // https://support.google.com/admanager/answer/9243220.
          // This feature isn't currently supported for RTB bidders.
          CREATIVE_SOURCE_PUBLISHER = 2;
        }
        optional CreativeSourceType creative_source = 16 [default =
          CREATIVE_SOURCE_ADVERTISER];

        // This field is only applicable to Programmatic Guaranteed deals. The
        // buyer is allowed to skip bidding on the impression if this field is
        // false. When it is true, the buyer is required to bid on this deal for
        // this impression opportunity.
        optional bool must_bid = 9 [default = true];

        // Constraints for creatives that can apply when bidding on a deal.
        message CreativeConstraints {
          // The allowed ad types of the deal. If empty, there are no
          // deal-specific allowed ad type restrictions for the deal. In that
          // case, bidders should refer to the BidRequest-level creative types
          // in adslot.allowed_ad_types.
          repeated AllowedAdType allowed_ad_types = 1 [packed = true];

          // Whether skippable creatives are allowed. For
          // PROGRAMMATIC_GUARANTEED or PREFERRED_DEAL deals that specifically
          // allow video or audio ad types, it is always set. For the
          // skippability setting of other deal types or open auction bidding,
          // refer to the corresponding BidRequest-level field
          // video.video_ad_skippable.
          optional Video.SkippableBidRequestType video_ad_skippable = 2 [default
            = ALLOW_SKIPPABLE];

          // The maximum allowed duration in milliseconds for the ad. For
          // PROGRAMMATIC_GUARANTEED or PREFERRED_DEAL deals that specifically
          // allow video or audio ad types, it is always set. For the allowed
          // max duration of other deal types or open auction bidding, refer to
          // the corresponding BidRequest-level field video.max_ad_duration.
          optional int32 max_ad_duration_ms = 3;
        }

        // Creative constraints for this deal. If this is not set, bidders
        // should refer to the BidRequest-level setting of each field.
        optional CreativeConstraints creative_constraints = 17;

        // If non-empty, this field contains a list of seat IDs in the bidder's
        // namespace set by media planners that are allowed by the publisher to
        // bid on this deal. All seat IDs not included in this list are blocked
        // from bidding on this deal. Bids on this deal on behalf of other
        // seats, as indicated by the BidResponse.ad.adslot.seat_id field, and
        // bids with no seat ID will be filtered before the auction. If this
        // field is empty, there are no restrictions on the seat IDs that can
        // bid on this deal.
        repeated string allowed_seat_ids = 18;
      }
      repeated DirectDeal direct_deal = 6;
    }
    repeated MatchingAdData matching_ad_data = 9;

    // If non-empty, this field contains a list of seat IDs in the bidder's
    // namespace set by media planners that are blocked by the publisher. Any
    // bids on behalf of a blocked seat, as indicated by the
    // BidResponse.ad.adslot.seat_id field, will be filtered before the auction.
    // If this field is non-empty, allowed_seat_ids will be empty. If this field
    // and allowed_seat_ids are both empty, there are no seat ID restrictions
    // for this request.
    repeated string blocked_seat_ids = 67;

    // If non-empty, this field contains a list of seat IDs in the bidder's
    // namespace set by media planners that are allowed by the publisher. All
    // seat IDs not included in this list are blocked. Bids on behalf of other
    // seats, as indicated by the BidResponse.ad.adslot.seat_id field, and bids
    // with no seat ID will be filtered before the auction. If this field is
    // non-empty, blocked_seat_ids will be empty. If this field and
    // blocked_seat_ids are both empty, there are no seat ID restrictions for
    // this request.
    repeated string allowed_seat_ids = 68;

    // The publisher settings list ids that apply to this slot. See the RTB
    // Publisher Settings guide at
    // https://developers.google.com/authorized-buyers/rtb/pub-settings-guide
    // for details.
    repeated fixed64 publisher_settings_list_id = 15;

    // Parameters related to exchange bidding (third party exchanges doing
    // real-time bidding on DFP). This is never populated in calls to AdX
    // real-time bidders.
    message ExchangeBidding {
      // Repeated KeyValue pairs to be sent from the publisher to the
      // exchange bidder.
      repeated KeyValue key_value = 3;
    }
    optional ExchangeBidding exchange_bidding = 28;

    // Parameters related to Open Bidding.
    message OpenBidding {
      // This field is set to true if the publisher set up a yield group or a
      // mediation group that targets this adslot and this bidder. See
      // https://support.google.com/admanager/answer/7128453 for information on
      // Open Bidding and its effects on the bidding process.
      optional bool is_open_bidding = 2;
    }
    optional OpenBidding open_bidding = 53;

    // AdUnitMapping is used to identify publisher inventory units in the
    // bidder's namespace. The mappings are only populated when
    // the bidder works directly with a publisher, and provides the mapping
    // from Google's ad unit namespace to the bidder's inventory namespace.
    // The ad unit mapping is only applicable for requests that use a custom
    // SDK. https://support.google.com/admanager/answer/9601810.
    message AdUnitMapping {
      // Key-value pair used to specify the inventory unit in the bidder's
      // namespace.
      message Keyval {
        // The key is the name of the bidder's inventory unit identifier for the
        // SDK.
        optional string key = 1;

        // The value of the bidder's inventory unit identifier for the given
        // format.
        optional string value = 2;
      }

      // Multiple key-value pairs can be specified in order to support
      // bidders whose inventory unit space is hierarchical and has multiple
      // identifiers. The key-value pairs for the chosen AdUnitMapping should be
      // sent back in the bid response as
      // BidResponse.ad.sdk_rendered_ad.sdk_params. This is passed to the
      // bidder's SDK.
      repeated Keyval keyvals = 1;

      // Possible ad unit formats that can be used for the mapping. Corresponds
      // to the adapter that will be used on the SDK.
      enum FormatType {
        FORMAT_UNKNOWN = 0;

        // Display banner ads for web or mobile apps. For example, a 320x50
        // leaderboard slot. This includes out-stream video.
        FORMAT_BANNER = 1;

        // A full-screen ad to be displayed inside a mobile app.
        FORMAT_INTERSTITIAL = 2;

        // Custom display or video ads for web or mobile apps that match the
        // user experience of the site or app in which theyre placed.
        FORMAT_NATIVE = 3;

        // Video ads that appear before, during, or after video content
        // streams.
        FORMAT_VIDEO_VAST = 4;

        // Video ads for mobile apps that allow users to voluntarily watch an
        // ad in exchange for an in-app reward.
        FORMAT_REWARDED = 5;

        // Interstitial ads that allow users to watch an ad in exchange for
        // an in-app reward. Does not require opt-in.
        // https://support.google.com/admanager/answer/7386053
        FORMAT_REWARDED_INTERSTITIAL = 6;

        // App open ads shows at app load screens. App open ads can be closed
        // at any time, and are designed to be shown when the users bring the
        // app to the foreground.
        FORMAT_APP_OPEN = 7;
      }

      // The mappings are targeted through a format, which is expressed in the
      // Google-defined taxonomy. Format is populated in the bid request since
      // Google supports targeting multiple formats with a single ad
      // unit, and Google's definition of the format may not match the bidder's
      // definition. In order for the bidder to differentiate which format
      // matched, it is sent in the bid request.
      optional FormatType format = 2;
    }

    // Ad unit mappings that match the given adslot.
    repeated AdUnitMapping ad_unit_mapping = 64;

    // Indicates the creative policy and publisher blocks that applies to this
    // request.
    message CreativeEnforcementSettings {
      // Creative policy enforcement level that applies to this request.
      // Creatives that don't adhere to the specified policy will be filtered
      // before the auction. The status of the creatives with their respective
      // policies can be retrieved through Creative API.
      // https://developers.google.com/authorized-buyers/apis/guides/rtb-api/creatives
      // Bids on deals may override the policy enforcement applicable to the
      // request.
      enum PolicyEnforcement {
        POLICY_ENFORCEMENT_UNKNOWN = 0;

        // Baseline policy for all ads serving through any of Google's ads
        // platform products. Learn more at:
        // https://support.google.com/platformspolicy/answer/3013851.
        POLICY_ENFORCEMENT_PLATFORM_POLICY = 1;

        // Policy for ads serving through Google's ad network. This includes the
        // baseline policy for all ads serving through any of Google's ads
        // platform products. Learn more at:
        // https://support.google.com/authorizedbuyers/answer/1325008.
        POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY = 2;
      }
      optional PolicyEnforcement policy_enforcement = 1;

      // Creative publisher blocks enforcement level that applies to this
      // request. Publisher blocks allow publishers to control which creatives
      // can be shown on their properties.
      // Deals may also override publisher blocks. Refer to adslot.
      // matching_ad_data.direct_deal.publisher_blocks_overridden field.
      enum PublisherBlocksEnforcement {
        PUBLISHER_BLOCKS_ENFORCEMENT_UNKNOWN = 0;

        // The publisher's blocking controls are enforced on creatives
        // submitted. Publisher blocks enforcement settings are provided in the
        // following fields:
        // - publisher_settings_list_id
        // - excluded_sensitive_category
        // - allowed_restricted_category
        // - excluded_product_category
        // - allowed_vendor_type
        // - excluded_attribute
        PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES = 1;

        // The publisher's blocking controls are not enforced on creatives
        // submitted.
        PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN = 2;
      }
      optional PublisherBlocksEnforcement publisher_blocks_enforcement = 3;
    }
    optional CreativeEnforcementSettings creative_enforcement_settings = 58;

    // The ad unit code (https://support.google.com/admanager/topic/4426071)
    // This is currently only set for exchange bidding requests.
    optional string dfp_ad_unit_code = 33;

    // Visibility information for the slot.
    enum SlotVisibility {
      NO_DETECTION = 0;
      ABOVE_THE_FOLD = 1;
      BELOW_THE_FOLD = 2;
    }
    optional SlotVisibility slot_visibility = 12 [default = NO_DETECTION];

    // Viewability percentage for the ad slot. This is an estimate of the
    // likelihood that this slot will be viewable by the end user based on
    // historical and environment data. It is expressed as a percentage in the
    // range of [0, 100]. The default value -1 indicates that viewability could
    // not be estimated.
    optional int32 viewability = 21 [default = -1];

    // Historical click-through rate for ads served in the ad slot. This is
    // expressed as a fraction in the range [0.0, 1.0]. The default value of
    // -1.0 indicates that historical click-through rate data is not available.
    // This figure does not include data aggregated from Google Ads. The
    // click-through rate can vary for a given ad slot throughout the day.
    optional float click_through_rate = 25 [default = -1];

    // Historical completion rate for video ads served in the ad slot. This is
    // expressed as a fraction in the range [0.0, 1.0]. The default value of
    // -1.0 indicates that historical completion rate data is not available.
    // This field is only applicable to video inventory, and does not include
    // data aggregated from Google Ads.
    optional float video_completion_rate = 30 [default = -1];

    // iFraming state of the ad slot on the webpage where it is present.
    enum IFramingState {
      UNKNOWN_IFRAME_STATE = 0;
      NO_IFRAME = 1;
      SAME_DOMAIN_IFRAME = 2;
      CROSS_DOMAIN_IFRAME = 3;
    }
    optional IFramingState iframing_state = 19 [default = UNKNOWN_IFRAME_STATE];

    // iFrame depth of the ad slot on the webpage where it is present.
    // Currently only set for video ad requests.
    enum IFramingDepth {
      UNKNOWN_IFRAME_DEPTH = 0;
      NOT_IN_IFRAME = 1;
      ONE_IFRAME = 2;
      MULTIPLE_IFRAME = 3;
    }
    optional IFramingDepth iframing_depth = 20 [default = UNKNOWN_IFRAME_DEPTH];

    // A native ad consists of pieces that are rendered by the publisher. A
    // publisher may support multiple distinct native ad templates. If the
    // request also allows banners or videos, you can respond with other types
    // of ads by setting html_snippet or video_url instead. If only native
    // templates exist, you must set the native_ad field in any response you
    // send.
    message NativeAdTemplate {
      // 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 fields 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;

      // 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 = 0;
        HEADLINE = 1;
        BODY = 2;
        CALL_TO_ACTION = 4;
        ADVERTISER = 8;
        IMAGE = 16;
        LOGO = 32;
        APP_ICON = 64;
        STAR_RATING = 128;
        PRICE = 256;
        DEPRECATED_STORE = 512;
        VIDEO = 1024;
      }
    }
    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, or another
      // placement type.
      PLACEMENT_OUTSIDE = 3;

      // Recommendation widget, most commonly presented below the article
      // content.
      PLACEMENT_RECOMMENDATION = 4;
    }
    optional NativePlacementType native_placement_type = 45 [default =
      PLACEMENT_UNKNOWN];

    // Whether the ad request has been determined to come directly from the
    // publisher.
    enum MediationStatus {
      UNKNOWN = 0;
      DIRECT_REQUEST = 1;
    }
    optional MediationStatus mediation_status = 52 [default = UNKNOWN];

    // Auto refresh settings.
    message AutoRefresh {

      message AutoRefreshSettings {
        enum AutoRefreshType {
          UNKNOWN_AUTO_REFRESH_TYPE = 0;

          // Refresh triggered by user-initiated action such
          // as scrolling.
          USER_ACTION = 1;

          // Event-driven content change. For example, ads refresh
          // when the football game score changes on the page.
          EVENT = 2;

          // Time-based refresh. Ads refresh on a predefined time
          // interval even without user activity.
          TIME = 3;
        }

        // The type of the declared auto refresh.
        optional AutoRefreshType refresh_type = 1 [default =
          UNKNOWN_AUTO_REFRESH_TYPE];

        // The minimum refresh interval. This applies to all refresh types.
        optional int32 min_refresh_interval_seconds = 2;
      }

      // The auto-refresh settings that the publisher has on this
      // inventory. This is repeated because publishers may
      // do multiple types of auto refresh on one piece of inventory.
      repeated AutoRefreshSettings refresh_settings = 1;

      // The number of times this ad slot had been refreshed since last page
      // load.
      optional int32 refresh_count = 2 [default = 0];
    }
    optional AutoRefresh auto_refresh = 23;

    // Stickiness settings declared by the publisher.
    message StickySettings {
      // Specifies the allowable sticky settings values.
      enum Stickiness {
        UNKNOWN_STICKINESS = 0;
        IS_STICKY = 1;
      }

      // Whether the ad slot is a sidebar that sticks on screen when user
      // scrolls.
      optional Stickiness vertical_stickiness = 1 [default =
        UNKNOWN_STICKINESS];

      // Whether the ad slot is a horizontal slot that sticks on the top of the
      // screen when user scrolls.
      optional Stickiness top_horizontal_stickiness = 2 [default =
        UNKNOWN_STICKINESS];

      // Whether the ad slot is a horizontal slot that sticks on the bottom of
      // the screen when user scrolls.
      optional Stickiness bottom_horizontal_stickiness = 3 [default =
        UNKNOWN_STICKINESS];
    }
    optional StickySettings sticky_settings = 31;

    // Sources for non-browser inventory.
    enum NonBrowserSource {
      UNDECLARED_SOURCE = 0;
      DESKTOP_APP = 1;
    }

    // Publisher declaration stating that this ad slot may serve on
    // non-browser inventory, like desktop apps.
    optional NonBrowserSource non_browser_slot_source = 34 [default =
      UNDECLARED_SOURCE];

    // Defines who controls the environment that made the ad request and will
    // render the ad. On platforms where code written by Google will handle
    // the ad this field is set to GOOGLE. When this field is PUBLISHER the
    // publisher has placed their own code on the device to handle playback of
    // the ad. There is no technical difference in how these request are
    // handled. You may use this field to differentiate between different
    // environments for non-technical reasons. This field is only set for
    // requests that allow VAST video ads.
    enum Renderer {
      UNKNOWN_RENDERER = 0;
      GOOGLE = 1;
      PUBLISHER = 2;
    }
    optional Renderer renderer = 26 [default = UNKNOWN_RENDERER];

    // Whether this request is for an Accelerated Mobile Page (AMP). AMP HTML
    // pages load faster, by restricting parts of HTML, CSS and Javascript. For
    // more information on how AMP ads render, refer to the AMP ads README:
    // https://github.com/ampproject/amphtml/blob/master/ads/README.md
    enum AmpAdRequestType {
      // AMP status unknown. Request may or may not be from an AMP page.
      UNKNOWN_AMP = 0;

      // Not an AMP page. Could be regular HTML, VAST video, or other context.
      NON_AMP_PAGE = 1;

      // Late-loading request from an AMP HTML page. Ad will render with a
      // slight delay so it will not negatively impact page render performance.
      AMP_PAGE_LATE_REQUEST = 2;
    }
    optional AmpAdRequestType amp_ad_request_type = 29 [default = NON_AMP_PAGE];

    // Whether this is an AMP page or not.
    enum AmpPage {
      // AMP page status unknown.
      UNKNOWN_AMP_PAGE = 0;

      // This is not an AMP page.
      DIALECT_HTML = 1;

      // This is an Amp page.
      DIALECT_HTML_AMP = 2;
    }
    optional AmpPage is_amp_page = 38;

    // Possible requirement types for AMP ads.
    enum AmpAdRequirementType {
      // AMP ad requirements unknown.
      UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0;

      // AMP ads are not allowed.
      AMP_AD_NOT_ALLOWED = 1;

      // Either AMP ads or non-AMP ads are allowed;
      // AMP ads are not early rendered.
      AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 2;

      // Either AMP ads or non-AMP ads are allowed;
      // AMP ads are early rendered.
      AMP_AD_ALLOWED_AND_EARLY_RENDERED = 3;

      // AMP ads are required.
      // Ads that are non-AMP may be rejected by the publisher.
      AMP_AD_REQUIRED = 4;
    }
    optional AmpAdRequirementType amp_ad_requirement_type = 39;

    // Whether the user receives a reward for viewing the ad. For video ads,
    // typical implementations allow users to read an additional news article
    // for free, receive an extra life in a game, or get a sponsored ad-free
    // music session. The reward is typically distributed after the video ad is
    // completed.
    optional bool is_rewarded = 32 [default = false];

    // Possible ad types that are allowed in the bid response. allowed_ad_types
    // always contains one or more values. Interstitial slots may also support
    // banner ads. An ad slot with ALLOWED_AD_TYPE_NATIVE may or may not support
    // native video, regardless of whether ALLOWED_AD_TYPE_VIDEO is set.
    // Likewise, an ad slot without ALLOWED_AD_TYPE_NATIVE does not support
    // native video, regardless of whether ALLOWED_AD_TYPE_VIDEO is set.
    enum AllowedAdType {
      UNKNOWN_ALLOWED_AD_TYPE = -1;
      ALLOWED_AD_TYPE_BANNER = 0;
      ALLOWED_AD_TYPE_NATIVE = 1;
      ALLOWED_AD_TYPE_VIDEO = 2;
      ALLOWED_AD_TYPE_AUDIO = 3;
    }
    repeated AllowedAdType allowed_ad_types = 36 [packed = true];

    // Total number of impressions served to this user (within this specific
    // site or app) in this browsing session, plus 1. A session ends after 30
    // minutes inactivity. The default value of -1 indicates that the session
    // depth cannot be estimated.
    optional int32 session_depth = 40 [default = -1];

    // Secure signals passed by the publisher.
    message SecureSignal {
      // The source (provider) of the signal. Identifier for the library or SDK
      // that generated this data.
      optional string source = 4;

      // The secure signal.
      optional string data = 2;
    }
    repeated SecureSignal secure_signals = 41;

    // Possible ad rendering API frameworks that can be supported.
    // If an API is not explicitly listed, it is assumed not to be supported.
    enum APIFramework {
      UNKNOWN_FRAMEWORK = 0;

      // Mobile Rich Media Ad Interface Definitions Version 1.0. See
      // https://www.iab.com/guidelines/mraid/.
      MRAID_1 = 3;

      // Mobile Rich Media Ad Interface Definitions Version 2.0. See
      // https://www.iab.com/guidelines/mraid/.
      MRAID_2 = 5;

      // Mobile Rich Media Ad Interface Definitions Version 3.0. See
      // https://www.iab.com/guidelines/mraid/.
      MRAID_3 = 6;

      // Open Measurement Interface Definition Version 1.0. See
      // https://iabtechlab.com/standards/open-measurement-sdk/.
      OMID_1 = 7;
    }

    // List of supported API frameworks for this impression.
    repeated APIFramework api = 46 [packed = true];

    // Deprecated. This will be removed in Q1 2024. This field has been
    // deprecated in favor of the repeated field
    // `billable_event_rate_bid_adjustment` below.
    // For ads rendered using a custom SDK only: multiplier applied to bid in
    // the auction. The adjustment reflects the likelihood that your bid would
    // generate a billable event (meaning the ad renders successfully) if
    // it won the auction, relative to the probability that other bids generate
    // a billable event if they won the auction. This adjustment can be larger
    // or smaller than 1. This affects the final ranking in the auction only; in
    // particular, this multiplier does not affect the payment.
    optional double billable_event_rate_adjustment = 59 [deprecated = true,
      default = 1];

    // The billable event rate bid adjustment of an ad and the dependent
    // features of the ad the adjustment applies to, such as the format or the
    // SDK used to render the ad. Each feature combination may have a unique
    // adjustment, each adjustment therefore specifies which SDK or creative
    // format it applies to.
    message BillableEventRateBidAdjustment {
      // A multiplier to your bid to adjust for the likelihood that your bid
      // would result in a billable event (namely, the ad renders successfully)
      // if it won the auction, relative to the average probability that bids
      // from other buyers would result in a billable event if they won the
      // auction. This adjustment can be larger or smaller than 1. This affects
      // the final ranking in the auction only; in particular, this multiplier
      // does not affect the payment or whether the bid clears any floor price.
      optional float bid_adjustment = 1 [default = 1];

      // The types of creative the bid adjustments can apply to.
      enum CreativeType {
        CREATIVE_TYPE_UNKNOWN = 0;

        // Banner ads
        HTML_SNIPPET = 1;

        // VAST video or audio ads
        VIDEO_VAST = 2;

        // Native ads
        NATIVE = 3;

        // SDK rendered ad
        SDK_RENDERED = 4;
      }

      // The type of ads to which the above bid adjustment applies to. Each type
      // corresponds to different ways of how the ad's creative is specified, as
      // described in
      // https://developers.google.com/authorized-buyers/rtb/response-guide#specify-creative.
      // If the ad is SDK-rendered, this will be set to SDK_RENDERED regardless
      // of the actual creative type.
      optional CreativeType creative_type = 2 [default = CREATIVE_TYPE_UNKNOWN];

      // The SDK used to render the ad with. The SDK ID will match the one sent
      // in BidRequest.mobile.installed_sdk.id. This field is not set for Google
      // SDK.
      optional Mobile.InstalledSdk sdk = 3;
    }

    // A list of billable event rate bid adjustments applicable to the request
    // and the ad features associated to the adjustment. Bid adjustments are
    // listed here only if they are not equal to 1.0, which is equivalent to
    // having no adjustment. This field replaces the deprecated field
    // billable_event_rate_adjustment.
    repeated BillableEventRateBidAdjustment billable_event_rate_bid_adjustment =
      65;

    // Identifier of the OM SDK integration. For more info, see the OpenRTB
    // Advisory for Open Measurement SDK:
    // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/OpenRTB%20support%20for%20OMSDK.md#openrtb-and-adcom.
    optional string omidpn = 56;

    // Version of the OM SDK integration. For more info, see the OpenRTB
    // Advisory for Open Measurement SDK:
    // https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/master/OpenRTB%20support%20for%20OMSDK.md#openrtb-and-adcom.
    optional string omidpv = 57;

    // Describes the environment where the ad auction is run.
    enum AuctionEnvironment {
      // The auction determining the winning ad is held server-side.
      SERVER_SIDE_AUCTION = 0;

      // The contextual auction that determines a winning contextual bid is held
      // server-side, and bidding functions are run on the device to determine
      // interest group bids. Both the winning contextual bid and interest
      // group bids are entered into a final auction held on the device to
      // select the winning ad. For more information regarding the Protected
      // Audience API, see:
      // https://github.com/WICG/turtledove and
      // https://github.com/WICG/turtledove/blob/main/FLEDGE.md
      ON_DEVICE_INTEREST_GROUP_AUCTION = 1;
    }

    // Specifies where the ad auction runs.
    // Deprecated. This will be removed in November, 2023. Use
    // supported_auction_environment instead.
    optional AuctionEnvironment auction_environment = 61 [deprecated = true,
      default = SERVER_SIDE_AUCTION];

    // The supported auction environment for this impression. For inventory
    // which does not support interest group bidding, this will always be set to
    // SERVER_SIDE_AUCTION. For inventory which does support interest group
    // bidding, this will be set to ON_DEVICE_INTEREST_GROUP_AUCTION. Note that
    // this only indicates that the interest group auction is supported, not
    // that it is guaranteed to execute. If no buyer chooses to participate in
    // the interest group auction, then the interest group auction will be
    // skipped and the winner of the contextual auction, if any, will be
    // served instead.
    optional AuctionEnvironment supported_auction_environment = 69 [default =
      SERVER_SIDE_AUCTION];

    // The expected time period when an impression can occur in seconds
    // following a winning bid. The impression may be billable only if it serves
    // within this time. To learn more about impression expiration, see the
    // following guide:
    // https://developers.google.com/authorized-buyers/rtb/billing-event-guide
    optional int32 impression_expiration_seconds = 63;

    // The name of the rendering environment, such as a mobile ads or video
    // SDK, or a publisher ad tag type. This field describes a Google SDK while
    // the installed_sdk field describes third party SDKs.
    optional string display_manager = 71;

    // Version of the rendering environment specified by the display_manager
    // field. This field describes a Google SDK while the installed_sdk field
    // describes third party SDKs.
    optional string display_manager_version = 72;
  }
  repeated AdSlot adslot = 14;

  // Feedback on bids submitted in previous responses. This is only set if
  // real-time feedback is enabled for your bidder. Contact your account
  // manager if you want to enable real-time feedback.
  message BidResponseFeedback {
    // The unique id from BidRequest.id
    optional bytes request_id = 1;

    // The index of the BidResponse_Ad if there was more than one. The index
    // starts at zero for the first creative.
    optional int32 creative_index = 2;

    // The status code for the ad. See creative-status-codes.txt in the
    // technical documentation for a list of ids.
    optional int32 creative_status_code = 3;

    // If the bid won the auction, this is the price paid in your account
    // currency. If the bid participated in the auction but was out-bid, this
    // is the CPM that should have been exceeded in order to win. This is not
    // set if the bid was filtered prior to the auction, if the publisher or
    // winning bidder has opted out of price feedback or if your account has
    // opted out of sharing winning prices with other bidders. For first-price
    // auctions, minimum_bid_to_win is populated instead of this field.
    optional int64 cpm_micros = 4;

    // The minimum bid value necessary to have won the auction, in micros of
    // your account currency. If your bid won the auction, this is the second
    // highest bid that was not filtered (including the floor price). If your
    // bid did not win the auction, this is the winning candidate's bid. This
    // field will only be populated if your bid participated in a first-price
    // auction, and will not be populated if your bid was filtered prior to the
    // auction.
    optional int64 minimum_bid_to_win = 7;

    // The minimum bid value necessary to have won the server-side component of
    // the overall auction given that there was also an interest group bidding
    // component to the overall auction which ran using the Protected Audience
    // API. The value is expressed in CPM micros of the buyer account currency.
    // The minimum bid to win for the overall auction, including bids from the
    // server-side and the on-device interest group components, is populated in
    // the minimum_bid_to_win field of the same BidResponseFeedback object.
    optional int64 server_side_component_minimum_bid_to_win = 16;

    // Billable event rate multiplier that was applied to this bid during
    // ranking. The adjustment reflects the likelihood that your bid would
    // generate a billable event (namely, the ad renders successfully) if it won
    // the auction, relative to the probability that other bids generate a
    // billable event if they won the auction. This adjustment can be larger or
    // smaller than 1. This affects the final ranking in the auction only; in
    // particular, this multiplier does not affect the payment or whether the
    // bid clears any floor price.
    optional float billable_event_rate_bid_adjustment = 15 [default = 1];

    // When a publisher uses an RTB auction and waterfall-based SDK mediation on
    // the same query, the winner of the real-time auction must also compete in
    // a mediation waterfall (which is ordered by price) to win the impression.
    // If the bid participated in the auction and there was no waterfall, the
    // value of this field is 0. If the bid participated in the auction and
    // there was a waterfall, the value of this field is a price representing a
    // sample bid from the eligible mediation networks that were higher than the
    // auction winner, weighted by expected fill rate. This field can be used
    // in conjunction with minimum_bid_to_win to train bidding models. The CPM
    // is in micros of your account currency.
    optional int64 sampled_mediation_cpm_ahead_of_auction_winner = 10;

    // Event notification token that was included in the bid response.
    optional bytes event_notification_token = 5;

    // Buyer creative ID that was included in the bid response.
    optional string buyer_creative_id = 6;

    // Possible types of bid response feedback objects.
    enum FeedbackType {
      FEEDBACK_TYPE_UNSPECIFIED = 0;

      // Feedback for a bid that was submitted on a bid response.
      BID_FEEDBACK = 1;

      // Feedback for an interest group buyer submitted on a bid response to
      // particpate in an interest group bidding component of the auction run
      // using the Protected Audience API.
      INTEREST_GROUP_BUYER_FEEDBACK = 2;
    }

    // The type of the BidResponseFeedback message. Google will send separate
    // BidResponseFeedback objects for:
    // a) Each bid submitted on a bid response
    // b) Each buyer submitted on a bid response to particpate in an interest
    // group bidding component of the auction run using the Protected Audience
    // API.
    optional FeedbackType feedback_type = 17;

    // Origin of an interest group buyer that was included in the bid response.
    // This field is populated only for feedback where a bidder opted in an
    // interest group buyer to participate in the interest group bidding
    // component of the overall auction run using the Protected Audience API.
    // To learn more about origins, see https://www.rfc-editor.org/rfc/rfc6454.
    // To learn more about interest group bidding and the Protected Audience
    // API, see
    // https://developers.google.com/authorized-buyers/rtb/fledge-origin-trial.
    optional string buyer_origin = 18;

    // The status code for the submitted interest group buyer. This field is
    // only populated in the feedback for an interest group buyer that a bidder
    // requested to enter into the interest group auction through the bid
    // response. Individual creative status codes of bids submitted by the buyer
    // in the on-device interest group auction are not available. See
    // https://storage.googleapis.com/adx-rtb-dictionaries/interest-group-buyer-status-codes.txt
    // for a list of interest group buyer status codes.
    optional int32 interest_group_buyer_status_code = 19;
  }
  repeated BidResponseFeedback bid_response_feedback = 44;

  // How many milliseconds Google will wait for a response before ignoring it.
  optional int32 response_deadline_ms = 57;

  // -----------------------------------------------------------
  // Testing options.
  //
  // If true, then this is a test request. Results will not be displayed to
  // users and you will not be billed for a response even if it wins the
  // auction. You should still do regular processing since the request may be
  // used to evaluate latencies or for other testing. During your initial
  // testing with Google traffic any response that you make will be filtered
  // out of the auction whether this option has a value of true or false.
  optional bool is_test = 15 [default = false];

  // If true, then this request is intended to measure network latency.
  // Return an empty BidResponse with only processing_time_ms set as quickly as
  // possible without executing any bidding logic.
  optional bool is_ping = 17 [default = false];

  // If true, then the callout model predicted that you will not bid
  // on this request. We send a sampled percentage of such requests so that we
  // can automatically update the model when bidding patterns change.
  optional bool is_predicted_to_be_ignored = 45 [default = false];

  // SupplyChain object. For more information, see
  // https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/supplychainobject.md.
  message SupplyChain {
    // Indicates whether the chain contains all nodes involved in the
    // transaction leading back to the owner of the site, app or other medium of
    // the inventory.
    optional bool complete = 1;

    message SupplyChainNode {
      // The canonical domain name of the SSP, Exchange, Header Wrapper, etc
      // system that bidders connect to. This may be the operational domain of
      // the system, if that is different than the parent corporate domain, to
      // facilitate WHOIS and reverse IP lookups to establish clear ownership of
      // the delegate system. This should be the same value as used to identify
      // sellers in an ads.txt file if one exists.
      optional string advertising_system_identifier = 1;

      // The identifier associated with the seller or reseller account within
      // the advertising system. This must contain the same value used in
      // transactions, specifically the publisher_id field in the Google
      // protocol. Should be limited to 64 characters in length.
      optional string seller_identifier = 2;

      // Indicates whether this node will be involved in the flow of payment for
      // the inventory. When set to true, the advertising system in the
      // advertising_system_identifier field pays the seller in the
      // seller_identifier field, who is responsible for paying the previous
      // node in the chain. When set to false, this node is not involved in the
      // flow of payment for the inventory.
      optional bool handles_payment = 6;
    }

    // Array of SupplyChainNode objects in the order of the chain. In a complete
    // supply chain, the first node represents the initial advertising system
    // and seller ID involved in the transaction, for example, the owner of the
    // site, app, or other medium. In an incomplete supply chain, it represents
    // the first known node. The last node represents the entity sending this
    // bid request.
    repeated SupplyChainNode nodes = 2;

    // Version of the supply chain specification in use, in the format of
    // "major.minor". For example, for version 1.0 of the spec, use the string
    // "1.0".
    optional string version = 3;
  }
  optional SupplyChain supply_chain = 69;

  // Experimental feature; may be subject to change. See
  // https://support.google.com/authorizedbuyers/answer/10890762 for more
  // information.
  //
  // Describes the scope of frequency cap enforcement available for this
  // request. Frequency caps to be enforced for a bid can be specified in the
  // BidResponse.ad.adslot.frequency_cap field.
  enum FrequencyCappingScope {
    // Default value which should not be used, or which can indicate that
    // frequency cap scope could not be reliably determined.
    FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0;

    // Frequency capping based on bid response specifications is not available
    // for this request. A frequency-capped bid for a bid request with no
    // frequency cap availability will be filtered prior to the auction.
    FREQUENCY_CAPPING_SCOPE_NONE = 1;

    // Frequency capping enforcement is available across multiple sites within
    // the same browser.
    FREQUENCY_CAPPING_SCOPE_BROWSER = 2;

    // Frequency capping enforcement is available across multiple apps on the
    // device, excluding browsers.
    FREQUENCY_CAPPING_SCOPE_DEVICE = 3;

    // Frequency capping enforcement is available within a single app.
    FREQUENCY_CAPPING_SCOPE_APP = 4;

    // Frequency capping enforcement is available within a single site.
    FREQUENCY_CAPPING_SCOPE_SITE = 5;
  }
  optional FrequencyCappingScope frequency_capping_scope = 70;

  // Contains labels indicating the experiment or control groups that are
  // active for this request. Work with your account manager to opt in to an
  // experiment. The exact set of experiments available, their meaning, and
  // whether there is any action required from the bidder varies from experiment
  // to experiment and will be communicated separately.
  //
  // If empty, then this request is not part of any experiment or control group,
  // or your bidder is not participating in any experiments.
  repeated string experiment_ids = 78;

  // The Digital Services Act (DSA) transparency requirements. See
  // https://support.google.com/admanager/answer/14335032.
  message Dsa {
    // Values indicating whether DSA declarations should be included in the bid
    // response and, if so, whether or not the publisher is an Online Platform
    // (OP) or Very Large Online Platform (VLOP), as defined by the DSA.
    enum DsaSupport {
      DSA_SUPPORT_UNKNOWN = 0;

      // DSA declarations are not required in the bid response.
      NOT_REQUIRED = 1;

      // DSA declarations are supported, but not required in the bid response.
      SUPPORTED = 2;

      // DSA declarations are required in the bid response.
      REQUIRED = 3;

      // DSA declarations are required in the bid response and the publisher is
      // an OP or VLOP.
      REQUIRED_BY_ONLINE_PLATFORM = 4;
    }

    // Indicates if DSA declarations should be included in the bid response.
    // Bids where DSA declarations are required but not included will not be
    // accepted.
    optional DsaSupport dsa_support = 1;

    // Options describing a publisher's ability to render DSA transparency
    // declarations.
    enum PublisherRenderingSupport {
      PUBLISHER_RENDERING_SUPPORT_UNKNOWN = 0;

      // Publisher can't render.
      PUBLISHER_UNABLE_TO_RENDER = 1;

      // Publisher could render depending on the buyer's rendering capability as
      // described in the BidResponse.ad.dsa_transparency.buyer_render field.
      PUBLISHER_CAN_RENDER = 2;

      // Publisher will render regardless of the buyer's rendering capability as
      // described in the BidResponse.ad.dsa_transparency.buyer_render field.
      PUBLISHER_WILL_RENDER = 3;
    }

    // Indicates if the publisher will render the DSA Transparency info. This
    // will signal if the publisher is able to and intends to render the icon
    // or other appropriate user-facing symbol and display the DSA transparency
    // info to the end user.
    optional PublisherRenderingSupport publisher_rendering_support = 2;

    // Options describing if a publisher requires DSA transparency declarations.
    enum DataToPublisher {
      DATA_TO_PUBLISHER_UNKNOWN = 0;

      // Do not send transparency data.
      DO_NOT_SEND = 1;

      // Optional to send transparency data.
      OPTIONAL = 2;

      // Send transparency data.
      SEND = 3;
    }

    // Indicates whether the bidder should provide DSA transparency declarations
    // in the bid response. A publisher may need this information for audit or
    // other purposes, even if they will not render the transparency
    // declarations themselves.
    optional DataToPublisher data_to_publisher = 3;
  }

  // The Digital Services Act (DSA) transparency information requirements.
  optional Dsa dsa = 86;
}

// This is the message that you return in response to a BidRequest. You may
// specify zero or more ads. For each ad, you should provide an ad slot on
// which the ad can run. An ad slot is identified by the AdSlot.id from the
// BidRequest. If you do not want to bid, submit a response with no ads and
// with only the processing_time_ms set.
message BidResponse {

  message Ad {
    // The event notification token is sent to AdX by bidders for
    // troubleshooting. AdX will include the token in real-time feedback for the
    // bid. The content of the token will not be logged by AdX. AdX will ignore
    // any token longer than 128 bytes.
    optional bytes event_notification_token = 25;

    // A unique identifier chosen by you for the creative in this response.
    // This must always be set, must be limited to at most 64 bytes, and must be
    // a valid UTF8 string. Every buyer_creative_id you use must always be
    // associated with the same creative. This field is used to communicate
    // approval statuses when issues are found. Do not specify the same id for
    // different creatives, or all creatives will be disapproved if a problem
    // with a single creative is found. Do not specify different ids for the
    // same creative in different responses or no creatives will be served since
    // approval status is assigned on a per-id basis.
    optional string buyer_creative_id = 10;

    // Only one of the following should be set:
    // 1) html_snippet, 2) video_url, 3) native_ad, or 4) sdk_rendered_ad.
    //
    // The HTML snippet that will be placed on the web page to display the ad.
    // Use BidResponse.Ad.AdSlot.billing_id to indicate which billing id
    // this snippet is attributed to.
    optional string html_snippet = 1;

    // The URL to fetch a video ad. The URL should return an XML response that
    // conforms to the VAST 2.0 or 3.0 standard. Use
    // BidResponse.Ad.AdSlot.billing_id to indicate which billing id to
    // attribute this ad to. Only one of the following should be set:
    // html_snippet, video_url. Only set this field if the BidRequest is for an
    // in-video ad (BidRequest.video is present).
    optional string video_url = 9;

    // The VAST document to be returned. This document should conform to the
    // VAST 2.0 or 3.0 standard. Use BidResponse.Ad.AdSlot.billing_id to
    // indicate which billing ID to attribute this ad to.
    // Only set this field if the BidRequest is for an in-video ad and the
    // response is VAST XML.
    optional string video_vast_xml = 24;

    // The URL to fetch an AMPHTML ad. Only one of the following should be set:
    // html_snippet, video_url, amp_ad_url, native_ad.
    optional string amp_ad_url = 23;

    // The content of a native ad. Native ads consist of multiple building
    // blocks, which are rendered by the publisher. Only one of the following
    // should be set: html_snippet, video_url, or native_ad.
    // Only set this field if the BidRequest is for a native ad
    // (BidRequest.adslot.native is present).
    message NativeAd {
      // A video in the form of either a URL for a VAST tag, or an in-line VAST
      // tag. Only set this field if VIDEO is required or recommended in the
      // BidRequest's NativeAdTemplate.
      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. Max size is 100kB.
        string video_vast_xml = 16;
      }

      // 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;

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

      // This field is deprecated in favor of the repeated click_tracking_urls
      // field at the BidResponse.Ad level. It will be removed at the end of
      // Q2 2022.
      // 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.
      optional string DEPRECATED_click_tracking_url = 11 [deprecated = true];

      // This field is deprecated in favor of the click_tracking_urls
      // field at the BidResponse.Ad level. It will be removed at the end of
      // Q2 2022.
      // The URLs to use for click tracking. This will be used throughout the
      // serving stack and will incorporate any URL in click_tracking_url.
      repeated string DEPRECATED_click_tracking_urls = 15 [deprecated = true];

      // 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 inal 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;

    // All vendor types for the ads that may be shown from this snippet. You
    // should only declare vendor ids listed in the vendors.txt file in the
    // technical documentation. We will check to ensure that the vendors you
    // declare are in the allowed_vendor_type list sent in the BidRequest for
    // AdX publishers.
    repeated int32 vendor_type = 5;

    // All attributes for the ads that may be shown from this snippet. See
    // buyer-declarable-creative-attributes.txt in the technical documentation
    // for a list of ids. We will check to ensure none of these attributes are
    // in the excluded_attribute list in the BidRequest.
    repeated int32 attribute = 6;

    // All sensitive categories for the ads that may be shown from this snippet.
    // See ad-sensitive-categories.txt in the technical documentation for a list
    // of ids. We will check to ensure none of these categories were in the
    // excluded_sensitive_category list in the BidRequest.
    repeated int32 category = 7;

    // All restricted categories for the ads that may be shown from this
    // snippet. See ad-restricted-categories.txt in the technical documentation
    // for a list of ids. We will check to ensure these categories were listed
    // in the allowed_restricted_category list in the BidRequest. If you are
    // bidding with ads in restricted categories you MUST ALWAYS declare them
    // here.
    repeated int32 restricted_category = 17;

    // All names of the ad's advertisers.
    repeated string advertiser_name = 11;

    // The width and the height in pixels of the ad. Setting these is optional.
    // However, these must be set if the bid BidRequest.AdSlot has more than one
    // width and height or if BidRequest.Mobile.is_interstitial_request is true.
    optional int32 width = 14;
    optional int32 height = 15;

    message AdSlot {
      // The slot id from the BidRequest that the ad may appear in.
      required int32 id = 1;

      // The maximum CPM you want to be charged if you win the auction for this
      // ad slot, expressed in micros of the specified currency or default
      // bidding currency. For example, to bid a CPM of 1.29 USD, set
      // max_cpm_micros = 1290000. Winning bids are rounded up to billable
      // units. For example, in USD, bids are rounded up to the next multiple
      // of 10,000 micros (one cent).
      required int64 max_cpm_micros = 2;

      // The minimum CPM you want to be charged if you win the auction for this
      // ad slot, expressed in micros of the specified currency or default
      // bidding currency. This may represent a second price if you choose
      // max_cpm_micros as the highest of several bids, or some form of reserve
      // price if you want to override the reserve price set by the publisher.
      // The bid must be less than or equal to max_cpm_micros or it will be
      // ignored. This field is optional and does not need to be set. This
      // field is not applicable when responding to bid requests with
      // auction_type set to FIRST_PRICE.
      optional int64 min_cpm_micros = 3;

      // The currency used by max_cpm_micros and min_cpm_micros, using ISO-4217
      // alpha codes. If this field is populated, the specified currency will
      // be used to interpret the bid. Otherwise, the default bidding currency
      // will be used, which is determined in the following priority:
      // 1. The bidder-level currency, if configured in RTB account settings.
      // 2. The buyer-level currency. The buyer will be determined by the
      // billing ID specified in the billing_id field of the bid response if it
      // is populated, otherwise it will be based on the sole billing ID sent
      // in the bid request.
      //
      // The currency of a buyer account is set on account creation and can be
      // checked by contacting a Technical Account Manager.
      optional string currency = 15;

      // Billing id to attribute this impression to. The value must be in the
      // set of billing ids for this slot that were sent in the
      // BidRequest.AdSlot.matching_ad_data.billing_id. This must always be set
      // if the BidRequest has more than one
      // BidRequest.AdSlot.matching_ad_data.billing_id or if the bidder has
      // active child seats.
      optional int64 billing_id = 4;

      // The deal id that you want this bid to participate in. Leave unset
      // or set it to "1" if a deal is available but you want to
      // ignore the deal and participate in the open auction.
      optional int64 deal_id = 5 [default = 0];

      // For exchange bidders (third party exchanges doing real-time bidding on
      // DFP), the deal id from the exchange's namespace that is associated with
      // this bid and reported to publishers. Leave unset if there is no
      // associated deal. This is arbitrary UTF8 text and must be at most 64
      // bytes.
      optional string exchange_deal_id = 6;

      // When exchange_deal_id is set, the type of deal. This is reported to
      // publishers and affects how the deal is treated in the auction.
      enum ExchangeDealType {
        OPEN_AUCTION = 0;
        PRIVATE_AUCTION = 1;
        PREFERRED_DEAL = 2;
        EXCHANGE_AUCTION_PACKAGE = 3;
      }
      optional ExchangeDealType exchange_deal_type = 7 [default = OPEN_AUCTION];

      // The seat ID in the bidder's namespace representing the seat on whose
      // behalf this bid was made.
      optional string seat_id = 25;

      // Buyer declared ID which will be used to break down cost transparency
      // metrics in Reporting. Note that IDs with fewer than 1000 impressions
      // will not be used to break down metrics. IDs longer than 64 bytes will
      // be ignored.
      optional string buyer_reporting_id = 8;

      // Token used to identify end third party buyer information if an
      // 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.
      optional string third_party_buyer_token = 12;

      // Experimental feature; may be subject to change. See
      // https://support.google.com/authorizedbuyers/answer/10890762 for more
      // information.
      //
      // Specifies frequency capping to be applied to the bid. Impressions for
      // each user are capped at the level specified by frequency_cap_id. A bid
      // will not participate in the auction if an additional impression for the
      // user would violate any of the specified caps. Multiple frequency caps
      // can be specified for the same frequency_cap_id.
      //
      // A bid is filtered before the auction if the frequency cap is malformed.
      // Instances where the cap is malformed include:
      //  - frequency_cap_id is empty or is very long
      //  - max_mpressions or time_range are non-positive
      //  - there are a large number of frequency caps for a single bid
      //  - time_unit is not specified
      //
      // Note that if a subsequent bid with the same frequency_cap_id uses a
      // different duration (represented by time_unit and time_range) then
      // impressions counted against the old frequency cap will not count
      // against the new one, and the impressions counted against the new
      // frequency cap with a different time_unit and time_range will not count
      // against the old frequency cap..
      message FrequencyCap {
        // An ID that can represent a bidder's use-case for frequency capping.
        // For example, it could represent their campaign, ad, line item, or
        // some other entity. It should not contain any user-specific
        // information or identifiers and should not be longer than 64
        // characters.
        optional string frequency_cap_id = 1;

        // The time units for which frequency caps can be enforced.
        enum TimeUnit {
          UNKNOWN_TIME_UNIT = 0;
          MINUTE = 1;
          DAY = 2;
          WEEK = 3;
          MONTH = 4;

          // When INDEFINITE is used, time_range will be ignored. INDEFINITE
          // means the frequency cap will be applied for a long period of time,
          // (longer than a month) but not necessarily forever.
          INDEFINITE = 5;
        }

        // The unit of time used to specify the time window for which a
        // frequency cap applies.
        optional TimeUnit time_unit = 2;

        // The length of the time window, in units specified by time_unit, for
        // which the frequency cap applies. For instance, if time_unit=WEEK and
        // time_range=3, then capping is applied for a three week period. If the
        // time_unit=INDEFINITE, this will be ignored.
        optional int32 time_range = 3 [default = 1];

        // The maximum number of impressions allowed to be shown to a user for
        // the provided frequency_cap_id within the time window described by
        // time_unit and time_range.
        optional int32 max_impressions = 4;
      }
      repeated FrequencyCap frequency_cap = 16;

      // Position within the pod.
      enum PodPosition {
        // Any position in the pod.
        POD_POSITION_ANY = 0;

        // Last position in the pod.
        POD_POSITION_LAST = 1;

        // First position in the pod.
        POD_POSITION_FIRST = 2;

        // First or last position in the pod.
        POD_POSITION_FIRST_OR_LAST = 3;
      }

      // Indicates that the bid is only eligible
      // for a specific position within the