工具 API
campaign_
Enables, pauses, or deletes one or more campaigns via `/v1.3/campaign/status/update/`. Deleted campaigns cannot be modified afterward. In v1.3, `opt_status` was renamed to `operation_status`, `advertiser_id` changed to string, `campaign_ids` changed to string[], and `postback_window_mode` was added. You can use `/campaign/get/` to retrieve a campaign's current `operation_status`. For SKAN 4.0 dedicated campaigns, `postback_window_mode` can be configured only under specific conditions and, once set, cannot be updated.
调用信息
- 工具标识
- tiktok-ads.campaign_status_update
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
advertiser_id必填Advertiser ID.
campaign_ids必填List of campaign IDs to update. Allowed quantity range: `1-20`.
operation_status必填Operation to apply to the specified campaigns. Enum values: `DELETE` (delete), `DISABLE` (pause), `ENABLE` (enable). Deleted campaigns cannot be modified.
postback_window_modeValid only when all of the following are true: the campaigns in `campaign_ids` are Dedicated Campaigns (`campaign_type = IOS14_CAMPAIGN`), `operation_status` is `DISABLE`, `postback_window_mode` has not already been configured for the campaign, and SKAN 4.0 is enabled for the app. If `operation_status` is `ENABLE` or omitted and you also pass this field, the request errors. If SKAN 4.0 is not enabled for the app (`app_id`), passing this field causes an error. If omitted while `campaign_type = IOS14_CAMPAIGN`, `operation_status = DISABLE`, and SKAN 4.0 is enabled for the app, it defaults to `POSTBACK_WINDOW_MODE1`. Once set, this field cannot be updated. Configuration may be partially successful: non-Dedicated Campaigns, or Dedicated Campaigns that already have `postback_window_mode` configured, are ignored and not modified. Enum values: `POSTBACK_WINDOW_MODE1` secures the first postback (0-2 day attribution window) and may take up to 4 days, releasing campaign quota after 4 days; `POSTBACK_WINDOW_MODE2` secures the first two postbacks (3-7 day attribution window) and may take up to 13 days, releasing quota after 13 days; `POSTBACK_WINDOW_MODE3` secures all three postbacks (8-35 day attribution window) and may take up to 41 days, releasing quota after 41 days. If SKAN 4.0 is enabled, target iOS 16.1+ devices; to do that, set `min_ios_version` to `16.1` at the ad group level.