创建升级版 Smart+ 推广系列异步复制任务
此接口可用于创建升级版 Smart+ 推广系列异步复制任务。
一次只能复制一个推广系列。如需了解详细步骤，参见复制升级版 Smart+ 推广系列。创建任务后，使用 /smart_plus/campaign/copy/task/check/ 接口查看结果。
注意
- 推广系列异步复制 API 目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。 - 此接口的频控限制为每个开发者应用每秒最多查询 1 次 (QPS) 和每分钟最多查询 30 次 (QPM)。全局频控限制不适用于此接口。
请求
地址 https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/copy/task/create/
方法 POST
Header
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://business-api.tiktok.com/portal/docs/marketing-api-authentication/v1.3)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许值：`application/json`。|
参数
|字段{35%}|类型{15%}|描述{50%}|
|---|---|---|
|advertiser_id {必填}|string|广告主 ID。|
|request_id {必填}|string|请求 ID 支持幂等处理，避免重复发送相同的请求。如果在 10 秒的缓存时间内，以相同的请求 ID 多次重复发送请求，仅其中 1 次请求会成功。如果在缓存时间过后收到使用过期请求 ID 的重复请求，服务器会将其视为新请求，并进行相应的处理。<br><br>请求 ID 不同于返回参数中的 `request_id`，后者用于唯一标识 HTTP 请求。<br><br>该值应为 64 位整数字符串形式。<br><br>示例：`"123456789"`。|
|campaign_id {必填}|string|要复制的升级版 Smart+ 推广系列的 ID。<br><br>若想获取广告账号内的升级版 Smart+ 推广系列，需使用 [/smart_plus/campaign/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-campaigns/v1.3) 接口。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>原推广系列必须使用以下任一推广目标：`APP_PROMOTION`、`LEAD_GENERATION`、`WEB_CONVERSIONS`</li><li>原推广系列不得被删除。</li><li>原推广系列必须至少包含 1 个未删除的广告组，且广告组必须至少包含 1 个未删除的广告。</li><li>原推广系列必须满足相应层级的所有限制要求，且已复制的素材总数不得超过针对新建推广系列的全局限制数量：<ul><li>在原推广系列中：最多可包含 10 个未删除的广告组，每个广告组最多可包含 30 个未删除的广告，每个广告最多可使用 50 个创意。</li><li>此外，新建推广系列必须满足全局限制要求：复制到新建推广系列的广告总数不得超过 200 个，创意总数不得超过 1,000 个。</li></ul></li></ul>|
|operation_status|string|新的推广系列创建时的状态。<br><br>枚举值：<ul><li>`ENABLE`：推广系列创建时处于已启用状态。</li><li>`DISABLE`：推广系列创建时处于未启用状态。</li></ul><br>默认值：`DISABLE`。<br><br>若想在创建推广系列后更新其状态，需使用 [/smart_plus/campaign/status/update/](https://business-api.tiktok.com/portal/docs/update-the-operation-statuses-of-upgraded-smart-campaigns/v1.3) 接口。|
|campaign_name|string|新建推广系列的名称。<br><br>长度限制：512 个字符。不支持使用表情符号。中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>如果不传入，此字段将默认为 `"COPIED_{{name_of_the_source_campaign}}"`。例如，如果原推广系列的名称为 `"FIRST_CAMPAIGN"`，且不传入此字段，新建推广系列的名称将为 `"COPIED_FIRST_CAMPAIGN"`。<br><br>|
|budget|number|新建推广系列的预算，或新建推广系列下所有广告组的预算限制。<ul><li>当原推广系列的 `budget_optimize_on` 为 `true` 时，此字段表示新建推广系列的固定预算或初始预算。<ul><li>当 `budget_auto_adjust_strategy` 为 `UNSET` 时，此字段表示新建推广系列的固定预算。</li><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，此字段表示新建推广系列的初始预算。若想获取当前的推广系列预算，需在复制任务完成后使用 [/smart_plus/campaign/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-campaigns/v1.3) 接口，并查看返回的 `current_budget`。</li></ul></li><li>当原推广系列的 `budget_optimize_on` 为 `false` 时，此字段表示该新建推广系列下所有广告组的预算限制。<ul><li>当 `budget_mode` 为 `BUDGET_MODE_DAY` 时，此字段表示该新建推广系列下所有广告组的日预算限制。</li><li>当 `budget_mode` 为 `BUDGET_MODE_TOTAL` 时，此字段表示该新建推广系列下所有广告组的总预算限制。</li></ul></li></ul><br>如果不传入，此字段将默认使用原推广系列的预算或原推广系列下所有广告组的预算限制。|
|schedule_type|string|<ul><li>仅在希望为新建推广系列中的所有广告组设置相同的排期时，才需传入此字段。</li><li>如果你希望在新建推广系列中沿用原广告组的排期，无需传入此字段。</li></ul><br>所有新建广告组的排期类型。<br><br>枚举值：<ul><li>`SCHEDULE_START_END`：设置投放广告组的开始时间和结束时间。需同时传入 `schedule_start_time` 和 `schedule_end_time`。</li><li>`SCHEDULE_FROM_NOW`：设置持续投放广告组的开始时间。只需传入 `schedule_start_time`，结束时间将自动设置为开始时间后 10 年。</li></ul>|
|schedule_start_time {+条件必填}|string|当传入 `schedule_type` 时必填。<br><br>所有新建广告组的排期开始时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。<br><br>开始时间最多可比当前时间早 12 小时，但不得晚于 `2028-01-01 00:00:00`。|
|schedule_end_time {+条件必填}|string|<ul><li>当 `schedule_type` 为 `SCHEDULE_START_END` 时，此为必填字段。</li><li>当 `schedule_type` 为 `SCHEDULE_FROM_NOW` 时，不支持此字段。</li></ul><br>所有新建广告组的排期结束时间 (UTC+0)，格式为 `YYYY-MM-DD HH:MM:SS`。<br><br>结束时间不得晚于 `2038-01-01 00:00:00`。|
|dayparting|string|<ul><li>仅在希望为新建推广系列中的所有广告组采用相同的广告投放安排时，才需传入此字段。</li><li>如果你希望在新建推广系列中沿用原广告组的广告投放安排，无需传入此字段。</li></ul><br>广告投放安排，格式为由 48 x 7 个字符组成的字符串。每个字符都对应星期一到星期日的一个 30 分钟的时间范围。每个字符可设为 0 或 1。1 表示在该 30 分钟时段投放，0 表示不投放。第一个字符对应星期一 0:01–0:30；第二个字符对应星期一 0:31–1:00；最后一个字符对应星期日 23:31–次日 0:00。<br><br><p><span style="color:darkred"><b>注意</b></span>：当该值全为 1 或不传入该字段时，均视为全时投放。|
|deep_copy_mode|string|复制模式，用于确定在新建推广系列中创建广告组和广告（素材组）的方式。<br><br>枚举值：<ul><li>`DEFAULT`：默认复制模式。将原推广系列中所有未删除的广告组和广告复制到新建推广系列中。你可以省略 `adgroup_list` 字段，因为在此模式下，API 会忽略该字段。</li><li>`CUSTOM`：自定义复制模式。只会将原推广系列中传入的未删除广告组和广告复制到新建推广系列中。你还可以自定义特定的广告组或广告设置，以覆盖原配置。<ul><li>使用这一模式时，你需要一并传入 `adgroup_list` 字段。每个广告组最多可复制 20 个广告，最多可复制 30 个广告组。</li></ul></li></ul> 默认值：`DEFAULT`。</li></ul>|
|adgroup_list|object[]|<ul><li>当 `deep_copy_mode` 设置为 `DEFAULT` 或不传入时，此字段将被忽略。</li><li>当 `deep_copy_mode` 设置为 `CUSTOM` 时，此字段必填。</li></ul><br>新建推广系列中广告组的自定义设置。<br><br>最大数量：10。|
#|adgroup_id {+条件必填}|string|当传入 `adgroup_list` 时必填。<br><br>要复制的广告组的 ID。该广告组应属于原推广系列 (`campaign_id`)。|
#|operation_status|string|新的广告组创建时的状态。<br><br>枚举值：<ul><li>`ENABLE`：广告组创建时处于已启用状态。</li><li>`DISABLE`：广告组创建时处于未启用状态。</li></ul><br>默认值：`ENABLE`。<br><br>若想在创建广告组后更新其状态，需使用 [/smart_plus/adgroup/status/update/](https://business-api.tiktok.com/portal/docs/update-the-operation-statuses-of-upgraded-smart-ad-groups/v1.3) 接口。|
#|adgroup_name|string|新建广告组的名称。<br><br>长度限制：512 个字符。不支持使用表情符号。<br>中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>如果不传入，此字段将默认使用原广告组的名称。|
#|budget|number|<ul><li>当推广系列层级未启用推广系列预算优化 (CBO)（`budget_optimize_on` 为 `false`）时生效。</li><li>当推广系列层级已启用 CBO（`budget_optimize_on` 为 `true`）时忽略。</li></ul><br>新建广告组的固定预算或初始预算。<ul><li>当原广告组的 `budget_auto_adjust_strategy` 为 `UNSET` 时，此字段表示新建广告组的固定预算。</li><li>当 `budget_auto_adjust_strategy` 为 `AUTO_BUDGET_INCREASE` 时，此字段表示新建广告组的初始预算。若想获取当前的广告组预算，需在复制任务完成后使用 [/smart_plus/adgroup/get/](https://business-api.tiktok.com/portal/docs/get-upgraded-smart-ad-groups/v1.3) 接口，并查看返回的 `current_budget`。</li></ul>|
#|min_budget|number|仅当满足以下所有条件时生效：<ul><li>在推广系列层级：<ul><li>`budget_optimize_on` 为 `true`</li><li>`budget_mode` 为 `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`</li></ul></li><li>在广告组层级：<ul><li>`bid_type` 为 `BID_TYPE_NO_BID`</li></ul></li></ul><br>广告组最低预算。<br><br>系统会尽量确保消耗至少达到该金额，但不作保证。|
#|targeting_spec|object|<ul><li>仅在希望为新建推广系列中的新建广告组自定义定向设置时，才需传入此字段。</li><li>如果你希望在新建推广系列中沿用原广告组的定向设置，无需传入此字段。</li></ul><br>定向设置。|
##|location_ids|string[]|新建广告组要定向的地域 ID。<br><br>若想根据你的广告位和推广目标获取可用地域及其对应 ID，需使用 [/tool/targeting/search/](1761236883355649.html) 或 [/tool/region/](1737189539571713.html) 接口。<br>如需获取地域 ID 列表，参见[地域 ID](1739311040498689.html)。 <br><br><p><span style="color:darkred"><b>注意</b></span>：如果你将美国添加为定向地域，那么在创建广告组后，将无法移除美国。|
##|zipcode_ids|string[]|你希望在新建广告组中用于定向地域的邮政编码 ID。<br><br>最大数量：3,000。如果你同时提供了 `location_ids` 和 `zipcode_ids`，每个广告组的地域 ID 和邮政编码 ID 的数量总和不得超过 3,000。<br><br>你可以通过从 [/tool/targeting/search/](1761236883355649.html) 接口返回的 `geo_id`（当 `geo_type` = `ZIP_CODE`），根据你的广告位、推广目标和关键词获取可用的邮政编码 ID。 <br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>邮政编码定向目前仅在美国、加拿大、巴西、印度尼西亚、泰国和越南可用。</li><li>在巴西、印度尼西亚、泰国和越南，邮政编码定向目前为白名单功能。如需使用此功能，请联系你的 TikTok 销售代表。</li><li>在已启用特殊广告类别 (`special_industries`) 的推广系列中，无法使用邮政编码定向。</li><li>不支持重叠的定向地域。例如，你无法同时定向美国和加利福尼亚州。</li><li>如果你在创建广告组时通过 `location_ids` 或 `zipcode_ids` 定向了美国地域，后续可以将这些 ID 更新为美国境内的其他地域，但不能移除所有美国地域以仅定向美国以外的国家/地区。</li><li>若想获取关于邮政编码 ID 的信息，只能使用 [/tool/targeting/info/](1761237001980929.html) 接口。</li></ul>|
##|excluded_audience_ids|string[]|要排除的受众 ID 列表。<br><br>若想获取受众 ID 列表，需使用 [/dmp/custom_audience/list/](1739940506015746.html) 接口。 <br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级传入 `rta_id` 时，不支持此字段。|
##|audience_ids|string[]|受众 ID 列表。<br><br>若想获取受众 ID，需使用 [/dmp/custom_audience/list/](1739940506015746.html) 接口。 <br><br><p><span style="color:darkred"><b>注意</b></span>：在推广系列层级传入 `rta_id` 时，不支持此字段。|
##|saved_audience_id|string|当同时满足以下条件时生效：<ul><li>原广告组的 `targeting_optimization_mode` 为 `MANUAL`。</li><li>在推广系列中不传入住房、就业或信贷的类别 (`specical_industries`)。</li><li>在广告组中选择了 TikTok 广告位（即 `placement_type` 设置为 `PLACEMENT_TYPE_AUTOMATIC`，<b>或</b> `placement_type` 设置为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 中包含 `PLACEMENT_TIKTOK`）。</li></ul><br>已保存受众 ID。<br><br>若想获取广告账号中已保存受众的列表，需使用 [/dmp/saved_audience/list/](1780154619404290.html) 接口。<br><br>在使用此字段之前，调用 [/dmp/saved_audience/create/](1780154541898754.html) 接口创建已保存受众，并从返回结果中获取已保存受众的 ID。已保存受众的关联广告主 ID 应与广告组中的广告主 ID 相同，否则系统将报错。<br><br>如果使用 `saved_audience_id` 来创建广告组，返回结果将包含已保存受众的 ID 及其中的定向选项。<br><br><p><span style="color:darkred"><b>注意</b></span>：<ul><li>在通过 [/dmp/saved_audience/create/](1780154541898754.html) 接口创建已保存受众时，你可以传入包括 `gender` 在内的不同定向选项。但是，请注意，如果你是基于已保存受众来创建广告组，必须避免同时设置 `saved_audience_id` 和已保存受众中定义的定向选项（如 `gender`）。</li><li>如果已保存受众中的定向设置与广告组中的定向设置相冲突，将以已保存受众中的设置为准。因此，广告组中有冲突的定向选项将被忽略。<ul><li>例如，如果你创建了已保存受众，其 `gender` 设置为 `GENDER_FEMALE`，然后使用该受众来创建广告组，并将 `gender` 指定为 `GENDER_MALE`，那么所创建的广告组将在性别定向配置中采用已保存受众中设置的值 `GENDER_FEMALE`。</li></ul></li><li>如果创建 `saved_audience_id` 时传入了 `age_groups`，[TikTok 广告的新增年龄定向限制](1788755983247362.html)中列出的针对不同推广目标的年龄限制规则同样适用。在广告组中使用已保存受众 (`saved_audience_id`) 之前，请先确认允许使用年龄定向设置。</li></ul>|
#|ad_list {+条件必填}|object[]|<ul><li>当 `deep_copy_mode` 设置为 `DEFAULT` 或不传入时，此字段将被忽略。</li><li>当 `deep_copy_mode` 设置为 `CUSTOM` 时，此字段必填。<ul><li>如果不希望自定义在新建广告组中生成的广告的设置，只需在此对象数组中传入 `ad_id`。</li><li>如果希望自定义在新建广告组中生成的广告的设置，在此对象数组中同时传入 `ad_id` 和其他参数。</li></ul></li></ul><br>新建广告组中的广告设置。<br><br>最大数量：30。<br><br><p><span style="color:darkred"><b>注意</b></span>：在新建推广系列中，最多可以传入 200 个广告。</p>|
##|smart_plus_ad_id {+条件必填}|string|当传入 `ad_list` 时必填。<br><br>要复制的广告的 ID。该广告应属于原广告组 (`adgroup_id`)。|
##|operation_status|string|新的广告创建时的状态。<br><br>枚举值：<ul><li>`ENABLE`：广告创建时处于已启用状态。</li><li>`DISABLE`：广告创建时处于未启用状态。</li></ul><br>默认值：`ENABLE`。<br><br>若想在创建广告后更新其状态，需使用 [/smart_plus/ad/status/update/](https://business-api.tiktok.com/portal/docs/update-the-operation-statuses-of-upgraded-smart-ads/v1.3) 接口。|
##|ad_name|string|新建广告的名称。<br><br>长度限制：512 个字符。不支持使用表情符号。中文或日文每个字计为两个字符，每个英文字母计为一个字符。<br><br>如果不传入，此字段将默认为 `"COPIED_{{name_of_the_source_ad}}_{{ID_of_the_source_ad}}"`。例如，如果原广告的名称为 `"FIRST_AD"`，广告 ID 为 1234567891234567，且不传入此字段，新建广告的名称将为 `"COPIED_FIRST_AD_1234567891234567"`。<br><br>|
##|creative_list|object[]|创意列表。数量范围：1-50。<br><br><p><span style="color:darkred"><b>注意</b></span>： <ul><li>如果提供此字段，它将替换新建广告中的所有现有创意。</li><li>自动添加的创意将被排除。这些创意包括：<ul><li>TikTok 创作者内容，来自 TikTok One、Content Suite 和授权 TikTok 帖子的创作者内容</li><li>你的自有内容，你之前使用过的来自关联 TikTok 账号和创意素材库的内容</li><li>为你生成的内容，例如混剪你的应用商店页面中的图片</li></ul></li><li>在新建推广系列中，最多可以传入 1,000 个创意。</li></ul>|
###|creative_info {+条件必填}|object|当传入 `creative_list` 时，此为必填字段。<br><br>创意信息。|
####|ad_format {+条件必填}|string|当传入 `creative_info` 时，此为必填字段。<br><br>广告样式。<ul><li>`SINGLE_VIDEO`：单视频广告。<ul><li>若想使用此样式，需传入以下任意一项：<ul><li>通过 `video_id` 传入视频，并通过 `web_uri` 传入视频封面。</li><li>通过 `tiktok_item_id` 传入 TikTok 视频帖子。</li></ul></li></ul></li><li>`CAROUSEL_ADS`：标准轮播。<ul><li>若想使用此样式，需传入以下任意一项：<ul><li>通过 `web_uri` 传入轮播图片，并通过 `music_id` 传入一首音乐。</li><li>通过 `tiktok_item_id` 传入 TikTok 照片帖子图片。</li></ul></li></ul> </li></ul><br><p><span style="color:darkred"><b>注意</b></span>：你可以将标准轮播广告复制到单视频广告中，也可以将单视频广告复制到标准轮播广告中。</p>|
####|video_info {+条件必填}|object|对于通过 Spark Ads 推送创建的 Spark Ads 单视频广告，此字段必填。<br><br>视频信息。|
######|video_id {+条件必填}|string|当传入 `video_info` 时，此为必填字段。<br><br>视频 ID。<br><br>若想上传视频并获取视频 ID，需使用 [/file/video/ad/upload/](1737587322856449.html) 接口。<br>若想搜索广告账号内的视频，需使用 [/file/video/ad/search/](1740050472224769.html) 接口。|
######|file_name|string|视频名称。|
####|image_info {+条件必填}|object[]|<ul><li>使用以下广告类型时，此为必填字段： <ul><li>通过 Spark Ads 推送创建的 Spark Ads 单视频广告。需传入视频封面。 </li><li>通过 Spark Ads 推送创建的 Spark Ads 标准轮播广告。需传入 1-35 张轮播图片。</li><li>[升级版 Smart+ 汽车广告](1843324618421314.html)中的商品库轮播广告。需传入 1 张图片作为片尾卡片图片。</li></ul></li><li>升级版 Smart+ 网站广告不支持商品库轮播广告。</li></ul><br>图片信息。|
######|web_uri {+条件必填}|string|当传入 `image_info` 时，此为必填字段。<br><br>图片 ID。<br><br>若想上传图片并获取图片 ID，需使用 [/file/image/ad/upload/](1739067433456642.html) 接口。<br>若想搜索广告账号内的图片，需使用 [/file/image/ad/search/](1740052016789506.html) 接口。|
####|music_info {+条件必填}|object|如果属于以下场景，此为必填字段：<ul><li>创建标准轮播广告时，包括：<ul><li>通过 Spark Ads 推送创建的 Spark Ads 标准轮播广告</li><li>通过 Spark Ads 提取创建的 Spark Ads 标准轮播广告</li></ul></li><li>当 `objective_type` 为 `WEB_CONVERSIONS` 或 `LEAD_GENERATION`，并且 `catalog_creative_toggle` 为 `true` 时。系统将自动生成商品库轮播广告。</li></ul><br>音乐信息。|
######|music_id {+条件必填}|string|当传入 `music_info` 时，此为必填字段。<br><br>轮播广告中使用的音乐的 ID。|
####|aigc_disclosure_type|string|是否开启 AIGC（人工智能生成内容）自主披露开关，标注广告包含 AI 生成内容。该开关开启后，当广告以完整形式展示时，将显示“广告主标记为 AI 生成”标签。<br><br>枚举值：<ul><li>`SELF_DISCLOSURE`：开启开关，声明广告包含 AI 生成内容。</li><li>`NOT_DECLARED`：不声明广告包含 AI 生成内容。默认值：`NOT_DECLARED`。</li></ul>|
####|tiktok_item_id {+条件必填}|string|<ul><li>通过 Spark Ads 提取创建 Spark Ads 时，此为必填字段，包括：<ul><li>通过 Spark Ads 提取创建的 Spark Ads 单视频广告。需传入 TikTok 视频帖子。</li><li>通过 Spark Ads 提取创建的 Spark Ads 标准轮播广告。需传入 TikTok 照片帖子。</li></ul></li><li>当 `catalog_creative_toggle` 为 `true` 时，不支持此字段。</li></ul><br>作为广告 (Spark Ads) 投放的 TikTok 帖子的 ID。<br><br>传入从 [/tt_video/info/](1738376324021250.html) 和 [/identity/video/get/](1740218475032577.html) 接口的返回结果中获取的 `item_id`。<br><br>在传入 `tiktok_item_id` 时，无需传入对象 `image_info`、`video_info` 和 `ad_text_list`。 <br><br><p><span style="color:darkred"><b>注意</b></span>：使用 Spark Ads，即表示你确认拥有将视频中的音乐用于商业用途的权利。|
####|identity_type {+条件必填}|string|当创建 Spark Ads 时，此为必填字段。<br><br>Spark Ads 的广告发布身份类型。<br><br>枚举值：`AUTH_CODE`、`TT_USER`、`BC_AUTH_TT`。<br><br>查看[广告发布身份](1738958351620097.html)文档，详细了解广告发布身份。|
####|identity_id {+条件必填}|string|当创建 Spark Ads 时，此为必填字段。<br><br>Spark Ads 的广告发布身份 ID。|
####|identity_authorized_bc_id {+条件必填}|string|当 `identity_type` 为 `BC_AUTH_TT` 时，此为必填字段。<br><br>与“添加到商务中心的 TikTok 用户”类型广告发布身份关联的商务中心 ID。|
##|ad_text_list {+条件必填}|object[]|当未指定 `tiktok_item_id` 时，此为必填字段。<br><br>广告文案列表。<br>广告文案作为广告创意的一部分展示给受众，用于传递你希望传达的信息。<br><br>最大数量：5。|
###|ad_text {+条件必填}|string|当传入 `ad_text_list` 时，此为必填字段。<br><br>广告文案。|
##|call_to_action_list {+条件必填}|object[]|行动引导文案列表。<br><br>最大数量：3。<br><br><p><span style="color:darkred"><b>注意</b></span>：在以下任意场景中，此字段不受支持，需改用 `call_to_action_id`。<ul><li>场景 1：<ul><li>在推广系列层级，`objective_type` 为 `LEAD_GENERATION`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li></ul></li><li>场景 2：<ul><li>推广系列层级的 `objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li><li>广告层级的 `creative_info` 对象内的 `identity_type` 设置为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`。</li></ul></li></ul>|
###|call_to_action {+条件必填}|string|当传入 `call_to_action_list` 时，此为必填字段。<br><br>行动引导文案。<br><br>枚举值参见[枚举值 - 行动引导文案](https://business-api.tiktok.com/portal/docs?id=1737174886619138#item-link-Call-to-action)。|
##|landing_page_url_list|object[]|落地页 URL 列表。<br><br>数量范围：0-1。|
###|landing_page_url {+条件必填}|string|当传入 `landing_page_url_list` 时，此为必填字段。<br><br>落地页 URL。|
##|ad_configuration|object|其他配置。|
###|utm_params|object[]|当推广系列层级的 `objective_type` 为 `WEB_CONVERSIONS` 时生效。<br><br>URL 参数列表。URL 参数是可添加到 URL 末尾的代码片段，帮助你通过第三方分析平台监测不同渠道的点击量，并了解访客与网站的互动方式。这类参数由键值对组成，通过 `key` 和 `value` 传入。<br><br>最大数量：14。<br><br>如果将 `landing_page_url` 设置为已包含 URL 参数的 URL，可选择同时传入 `utm_params` 以存储 URL 中使用的参数。在这一情况下，需确保 `utm_params` 与已使用的 URL 参数精确匹配。广告投放时，URL 参数不会自动附加到 `landing_page_url` 中。|
####|key|string|支持的 UTM 参数包括：<ul><li>`utm_source`：为你的网站引流的应用、网站等。示例：TikTok。</li><li>`utm_medium`：广告或营销媒介。示例：CPM、CPC、横幅、视频。</li><li>`utm_content`：用于推广的创意内容。示例：广告名称、CTA、素材、颜色等。</li><li>`utm_campaign`：单个推广系列名称、宣传语或促销码。示例：黑色星期五促销活动。注意：UTM 参数区分大小写。</li></ul><br>指定自定义参数时的长度限制：100 个字符。|
####|value|string|URL 参数的值。<br><br>你可以指定自定义值或宏名称。<br><br>支持的宏包括：<ul><li>`CAMPAIGN_NAME`：这将替换为你的推广系列名称。</li><li>`CAMPAIGN_ID`：这将替换为你的推广系列 ID。</li><li>`AID_NAME`：这将替换为你的广告组名称。</li><li>`AID`：这将替换为你的广告组 ID。</li><li>`CID_NAME`：这将替换为你的广告名称。</li><li>`CID`：这将替换为你的广告 ID。</li><li>`PLACEMENT`：这将替换为你的广告位。</li></ul><br>指定自定义值时的长度限制：600 个字符。|
###|call_to_action_id|string|在以下任意场景中生效：<ul><li>场景 1：<ul><li>推广系列层级的 `objective_type` 为 `LEAD_GENERATION`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li></ul></li><li>场景 2：<ul><li>推广系列层级的 `objective_type` 为 `APP_PROMOTION` 或 `WEB_CONVERSIONS`。</li><li>广告组层级的 `placement_type` 为 `PLACEMENT_TYPE_NORMAL` 且 `placements` 包含 `PLACEMENT_TIKTOK`，或 `placement_type` 为 `PLACEMENT_TYPE_AUTOMATIC`。</li><li>广告层级的 `creative_info` 对象内的 `identity_type` 设置为 `TT_USER`、`BC_AUTH_TT` 或 `AUTH_CODE`。</li></ul></li></ul><br>要在广告中使用的行动引导文案 (CTA) 素材包（也称为动态 CTA）的 ID。CTA 组合是一组自动优化的 CTA。<br><br>如需详细了解自动优化的 CTA，参见[智能推荐行动引导文案 > 动态优选行动引导文案](https://business-api.tiktok.com/portal/docs?id=1740307296329730#item-link-Dynamic%20CTAs%20)。|
示例
根据你是希望使用默认设置，还是在广告组或广告设置等不同层级应用自定义设置，你可以使用以下任意示例代码复制推广系列：
默认复制模式：完全复制原推广系列的所有设置
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": {{advertiser_id}},
"request_id": "{{request_id}}",
"campaign_id": "{{campaign_id}}"
}'
(/code)
默认复制模式：推广系列层级自定义设置，且新建广告组使用相同排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"request_id": "{{request_id}}",
"campaign_id": "{{campaign_id}}",
"operation_status": "ENABLE",
"campaign_name": "{{campaign_name}}",
"budget": {{budget}},
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"deep_copy_mode": "DEFAULT"
}'
(/code)
自定义复制模式：推广系列和广告组层级自定义设置，且新建广告组使用相同排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"request_id": "{{request_id}}",
"campaign_id": "{{campaign_id}}",
"operation_status": "ENABLE",
"campaign_name": "{{campaign_name}}",
"budget": {{budget}},
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"deep_copy_mode": "CUSTOM",
"adgroup_list": [
{
"adgroup_id": "{{adgroup_id}}",
"operation_status": "ENABLE",
"adgroup_name": "{{adgroup_name}}",
"budget": {{budget}},
"targeting_spec": {
"location_ids": [
"{{location_ids}}"
]
},
"ad_list": [
{
"smart_plus_ad_id": "{{smart_plus_ad_id}}"
}
]
}
]
}'
(/code)
自定义复制模式：推广系列、广告组和广告层级自定义设置，且新建广告组使用相同排期
(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/smart_plus/campaign/copy/task/create/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
"advertiser_id": "{{advertiser_id}}",
"request_id": "{{request_id}}",
"campaign_id": "{{campaign_id}}",
"operation_status": "ENABLE",
"campaign_name": "{{campaign_name}}",
"schedule_type": "SCHEDULE_START_END",
"schedule_start_time": "{{schedule_start_time}}",
"schedule_end_time": "{{schedule_end_time}}",
"deep_copy_mode": "CUSTOM",
"adgroup_list": [
{
"adgroup_id": "{{adgroup_id}}",
"operation_status": "ENABLE",
"adgroup_name": "{{adgroup_name}}",
"budget": {{budget}},
"targeting_spec": {
"location_ids": [
"{{location_ids}}"
]
},
"ad_list": [
{
"smart_plus_ad_id": "{{smart_plus_ad_id}}",
"operation_status": "ENABLE",
"ad_name": "{{ad_name}}",
"creative_info": {
"ad_format": "SINGLE_VIDEO",
"identity_type": "BC_AUTH_TT",
"identity_id": "{{identity_id}}",
"identity_authorized_bc_id": "{{identity_authorized_bc_id}}",
"image_info": [
{
"web_uri": "{{web_uri}}"
}
],
"video_info": {
"file_name": "{{file_name}}",
"video_id": "{{video_id}}"
}
},
"ad_text_list": [
{
"ad_text": "{{ad_text}}"
}
],
"ad_configuration": {
"call_to_action_id": "{{call_to_action_id}}"
}
}
]
}
]
}'
(/code)
返回
|字段{30%}|类型{15%}|描述{55%}|
|-|-|-|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|message |string|返回信息。更多信息参见[附录 - 返回码](https://business-api.tiktok.com/portal/docs/return-codes-appendix/v1.3)。|
|request_id|string| 请求的日志 ID，唯一标识一个请求。|
|data|object|返回数据。|
#|task_id|string|推广系列异步复制任务的 ID。<br><br>若想查看任务结果，需使用 [/smart_plus/campaign/copy/task/check/](https://business-api.tiktok.com/portal/docs/get-the-results-of-an-asynchronous-copy-task-for-an-upgraded-smart-campaign/v1.3) 接口。|
#|adgroup_error_list|object[]|特定广告组复制过程中出现的错误。|
##|adgroup_id|string|复制失败的广告组 ID。|
##|error_message|string|广告组 (`adgroup_id`) 复制过程中出现的错误。|
示例
(code curl http)
HTTPS/1.1 200 OK
{
"code": 0,
"message": "OK",
"request_id": "{{request_id}}",
"data": {
"task_id": "{{task_id}}"
}
}
(/code)