工具 API

search_ad_negative_keyword_add

Creates Search Ads negative keywords for campaigns or ad groups. If a user's search term matches a negative keyword, the ad in that campaign or ad group will not be shown. Before using this endpoint, Automatic Search Placement must already be enabled: for ad-group negative keywords, it must be enabled on the target ad group; for campaign negative keywords, it must be enabled for at least one ad group in the target campaign. See Create Search Ads: https://business-api.tiktok.com/portal/docs?id=1780164603696130.

ecommerceOAuth1 积分

调用信息

工具标识: tiktok-ads.search_ad_negative_keyword_add
服务提供方: TikTok 广告
平均响应: 0 ms
近 7 天调用: 0

输入参数

advertiser_id必填

Advertiser ID.

keywords必填

List of negative keywords to create. Max size: 1,000. For each ad group, you can configure a maximum of 10,000 negative keywords.

object_ids必填

Campaign IDs or ad group IDs to which the negative keywords will be applied. Max size: 50. Specify values according to `object_type`: if `object_type` is `CAMPAIGN`, provide campaign IDs; if `object_type` is `ADGROUP`, provide ad group IDs.

object_type必填

Specifies whether to create negative keywords for campaigns or ad groups. Use `CAMPAIGN` for campaigns or `ADGROUP` for ad groups. This value determines what IDs must be provided in `object_ids`.

replace

Whether to replace all existing negative keywords on the specified campaign or ad group with the values in `keywords`. `true` replaces all existing negative keywords; `false` adds new negative keywords. Default value: `false`.