支持的指标

您可以在受众分析报表中使用以下指标。如果某指标在当前查询条件下没有消耗，则会返回为-。请注意，我们尚未支持TikTok广告管理平台上的全部指标。

v1.2与v1.3版本对比

以下表格概括了 v1.2 与 v1.3 相比受众分析报表的指标变化。

|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|新增指标类型| / |<strong>视频播放数据指标</strong><br><strong>互动数据指标</strong><br><strong>归因数据指标</strong><br><strong>网页事件数据指标</strong>|
| 属性指标名称 |`placement` |  `placement_type`|
| 属性指标类型 |`campaign_id`: number<br> `adgroup_id`: number| `campaign_id`: string <br> `adgroup_id`: string|
|新增属性指标 | / |`campaign_automation_type`<br>`ad_id_v2` |
| 新增基础数据指标 | /  |`reach`<br> `cost_per_1000_reached`<br>`frequency` <br>`cost` |

属性指标

属性指标（如广告组名称和推广对象类型）是推广系列、广告组或广告的基本属性。属性指标仅在使用ID类型的维度时有效。

|字段{25%}|数据类型{10%}|简要说明{35%}|详细说明{30%}|
|---|---|---|---|
| advertiser_name | string | 账户名称 | 广告主、推广系列、广告组、广告层级支持。|
| advertiser_id | string | 账户ID | 广告主、推广系列、广告组、广告层级支持。 |
| campaign_automation_type | string | 推广系列自动化类型。<br><br>枚举值：<ul><li>`MANUAL`：手动推广系列。</li><li>`SMART_PLUS`：Smart+ 推广系列。</li><li>`UPGRADED_SMART_PLUS`：升级版 Smart+ 推广系列。要了解有关升级版 Smart+ 推广系列的更多信息，请参阅[升级版 Smart+ 推广系列](1853452461203458.html)。<ul><li>当 `campaign_automation_type` 为 `UPGRADED_SMART_PLUS` 时，返回的 `ad_id_v2` 是升级版 Smart+ 广告的 ID。</li></ul></li><li>`UPGRADED_SMART_PLUS_CREATIVE`：升级版 Smart+ 推广系列。要了解有关升级版 Smart+ 推广系列的更多信息，请参阅[升级版 Smart+ 推广系列](1853452461203458.html)。<ul><li>当 `campaign_automation_type` 为 `UPGRADED_SMART_PLUS_CREATIVE` 时，返回的 `ad_id` 是升级版 Smart+ 广告中素材的 ID。</li></ul></li></ul> |推广系列、广告组、广告层级支持。|
| campaign_name | string | 推广系列名称 | 推广系列、广告组、广告层级支持。 |
| campaign_id | string | 推广系列ID | 广告组、广告层级支持。 |
| objective_type | string | 推广目标 | 推广系列、广告组、广告层级支持。 |
| split_test | string | 拆分对比实验状态 | 推广系列、广告组、广告层级支持。 |
| campaign_budget | string | 推广系列预算 | 推广系列、广告组、广告层级支持。 |
| campaign_dedicate_type | string | 推广系列类型 | iOS 14 专属推广系列或普通推广系列。推广系列、广告组、广告层级支持。 |
| app_promotion_type  | string | 应用推广类型 | 推广系列、广告组、广告层级支持。 |
| adgroup_name | string | 广告组名称 | 广告组、广告层级支持。 |
| adgroup_id | string | 广告组ID | 仅广告层级支持。 |
| placement_type | string | 版位类型 | 广告组、广告层级支持。 |
| promotion_type | string | 推广对象类型| 推广对象类型。枚举值为app（应用）, website（网站）和 others（其他)。广告组和广告层级支持。同步报表和异步报表都支持本指标。 |
| opt_status | string | 程序化创意 | 广告组、广告层级支持。 |
| adgroup_download_url | string | 下载 URL/网站 URL | 广告组、广告层级支持。|
| profile_image | string | 头像| 广告组、广告层级支持。 |
| dpa_target_audience_type | string | DPA广告的目标受众类型 | DPA广告的目标受众类型。广告组和广告层级，同步报表和异步报表都支持本指标。 |
| budget | string | 广告组预算 | 广告组、广告层级支持。 |
| smart_target | string | 优化目标 | 广告组、广告层级支持。 |
| pricing_category {-即将废弃}   | string | 计费点 | 广告组、广告层级支持。 <br>若您想获取广告的计费点（计费事件）信息，请使用指标`billing_event`。 |
| billing_event | string | 计费点 | 广告组、广告层级支持。 <br> 示例：`"Clicks"`，`"Impression"`。 |
| bid_strategy | string | 竞价策略 | 广告组、广告层级支持。 |
| bid | string | 出价 | 广告组、广告层级支持。 |
| bid_secondary_goal | string | 深层目标出价 | 广告组、广告层级支持。  |
| aeo_type | string | 应用内事件优化类型 | 广告组、广告层级支持（广告组层级目前已支持，广告层级即将支持）。 |
| ad_name | string | 广告名称 | 仅广告层级支持。 |
| ad_id_v2 | string | 可以获取的数据类型包括：<ul><li>手动广告的广告 ID。</li><li>Smart+ 推广系列的广告 ID。</li><li>升级版 Smart+ 广告的广告 ID。</li></ul><br><ul><li>不能将此指标与`ad_id`维度、筛选条件 `ad_ids` 或属性指标 `ad_id` 一起使用。</li></ul> | 广告层级支持。 |
| ad_id | string | 广告ID | 仅广告层级支持。 |
| ad_text | string | 广告文案 | 仅广告层级支持。 |
| call_to_action | string | 行动引导文案 | 仅广告层级支持。 |
| ad_profile_image | string | Profile image (Ad level)头像（广告层级） | 仅广告层级支持。|
| ad_url | string | URL（广告层级）| 仅广告层级支持。 |
| tt_app_id | string | 推广应用 ID | 您在创建广告组时使用的应用ID。仅广告组、广告层级支持，当一个广告组的推广对象类型为 App 时返回。 |
| tt_app_name | string | 推广应用名称 | 广告组、广告层级支持，当一个广告组的推广对象类型为 App 时返回。 |
| mobile_app_id | string | 推广应用在Google Play或Apple App Store中的ID|例如：App Store: https://apps.apple.com/us/app/angry-birds/id<b>343200656</b>; Google Play：https://play.google.com/store/apps/details?id=<b>com.rovio.angrybirds</b>。</p>仅广告组、广告层级支持，当一个广告组的推广对象类型为 App 时返回。 |
| device_brand_name | string |设备品牌名称 |当维度中包含 `device_brand_id` 时支持此指标。 |
|behavior_name|string| 行为名称|当维度中包含`behavior_id` 时支持此指标。 |
|action_category|string|行为类别 | 当维度中包含`behavior_id` 时支持此指标。仅实时报表支持，异步报表不支持。|
|action_scene| string| 行为场景。枚举值: `VIDEO_RELATED`（视频行为）, `CREATOR_RELATED`（创作者行为）。 |当维度中包含`behavior_id`时支持此指标。仅实时报表支持，异步报表不支持。|
|user_action|string|用户行为 |对于视频行为场景，枚举值包括`WATCHED_TO_END`（看完）, `LIKED`（点赞）, `COMMENTED`（评论）和`SHARED`（分享）。 对于创作者行为场景，枚举值包括`FOLLOWING`（关注）和`VIEW_HOMEPAGE`（浏览主页）。 |
|action_period|string|行为天数。 枚举值: `7`，`15`。 | 仅实时报表支持，异步报表不支持。|
|rf_campaign_type| string |推广系列类型。枚举值：`0` （覆盖和频次推广系列）, `1`（TikTok Pulse推广系列）。 |推广系列、广告组和广告层级，同步报表和异步报表都支持本指标。 |
|delivery_type|string|投放速度。|广告组、广告层级支持。|
|adgroup_display_name|string|广告组显示名称。|广告组、广告层级支持。|
|adgroup_schedule|string|广告组排期。如：“2024-01-09-持续投放”。|广告组、广告层级支持。|
|optimization_preference|string|优化偏好。如：“在学习阶段优化转化”。|广告组、广告层级支持。|
|image_info|string|图片信息。如：`https://p16-sign-sg.tiktokcdn.com/tos-alisg-p-0051c001-sg/o4PDmEEDgzoBf7VFfmlNBBAtE7p2uqI4TduOYQ~tplv-noop.image?x-expires=1707528999&x-signature=91iFceqlBWKfwNuOJjyaijC5qU0%3D`|仅广告层级支持。|
|ad_display_name|string|广告展示名称。|仅广告层级支持。|
|identity_type|string|认证身份类型。如：“TikTok账户（Spark Ads）”。|仅广告层级支持。|
| currency  | string |  货币 | 货币代码，比如USD。请注意如果要使用`currency`作为指标，则请求中的`dimensions`字段必须包含`adgroup_id`/`ad_id`/`campaign_id`/`advertiser_id`。 |
|is_aco|boolean|广告是否为程序化创意广告或智能创意广告。若为程序化创意广告或智能创意广告，设置为`True`。|支持竞价广告组（AUCTION_ADGROUP）层级。|
|is_smart_creative|boolean|广告是否为智能创意广告。|支持竞价广告（AUCTION_AD）层级。|

