chore: update docs/dyn , add static discovery files to discovery_cache/documents (#1111)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/78f53313-0c78-4a29-8841-f031665a4c6a/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/c2de32114ec484aa708d32012d1fa8d75232daf5
diff --git a/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html b/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html
index 4217948..29373ab 100644
--- a/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html
+++ b/docs/dyn/realtimebidding_v1.bidders.pretargetingConfigs.html
@@ -141,55 +141,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -198,26 +154,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -228,11 +180,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -261,55 +261,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -318,26 +274,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -348,11 +300,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -366,10 +366,10 @@
The object takes the form of:
{ # A request to start targeting the provided publishers in a specific pretargeting configuration. The pretargeting configuration itself specifies how these publishers are targeted in PretargetingConfig.publisherTargeting.
- "targetingMode": "A String", # Required. The targeting mode that should be applied to the list of publisher IDs. If are existing publisher IDs, must be equal to the existing PretargetingConfig.publisherTargeting.targetingMode or a 400 bad request error will be returned.
"publisherIds": [ # A list of publisher IDs to target in the pretargeting configuration. These values will be added to the list of targeted publisher IDs in PretargetingConfig.publisherTargeting.values. Publishers are identified by their publisher ID from ads.txt / app-ads.txt. See https://iabtechlab.com/ads-txt/ and https://iabtechlab.com/app-ads-txt/ for more details.
"A String",
],
+ "targetingMode": "A String", # Required. The targeting mode that should be applied to the list of publisher IDs. If are existing publisher IDs, must be equal to the existing PretargetingConfig.publisherTargeting.targetingMode or a 400 bad request error will be returned.
}
x__xgafv: string, V1 error format.
@@ -381,55 +381,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -438,26 +394,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -468,11 +420,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -486,10 +486,10 @@
The object takes the form of:
{ # A request to start targeting the provided sites in a specific pretargeting configuration. The pretargeting configuration itself specifies how these sites are targeted in PretargetingConfig.webTargeting.
- "targetingMode": "A String", # Required. The targeting mode that should be applied to the list of site URLs. If there are existing targeted sites, must be equal to the existing PretargetingConfig.webTargeting.targetingMode or a 400 bad request error will be returned.
"sites": [ # A list of site URLs to target in the pretargeting configuration. These values will be added to the list of targeted URLs in PretargetingConfig.webTargeting.values.
"A String",
],
+ "targetingMode": "A String", # Required. The targeting mode that should be applied to the list of site URLs. If there are existing targeted sites, must be equal to the existing PretargetingConfig.webTargeting.targetingMode or a 400 bad request error will be returned.
}
x__xgafv: string, V1 error format.
@@ -501,55 +501,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -558,26 +514,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -588,11 +540,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -611,55 +611,11 @@
The object takes the form of:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -668,26 +624,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -698,11 +650,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}
x__xgafv: string, V1 error format.
@@ -714,55 +714,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -771,26 +727,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -801,11 +753,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -842,55 +842,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -899,26 +855,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -929,11 +881,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -954,58 +954,13 @@
An object of the form:
{ # A response containing pretargeting configurations.
- "nextPageToken": "A String", # A token which can be passed to a subsequent call to the `ListPretargetingConfigs` method to retrieve the next page of results in ListPretargetingConfigsRequest.pageToken.
"pretargetingConfigs": [ # List of pretargeting configurations.
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1014,26 +969,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1044,13 +995,62 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
},
],
+ "nextPageToken": "A String", # A token which can be passed to a subsequent call to the `ListPretargetingConfigs` method to retrieve the next page of results in ListPretargetingConfigsRequest.pageToken.
}</pre>
</div>
@@ -1078,55 +1078,11 @@
The object takes the form of:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1135,26 +1091,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1165,11 +1117,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}
updateMask: string, Field mask to use for partial in-place updates.
@@ -1182,55 +1182,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1239,26 +1195,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1269,11 +1221,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -1301,55 +1301,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1358,26 +1314,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1388,11 +1340,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -1420,55 +1420,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1477,26 +1433,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1507,11 +1459,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -1539,55 +1539,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1596,26 +1552,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1626,11 +1578,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>
@@ -1655,55 +1655,11 @@
An object of the form:
{ # Pretargeting configuration: a set of targeting dimensions applied at the pretargeting stage of the RTB funnel. These control which inventory a bidder will receive bid requests for.
- "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
- "A String",
- ],
- "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
- "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
- "A String",
- ],
+ "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
+ "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
"includedUserIdTypes": [ # User identifier types included in this configuration. At least one of the user identifier types specified in this list must be available for the bid request to be sent.
"A String",
],
- "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
- "A String",
- ],
- "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
- "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
- "targetingMode": "A String", # How the items in this list should be targeted.
- "values": [ # The values specified.
- "A String",
- ],
- },
- "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
- "includedIds": [ # The IDs included in a configuration.
- "A String",
- ],
- "excludedIds": [ # The IDs excluded in a configuration.
- "A String",
- ],
- },
- },
- "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
- "A String",
- ],
- "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
- "A String",
- ],
"geoTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The geos included or excluded in this configuration defined in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv
"includedIds": [ # The IDs included in a configuration.
"A String",
@@ -1712,26 +1668,22 @@
"A String",
],
},
- "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
- "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
- "billingId": "A String", # Output only. The identifier that corresponds to this pretargeting configuration that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one configuration, the buyer chooses which billing_id to attribute each of their bids.
- "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
- "A String",
- ],
- "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
- { # The dimensions of a creative. This applies to only HTML and Native creatives.
- "width": "A String", # The width of the creative in pixels.
- "height": "A String", # The height of the creative in pixels.
- },
- ],
+ "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
"publisherTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of publisher inventory. Publishers can either be targeted positively (bid requests will be sent only if the publisher is listed in the targeting dimension) or negatively (bid requests will be sent only if the publisher is not listed in the targeting dimension). A maximum of 10,000 publisher IDs can be targeted. Publisher IDs are found in [ads.txt](https://iabtechlab.com/ads-txt/) / [app-ads.txt](https://iabtechlab.com/app-ads-txt/) and in bid requests in the `BidRequest.publisher_id` field on the [Google RTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/realtime-bidding-proto) or the `BidRequest.site.publisher.id` / `BidRequest.app.publisher.id` field on the [OpenRTB protocol](https://developers.google.com/authorized-buyers/rtb/downloads/openrtb-adx-proto).
"targetingMode": "A String", # How the items in this list should be targeted.
"values": [ # The values specified.
"A String",
],
},
- "state": "A String", # Output only. The state of this pretargeting configuration.
- "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "minimumViewabilityDecile": 42, # The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the configuration will only match adslots for which we predict at least 50% viewability. Values > 10 will be rounded down to 10. An unset value or a value of 0 indicates that bid requests will be sent regardless of viewability.
+ "includedMobileOperatingSystemIds": [ # The mobile operating systems included in this configuration as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv
+ "A String",
+ ],
+ "interstitialTargeting": "A String", # The interstitial targeting specified for this configuration. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.
+ "includedFormats": [ # Creative formats included by this configuration. Only bid requests eligible for at least one of the specified creative formats will be sent. An unset value will allow all bid requests to be sent, regardless of format.
+ "A String",
+ ],
+ "includedPlatforms": [ # The platforms included by this configration. Bid requests for devices with the specified platform types will be sent. An unset value allows all bid requests to be sent, regardless of platform.
"A String",
],
"verticalTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The verticals included or excluded in this configuration as defined in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals
@@ -1742,11 +1694,59 @@
"A String",
],
},
- "displayName": "A String", # The diplay name associated with this configuration. This name must be unique among all the pretargeting configurations a bidder has.
- "maximumQps": "A String", # The maximum QPS threshold for this configuration. The bidder should receive no more than this number of bid requests matching this configuration per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide
+ "state": "A String", # Output only. The state of this pretargeting configuration.
+ "name": "A String", # Output only. Name of the pretargeting configuration that must follow the pattern `bidders/{bidder_account_id}/pretargetingConfigs/{config_id}`
+ "invalidGeoIds": [ # Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.
+ "A String",
+ ],
+ "includedCreativeDimensions": [ # Creative dimensions included by this configuration. Only bid requests eligible for at least one of the specified creative dimensions will be sent. An unset value allows all bid requests to be sent, regardless of creative dimension.
+ { # The dimensions of a creative. This applies to only HTML and Native creatives.
+ "height": "A String", # The height of the creative in pixels.
+ "width": "A String", # The width of the creative in pixels.
+ },
+ ],
+ "allowedUserTargetingModes": [ # Targeting modes included by this configuration. A bid request must allow all the specified targeting modes. An unset value allows all bid requests to be sent, regardless of which targeting modes they allow.
+ "A String",
+ ],
+ "userListTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # The remarketing lists included or excluded in this configuration as defined in UserList.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "webTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeting on a subset of site inventory. If WEB is listed in included_environments, the specified targeting is applied. A maximum of 50,000 site URLs can be targeted. An unset value for targeting allows all web-based bid requests to be sent. Sites can either be targeting positively (bid requests will be sent only if the destination site is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination site is not listed in the pretargeting configuration).
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ "appTargeting": { # A subset of app inventory to target. Bid requests that match criteria in at least one of the specified dimensions will be sent. # Targeting on a subset of app inventory. If APP is listed in targeted_environments, the specified targeting is applied. A maximum of 30,000 app IDs can be targeted. An unset value for targeting allows all app-based bid requests to be sent. Apps can either be targeting positively (bid requests will be sent only if the destination app is listed in the targeting dimension) or negatively (bid requests will be sent only if the destination app is not listed in the targeting dimension).
+ "mobileAppCategoryTargeting": { # Generic targeting used for targeting dimensions that contain a list of included and excluded numeric IDs used in app, user list, geo, and vertical id targeting. # Lists of included and excluded mobile app categories as defined in https://developers.google.com/adwords/api/docs/appendix/mobileappcategories.csv.
+ "includedIds": [ # The IDs included in a configuration.
+ "A String",
+ ],
+ "excludedIds": [ # The IDs excluded in a configuration.
+ "A String",
+ ],
+ },
+ "mobileAppTargeting": { # Generic targeting with string values used in app, website and publisher targeting. # Targeted app IDs. App IDs can refer to those found in an app store or ones that are not published in an app store. A maximum of 30,000 app IDs can be targeted.
+ "targetingMode": "A String", # How the items in this list should be targeted.
+ "values": [ # The values specified.
+ "A String",
+ ],
+ },
+ },
"excludedContentLabelIds": [ # The sensitive content category label IDs excluded in this configuration. Bid requests for inventory with any of the specified content label IDs will not be sent. Refer to this file https://storage.googleapis.com/adx-rtb-dictionaries/content-labels.txt for category IDs.
"A String",
],
+ "includedEnvironments": [ # Environments that are being included. Bid requests will not be sent for a given environment if it is not included. Further restrictions can be applied to included environments to target only a subset of its inventory. An unset value includes all environments.
+ "A String",
+ ],
+ "includedLanguages": [ # The languages included in this configuration, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.
+ "A String",
+ ],
}</pre>
</div>