TOOL 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 credits

Call information

Tool slug
tiktok-ads.smart_plus_campaign_status_update
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

advertiser_idrequired

Advertiser ID.

campaign_idsrequired

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

operation_statusrequired

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.