TOOL API

smart_plus_ad_preview

Previews an Upgraded Smart+ ad before creation or previews an existing Upgraded Smart+ ad. Use `preview_type=ADS_CREATION` to preview from ad-creation parameters, or `preview_type=AD` to preview an existing ad by `smart_plus_ad_id`. This endpoint depends on assets and IDs from other APIs, including catalog, product set, product, video, image, TikTok post, and existing Smart+ ad lookup endpoints.

ecommerceOAuth1 credits

Call information

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

Input parameters

ad_configuration

Additional preview configuration.

ad_text_list

Required when `tiktok_item_id` is not specified. List of ad texts shown to the audience as part of the creative. Max size: 5.

advertiser_idrequired

Advertiser ID.

call_to_action_list

Call-to-action list. Max size: 3. Not supported for Upgraded Smart+ Lead Generation Campaigns. The preview link displays only the first call-to-action in the list.

catalog_authorized_bc_id

Required when `catalog_enabled` is `true`. Business Center ID that owns `catalog_id`.

catalog_enabled

Whether to use catalog in the campaign. Supported values: `true`, `false`.

catalog_id

Required when `catalog_enabled` is `true`. Catalog ID to use in the ad group.

creative_list

List of creatives to preview. Size range: 1 to 31.

preview_typerequired

Preview mode. `ADS_CREATION` previews an ad from creation parameters. `AD` previews an existing ad and requires `smart_plus_ad_id`.

smart_plus_ad_id

Required when `preview_type` is `AD`. Upgraded Smart+ ad ID to preview.