工具 API
creative_
Gets recommended call-to-actions (CTAs) for ad creation or update. This endpoint supports two modes: when `new_version=false` or omitted, you request standard recommendations by `asset_type` and `content_type`; when `new_version=true`, you can retrieve Dynamic CTAs based on ad settings such as `objective_type`, `promotion_type`, `language`, `app_id`, `placements`, `region_codes`, `optimization_goal`, `ad_texts`, and `landing_page_url`. Compared with v1.2, v1.3 uses `/v1.3/creative/cta/recommend/`, replaces `external_type` with `content_type`, changes `advertiser_id` from number to string, adds the ad-setting-based parameters, and returns `asset_ids` as string[]. For background on Standard Recommended CTAs and Dynamic CTAs, see CTA recommendations: https://ads.tiktok.com/marketing_api/docs?id=1740307296329730.
调用信息
- 工具标识
- tiktok-ads.creative_cta_recommend_get
- 服务提供方
- TikTok 广告
- 平均响应
- 0 ms
- 近 7 天调用
- 0
输入参数
ad_textsValid only when `new_version` is `true`. List of ad texts shown as part of the ad creative. Each ad text must be 1-100 characters and cannot contain emoji. Each Chinese or Japanese word counts as two characters, and each English letter counts as one character. Recommended size: 1. Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
advertiser_id必填Advertiser ID.
app_idValid only when `new_version` is `true`. Application ID of the promoted app. Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
asset_typeRequired when `new_version` is `false` or omitted. Ignored when `new_version` is `true`. Asset type for recommendation retrieval.
content_typeRequired when `new_version` is `false` or omitted. Ignored when `new_version` is `true`. Ad content type. `MESSAGE` means a Lead Generation ad with promotion type as TikTok direct message; `SOCIAL_MEDIA_APP_MESSAGE` means a Lead Generation ad with promotion type as social media app; `PHONE_CALL` means a Lead Generation ad with promotion type as phone call.
landing_page_urlValid only when `new_version` is `true`. Landing page URL that users are redirected to. Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
languageValid only when `new_version` is `true`. Language code for the recommended CTAs. Default value: `en`. For example, if set to `fr`, the returned `asset_content` is in French.
new_versionWhether to use the new version that supports retrieving Dynamic CTAs based on your ad settings. Supported values: `true`, `false`. Default value: `false`.
objective_typeRequired when `new_version` is `true`. Not supported when `new_version` is `false` or omitted. Advertising objective.
optimization_goalValid only when `new_version` is `true`. The measurable result you want your ads to drive. Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
placementsValid only when `new_version` is `true`. Apps where you want to deliver your ads. Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.
promotion_typeRequired when `new_version` is `true`. Not supported when `new_version` is `false` or omitted. Promotion type (optimization location).
region_codesValid only when `new_version` is `true`. Codes of the regions you want to target. Example: `US`. Due to limited historical data for generating customized results, you might receive the same recommended CTAs even if you provide a different value for this field.