tool_vbo_status_check

Advertiser ID.

Promoted app ID. Not supported when `objective_type` is `PRODUCT_SALES` and `promotion_type` is `LIVE_SHOPPING` or `VIDEO_SHOPPING`, or when `app_promotion_type` is `MINIS`. Otherwise, pass either `pixel_id` or `app_id`.

Required when `objective_type` is `APP_PROMOTION`. App promotion type: `APP_INSTALL` for acquiring new app installs, `APP_RETARGETING` for re-engaging existing users in your app, and `MINIS` for TikTok Minis. Only `APP_INSTALL` can be used in an iOS14 Dedicated Campaign.

Attribution type for the Dedicated Campaign; determines whether ad-group target CPA or ROAS is based on SAN or SKAN. Valid only when all of the following are true: `objective_type` is `APP_PROMOTION`, `app_promotion_type` is `APP_INSTALL`, `campaign_type` is `IOS14_CAMPAIGN`, and `app_id` is an eligible iOS app ID. Check app eligibility with `/app/list/` and the returned `advanced_dedicated_campaign_allowed` field. Set this field as follows: when `is_advanced_dedicated_campaign` is `true` and you are not allowlisted for disabling SKAN attribution, use `SKAN`; when `is_advanced_dedicated_campaign` is `true`, you are allowlisted for disabling SKAN attribution, and `disable_skan_campaign` is `false`, use `SAN`; when `is_advanced_dedicated_campaign` is `true` and `disable_skan_campaign` is `true`, use `SAN`; when `is_advanced_dedicated_campaign` is `false` and `disable_skan_campaign` is `false`, use `SKAN`.

Whether to enable Campaign Budget Optimization (CBO).

Whether to use App Profile Page at the campaign level to optimize delivery. Valid only when `objective_type` is `APP_PROMOTION` and the campaign is an iOS14 Dedicated Campaign (`ios14_quota_type` = `OCCUPIED`); otherwise an error occurs.

Campaign automation type.

Campaign type. Do not pass `campaign_type` and `ios14_quota_type` together; if both are provided, `ios14_quota_type` is ignored. `IOS14_CAMPAIGN` is valid only when `objective_type` is `PRODUCT_SALES`, or when `objective_type` is `APP_PROMOTION` and `app_promotion_type` is `APP_INSTALL`.

Whether to disable SKAN attribution for an iOS Dedicated Campaign. Valid only when all of the following are true: `objective_type` is `APP_PROMOTION`, `app_promotion_type` is `APP_INSTALL`, `campaign_type` is `IOS14_CAMPAIGN`, and `app_id` is an eligible iOS app ID. Check app eligibility with `/app/list/` and the returned `advanced_dedicated_campaign_allowed` field. If `true`, SKAN attribution is disabled, Dedicated Campaign quota limits do not apply, and SAN metrics are available, but SKAN reporting metrics are not. If the app is eligible for Advanced Dedicated Campaigns, you cannot disable both SKAN attribution and Advanced Dedicated Campaign at the same time. If `false`, SKAN attribution is enabled; quota limits apply and SKAN metrics are available. If `false` and `is_advanced_dedicated_campaign` is also `true`, both SAN and SKAN reporting metrics are available. Disabling SKAN attribution for Dedicated Campaigns is an allowlist-only feature. If you are allowlisted for this feature, you still cannot set ad-group-level `bid_type` to `BID_TYPE_CUSTOM` when campaign-level `is_advanced_dedicated_campaign` is `false`, campaign-level `disable_skan_campaign` is `false`, and ad-group-level `optimization_goal` is `INSTALL` or `IN_APP_EVENT`. Once set, this field cannot be updated.

Whether the campaign is an Advanced Dedicated Campaign. Default is `false`. Once set, this field cannot be updated.

Advertising objective. Supported VBO objectives are `APP_PROMOTION`, `WEB_CONVERSIONS`, and `PRODUCT_SALES`; any other value causes `vo_status` to return `NOT_SUPPORT`. When `objective_type` is `PRODUCT_SALES` and `promotion_type` is `LIVE_SHOPPING` or `VIDEO_SHOPPING`, do not pass `pixel_id` or `app_id`; otherwise, pass either `pixel_id` or `app_id`.

Conversion event for the ad group. Required when `pixel_id` is passed and ignored when `app_id` is passed.

Pixel ID. Not supported when `objective_type` is `PRODUCT_SALES` and `promotion_type` is `LIVE_SHOPPING` or `VIDEO_SHOPPING`, or when `app_promotion_type` is `MINIS`. Otherwise, pass either `pixel_id` or `app_id`. If you pass `pixel_id`, you must also pass `optimization_event`.

Apps where ads will be delivered. Supported values are `PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`, and `PLACEMENT_GLOBAL_APP_BUNDLE`. When `objective_type` is `PRODUCT_SALES`, only `PLACEMENT_TIKTOK` is supported.

Promotion type that determines where products are promoted. When `objective_type` is `PRODUCT_SALES` and `promotion_type` is `LIVE_SHOPPING` or `VIDEO_SHOPPING`, do not pass `pixel_id` or `app_id`; otherwise, pass either `pixel_id` or `app_id`.

TikTok Shop ID. Valid only when `objective_type` is `PRODUCT_SALES`.