Interface TargetingOverlay

Optional restriction overlays for media buys. Most targeting should be expressed in the brief and handled by the publisher. These fields are for functional restrictions: geographic (RCT testing, regulatory compliance, proximity targeting), age verification (alcohol, gambling), device platform (app compatibility), language (localization), and keyword targeting (search/retail media).

interface TargetingOverlay {
    geo_countries?: string[];
    geo_countries_exclude?: string[];
    geo_regions?: string[];
    geo_regions_exclude?: string[];
    geo_metros?: { system: MetroAreaSystem; values: string[] }[];
    geo_metros_exclude?: { system: MetroAreaSystem; values: string[] }[];
    geo_postal_areas?: { system: PostalCodeSystem; values: string[] }[];
    geo_postal_areas_exclude?: { system: PostalCodeSystem; values: string[] }[];
    daypart_targets?: DaypartTarget[];
    axe_include_segment?: string;
    axe_exclude_segment?: string;
    audience_include?: string[];
    audience_exclude?: string[];
    frequency_cap?: FrequencyCap;
    property_list?: PropertyListReference;
    collection_list?: CollectionListReference;
    collection_list_exclude?: CollectionListReference;
    age_restriction?: {
        min: number;
        verification_required?: boolean;
        accepted_methods?: AgeVerificationMethod[];
    };
    device_platform?: DevicePlatform[];
    device_type?: DeviceType[];
    device_type_exclude?: DeviceType[];
    store_catchments?: {
        catalog_id: string;
        store_ids?: string[];
        catchment_ids?: string[];
    }[];
    geo_proximity?: { [k: string]: unknown }[];
    language?: string[];
    keyword_targets?: {
        keyword: string;
        match_type: MatchType;
        bid_price?: number;
    }[];
    negative_keywords?: { keyword: string; match_type: MatchType }[];
}

Properties

`Optional`geo_countries

geo_countries?: string[]

Restrict delivery to specific countries. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').

`Optional`geo_countries_exclude

geo_countries_exclude?: string[]

Exclude specific countries from delivery. ISO 3166-1 alpha-2 codes (e.g., 'US', 'GB', 'DE').

`Optional`geo_regions

geo_regions?: string[]

Restrict delivery to specific regions/states. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').

`Optional`geo_regions_exclude

geo_regions_exclude?: string[]

Exclude specific regions/states from delivery. ISO 3166-2 subdivision codes (e.g., 'US-CA', 'GB-SCT').

`Optional`geo_metros

geo_metros?: { system: MetroAreaSystem; values: string[] }[]

Restrict delivery to specific metro areas. Each entry specifies the classification system and target values. Seller must declare supported systems in get_adcp_capabilities.

Type Declaration

system: MetroAreaSystem
values: string[]
Metro codes within the system (e.g., ['501', '602'] for Nielsen DMAs)

`Optional`geo_metros_exclude

geo_metros_exclude?: { system: MetroAreaSystem; values: string[] }[]

Exclude specific metro areas from delivery. Each entry specifies the classification system and excluded values. Seller must declare supported systems in get_adcp_capabilities.

Type Declaration

system: MetroAreaSystem
values: string[]
Metro codes to exclude within the system (e.g., ['501', '602'] for Nielsen DMAs)

`Optional`geo_postal_areas

geo_postal_areas?: { system: PostalCodeSystem; values: string[] }[]

Restrict delivery to specific postal areas. Each entry specifies the postal system and target values. Seller must declare supported systems in get_adcp_capabilities.

Type Declaration

system: PostalCodeSystem
values: string[]
Postal codes within the system (e.g., ['10001', '10002'] for us_zip)

`Optional`geo_postal_areas_exclude

geo_postal_areas_exclude?: { system: PostalCodeSystem; values: string[] }[]

Exclude specific postal areas from delivery. Each entry specifies the postal system and excluded values. Seller must declare supported systems in get_adcp_capabilities.

Type Declaration

system: PostalCodeSystem
values: string[]
Postal codes to exclude within the system (e.g., ['10001', '10002'] for us_zip)

`Optional`daypart_targets

daypart_targets?: DaypartTarget[]

Restrict delivery to specific time windows. Each entry specifies days of week and an hour range.

`Optional`axe_include_segment

axe_include_segment?: string

Deprecated

Deprecated: Use TMP provider fields instead. AXE segment ID to include for targeting.

`Optional`axe_exclude_segment

axe_exclude_segment?: string

Deprecated

Deprecated: Use TMP provider fields instead. AXE segment ID to exclude from targeting.

`Optional`audience_include

audience_include?: string[]

Restrict delivery to members of these first-party CRM audiences. Only users present in the uploaded lists are eligible. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Not for lookalike expansion — express that intent in the campaign brief. Seller must declare support in get_adcp_capabilities.

`Optional`audience_exclude

audience_exclude?: string[]

Suppress delivery to members of these first-party CRM audiences. Matched users are excluded regardless of other targeting. References audience_id values from sync_audiences on the same seller account — audience IDs are not portable across sellers. Seller must declare support in get_adcp_capabilities.

`Optional`frequency_cap

frequency_cap?: FrequencyCap

`Optional`property_list

property_list?: PropertyListReference

`Optional`collection_list

collection_list?: CollectionListReference

`Optional`collection_list_exclude

collection_list_exclude?: CollectionListReference

`Optional`age_restriction

age_restriction?: {
    min: number;
    verification_required?: boolean;
    accepted_methods?: AgeVerificationMethod[];
}

Age restriction for compliance. Use for legal requirements (alcohol, gambling), not audience targeting.

Type Declaration

min: number
Minimum age required

Minimum
13