基础数据指标

基础数据指标是广告消耗和表现的相关数据。

|字段{25%}|数据类型{10%}|简要说明{25%}|详细说明{40%}|
|---|---|---|---|
| spend | string | 消耗 | 您的广告消耗总金额，以广告账号所用币种计算。 |
| cost | string | 消耗 | 您的广告消耗总金额，以美元计算。 <br><br><p><span style="color:darkred"><b>注意</b></span>：此指标只能与 `bucket_id` 维度一同使用。 |
| cpc | string | 平均点击成本（目标页面） | 跳转到指定目标页面的每次点击平均成本。 |
| cpm | string | 千次展示成本 (CPM) | 您为每 1,000 次展示平均花费的金额。 |
| impressions | string | 展示量 | 您的广告展示的次数。 |
| gross_impressions | string | 总展示数（包括无效展示） | 广告显示在屏幕上的次数，包括无效展示。 |
| clicks | string | 点击量（目标页面） | 您的广告获得的跳转到指定目标页面的点击次数。 |
| ctr | string | 点击率（目标页面） | 促成目标页面点击的展示次数占总展示次数的百分比。 |
| reach | string | 覆盖人数 | 至少看过您的广告一次的去重用户数。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您想使用本指标，需在请求中的`dimensions`字段指定以下任一受众维度组合，可同时使用一个可选的 ID 维度和一个可选的时间维度：<ul><li>`age`</li><li>`gender`</li><li>`age` + `gender`</li><li> `country_code` </li><li> `province_id`</li><li>`language`</li></ul>|
| cost_per_1000_reached | string |覆盖千人成本 | 触达 1,000 个去重用户的平均成本。 <br><br><p><span style="color:darkred"><b>注意</b></span>：若您想使用本指标，需在请求中的`dimensions`字段指定以下任一受众维度组合，可同时使用一个可选的 ID 维度和一个可选的时间维度：<ul><li>`age`</li><li>`gender`</li><li>`age` + `gender`</li><li> `country_code` </li><li> `province_id`</li><li>`language`</li></ul>|
| frequency | string | 频次 | 在特定时间段内每位用户看到您的广告的平均次数。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您想使用本指标，需在请求中的`dimensions`字段指定以下任一受众维度组合，可同时使用一个可选的 ID 维度和一个可选的时间维度：<ul><li>`age`</li><li>`gender`</li><li>`age` + `gender`</li><li> `country_code` </li><li> `province_id`</li><li>`language`</li></ul>|
| conversion | string | 转化量 | 广告达成您选择的优化事件的次数。 |
| cost_per_conversion | string | 平均转化成本 | 在转化上花费的平均金额。 |
| conversion_rate | string | 转化率（点击） | 您获得的成效数占广告获得的目标页面总点击量的百分比。 <br><br><p><span style="color:darkred"><b>注意</b></span>：2023年10月末起，本字段将调整为基于展示次数计数（即使用与 `conversion_rate_v2` 相同的计算逻辑）。为保证流畅的API 体验，避免计算逻辑变更带来的影响，建议您尽快切换到基于展示次数的 `conversion_rate_v2` 指标。 |
| conversion_rate_v2 | string | 转化率（展示） | 您获得的成效数占广告获得的总展示次数的百分比。 |
| real_time_conversion | string | 实时转化量 | 广告达成您选择的优化事件的次数。 |
| real_time_cost_per_conversion | string | 实时平均转化成本 | 在转化上花费的平均金额。 |
| real_time_conversion_rate | string | 实时转化率（点击） | 您获得的转化数占广告获得的目标页面总点击量的百分比。<br><br><p><span style="color:darkred"><b>注意</b></span>：2023年10月末起，本字段将调整为基于展示次数计数（即使用与 `real_time_conversion_rate_v2` 相同的计算逻辑）。为保证流畅的API体验，避免计算逻辑变更带来的影响，建议您尽快切换到基于展示次数的 `real_time_conversion_rate_v2` 指标。|
| real_time_conversion_rate_v2 | string | 实时转化率（展示） | 您获得的转化数占广告获得的总展示次数的百分比。 |
| result | string | 成效数 | 广告达到您预期的推广目标和优化目标的次数。 |
| cost_per_result | string | 平均成效成本 | 广告获得单次成效的平均成本。 |
| result_rate | string | 成效率 | 产生的成效数占广告获得的总展示次数的百分比。 |
| real_time_result | string | 实时成效数 | 广告达到您预期的推广目标和优化目标的次数。 |
| real_time_cost_per_result | string | 实时平均成效成本 | 广告获得单次成效的平均成本。 |
| real_time_result_rate | string | 实时成效率 | 产生的成效数占广告获得的总展示次数的百分比。 |

