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

获取升级版 Smart+ 、Smart+ 和手动推广系列的数据

本指南概述了三种不同推广系列类型的数据层级：手动推广系列、Smart+ 推广系列和升级版 Smart+ 推广系列（也称为升级版 Smart+）。同时说明获取各推广系列类型数据的具体流程，确保你能全面了解它们的结构。

整体数据层级

升级版 Smart+ 推广系列将手动推广系列和 Smart+ 推广系列整合到一个简化的流程中，提供灵活的广告购买体验。借助这项改进，你可以通过不同层级的控制方式对推广系列进行优化调整，包括完全自动化、部分自动化或完全手动操作。

数据层级 手动推广系列 Smart+ 推广系列 升级版 Smart+ 推广系列
推广系列 ✅ ✅ ✅
广告组 ✅ ✅ ✅
广告 ✅ ⚠️（返回有限数据） ✅
创意 ❌ ✅ ✅

获取不同推广系列类型的数据

本小节将指导你分别获取手动推广系列、Smart+ 推广系列和升级版 Smart+ 推广系列的数据。

数据获取的整体情况

自动化类型 获取接口 报表 API
获取推广系列 获取广告组 获取广告
（升级版 Smart+ 中的素材组）		 获取创意 推广系列 广告组 广告
（升级版 Smart+ 中的素材组）		 创意
手动流程 ✅ /campaign/get/ ✅ /adgroup/get/ ✅ /ad/get/ N/A ✅ /report/integrated/get/
报表 API		 N/A
Smart+ API ✅ /campaign/get/
✅ /campaign/spc/get/		 N/A
（旧版 Smart+ 推广系列中没有广告组）		 ⚠️ /ad/get/
（返回有限数据）		 ✅ /campaign/spc/get/ ✅ /campaign/spc/report/get/
升级版 Smart+ API ✅ /campaign/get/
✅ /smart_plus/campaign/get/		 ✅ /adgroup/get/
✅ /smart_plus/adgroup/get/		 ✅ /smart_plus/ad/get/
⚠️ /ad/get/
（返回广告和创意层级的有限数据）

升级版 Smart+ 中的 ID：
素材组（第三层级）：
  • 当提取创意层级的数据时返回 smart_plus_ad_id，用于识别该创意所属的广告。
  • 当提取广告（素材组）层级的数据时返回 ad_id_v2，用于筛选和显示素材组层级的数据。
创意（第四层级）：ad_id		 ✅ /smart_plus/material_report/overview/
✅ /smart_plus/material_report/breakdown/

获取手动推广系列的数据

数据层级 通过推广系列管理 API 接口 通过报表 API 接口
推广系列 使用 /campaign/get/ 接口获取广告账号内的所有手动推广系列。
  • 可以选择在 campaign_ids 中传入最多 100 个手动推广系列 ID 以获取这些推广系列。
  • 返回的 campaign_automation_type 将为 MANUAL。
 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_CAMPAIGN，并在 dimensions 中包含 campaign_id。
广告组 使用 /adgroup/get/ 接口获取广告账号内的所有手动广告组。
  • 可以选择在 adgroup_ids 中传入最多 100 个手动广告组 ID 以获取这些广告组。
  • 返回的 campaign_automation_type 将为 MANUAL。
 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_ADGROUP，并在 dimensions 中包含 adgroup_id。
广告 使用 /ad/get/ 接口获取所有手动广告。
  • 可以选择在 ad_ids_v2（推荐）或 ad_ids 中传入最多 100 个手动广告 ID 以获取这些广告。
  • 返回的 campaign_automation_type 将为 MANUAL。返回的 ad_ids_v2 或 ad_id 表示手动广告 ID。
 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_AD，并在 dimensions 中包含 ad_id_v2（推荐）或 ad_id。
  • 可以选择在筛选条件 ad_ids_v2（推荐）或 ad_ids 中传入最多 100 个手动广告 ID 以获取这些广告的详细信息。
创意 ❌ ❌

获取 Smart+ 推广系列的数据

数据层级 通过推广系列管理 API 接口 通过 Smart+ API 接口 通过报表 API 接口
推广系列 使用 /campaign/get/ 接口并将 is_smart_performance_campaign 设置为 true，获取广告账号内的所有 Smart+ 推广系列。
  • 可以选择在 campaign_ids 中传入最多 100 个 Smart+ 推广系列 ID 以获取这些推广系列。
  • 返回的 campaign_automation_type 将为 SMART_PLUS。
 使用 /campaign/spc/get/ 接口，并在 campaign_ids 中传入最多 100 个 Smart+ 推广系列 ID，以获取这些推广系列的详细信息。

  • 注意：此接口不可用于获取你的广告账号内的所有 Smart+ 推广系列。

 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_CAMPAIGN，并在 dimensions 中包含 campaign_id。
