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

升级版 Smart+ 推广系列的兼容性变更

下表概述了升级版 Smart+ 推广系列在不同接口中的兼容性变更情况。

模块 接口 主要兼容性变更
推广系列 /campaign/get/
  • 默认返回升级版 Smart+ 推广系列。
  • 可通过请求和返回结果中的参数 campaign_automation_type 获取推广系列类型(手动推广系列、Smart+ 推广系列、升级版 Smart+ 推广系列)。
/campaign/create/ 这些接口不可用于创建、更新或复制升级版 Smart+ 推广系列。
应使用升级版 Smart+ 推广系列接口。
/campaign/update/
/campaign/copy/task/create/
广告组 /adgroup/get/
  • 默认返回升级版 Smart+ 广告组。
  • 可通过请求和返回结果中的参数 campaign_automation_type 识别广告组所属推广系列的类型(手动推广系列、Smart+ 推广系列、升级版 Smart+ 推广系列)。
/adgroup/create/ 这些接口不可用于创建或更新升级版 Smart+ 广告组。
应使用升级版 Smart+ 广告组接口。
/adgroup/update/
/adgroup/budget/update/
广告 /ad/get/
  • 可获取升级版 Smart+ 广告。
  • 可通过请求和返回结果中的参数 campaign_automation_type 获取广告所属推广系列的类型(手动推广系列、Smart+ 推广系列、升级版 Smart+ 推广系列)。
  • 你可以通过新的返回参数 smart_plus_ad_id 获取升级版 Smart+ 广告的广告 ID。
  • 你可以使用筛选条件 ad_ids_v2 高效筛选手动推广系列、Smart+ 推广系列和升级版 Smart+ 推广系列中的广告,确保有针对性地分析。
  • 使用返回参数 ad_id_v2 轻松识别手动推广系列、Smart+ 推广系列和升级版 Smart+ 推广系列中的特定广告。
  • 借助返回参数 campaign_automation_type 中新增的枚举值 UPGRADED_SMART_PLUS,你可以区分升级版 Smart+ 推广系列中的广告,从而进行有针对性的分析。
/ad/create/ 这些接口不可用于创建或更新升级版 Smart+ 广告。
应使用升级版 Smart+ 广告接口。
/ad/update/
广告预览 /creative/ads_preview/create/ 此接口不可用于预览升级版 Smart+ 广告。
应使用 /smart_plus/ad/preview/ 接口。
智能创意 /ad/aco/create/ 这些接口不可用于使用升级版 Smart+ 广告组创建或更新智能创意广告。
/ad/aco/update/
/ad/aco/material_status/update/
Smart+ /campaign/spc/create/ 这些接口不可用于创建、更新或获取升级版 Smart+ 推广系列。
应使用升级版 Smart+ 推广系列接口。
/campaign/spc/update/
/campaign/spc/get/
报告 /report/integrated/get/
  • 默认情况下,包含升级版 Smart+ 广告的创意数据。
  • 当使用筛选条件 ad_ids,并在 dimensions 中传入 ad_id 或将 data_level 设置为 AUCTION_AD 时,你可以获取升级版 Smart+ 广告数据(ad_id 表示创意 ID)。
  • 维度 ad_id_v2 现可用于为手动推广系列、Smart+ 推广系列和升级版 Smart+ 推广系列的广告分组。这有助于更细致地分析广告投放效果。
  • 通过与维度 ad_id_v2 相关的以下归因指标获取更深入的洞察:
    • ad_id_v2
    • ad_text_list
    • call_to_action_list
    • ad_profile_image_list
    • ad_url_list
    • image_mode_list
    • image_info_list
    • ad_display_name_list
    • identity_type_list
    • profile_image_list
  • 使用筛选条件 ad_id_v2 和 campaign_automation_type 高效筛选手动推广系列、Smart+ 推广系列和升级版 Smart+ 推广系列的数据,确保有针对性地分析。
/report/task/create/
/campaign/spc/report/get/ 此接口不可用于获取升级版 Smart+ 广告中创意的报告数据。
应使用 /smart_plus/material_report/overview/ 接口或 /smart_plus/material_report/breakdown/ 接口。
创意报告 /report/ad_benchmark/get/ 这些接口不可用于获取升级版 Smart+ 广告的创意报告数据。
/report/video_performance/get/
覆盖和频次 /adgroup/rf/create/ 这些接口不可用于创建、更新、取消或获取升级版 Smart+ 广告组的预估每日消耗和频次分布。
/adgroup/rf/update/
/adgroup/rf/order/cancel/
/adgroup/rf/estimated/info/
工具 /delivery/budget/recommend/ 这些接口不可用于获取升级版 Smart+ 广告组的预算和出价预估投放成效。
/delivery/bid/recommend/
/tool/vbo_status/ 可通过参数 campaign_automation_type 和请求参数 app_promotion_type 的 MINIS 值,查看创建升级版 Smart+ Minis 推广系列的设置是否符合价值优化的条件。
订阅 /subscription/subscibe/ 此接口不可用于订阅升级版 Smart+ 广告组或广告的审核或审美疲劳状态事件。
广告诊断 /tool/diagnosis/get/ 此接口不可用于获取升级版 Smart+ 广告组的诊断。
广告评论 /comment/list/ 不可获取评论所涉升级版 Smart+ 广告的广告 ID、广告名称、广告组 ID 和广告组名称。
/comment/post/ 这些接口不可用于以下目的:
  • 回复升级版 Smart+ 广告的评论
  • 删除升级版 Smart+ 广告的评论
  • 为升级版 Smart+ 广告组创建评论导出任务
/comment/delete/
/comment/task/create/
自动规则 /optimizer/rule/create/ 这些接口不可用于以下目的:
  • 为升级版 Smart+ 推广系列、广告组和广告创建自动规则
  • 为升级版 Smart+ 推广系列、广告组和广告更新自动规则
  • 为升级版 Smart+ 推广系列、广告组和广告绑定或解绑自动规则
/optimizer/rule/batch_bind/
/optimizer/rule/update/
创意工具 /creative_fatigue/get/ 此接口不可用于获取升级版 Smart+ 广告的创意审美疲劳检测结果。

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