Method: bidders.pretargetingConfigs.addTargetedPublishers

  • Adds targeted publishers to the specified pretargeting configuration.

  • The request requires a list of publisher IDs and a targeting mode to be applied.

  • A successful response returns the updated PretargetingConfig object.

  • The endpoint requires authorization with the https://www.googleapis.com/auth/realtime-bidding scope.

  • Uses an HTTP POST request to https://realtimebidding.googleapis.com/v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:addTargetedPublishers.

Adds targeted publishers to the pretargeting config.

HTTP request

POST https://realtimebidding.googleapis.com/v1/{pretargetingConfig=bidders/*/pretargetingConfigs/*}:addTargetedPublishers

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
pretargetingConfig

string

Required. The name of the pretargeting configuration. Format: bidders/{bidderAccountId}/pretargetingConfig/{configId}

Request body

The request body contains data with the following structure:

JSON representation 
{
  "publisherIds": [
    string
  ],
  "targetingMode": enum (TargetingMode)
}
Fields
publisherIds[]

string

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.
targetingMode

enum (TargetingMode)

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.

Response body

If successful, the response body contains an instance of PretargetingConfig.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/realtime-bidding