视频播放数据指标

视频播放数据指标（如播放2s次数和播放50%次数）是视频播放表现的相关数据。

|字段{25%}|数据类型{10%}|简要说明{25%}|详细说明{40%}|
|---|---|---|---|
| video_play_actions | string | 视频播放量 | 视频开始播放的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_watched_2s | string | 视频播放 2 秒次数 | 视频至少播放 2 秒的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_watched_6s | string | 视频播放 6 秒次数 | 视频至少播放 6 秒的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| engaged_view | string | 播放 6 秒次数（专注观看） | 您的视频至少播放 6 秒（如视频短于 6 秒，则完整播放）或在前 6 秒至少收到 1 次互动的次数。 |
| engaged_view_15s | string | 播放 15 秒次数（专注观看） | 您的视频至少播放 15 秒（如视频短于 15 秒，则完整播放）或在前 15 秒至少收到 1 次互动的次数。 |
| video_views_p25 | string | 播放 25% 次数 | 视频至少播放总时长的 25% 的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_views_p50 | string | 播放 50% 次数 | 视频至少播放总时长的 50% 的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_views_p75 | string | 播放 75% 次数 | 视频至少播放总时长的 75% 的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_views_p100 | string | 播放完成次数 | 您的视频完整播放的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| average_video_play | string | 平均视频播放时长 | 您的视频的平均播放时长，重播的播放时长也计算在内。 |
| average_video_play_per_user | string | 用户平均播放时长 | 每位用户播放您的视频的平均时长，重播的时长也计算在内。 <br><br><p><span style="color:darkred"><b>注意</b></span>: 只有当 `dimensions` 字段包含 `placement` 时，才可使用本指标。 |

