内容加热推广系列

内容加热（Promote）是 TikTok 应用内的广告工具，可以帮助您增加视频的曝光度，为您的网站导流，增加您的涨粉机会。当您在 TikTok 移动应用中为一个视频启用内容加热功能后，将自动生成一个包含一个内容加热广告组和一个内容加热广告的内容加热推广系列。

若想了解 TikTok 上的 Promote 功能以及如何设置 Promote 视频，请查看 Use Promote to grow your TikTok audience （使用推广增加您的 TikTok 受众）。

支持功能范围

下表概括了 API 中支持的内容加热广告功能。

注意
商务中心接口不支持内容加热广告。

| 功能 {30%}| API 中是否支持 {20%}|相关接口{50%} |
|---|---|---|
| 创建内容加热推广系列、广告组、广告 | ❌ |<ul><li> /campaign/create/</li><li>/adgroup/create/ </li><li>/ad/create/ </li></ul> |
| 更新内容加热推广系列、广告组、广告 | ❌ | <ul><li>/campaign/update/</li><li>/campaign/status/update/ </li><li>/adgroup/update/</li><li>/adgroup/status/update/</li><li>/adgroup/budget/update/</li><li>/ad/update/ </li><li>/ad/status/update/</li></ul> |
| 获取内容加热推广系列、广告组、广告 | ✅ | <ul><li>[/campaign/get/](1739315828649986.html)</li><li> [/adgroup/get/](1739314558673922.html)</li><li>[/ad/get/](1735735588640770.html)</li></ul> |
| 请求同步及异步基础报表和受众报表 | ✅ |<ul><li>[/report/integrated/get/](1740302848100353.html)</li><li>[/report/task/create/](1740302766489602.html) </li><li> [/report/task/check/](1740302781443073.html)</li><li>[/report/task/download/](1740302808815618.html)</li></ul>  |
| 预览内容加热广告 | ❌ | <ul><li>/creative/ads_preview/create/</li></ul> |
| 创建及绑定自动规则  | ❌ | <ul><li>/optimizer/rule/create/</li><li>/optimizer/rule/update/ </li><li>/optimizer/rule/batch_bind/ </li></ul> |
| 更改日志| ❌ |<ul><li>/changelog/task/create/</li></ul>  |
| 广告评论| ❌ |<ul><li>/comment/list/</li></ul>  |
| 否定关键词| ❌ |<ul><li>/search_ad/negative_word/add/</li><li>/search_ad/negative_word/update/</li></ul>   |

内容加热广告的状态

若想了解内容加热广告在推广系列、广告组和广告层级的状态，请查看一级状态下所支持的二级状态 - 内容加热推广系列。

支持的内容加热广告筛选条件

下表概括了 /campaign/get/， /adgroup/get/ 和 /ad/get中支持的内容加热广告筛选条件。需注意这些接口中默认筛除内容加热广告的数据（campaign_system_origins 默认设置为 ["TT_ADS_PLATFORM"]）。若想检索内容加热广告的数据，可将 campaign_system_origins 设置为["PROMOTE"] 。

内容加热广告的报表数据

您可为内容加热广告生成推广系列、广告组或广告层级的基础报表或受众报表。需注意同步基础报表和同步受众报表中默认筛除内容加热广告的报表数据（filtering 中 campaign_system_origins 默认设置为 "[\"TT_ADS_PLATFORM\"]"）。若想检索内容加热广告的同步报表数据，您可以在请求 /report/integrated/get/时手动将 filtering 设置为[{"field_name":"campaign_system_origins","filter_type": "IN","filter_value": "[\"PROMOTE\"]"}]。异步基础报表和异步受众报表中不会默认筛除内容加热广告的报表数据，您无需额外设置筛选条件便可获取内容加热广告的异步报表数据。

支持的维度

下表列出了内容加热广告支持的报表维度。若想了解维度的详细描述，请查看基础报表 - 支持的维度和受众报表 - 支持的维度。

| 维度 {40%} | 基础报表中是否支持？  {30%}| 受众报表中是否支持？  {30%}|
|---|---|---|
| `advertiser_id` | ✅ | ✅ |
| `campaign_id` | ✅ | ✅ |
| `adgroup_id` | ✅ | ✅ |
| `ad_id` | ✅ | ✅ |
| `stat_time_day` | ✅ | ✅ |
| `gender` | ❌ | ✅ |
| `age` | ❌ | ✅ |
| `country_code` | ❌ | ✅ |
| `province_id` | ❌ | ✅ |
| `dma_id` | ❌ | ✅ |
| `ac` | ❌ | ✅ |
| `platform` | ❌ | ✅ |
| `interest_category` | ❌ | ✅ |
| `placement` | ❌ | ✅ |
| `ad_type` | ❌ | ✅ |
| `device_brand_id` | ❌ | ✅ |

支持的指标

下表列出了内容加热广告支持的报表指标。若想了解指标的详细描述，请查看基础报表 - 支持的指标和受众报表 - 支持的指标。

注意
若您请求不支持的指标，结果中可能不会包含有意义的数据。例如，"vta_app_install"指标的值可能返回"0"。

