工具 API
dmp_
Applies a custom audience to, or disconnects a custom audience from, multiple ad groups. This endpoint operates on ad groups under a single advertiser account. When applying an audience, you must also specify whether the audience should be included or excluded. Lookalike Audiences cannot be used with Reach & Frequency ads: an error occurs if `custom_audience_id` is a Lookalike Audience and any `adgroup_ids` are Reach & Frequency ad groups, or if `custom_audience_id` is a Lookalike Audience with the `REACH_FREQUENCY` audience subtype.
调用信息
- 工具标识
- tiktok-ads.dmp_custom_audience_apply
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
action_mode必填Operation to perform on the audience. `Apply` applies the audience to the specified ad groups and requires `usage_mode` to specify whether the audience is included or excluded. `Disconnect` removes the audience from the specified ad groups and does not require `usage_mode`.
adgroup_ids必填List of ad group IDs to which the audience will be applied or from which it will be disconnected. `adgroup_ids` and `custom_audience_id` must belong to the same advertiser account, or an error occurs. Lookalike Audiences cannot be used in Reach & Frequency ads: an error occurs if `custom_audience_id` is a Lookalike Audience and any listed ad groups are Reach & Frequency ad groups, or if `custom_audience_id` is a Lookalike Audience with the `REACH_FREQUENCY` audience subtype.
advertiser_id必填Advertiser ID.
custom_audience_id必填Custom audience ID to apply or disconnect. Only one custom audience ID can be passed.
usage_modeWhether to include or exclude the audience in the specified ad groups. Required when `action_mode` is `Apply`.