互动数据指标

互动数据指标（如点赞数和评论数）是用户与广告互动情况的相关数据。

|字段{25%}|数据类型{10%}|简要说明{25%}|详细说明{40%}|
|---|---|---|---|
| follows | string | 付费关注数 | 广告展示期间，关联主页获得的关注次数。 |
| likes | string | 付费点赞数 | 广告展示期间，您的广告获得的点赞次数。 |
| comments | string | 付费评论数 | 广告展示期间，您的广告获得的评论次数。 |
| shares | string | 付费分享数 | 广告展示期间，您的广告获得的分享次数。 |
| profile_visits | string | 付费主页访问量 | 广告展示期间，关联主页获得的访问次数。 |
| profile_visits_rate | string | 付费主页访问率 | 广告带来的主页访问次数占广告获得的总展示次数的百分比。 |
| clicks_on_music_disc | string | 音乐点击数 | 广告展示期间，与广告关联的音乐获得的点击次数。 |
| ix_page_duration_avg | string | 即时体验页面平均浏览时长 | 您的即时体验页面展示的平均时长。<br><br><p><span style="color:darkred"><b>注意</b></span>: 只有当`dimensions`字段包含 `placement` 时，才可使用本指标。 |
| ix_page_viewrate_avg | string | 即时体验页面平均浏览率 | 您的即时体验页面上的内容被浏览的平均百分比。<br> <br><p><span style="color:darkred"><b>注意</b></span>:  只有当`dimensions`字段包含 `placement` 时，才可使用本指标。 |

归因数据指标

归因数据指标是事件归因分析的相关数据。

注意
受众分析报表中支持和归因数据指标组合使用的受众维度仅包括 placement 和 ad_type。

|字段{25%}|数据类型{10%}|简要说明{25%}|详细说明{40%}|
|---|---|---|---|
| vta_complete_payment| string | 展示归因支付完成数 | 归因于用户仅浏览广告的支付完成事件数。 |
| cost_per_vta_payments_completed | string | 展示归因支付完成平均成本 | 归因于用户仅 浏览广告的每个支付完成事件的平均成本。 |
| vta_complete_payment_value | string | 展示归因支付完成总价值 | 归因于用户仅浏览广告的支付完成事件的总价值。 |
| vta_complete_payment_roas | string | 展示归因支付完成 ROAS | 归因于用户仅浏览广告的支付完成事件的广告支出回报率（ROAS）。 |

网页事件数据指标

网页事件数据指标是网页转化事件的相关数据。

|字段{25%}|数据类型{10%}|简要说明{25%}|详细说明{40%}|
|---|---|---|---|
| 落地页浏览 | | | |
#| total_landing_page_view | string | "落地页浏览"总数 | "落地页浏览"事件发生的次数。 |
#| cost_per_landing_page_view | string | 单次"落地页浏览"成本 | "落地页浏览"事件的平均成本。 |
#| landing_page_view_rate | string | 落地页浏览率 | "落地页浏览"事件在点击事件后发生的概率。 |