| 字段 {30%} | 描述 {30%} | 基础报表中是否支持？ {20%} | 受众报表中是否支持？ {20%} |
|---|---|---|---|
| 属性指标   |  | |  |
#| `advertiser_name` | 账户名称 | ✅ | ✅ |
#| `advertiser_id` | 账户 ID | ✅ | ✅ |
#| `campaign_name` | 推广系列名称 | ✅ | ✅ |
#| `campaign_id` | 推广系列 ID | ✅ | ✅ |
#| `campaign_budget` | 推广系列预算 | ✅ | ✅ |
#| `adgroup_name` | 广告组名称 | ✅ | ✅ |
#| `adgroup_id` | 广告组 ID | ✅ | ✅ |
#| `placement_type` | 版位类型 | ✅ | ✅ |
#| `promotion_type` | 推广对象类型<br>对于内容加热广告，本字段的值将显示为`"Other"`。| ✅ | ✅ |
#| `opt_status` | 程序化创意 | ✅ | ✅ |
#|`budget` | 广告组预算 | ✅ | ✅ |
#| `smart_target` | 优化目标 | ✅ | ✅ |
#| `billing_event` | 计费点 | ✅ | ✅ |
#| `bid_strategy` | 竞价策略 | ✅ | ✅ |
#| `ad_name` | 广告名称 | ✅ | ✅ |
#| `ad_id` | 广告 ID | ✅ | ✅ |
#| `image_mode` | 样式 | ✅ | ❌ |
| 基础数据指标   |  | |  |
#| `spend` | 总消耗 | ✅ | ✅ |
#| `cpc` | CPC（目标页面） | ✅ | ✅ |
#| `cpm` | CPM | ✅ | ✅ |
#| `impressions` | 展示数 | ✅ | ✅ |
#| `clicks` | 点击量（目标页面） | ✅ | ✅ |
#| `ctr` | CTR（目标页面） | ✅ | ✅ |
#| `reach` | 总覆盖人数 | ✅ | ❌ |
#| `cost_per_1000_reached` | 覆盖千人成本 | ✅ | ❌ |
#| `conversion` | 转化数 | ✅ | ✅ |
#| `cost_per_conversion` | 转化成本 | ✅ | ✅ |
#| `conversion_rate` | 转化率（点击） | ✅ | ✅ |
#| `conversion_rate_v2` | 转化率（展示） | ✅ | ✅ |
#| `real_time_conversion` | 实时转化 | ✅ | ✅ |
#| `real_time_cost_per_conversion` | 实时单次转化费用 | ✅ | ✅ |
#| `real_time_conversion_rate` | 实时转化率（点击） | ✅ | ✅ |
#| `real_time_conversion_rate_v2` | 实时转化率（展示） | ✅ | ✅ |
#| `result` | 成效 | ✅ | ✅ |
#| `cost_per_result` | 单次成效费用 | ✅ | ✅ |
#| `result_rate` | 成效率 (%) | ✅ | ✅ |
#| `real_time_result` | 实时成效 | ✅ | ✅ |
#| `real_time_cost_per_result` | 实时单次成效费用 | ✅ | ✅ |
#| `real_time_result_rate` | 实时成效率 (%) | ✅ | ✅ |
| 视频播放数据指标   |   | |  |
#| `video_play_actions` | 播放次数 | ✅ | ✅ |
#| `video_watched_2s` | 播放2s次数 | ✅ | ✅ |
#| `video_watched_continuous_2s` | 连续观看 2 秒次数 | ✅ | ✅ |
#| `video_watched_6s` | 播放6s次数 | ✅ | ✅ |
#| `engaged_view` | 观看6秒次数（专注观看） | ✅ | ❌ |
#| `engaged_view_15s` | 观看15秒次数（专注观看） | ✅ | ❌ |
| 互动数据指标   |    ||  |
#| `engagements` | 点击量（全部） | ✅ | ❌ |
#| `engagement_rate` | CTR（全部） | ✅ | ❌ |
#| `profile_visits` | 付费主页访问数 | ✅ | ✅ |
#| `profile_visits_rate` | 付费主页访问率 | ✅ | ✅ |
#| `likes` | 付费点赞数 | ✅ | ✅ |
#| `comments` | 付费评论数 | ✅ | ✅ |
#| `shares` | 付费分享数 | ✅ | ✅ |
#| `follows` | 付费关注数 | ✅ | ✅ |
| LIVE 指标   |    |    ||
#| `live_views` | LIVE 播放量 | ✅ | ❌ |
#| `live_unique_views` | LIVE 去重播放量 | ✅ | ❌ |
#| `live_effective_views` | LIVE 有效播放量 | ✅ | ❌ |
#| `live_product_clicks` | LIVE 商品点击数 | ✅ | ❌ |
| 应用内事件数据指标   |   ||  |
#| `total_purchase` | 付费总数 | ✅ | ❌ |
#| `cost_per_total_purchase` | 付费平均成本 | ✅ | ❌ |
#| `value_per_total_purchase` | 付费平均价值 | ✅ | ❌ |
#| `total_purchase_value` | 总付费价值 | ✅ | ❌ |
#| `total_active_pay_roas` | 付费 ROAS | ✅ | ❌ |

支持的筛选条件

内容加热广告支持的筛选条件包括： - campaign_ids - adgroup_ids - ad_ids - campaign_status - adgroup_status - ad_status - billing_event - image_mode - create_time

若想了解筛选条件的详细描述，请查看基础报表 - 支持的筛选条件和受众报表 - 支持的筛选条件。