工具 API
dmp_
Creates a custom audience from rule-based inclusion criteria and optional exclusion criteria. Newly created audiences can take up to 48 hours to be analyzed before becoming active. Use /dmp/custom_audience/get/ to check audience status; only available audiences (`is_valid` = `true`) can be operated on. When an audience expires, it becomes unavailable (`is_valid` = `false`) and is detached from active campaigns. If a campaign has no targeting other than audience targeting, the campaign will be paused.
调用信息
- 工具标识
- tiktok-ads.dmp_custom_audience_rule_create
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
advertiser_id必填Advertiser ID.
audience_sub_typeAudience subtype indicating which ad type can use the audience. `NORMAL` is for non-Reach & Frequency ads. `REACH_FREQUENCY` can only be used in Reach & Frequency ads. Defaults to `NORMAL`.
audience_type必填Audience type. Determines valid rule inputs such as `event_source_ids`, identity fields, and filter values. `ENGAGEMENT`: engagement audience using ad groups as assets. `ENGAGEMENT_ORGANIC_VIDEO`: organic engagement audience using public videos; requires `identity_id` and `identity_type`. `ENGAGEMENT_LIVE_VIDEO`: live engagement audience using live videos; requires `identity_id` and `identity_type`. `APP`: app activity audience. `PIXEL`: website traffic audience. `LEAD_GENERATION`: lead generation audience; do not pass `event_source_ids` in rules or an error occurs. `BUSINESS_ACCOUNT`: business account audience. `TIKTOK_SHOP`: shop activity audience. `OFFLINE`: offline activity audience.
custom_audience_name必填Audience name. Length limit: 128 characters.
identity_authorized_bc_idBusiness Center ID associated with a TikTok Account User in Business Center identity. Required when `identity_type` is `BC_AUTH_TT`.
identity_idIdentity ID. Required when `audience_type` is `ENGAGEMENT_LIVE_VIDEO` or `ENGAGEMENT_ORGANIC_VIDEO`.
identity_typeIdentity type. Required when `audience_type` is `ENGAGEMENT_LIVE_VIDEO` or `ENGAGEMENT_ORGANIC_VIDEO`. If `identity_type` is `BC_AUTH_TT`, you must also provide `identity_authorized_bc_id`.
is_auto_refreshWhether to enable auto-refresh. Supported values: `true`, `false`. Defaults to `true`. When enabled, the audience automatically refreshes based on the lookback window you set; when disabled, it does not automatically refresh.
retention_in_daysNumber of days to retain the audience. Range: 1-365. If set, the audience expires this many days after creation and later operations cannot reset the expiration date. If omitted, expiration is 365 days from the last time the audience was applied to an active ad group or modified; applying it to an active ad group or modifying it resets expiration.
rule_spec必填Audience rule definition, containing a required inclusion rule set and an optional exclusion rule set.