工具 API

smart_plus_campaign_status_update

Enables, pauses, or deletes Upgraded Smart+ campaigns through `/smart_plus/campaign/status/update/`. For Dedicated Campaigns (`campaign_type=IOS14_CAMPAIGN`), you can also configure `postback_window_mode` when disabling campaigns to secure SKAN 4.0 postbacks. This SKAN setting applies only if the campaign is a Dedicated 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 eligible Dedicated Campaigns are mixed with ineligible campaigns, the postback window configuration can be partially successful: ineligible campaigns are ignored and their `postback_window_mode` is not changed. Deleted campaigns cannot be modified.

ecommerceOAuth1 积分

调用信息

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

输入参数

advertiser_id必填

Advertiser ID.

campaign_ids必填

IDs of the campaigns to operate on. Size range: 1-20.

operation_status必填

Operation to perform on the campaigns. `DELETE` deletes campaigns, `DISABLE` pauses campaigns, and `ENABLE` enables campaigns. Deleted campaigns cannot be modified.

postback_window_mode

Valid 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 (`app_id`). If `operation_status` is `ENABLE` or this field is passed without meeting the SKAN 4.0 requirement, an error occurs. 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`. Configuration can be partially successful: non-Dedicated Campaigns and Dedicated Campaigns that already have `postback_window_mode` configured are ignored and not modified. To receive SKAN 4.0 postbacks, target iOS 16.1+ devices by setting ad-group-level `min_ios_version` to `16.1`. `POSTBACK_WINDOW_MODE1` secures the first postback (0-2 day attribution window) and may delay quota release up to 4 days. `POSTBACK_WINDOW_MODE2` secures the first two postbacks (3-7 day attribution window) and may delay quota release up to 13 days. `POSTBACK_WINDOW_MODE3` secures all three postbacks (8-35 day attribution window) and may delay quota release up to 41 days.