GOgoogle
bidders

POST /v1/bidders/{biddersId}/pretargetingConfigs/{pretargetingConfigsId}:addTargetedApps

Adds targeted apps to the pretargeting configuration.

Request

Path parameters

biddersIdstring required
pretargetingConfigsIdstring required

Request body

appIdsstring[]

A list of app IDs to target in the pretargeting configuration. These values will be added to the list of targeted app IDs in PretargetingConfig.appTargeting.mobileAppTargeting.values.

targetingMode'TARGETING_MODE_UNSPECIFIED' | 'INCLUSIVE' | 'EXCLUSIVE'

Required. The targeting mode that should be applied to the list of app IDs. If there are existing targeted app IDs, must be equal to the existing PretargetingConfig.appTargeting.mobileAppTargeting.targetingMode or a 400 bad request error will be returned.

Response

Successful response

allowedUserTargetingModesstring[]

Deprecated: The value of this field no longer has any effect. Targeting modes included by this config. 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.

billingIdstring int64

Output only. The identifier that corresponds to this pretargeting config that helps buyers track and attribute their spend across their own arbitrary divisions. If a bid request matches more than one config, the buyer chooses which billing_id to attribute each of their bids.

displayNamestring

The diplay name associated with this config. This name must be unique among all the pretargeting configs a bidder has.

excludedContentLabelIdsstring[]

The sensitive content category label IDs excluded in this config. 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.

includedEnvironmentsstring[]

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.

includedFormatsstring[]

Creative formats included by this config. 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.

includedLanguagesstring[]

The languages included in this config, represented by their language code. See https://developers.google.com/adwords/api/docs/appendix/languagecodes.

includedMobileOperatingSystemIdsstring[]

The mobile operating systems included in this config as defined in https://storage.googleapis.com/adx-rtb-dictionaries/mobile-os.csv

includedPlatformsstring[]

The platforms included by this config. 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.

includedUserIdTypesstring[]

User identifier types included in this config. At least one of the user identifier types specified in this list must be available for the bid request to be sent.

interstitialTargeting'INTERSTITIAL_TARGETING_UNSPECIFIED' | 'ONLY_INTERSTITIAL_REQUESTS' | 'ONLY_NON_INTERSTITIAL_REQUESTS'

The interstitial targeting specified for this config. The unset value will allow bid requests to be sent regardless of whether they are for interstitials or not.

invalidGeoIdsstring[]

Output only. Existing included or excluded geos that are invalid. Previously targeted geos may become invalid due to privacy restrictions.

maximumQpsstring int64

The maximum QPS threshold for this config. The bidder should receive no more than this number of bid requests matching this config per second across all their bidding endpoints among all trading locations. Further information available at https://developers.google.com/authorized-buyers/rtb/peer-guide

minimumViewabilityDecileinteger

The targeted minimum viewability decile, ranging in values [0, 10]. A value of 5 means that the config 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.

namestring

Output only. Name of the pretargeting config that must follow the pattern bidders/{bidder_account_id}/pretargetingConfigs/{config_id}

state'STATE_UNSPECIFIED' | 'ACTIVE' | 'SUSPENDED'

Output only. The state of this pretargeting config.

Changes

No recorded changes to this operation across all 5 revisions of this API.