← 返回目录
📁 Marketing API › Campaign Management › Guides › Campaign

复制手动推广系列

本文介绍如何复制手动推广系列。

如需复制升级版 Smart+ 推广系列,参见复制升级版 Smart+ 推广系列。

简介

借助推广系列复制功能,你可以高效地复制整个手动推广系列,包括多个广告组和广告。

你可以使用推广系列异步复制 API 来复制手动推广系列,同时根据需要调整推广系列、广告组和广告设置。这有助于节省时间,让你专注于优化整体广告策略。

前提条件

  • 你可以访问 TikTok API for Business。更多信息参见快速入门 - 具体步骤。
  • 若想复制推广系列,你需要具备相关权限。如需了解使用接口(包括步骤小节列出的接口)所需的权限,参见 API 参考。如需了解如何配置权限,参见更新应用权限范围。
  • 推广系列异步复制 API 目前为白名单功能。如需使用此功能,请联系你的 TikTok 销售代表。
  • 确保你的广告账号中有可供复制的现有广告。

步骤

  1. 确定要复制的手动推广系列、广告组和广告。

你可以使用 /campaign/get/、/adgroup/get/ 和 /ad/get/ 接口筛选符合条件的推广系列、广告组和广告。需确保满足以下要求。

注意
如果复制的推广系列中包含绑定了拆分对比测试的广告组,系统只会复制这些广告组本身,而不会创建与这些广告组关联的拆分对比测试组。

| 层级 {10%}| 设置 {18%}| 要求 {25%}| 参数 {22%}| 符合条件的配置{25%} |
|---|---|---|---|---|
| 推广系列 | 推广目标 | 使用以下任意类型: <ul><li> 覆盖人数 </li><li> 访问量 </li><li> 视频播放量 </li><li> 社区互动 </li><li> 应用推广 </li><li> 线索收集 </li><li> 网站转化量 </li></ul> <br><p><span style="color:darkred"><b>注意</b></span>:无法复制社区互动直播广告组。  | `objective_type` | 使用以下任意值: <ul><li>`REACH`</li><li>`TRAFFIC`</li><li>`VIDEO_VIEWS`</li><li>`ENGAGEMENT`</li><li> `APP_PROMOTION` </li><li>`LEAD_GENERATION` </li><li>`WEB_CONVERSIONS`</li></ul> <br><p><span style="color:darkred"><b>注意</b></span>:无法复制属于 `ENGAGEMENT` 推广系列且 `promotion_type` 为 `LIVE_SHOPPING` 的广告组。 |
| 推广系列 | Smart+ 推广系列 | 未启用 | `is_smart_performance_campaign` |  `false`  |
| 广告组 | 每个推广系列中要复制的未删除广告组数量。  | 1-20 | / | / |
| 广告组 | 程序化创意 (ACO) | 未启用 <br><br><p><span style="color:darkred"><b>注意</b></span>:可复制智能创意广告组。 | `creative_material_mode` | 使用以下任意值: <ul><li>`CUSTOM`</li><li>`SMART_CREATIVE`(智能创意广告组) </li></ul>  |
| 广告 | 每个广告组中要复制的未删除广告数量。 |<ul><li> 非 ACO、非智能创意广告组:1-50。</li><li> 智能创意广告组:无特定要求,因为每个广告组中至少已包含 1 个自动生成的广告。</li></ul>  | / | / |

示例

筛选未删除的非 SPC 应用推广推广系列

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/campaign/get/?advertiser_id={{advertiser_id}}&filtering={"primary_status": "STATUS_NOT_DELETE","objective_type":"APP_PROMOTION","is_smart_performance_campaign": false}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

筛选推广系列中未删除的非 ACO、非智能创意广告组

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/adgroup/get/?advertiser_id={{advertiser_id}}filtering={"campaign_ids":["{{campaign_id}}"],"primary_status":"STATUS_NOT_DELETE", "creative_material_mode":"CUSTOM"}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

