Set up pretargeting configurations

To ensure that Google sends you the most appropriate impression calls, you can "pre-target" impressions to only receive requests for impressions that match your desired targeting criteria. This can be done in the Authorized Buyers user interface or using the REST API. Learn more about pretargeting using the REST API.

Note that regardless of how you configure pretargeting, Programmatic Guaranteed deals will always be sent to your bidder.

You can choose to have Private Auctions and Preferred Deals always sent to your bidder by toggling enable/disable in the Deals section under the Pretargeting tab:

 

To set up a pretargeting configuration:

  1. In your Authorized Buyers account, click on Bidder settings > Pretargeting.

  2. Click New Pretargeting Group to create a new pretargeting configuration. You can have up to 10 configurations.

  3. Name your configuration.

  4. Select Active or Paused as the status. You can change this later.
    Google pauses individual pretargeting configurations that are without spend for a 6-month period. You can re-activate any pretargeting configuration by changing the status back to "Active" in the configuration settings.
  5. Select whether you would like the configuration to apply to Banner, Video, or Native formats.

  6. Set the Daily budget in your account currency.

    The daily budget is required and allows you to cap your spend. The value you choose should be a whole number.
  7. (Optional) Set the Maximum QPS for each pretargeting configuration.

    Maximum Queries per second (QPS)
    This is the maximum number of queries per second (QPS) allowed for the pretargeting configuration. Leave this blank (blank by default) if you do not want to limit the QPS volume for the pretargeting configuration.
     

    Frequently asked questions

    What if the volume of QPS entered is more than the maximum QPS configured for the account? The maximum QPS configured for the account will always be respected regardless of QPS caps set in pretargeting.


    Is there a way to reserve QPS for a specific pretargeting group? Yes, you can reserve QPS for a specific pretargeting group. For example, say a bidder has a capacity for 50k QPS in their account setup, and has pretargeting groups A, B, and C for which group C is a video pretargeting group. One can cap groups A and B to a combined QPS of 40k, meaning pretargeting group C will have 10k in reserve for video at all times (based on the account max of 50k).
  8. In the Environment section, select whether to: include all, exclude all, or target specific apps/sites. See more detailed examples in the "Common targeting scenarios" section. 

    Learn more about configuring Environment criteria

    Selecting multiple apps and sites results in OR logic. For example, including both a list of apps and URLs will include all apps and all URLs specified. 

    Once configured, the Environment section will result in AND logic with the other settings within the same pretargeting configuration, which means bid requests will need to meet both the Environment criteria and the Settings criteria to be sent to the bidder. For example, if a list of apps is selected in the Environment section and France is included within the Settings > Geographies section, then only bid requests for the specified apps for users in France will be sent.

    Select the URLs and mobile apps that you wish to receive bid requests for. Do not use app store or other URLs to target app inventory, only use the app ID in the mobile app dimension.

  9. In the Settings section, define your targeting by selecting a category, finding the desired criteria, and clicking either include or exclude. See more detailed examples in the "Common targeting scenarios" section.

    Learn more about selecting targeting criteria

    All inventory is included, by default. This applies to every category in the targeting selector. This behavior changes once you explicitly include criteria within a category. For example, click include on the "300x250" criterion in the "Inventory sizes" category to include only 300x250 and exclude all sizes that are not explicitly included.

    Selecting multiple criteria within the same category results in OR logic. For example, click include on the "United States" and "Canada" criteria in the "Geography" category to receive callouts for impressions that are either from the United States or Canada.

    Selecting multiple criteria across different categories results in AND logic. For example, click include on the "300x250" criterion in the "Creative sizes" category, and include on the "United States" and "Canada" criteria in the "Geography" category to receive callouts for impressions that are for 300x250 inventory and from either from the United States or Canada.

    Learn more about selecting User identifiers criteria

    Note that bid requests from App, CTV, and console traffic will be filtered if there are no hosted match entries present when the buyer has chosen to only target traffic with hosted match entries (Pretargeting configuration > User identifiers > Hosted match table entry present)
    Hosted match entries will be present for Apps when the buyer has enabled Same Device Targeting. CTV and console traffic will never have hosted match entries. Hosted match table entry present therefore in general means limiting to web-only inventory unless other user identifier targeting is also selected.
    Learn more about Same Device Targeting
      Web traffic App/CTV/Console
    Hosted match table entry present Bid requests without HM entry are filtered
    DoubleClick cookie present Bid requests without DoubleClick cookie are filtered
    Device advertising ID present Bid requests without Device advertising ID are filtered
  10. Click Save after you've made your selections. The added configuration will display in the list.

To edit a pretargeting configuration:

  1. In your Authorized Buyers account, click on Bidder settings > Pretargeting.
  2. Select the configuration you want to edit.
  3. Make your changes and click Save.

To delete a pretargeting configuration:

  1. In your Authorized Buyers account, click on Bidder settings > Pretargeting.
  2. Select the configuration you want to edit.
    1. Click Delete in the bottom right corner.

Language limitations

Brand safety categories and content classifiers are available in 12 languages: English, German, Spanish, French, Japanese, Simplified Chinese, Portuguese, Dutch, Italian, Russian, Traditional Chinese, and Korean.

Exceptions:

Sexually suggestive content and Death and tragedy are not available for the following languages: Korean and Traditional Chinese.

Violent content is not available in Traditional Chinese.

Common targeting scenarios

When creating a pretargeting configuration, use the illustrated examples below to determine the correct category and criteria options in the targeting selector.

Format examples

Banner, Video, or Native

Banner and Native

Banner, Video, and Native

Environment and Platforms examples

Note that Web and App targeting selections have an OR relationship with each other and an AND relationship with all other pretargeting configurations.

Include all apps or sites

Target specific apps (upload a CSV file)

  1. From the Environment section, navigate to Apps > Target specific apps and categories > Apps.

  2. Select a targeting behavior and upload a CSV file containing a list of apps. Download the sample file to use as a reference.

Target specific app categories

From the Environment section, navigate to Apps > Target specific apps and categories > App categories. Select a platform to include all categories within it. Exclude a specific category by going into each platform and clicking exclude.

Target specific sites (upload a CSV file)

From the Environment section, navigate to Web > Target specific sites. Next, select a targeting behavior and upload a CSV file containing a list of sites. Download the sample file to use as a reference. 

Environment and Platforms

Banner inventory, desktop only (no mobile)

Mobile web inventory only (no desktop banner, no mobile app)

Mobile app inventory only (no desktop banner, no mobile web)

Mobile video inventory only (no desktop video)

Video inventory, Connected TV only

Other examples

Mobile app inventory, only interstitials

 

Historical viewability

User identifiers

Was this helpful?
How can we improve it?