TOOL API

dmp_saved_audience_create

Creates a Saved Audience for an advertiser account using demographic, audience, interest, action, and device targeting criteria. An advertiser account can have up to 400 Saved Audiences.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.dmp_saved_audience_create
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

actions

List of action targeting objects. Within each object, `action_scene`, `action_period`, and `video_user_actions` are required; `action_category_ids` is also required when `actions` is specified and is valid only when TikTok placement is the only placement selected in your ad group.

advertiser_idrequired

Advertiser ID.

age_groups

Age groups to target.

audience_ids

Audience IDs to include.

carrier_ids

Carrier IDs to target. A carrier is valid only when its `in_use` field is `true`. Carriers must be consistent with the targeted `location_ids`.

device_model_ids

Device model IDs to target. Only active devices (`is_active = true`) from `/tool/device_model/` can be used. `device_model_ids` and `device_price_ranges` cannot be set at the same time.

device_price_ranges

Device price range to target. Values must be multiples of 50. `10000` means `1000+`. The upper limit you set is increased by 50 and that new number is used as the actual upper limit for targeting. For example, if you set and get `[0, 250]`, it actually means `[0, 300]`.

excluded_audience_ids

Audience IDs to exclude.

gender

Gender to target.

interest_category_ids

Interest category IDs. If specified, users who do not meet the interest target will be excluded during delivery. Omit this field if you want to target everyone.

interest_keyword_ids

Interest keyword IDs for audience targeting.

languages

Language codes to target. If you do not want to limit languages, pass an empty value or omit this field.

location_idsrequired

Location IDs to target. Overlapping targeted locations are not supported; for example, you cannot target the U.S. and the state of California at the same time.

min_android_version

Minimum Android version to target.

min_ios_version

Minimum iOS version to target.

network_types

Device connection types to target. Default: `unlimited`.

operating_systems

Device operating systems to target. Only one value is allowed.

saved_audience_namerequired

Saved Audience name. Maximum 512 characters and cannot contain emoji.