工具 API
smart_
Creates an Upgraded Smart+ ad. Checklist before calling: - `advertiser_id`, `adgroup_id` and `ad_name` are required. Pass `ad_name` as an empty string `""` to auto-generate the name; omitting the field fails. - `creative_info.ad_format=SINGLE_VIDEO` built from `video_info` requires exactly one `image_info` entry as the video cover. Omitting the cover fails. - Unless the creative references an existing TikTok post via `tiktok_item_id`, `ad_text_list` needs at least one `ad_text` of 1-100 characters without emojis. A Spark identity does not remove this requirement. - With a Spark identity (`TT_USER`, `BC_AUTH_TT`, `AUTH_CODE`) on an ad group that includes TikTok placement, the CTA must be `ad_configuration.call_to_action_id`: a CTA portfolio ID returned by `/creative/portfolio/create/` with `creative_portfolio_type=CTA`. `call_to_action_list` is rejected there whatever value it holds. - Non-Spark ads with `CUSTOMIZED_USER` identities are not supported on TikTok or Automatic placement; only Pangle-only and Global App Bundle ad groups accept them. Use a Spark identity elsewhere. Dependent resources: `/smart_plus/adgroup/get/` (placements, identity), `/creative/portfolio/create/` (CTA portfolio), `/file/video/ad/upload/`, `/file/image/ad/upload/`.
调用信息
- 工具标识
- tiktok-ads.smart_plus_ad_create
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
ad_configurationAdditional configurations.
ad_nameAd name. Always pass this field. If you want TikTok to auto-generate the name, pass an empty string (`""`); do not omit the field. Length limit: 512 characters, no emojis. Each Chinese or Japanese word counts as two characters; each English letter counts as one.
ad_text_listRequired when `tiktok_item_id` is not specified. List of ad texts shown with the ad creative. Max size: 5. Each item is an object, for example `[{"ad_text": "Shop the fall drop"}]`, not a bare string.
adgroup_id必填Ad group ID. Obtain valid IDs from `/smart_plus/adgroup/get/`.
advertiser_id必填Advertiser ID.
auto_message_listRequired when ad group `promotion_type` is `LEAD_GEN_CLICK_TO_TT_DIRECT_MESSAGE`. Automatic message details for TikTok Direct Messaging Ads. Max size: 1.
call_to_action_listCall-to-action list. Max size: 3. Rejected, whatever value it holds, when the creative uses a Spark identity (`TT_USER`, `BC_AUTH_TT`, `AUTH_CODE`) and the ad group includes TikTok placement, or when the campaign objective is `LEAD_GENERATION` on TikTok placement. In those cases leave this field out and pass `ad_configuration.call_to_action_id` (a CTA portfolio ID). Sending a different call-to-action value does not help.
creative_listList of creatives. Size range: 1-50.
custom_product_page_listCustom product page details. Valid only for iOS app retargeting campaigns as documented. Size range: 0-1.
deeplink_listList of deeplinks. Size range: 0-1.
disclaimerDisclaimer information. Valid only when campaign `objective_type` is `APP_PROMOTION` or `WEB_CONVERSIONS`, or when campaign `objective_type` is `LEAD_GENERATION` and `catalog_enabled` is `false` or omitted; and the ad group includes TikTok placement either by leaving placement fields unspecified for automatic placement or by setting `placement_type=PLACEMENT_TYPE_NORMAL` and including `PLACEMENT_TIKTOK` in `placements`. Once added to the ad, the disclaimer cannot be deleted.
interactive_add_on_listList of interactive add-on (creative portfolio) IDs. Size range: 0-1.
landing_page_url_listLanding page URL list. Size range: 0-1. Each item is an object, for example `[{"landing_page_url": "https://example.com/fall"}]`, not a bare string.
operation_statusStatus to apply when the ad is created. Defaults to `ENABLE`.
page_listList of pages. Size range: 0-3.
playable_listA list of playables.