筛选推广系列中未删除的智能创意广告组

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/adgroup/get/?advertiser_id={{advertiser_id}}&filtering={"campaign_ids":["{{campaign_id}}"],"primary_status":"STATUS_NOT_DELETE", "creative_material_mode":"SMART_CREATIVE"}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)

筛选广告组中未删除的广告

(code curl http)
curl --location  --request GET 'https://business-api.tiktok.com/open_api/v1.3/ad/get/?advertiser_id={{advertiser_id}}&filtering={"adgroup_ids":["{{adgroup_id}}"],"primary_status":"STATUS_NOT_DELETE"}&page=1&page_size=1000' \
--header 'Access-Token: {{Access-Token}}'
(/code)
  1. 使用 /campaign/copy/task/create/ 接口创建推广系列异步复制任务。 - 提供 campaign_id(从第 1 步获取的原推广系列 ID)、advertiser_id、request_id(用于防止重复请求),以及选择是否自定义推广系列设置(operation_status、campaign_name 和 budget)。 - (可选)使用 schedule_type、schedule_start_time 和选填的 schedule_end_time,为新建推广系列中所有广告组定义相同的排期。 - 默认复制模式和自定义复制模式均支持这些参数。但如果使用默认复制模式,并想复制投放开始时间比当前时间至少早 12 小时的广告组,建议为所有新建广告组定义新的排期。否则系统将报错,提示该排期开始时间已过,无法复制到新建广告组中。 - 通过 deep_copy_mode 传入复制模式。你可以从两种复制模式中选择: - 默认复制模式。在此模式下,系统会将原推广系列中所有未删除的广告组和广告复制到新建推广系列中。
    • 若想选择默认复制模式,需将 deep_copy_mode 设置为 DEFAULT 或省略 deep_copy_mode。
    • 请勿传入 adgroup_list、ad_list 和 smart_creative_info 字段,因为这些字段将被忽略。
    • 自定义复制模式。在此模式下,系统只会将原推广系列中传入的未删除广告组和广告复制到新建推广系列中。
    • 若想选择自定义复制模式,需将 deep_copy_mode 设置为 CUSTOM。
    • 对于非 ACO、非智能创意广告组,需提供 adgroup_list、adgroup_id 和 ad_list,以传入要复制的广告组和广告。你也可以选择自定义新建推广系列中广告组和广告的特定设置。请勿传入 smart_creative_info。
      • 下表列出了可自定义的广告组和广告设置。
| 层级 {15%}| 可自定义的设置 {40%}|
|---|---|
| 广告组 | <ul><li>`operation_status` </li><li>`adgroup_name` </li><li>`location_ids` </li><li>`zipcode_ids` </li><li>`audience_ids` </li><li>`excluded_audience_ids` </li><li>`budget`</li><li>`schedule_type` </li><li>`schedule_start_time` </li><li>`schedule_end_time` </li></ul>|
| 广告 |<ul><li> `operation_status` </li><li>`ad_name` </li><li>`identity_type` </li><li>`identity_id` </li><li>`identity_authorized_bc_id` </li><li>`video_id` </li><li>`image_ids` </li><li>`music_id` </li><li>`tiktok_item_id` </li><li>`ad_text` </li><li>`aigc_disclosure_type`</li><li>`tracking_pixel_id` </li><li>`tracking_app_id` </li></ul>|
  • 对于智能创意广告组,提供 adgroup_list 和 adgroup_id 以传入要复制的广告组。你还可以通过 smart_creative_info,自定义新建广告组中用于生成智能创意广告的广告创意。请勿传入 ad_list。
    • 除 is_smart_creative 以外,可通过 /ad/aco/create/ 接口传入的所有设置均可自定义。

每次可为一个推广系列创建一个复制任务。创建任务后,你将获得任务 ID (task_id)。

  1. 将从第 2 步获取的 task_id 传入 /campaign/copy/task/check/ 接口,查看推广系列异步复制任务的结果。

建议在任务创建后等待约 1 分钟,再查看任务结果。

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →