（已废弃）支持的指标

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

v1.2与v1.3版本对比

以下表格概括了 v1.2 与 v1.3 相比合约广告报表的指标变化。

|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
| 属性指标类型 | `campaign_id`: number<br> `adgroup_id`: number| `campaign_id`: string <br> `adgroup_id`: string|

属性指标

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

| 指标名称{25%}| 数据类型{10%} | 简要说明{25%}| 详细说明{40%}|
|---|---|---|---|
| campaign_name   | string | 推广系列名称  | 推广系列名称。推广系列、广告组和广告层级支持。  |
| campaign_id   | string| 推广系列 ID  | 推广系列 ID。仅广告组和广告层级支持。  |
| objective_type | string |推广目标 |推广目标。推广系列、广告组、广告层级支持。 |
| adgroup_name   | string | 广告组名称  | 广告组名称。仅广告组和广告层级支持。|
| adgroup_id   | string | 广告组 ID| 广告组 ID。仅广告层级支持。|
| ad_name  | string | 广告名称  | 广告名称。仅广告层级支持。|

基础数据指标

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

| 指标名称{25%}| 数据类型{10%} | 简要说明{25%}| 详细说明{40%}|
|---|---|---|---|
| spend | string | 花费 | 你的广告消耗总金额。 |
| impressions | string | 展示量 | 你的广告展示的次数。 |
| clicks | string | 点击量（目标页面） | 你的广告获得的跳转到指定目标页面的点击次数。 |
| ctr | string | 点击率（目标页面） | 促成目标页面点击的展示次数占总展示次数的百分比。 |
| reach | string | 覆盖人数 | 至少看过你的广告一次的去重用户数。 |
| cost_per_1000_reached | string | 覆盖千人成本 | 触达 1,000 个去重用户的平均成本。 |
| frequency | string | 频次 | 在特定时间段内每位用户看到你的广告的平均次数。 |
| currency  | string | 货币 | 货币代码, 比如 USD。请注意要使`currency`生效，请求中的`dimensions`字段需有`adgroup_id`/ `ad_id`/`campaign_id`/`advertiser_id`。 |

视频播放数据指标

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

| 指标名称{25%}| 数据类型{10%} | 简要说明{25%}| 详细说明{40%}|
|---|---|---|---|
| video_play_actions | string | 视频播放量 | 视频开始播放的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_watched_2s | string | 视频播放 2 秒次数 | 视频至少播放 2 秒的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| video_watched_6s | string | 视频播放 6 秒次数 | 视频至少播放 6 秒的次数。每次视频展示的播放次数会单独统计，且不包括重播次数。 |
| 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 | 用户平均播放时长 | 每位用户播放你的视频的平均时长，重播的时长也计算在内。 |

互动数据指标

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

| 指标名称{25%}| 数据类型{10%} | 简要说明{25%}| 详细说明{40%}|
|---|---|---|---|
| engagements | string | 点击数（全部） | 你的广告获得的点击次数。此项包括了跳转到目标页面的点击以及出于社交和互动目的进行的点击。 |
| engagement_rate | string | 点击率（全部） | 促成点击的展示次数占总展示次数的百分比。 |
| follows | string | 付费关注数 | 广告展示期间，关联主页获得的关注次数。 |
| likes | string | 付费点赞数 | 广告展示期间，你的广告获得的点赞次数。 |
| comments | string | 付费评论数 | 广告展示期间，你的广告获得的评论次数。 |
| shares | string | 付费分享数 | 广告展示期间，你的广告获得的分享次数。 |
| profile_visits | string | 付费主页访问量 | 广告展示期间，关联主页获得的访问次数。 |
| clicks_on_music_disc | string | 音乐点击数 | 广告展示期间，与广告关联的音乐获得的点击次数。 |
| clicks_on_hashtag_challenge | string | 话题点击数 | 广告展示期间，与广告关联的挑战赛获得的点击次数。 |
| skip_ad | string | 广告跳过数 | 用户点击跳过或划动跳过你的广告的次数。 |

附加创意数据指标

| 指标名称{25%}| 数据类型{10%} | 简要说明{25%}| 详细说明{40%}|
|---|---|---|---|
| interact_card_show_cnt | string | 互动卡片展示数    | 互动卡片展示数  |
| interact_card_a_click_cnt   | string | 互动卡片A按钮点击数    | 互动卡片A按钮点击数  |
| interact_card_b_click_cnt   | string | 互动卡片B按钮点击数    | 互动卡片B按钮点击数  |
| vote_card_show_cnt| string | 投票卡片展示数    | 投票卡片展示数  |
| vote_card_a_click_cnt  | string | 投票卡片A按钮点击数    | 投票卡片A按钮点击数  |
| vote_card_b_click_cnt  | string | 投票卡片B按钮点击数    | 投票卡片B按钮点击数  |
| vote_card_convert_click_cnt | string | 投票卡片转化按钮点击数 | 投票卡片投票后转化按钮点击数   |
| redpacket_show_cnt| string | 福袋样式展示数    | 福袋样式展示数  |
| redpacket_click_cnt    | string | 福袋样式点击数    | 福袋样式点击数  |
| image_card_show_cnt    | string | 图片卡片展示数    | 图片卡片展示数  |
| image_card_click_cnt   | string | 图片卡片点击数    | 图片卡片点击数  |