智能推荐行动引导文案
您可以使用本接口获取智能推荐行动引导文案。您可以使用系统推荐的行动引导文案，创建或更新广告。
请在智能推荐行动引导文案中查看两种智能推荐行动引导文案（标准推荐行动引导文案和动态优选行动引导文案）的介绍。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/creative/recommend_asset/get/|/v1.3/creative/cta/recommend/|
|请求参数名称|external_type|content_type|
|请求参数类型|advertiser_id: number |advertiser_id: string|
|新增请求参数 |/ |new_version<br>objective_type<br>promotion_type<br>language<br>app_id<br>placements<br>region_codes<br>optimization_goal<br>ad_texts<br>landing_page_url|
|返回参数名称和类型|asset_id: number[] |asset_ids`: string[]|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/creative/cta/recommend/
**方法** GET
**Header**
``` xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
参数
|字段|类型|描述|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
| new_version| boolean | 是否使用此接口的新版本，从而根据广告设置获取动态优选行动引导文案。<br><br>支持的值：`true`，`false`。<br> 默认值：`false`。 |
| asset_type {+条件必填} | string | <ul><li>`new_version` 为 `false`或未传入时必填本字段。</li><li>`new_version` 为 `true` 时忽略本字段。 </li></ul> <br> 资产类型。 <br><br>枚举值： <ul><li>`CTA_NORMAL`：标准推荐行动引导文案。 </li><li>`CTA_AUTO_OPTIMIZED`：动态优选行动引导文案。</li></ul>|
|content_type {+条件必填} |string|<ul><li>`new_version` 为 `false`或未传入时必填本字段。</li><li>`new_version` 为 `true` 时忽略本字段。 </li></ul> <br> 广告内容类型。<br><br>枚举值：<ul><li>`APP_DOWNLOAD`：应用下载。</li><li>`LANDING_PAGE`：落地页。</li><li>`OTHER`：其他。</li><li>`MESSAGE` ：推广对象类型为 TikTok 私信的线索广告。</li><li>`SOCIAL_MEDIA_APP_MESSAGE`：推广对象类型为社交媒体应用的线索广告。</li><li>`PHONE_CALL`：推广对象类型为电话通话的线索广告。</li></ul>|
| objective_type {+条件必填} | string | <ul><li>`new_version` 为 `true` 时必填本字段。</li><li>`new_version` 为 `false` 或不传入时不支持本字段。 </li></ul> <br> 推广目标。 <br><br>枚举值及相关介绍参见[推广目标](1737585562434561.html)。 |
| promotion_type {+条件必填} | string |<ul><li>`new_version` 为 `true` 时必填本字段。</li><li>`new_version` 为 `false` 或不传入时不支持本字段。 </li></ul> <br> 推广对象类型（优化位置）。 <br><br>枚举值详见[枚举值-推广对象类型](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-%E6%8E%A8%E5%B9%BF%E5%AF%B9%E8%B1%A1%E7%B1%BB%E5%9E%8B)。 |
| language | string | 仅当 `new_version` 为 `true` 时生效。<br><br>推荐的行动引导文案的语言代码。<br><br>若想获取语言代码列表，可使用[/tool/language/](https://ads.tiktok.com/marketing_api/docs?id=1737188554152962)。 <br><br> 默认值：`en`。<br><br>例如，若您将本字段设置为 `fr`，返回的 `asset_content` 将为法语文案。 |
| app_id | string | 仅当 `new_version` 为 `true` 时生效。<br><br>推广的应用的 ID。 <br><br>若想获取您的广告账户中的应用列表，可使[/app/list/](1740859313270786.html)。<br><br><p><span style="color:darkred"><b>注意</b></span>：由于用于生成个性化推荐结果的历史数据有限，可能在您为本字段指定不同值时，仍获取到相同的推荐行动引导文案。 |
| placements | string[] | 仅当 `new_version` 为 `true` 时生效。 <br><br>版位（广告位），即广告投放的应用。<br><br>枚举值：<ul><li>`PLACEMENT_TIKTOK`：TikTok。</li><li>`PLACEMENT_PANGLE`：Pangle。</li><li> `PLACEMENT_GLOBAL_APP_BUNDLE`：全球化应用组合。</li></ul><br><p><span style="color:darkred"><b>注意</b></span>：由于用于生成个性化推荐结果的历史数据有限，可能在您为本字段指定不同值时，仍获取到相同的推荐行动引导文案。 |
| region_codes | string[] | 仅当 `new_version` 为 `true` 时生效。<br><br> 想要定向的地域的地区代码。 <br><br>枚举值参见[地区代码](1737585867307010.html)。<br><br> 示例：`US`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：由于用于生成个性化推荐结果的历史数据有限，可能在您为本字段指定不同值时，仍获取到相同的推荐行动引导文案。 |
| optimization_goal | string | 仅当 `new_version` 为 `true` 时生效。 <br><br>优化目标。<br><br>若想查看完整的枚举值，请参阅[枚举值 - 优化目标](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-%E4%BC%98%E5%8C%96%E7%9B%AE%E6%A0%87)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：由于用于生成个性化推荐结果的历史数据有限，可能在您为本字段指定不同值时，仍获取到相同的推荐行动引导文案。 |
| ad_texts | string[] | 仅当 `new_version` 为 `true` 时生效。<br><br>广告文案列表。<br>广告文案将作为广告创意的一部分展示给受众，向他们传达您想要推广的信息。<ul><li>广告文案长度允许值为 1-100 字符，不能包含表情符号。</li><li> 中文或日文每个字占用 2 个字符，每个英语字符占用 1 个字符。</li></ul><br>推荐数量：1。<br><br>若不知道如何创作有效的广告文案，可尝试[智能文案](1739084248002626.html)功能，根据行业和语言生成推荐的广告文案。 <br><br><p><span style="color:darkred"><b>注意</b></span>：由于用于生成个性化推荐结果的历史数据有限，可能在您为本字段指定不同值时，仍获取到相同的推荐行动引导文案。 |
| landing_page_url | string | 仅当 `new_version` 为 `true` 时生效。<br><br>用户跳转至的落地页。<br><br><p><span style="color:darkred"><b>注意</b></span>： 由于用于生成个性化推荐结果的历史数据有限，可能在您为本字段指定不同值时，仍获取到相同的推荐行动引导文案。 |
示例
基于广告设置获取推荐行动引导文案
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/creative/cta/recommend/?advertiser_id={{advertiser_id}}&new_version=true&objective_type=WEB_CONVERSIONS&promotion_type=WEBSITE&language=en' \
--header 'Access-Token: {{Access-Token}}'
(/code)
不基于广告设置获取推荐行动引导文案
(code curl http)
curl --location --request GET 'https://business-api.tiktok.com/open_api/v1.3/creative/cta/recommend/?advertiser_id={{advertiser_id}}&asset_type=CTA_AUTO_OPTIMIZED&content_type=APP_DOWNLOAD' \
--header 'Access-Token: {{Access-Token}}'
(/code)
返回
|字段|类型|描述|
|---|---|---|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|data |object|返回数据。|
#|recommend_assets|object[]| 推荐资产。 |
##|asset_ids|string[]|推荐行动引导文案的资产ID。|
##|asset_content|string|行动引导文案的文案内容。例如，`"Learn More"`。|
|request_id |string|请求日志 ID。|
示例
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"recommend_assets": [
{
"asset_ids": [
"201902",
"201404"
],
"asset_content": "Download now"
},
{
"asset_ids": [
"202114",
"201743"
],
"asset_content": "Install now"
},
{
"asset_ids": [
"201850",
"201352"
],
"asset_content": "Install app"
},
{
"asset_ids": [
"202141",
"201716"
],
"asset_content": "Enroll today"
},
{
"asset_ids": [
"201899",
"201401"
],
"asset_content": "Check it now"
},
{
"asset_ids": [
"201808",
"201598"
],
"asset_content": "Check in app"
},
{
"asset_ids": [
"201836",
"201628"
],
"asset_content": "Try this new app"
},
{
"asset_ids": [
"202116",
"201740"
],
"asset_content": "Install app now"
},
{
"asset_ids": [
"201934",
"202158"
],
"asset_content": "Download"
},
{
"asset_ids": [
"202124",
"201733"
],
"asset_content": "Install it now"
}
]
}
}
(/code)