ad_audience_size_estimate

Behavioral targeting objects.

Advertiser ID.

Age groups to target.

Promoted app ID. Required when `objective_type` is `APP_PROMOTION`.

Audience IDs to include.

Audience rule object. Valid only when `objective_type` is `TRAFFIC` or `WEB_CONVERSIONS`.

App retargeting audience type.

Pangle app block list IDs. Takes effect only when Pangle placement is selected.

Carrier IDs to target. A carrier is valid only when its `in_use` field is `true`, and selected carriers must be consistent with the targeted locations.

Business Center ID for catalogs owned in Business Center.

Catalog ID. Required when `objective_type` = `PRODUCT_SALES`.

Contextual tag IDs. This is an allowlist-only feature. Supported only when `objective_type` is `REACH` or `VIDEO_VIEWS`, and not supported when `brand_safety_type` is `THIRD_PARTY`.

Device model IDs to target. Only active device models (`is_active=True`) can be used. Do not set this field together with `device_price_ranges`.

Device price range targeting. Values must be multiples of 50. `10000` means 1000+. The upper limit you submit is increased by 50 and that result is used as the actual upper limit shown in TikTok Ads Manager; for example, `[0,250]` actually means `[0,300]`.

Audience IDs to exclude.

Exclude conditions for shopping ads retargeting audience filtering. When `shopping_ads_retargeting_type` is `LAB3`, you must provide either `included_custom_actions` or `excluded_custom_actions`.

Pangle audience package IDs to exclude. Valid only for Pangle placement. Do not specify this field together with `included_pangle_audience_package_ids`. Use `bind_type=EXCLUDE` when retrieving packages.

Gender to target.

Household income targeting. Supported only for Auction ad objectives, only on TikTok placement in the US, and cannot be used if `special_industries` is set at campaign level.

Include conditions for shopping ads retargeting audience filtering. When `shopping_ads_retargeting_type` is `LAB3`, you must provide either `included_custom_actions` or `excluded_custom_actions`.

Pangle audience package IDs to include. Valid only for Pangle placement. Do not specify this field together with `excluded_pangle_audience_package_ids`. Use `bind_type=INCLUDE` when retrieving packages.

General interest category IDs to target audiences.

Additional interest category IDs to target audiences.

iOS device targeting setting. When the campaign `campaign_type` is `IOS14_CAMPAIGN`, this field is required and must be `IOS14_PLUS`. `UNSET` is the default for ad groups created before this field existed. `IOS14_MINUS` targets iOS 14.4 and earlier and is the default for ad groups created after introduction of this field. `IOS14_PLUS` targets iOS 14.5 and above; each iOS 14 campaign can have up to 2 active ad groups. If `IOS14_PLUS` is specified, this field cannot be updated. If `IOS14_PLUS` is used, the system also validates related fields: `app_id` must not be an Android app, `operating_systems` must not be `ANDROID` or `PC`, `min_ios_version` must be provided and not conflict with `ios14_targeting`, `min_android_version` must not be provided, `optimization_goal` must be `CLICK`, `INSTALL`, `IN_APP_EVENT`, or `VALUE`, `shopping_ads_retargeting_type` and `shopping_ads_retargeting_actions_days` must not be provided, `conversion_window` must not be provided, and at the ad level `deeplink_type` must not be `DEFERRED_DEEPLINK`.

Internet service provider IDs to target. Valid only when `location_ids` includes a valid country- or region-level location. When `isp_ids` is provided, `placements` cannot be only `PLACEMENT_GLOBAL_APP_BUNDLE`.

Language codes to target. To avoid restricting language targeting, pass an empty value or omit this field.

Location IDs to target. You must provide `location_ids`, `zipcode_ids`, or both. Maximum 3,000 entries total across location IDs, zip code IDs, and postal code IDs in one ad group. Use /tool/region/ or /tool/targeting/search/ to retrieve valid IDs based on placement and objective. Overlapping targeted locations are not supported; for example, you cannot target the U.S. and California at the same time.

Minimum Android version.

Minimum iOS version.

Device connection types to target. Default is unlimited.

Advertising objective type.

Device operating systems to target. Only one value is allowed. Required when `objective_type` is `APP_PROMOTION`, or when `objective_type` is `TRAFFIC` and `promotion_type` is `APP_IOS` or `APP_ANDROID`.

Optimization goal.

Pixel ID for landing page scenarios. Must be passed together with `external_action`.

Placement type. `PLACEMENT_TYPE_NORMAL` means select placements manually; `PLACEMENT_TYPE_AUTOMATIC` means automatic placement. Default is `PLACEMENT_TYPE_NORMAL`.

Apps where ads would be delivered. Required when `placement_type` is `PLACEMENT_TYPE_NORMAL`, and ignored when `placement_type` is `PLACEMENT_TYPE_AUTOMATIC`. Supported values include `PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`, and `PLACEMENT_GLOBAL_APP_BUNDLE`. `PLACEMENT_GLOBAL_APP_BUNDLE` is only available for Brazil, Indonesia, Vietnam, the Philippines, Thailand, Malaysia, Mexico, Saudi Arabia, and Japan, and does not support `optimization_goal=TRAFFIC_LANDING_PAGE_VIEW`. When `objective_type` = `PRODUCT_SALES`, only `PLACEMENT_TIKTOK` is supported.

Product set ID in the catalog. `0` means all product sets. Default is `0`.

Product source for promotion. Required when `objective_type` = `PRODUCT_SALES`.

Promotion type. Required when `objective_type` = `PRODUCT_SALES`.

Purchase intention category IDs for audiences interested in purchases related to a content category. Do not pass this field together with `interest_keyword_ids`, or keyword conflict will occur. Supported only for Auction ads when `objective_type` is `APP_PROMOTION`, `WEB_CONVERSIONS`, `LEAD_GENERATION`, `TRAFFIC`, or `PRODUCT_SALES` with `product_source=CATALOG`, and placements include `PLACEMENT_TIKTOK` or `PLACEMENT_PANGLE`.

Required when `shopping_ads_retargeting_type` is `LAB1` or `LAB2`. Specifies the lookback window in days for the audience action. Allowed values: 1, 2, 3, 7, 14, 30, 60, 90, 180.

Shopping ads retargeting type. Valid only when `objective_type` is `PRODUCT_SALES`. `LAB1` retargets users who viewed products or added to cart but did not purchase. `LAB2` retargets users who added to cart but did not purchase. `LAB3` retargets using custom combinations. `OFF` disables retargeting.

Spending power targeting. `HIGH` targets users who typically spend more on TikTok ads than average users; `ALL` applies no special restriction. Not supported for campaign objectives `PRODUCT_SALES` and `RF_REACH`. Requires either `placement_type=PLACEMENT_TYPE_AUTOMATIC` or `placements` including `PLACEMENT_TIKTOK`; if Pangle is included, spending power targeting does not take effect on Pangle. Cannot be used with special industries targeting. When `auto_targeting_enabled` is `true`, this field is automatically set to `ALL`.

Zip code or postal code IDs to target. You must provide `location_ids`, `zipcode_ids`, or both. Maximum 3,000 combined entries across location IDs, zip code IDs, and postal code IDs in one ad group. Zip code targeting is supported only for the US. Postal code targeting is supported only for Canada, Brazil, Indonesia, Thailand, and Vietnam. Postal code targeting in Brazil, Indonesia, Thailand, and Vietnam is allowlist-only. `placements` must include `PLACEMENT_TIKTOK`. Overlapping targeted locations are not supported. Use /tool/targeting/search/ to find ZIP_CODE `geo_id` values and /tool/targeting/info/ to retrieve zip code or postal code details.