广告组 使用 /adgroup/get/ 接口获取 Smart+ 推广系列中的所有广告组。
  • 可以选择在 adgroup_ids 中传入最多 100 个 Smart+ 推广系列中广告组的 ID 以获取这些广告组。
  • 返回的 campaign_automation_type 将为 SMART_PLUS。
 ❌ 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_ADGROUP，并在 dimensions 中包含 adgroup_id。
广告 使用 /ad/get/ 接口获取 Smart+ 推广系列中的所有广告。
  • 可以选择在 ad_ids 中传入最多 100 个 Smart+ 推广系列中广告的 ID 以获取这些广告。
  • 返回的 campaign_automation_type 将为 SMART_PLUS。
 ❌ 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_AD，并在 dimensions 中包含 ad_id。
创意 ❌ 使用 /campaign/spc/report/get/ 接口获取一个 Smart+ 推广系列的创意层级数据。 ❌

获取升级版 Smart+ 推广系列的数据

数据层级 通过推广系列管理 API 接口 通过升级版 Smart+ API 接口 通过报表 API 接口
推广系列 使用 /campaign/get/ 接口。
  • 可以选择在 campaign_ids 中传入最多 100 个升级版 Smart+ 推广系列 ID 以获取这些推广系列。
  • 返回的 campaign_automation_type 将为 UPGRADED_SMART_PLUS。
 使用 /smart_plus/campaign/get/ 接口获取广告账号内的所有升级版 Smart+ 推广系列。
  • 可以选择在 campaign_ids 中传入最多 100 个升级版 Smart+ 推广系列 ID 以获取这些推广系列。
 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_CAMPAIGN，并在 dimensions 中包含 campaign_id。
广告组 使用 /adgroup/get/ 接口。
  • 可以选择在 adgroup_ids 中传入最多 100 个升级版 Smart+ 广告组 ID 以获取这些广告组。
  • 返回的 campaign_automation_type 将为 UPGRADED_SMART_PLUS。
 使用 /smart_plus/adgroup/get/ 接口获取广告账号内的所有升级版 Smart+ 广告组。
  • 可以选择在 adgroup_ids 中传入最多 100 个升级版 Smart+ 广告组 ID 以获取这些广告组。
 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_ADGROUP，并在 dimensions 中包含 adgroup_id。
广告 使用 /ad/get/ 接口，并在筛选条件 ad_ids_v2 中传入最多 100 个升级版 Smart+ 广告 ID，以获取这些广告的详细信息。
  • 对于升级版 Smart+ 广告，返回的 campaign_automation_type 将为 UPGRADED_SMART_PLUS。
  • 返回的 ad_id_v2 表示升级版 Smart+ 广告 ID。
 使用 /smart_plus/ad/get/ 接口获取广告账号内的所有升级版 Smart+ 广告。
  • 可以选择在 smart_plus_ad_ids 中传入最多 100 个升级版 Smart+ 广告 ID 以获取这些广告。
 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_AD，并在 dimensions 中包含 ad_id_v2。
  • 可以选择在筛选条件 ad_ids_v2 中传入最多 100 个升级版 Smart+ 广告 ID，以获取这些广告的详细信息。
创意 使用 /ad/get/ 接口，不传入筛选条件 ad_ids_v2。
  • 对于升级版 Smart+ 广告中的创意，返回的 campaign_automation_type 将为 UPGRADED_SMART_PLUS_CREATIVE。
  • 返回的 ad_id 表示升级版 Smart+ 广告中创意的 ID，返回的 smart_plus_ad_id 表示升级版 Smart+ 广告 ID。
 使用 /smart_plus/material_report/overview/ 接口获取升级版 Smart+ 创意概览报表，或使用 /smart_plus/material_report/breakdown/ 接口获取升级版 Smart+ 创意细分报表。 使用 /report/integrated/get/ 接口获取同步报表，或使用 /report/task/create/ 接口获取异步报表。
  • 将 data_level 设置为 AUCTION_AD，并在 dimensions 中包含 ad_id。
  • 可以选择在筛选条件 ad_ids 中传入最多 100 个升级版 Smart+ 广告中创意的 ID，以获取这些创意的详细信息。
← 升级版 Smart+ 推广系列的兼容性变更TopView →

内容来源：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 每日平台更新简报 →