Maximum
99
Optionalverification_required?: boolean
Whether verified age (not inferred) is required for compliance
Optionalaccepted_methods?: AgeVerificationMethod[]
Accepted verification methods. If omitted, any method the platform supports is acceptable.

`Optional`device_platform

device_platform?: DevicePlatform[]

Restrict to specific platforms. Use for technical compatibility (app only works on iOS). Values from Sec-CH-UA-Platform standard, extended for CTV.

`Optional`device_type

device_type?: DeviceType[]

Restrict to specific device form factors. Use for campaigns targeting hardware categories rather than operating systems (e.g., mobile-only promotions, CTV campaigns).

`Optional`device_type_exclude

device_type_exclude?: DeviceType[]

Exclude specific device form factors from delivery (e.g., exclude CTV for app-install campaigns).

`Optional`store_catchments

store_catchments?: {
    catalog_id: string;
    store_ids?: string[];
    catchment_ids?: string[];
}[]

Target users within store catchment areas from a synced store catalog. Each entry references a store-type catalog and optionally narrows to specific stores or catchment zones.

Type Declaration

catalog_id: string
Synced store-type catalog ID from sync_catalogs.
Optionalstore_ids?: string[]
Filter to specific stores within the catalog. Omit to target all stores.
Optionalcatchment_ids?: string[]
Catchment zone IDs to target (e.g., 'walk', 'drive'). Omit to target all catchment zones.

`Optional`geo_proximity

geo_proximity?: { [k: string]: unknown }[]

Target users within travel time, distance, or a custom boundary around arbitrary geographic points. Multiple entries use OR semantics — a user within range of any listed point is eligible. For campaigns targeting 10+ locations, consider using store_catchments with a location catalog instead. Seller must declare support in get_adcp_capabilities.

`Optional`language

language?: string[]

Restrict to users with specific language preferences. ISO 639-1 codes (e.g., 'en', 'es', 'fr').

`Optional`keyword_targets

keyword_targets?: { keyword: string; match_type: MatchType; bid_price?: number }[]

Keyword targeting for search and retail media platforms. Restricts delivery to queries matching the specified keywords. Each keyword is identified by the tuple (keyword, match_type) — the same keyword string with different match types are distinct targets. Sellers SHOULD reject duplicate (keyword, match_type) pairs within a single request. Seller must declare support in get_adcp_capabilities.

Type Declaration

keyword: string
The keyword to target

Min Length
1
match_type: MatchType
Optionalbid_price?: number
Per-keyword bid price, denominated in the same currency as the package's pricing option. Overrides the package-level bid_price for this keyword. Inherits the max_bid interpretation from the pricing option: when max_bid is true, this is the keyword's bid ceiling; when false, this is the exact bid. If omitted, the package bid_price applies.

Minimum
0

`Optional`negative_keywords

negative_keywords?: { keyword: string; match_type: MatchType }[]

Keywords to exclude from delivery. Queries matching these keywords will not trigger the ad. Each negative keyword is identified by the tuple (keyword, match_type). Seller must declare support in get_adcp_capabilities.

Type Declaration

keyword: string
The keyword to exclude

Min Length
1
match_type: MatchType

Interface TargetingOverlay

Index

Properties

Properties

Optionalgeo_countries

Optionalgeo_countries_exclude

Optionalgeo_regions

Optionalgeo_regions_exclude

Optionalgeo_metros

Type Declaration

system: MetroAreaSystem

values: string[]

Optionalgeo_metros_exclude

Type Declaration

system: MetroAreaSystem

values: string[]

Optionalgeo_postal_areas

Type Declaration

system: PostalCodeSystem

values: string[]

Optionalgeo_postal_areas_exclude

Type Declaration

system: PostalCodeSystem

values: string[]

Optionaldaypart_targets

Optionalaxe_include_segment

Deprecated

Optionalaxe_exclude_segment

Deprecated

Optionalaudience_include

Optionalaudience_exclude

Optionalfrequency_cap

Optionalproperty_list

Optionalcollection_list

Optionalcollection_list_exclude

Optionalage_restriction

Type Declaration

min: number

Minimum

Maximum

Optionalverification_required?: boolean

Optionalaccepted_methods?: AgeVerificationMethod[]

Optionaldevice_platform

Optionaldevice_type

Optionaldevice_type_exclude

Optionalstore_catchments

Type Declaration

catalog_id: string

Optionalstore_ids?: string[]

Optionalcatchment_ids?: string[]

Optionalgeo_proximity

Optionallanguage

Optionalkeyword_targets

Type Declaration

keyword: string

Min Length

match_type: MatchType

Optionalbid_price?: number

Minimum

Optionalnegative_keywords

Type Declaration

keyword: string

Min Length

match_type: MatchType

Settings

On This Page

`Optional`geo_countries

`Optional`geo_countries_exclude

`Optional`geo_regions

`Optional`geo_regions_exclude

`Optional`geo_metros

`Optional`geo_metros_exclude

`Optional`geo_postal_areas

`Optional`geo_postal_areas_exclude

`Optional`daypart_targets

`Optional`axe_include_segment

`Optional`axe_exclude_segment

`Optional`audience_include

`Optional`audience_exclude

`Optional`frequency_cap

`Optional`property_list

`Optional`collection_list

`Optional`collection_list_exclude

`Optional`age_restriction

`Optional`verification_required?: boolean

`Optional`accepted_methods?: AgeVerificationMethod[]

`Optional`device_platform

`Optional`device_type

`Optional`device_type_exclude

`Optional`store_catchments

`Optional`store_ids?: string[]

`Optional`catchment_ids?: string[]

`Optional`geo_proximity

`Optional`language

`Optional`keyword_targets

`Optional`bid_price?: number

`Optional`negative_keywords