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.
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
actionsList 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_idrequiredAdvertiser ID.
age_groupsAge groups to target.
audience_idsAudience IDs to include.
carrier_idsCarrier 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_idsDevice 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_rangesDevice 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_idsAudience IDs to exclude.
genderGender to target.
interest_category_idsInterest 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_idsInterest keyword IDs for audience targeting.
languagesLanguage codes to target. If you do not want to limit languages, pass an empty value or omit this field.
location_idsrequiredLocation 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_versionMinimum Android version to target.
min_ios_versionMinimum iOS version to target.
network_typesDevice connection types to target. Default: `unlimited`.
operating_systemsDevice operating systems to target. Only one value is allowed.
saved_audience_namerequiredSaved Audience name. Maximum 512 characters and cannot contain emoji.