← 返回目录
📁 Marketing API › Reporting › Guides › Report types › DSA reports

支持的指标

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

v1.2与v1.3版本对比

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

|变化内容{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|
|新增属性指标 | / |`ad_id_v2` |

对于商品库广告

注意
若要为商品库广告(旧称商品来源为商品库的视频购物广告)请求 DSA 报表,则仅支持异步模式。

属性指标

属性指标是推广系列、广告组或广告的基本属性。属性指标仅在使用 ID 类型的维度时有效。

| 字段{35%}| 类型{10%}| 描述{55%}|
| --- | --- | --- |
| product_name_v2 | string | 商品库商品名称 |
| product_image_v2 | string | 商品库商品图片 |
| catalog_name_v2 | string | 商品库名称 |
| campaign_name | string | 推广系列名称。<br>推广系列、广告组、广告层级支持。 |
| campaign_id | string | 推广系列 ID。 <br>广告组、广告层级支持。 |
| adgroup_name | string | 广告组名称。 <br>广告组、广告层级支持。 |
| adgroup_id | string | 广告组 ID。<br>仅广告层级支持。 |
| 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> <br>仅广告层级支持。 |
| ad_name | string | 广告名称。 <br>仅广告层级支持。 |

核心指标

核心指标提供关于广告表现的基本洞察,涵盖基本数据。

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
|---|---|---|---|
| conversion | string | 转化数 | 广告达成您选择的优化事件的次数。 |

商品指标

商品指标是商品的表现相关数据。

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
|---|---|---|---|
| product_impressions | string | 商品曝光量 | 您商品的展示次数。 |
| product_clicks| string | 商品点击数(目标页面) | 从您的商品跳转到指定目标页面的点击数。 |
| product_cta | string | 商品点击率(目标页面) | 促成目标页面点击的商品曝光量占总商品曝光量的百分比。 |

应用指标

应用指标衡量与移动应用相关的操作。

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
|---|---|---|---|
| 付费   | | | |
#| purchase | string | 去重付费次数(应用) | 归因于广告的去重应用内付费操作次数。 |
#| total_purchase | string | 付费次数(应用) | 归因于广告的应用内付费操作次数。 |
#| value_per_total_purchase | string | 平均付费价值(应用) | 归因于广告的应用内付费操作平均价值。 |
#| total_purchase_value | string | 付费价值(应用) | 归因于广告的应用内付费操作总价值。 |
| 加入购物车   | | | |
#| app_event_add_to_cart | string | 去重加入购物车次数(应用) | 归因于广告的去重应用内加入购物车操作次数。 |
#| total_app_event_add_to_cart | string | 加入购物车次数(应用) | 归因于广告的应用内加入购物车操作次数。 |
#| value_per_total_app_event_add_to_cart | string | 加入购物车平均价值(应用) | 归因于广告的应用内加入购物车操作平均价值。 |
#| total_app_event_add_to_cart_value | string | 加入购物车价值(应用) | 归因于广告的应用内加入购物车操作总价值。 |
| 结账   | | | |
#| checkout | string | 去重结账次数(应用) | 归因于广告的去重应用内结账操作次数。 |
#| total_checkout | string | 结账次数(应用) | 归因于广告的应用内结账操作次数。 |
#| value_per_checkout | string | 平均结账价值(应用) | 归因于广告的应用内结账操作平均价值。 |
#| total_checkout_value | string | 结账价值(应用) | 归因于广告的应用内结账操作总价值。 |
| 查看内容   | | | |
#| view_content | string | 去重查看内容次数(应用) | 归因于广告的去重应用内查看内容操作次数。 |
#| total_view_content | string | 查看内容次数(应用) | 归因于广告的应用内查看内容操作次数。 |
#| value_per_total_view_content | string | 查看内容平均价值(应用) | 归因于广告的应用内查看内容操作平均价值。 |
#| total_view_content_value | string | 查看内容价值(应用) | 归因于广告的应用内查看内容操作总价值。 |

网站指标

网站指标衡量广告带来的网站操作,例如付费。

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
|---|---|---|---|
| 付费 | | | |
#| complete_payment | string | 付费数(网站) | 归因于广告的网站付费操作次数。 |
#| value_per_complete_payment | string | 付费平均价值(网站) | 归因于广告的网站付费操作的平均价值。 |
#| total_complete_payment_rate | string | 付费价值(网站) | 归因于广告的网站付费操作的总价值。 |
| 网页浏览   |  |  |  |
#| total_pageview | string | 网页浏览总数 | 网页浏览事件发生的次数 |
#| avg_value_per_pageview | string | 网页浏览平均价值 | 网页浏览事件的单次价值 |
#| total_value_per_pageview | string | 网页浏览总价值 | 网页浏览事件的总价值 |
| 查看内容    |  |  |  |
#| page_content_view_events | string | 查看内容次数(网页) | 归因于广告的网页查看内容操作次数。 |
#| value_per_page_content_view_event | string | 查看内容平均价值(网页) | 归因于广告的网页查看内容操作平均价值。 |
#| total_page_view_content_events_value | string | 查看内容价值(网页) | 归因于广告的网页查看内容操作总价值。 |
| 加入购物车   |  |  |  |
#| web_event_add_to_cart | string | 加入购物车次数(网页) | 归因于广告的网页加入购物车操作次数。 |
#| value_per_web_event_add_to_cart | string | 加入购物车平均价值(网页) | 归因于广告的网页加入购物车操作平均价值。 |
#| total_web_event_add_to_cart_value | string | 加入购物车价值(网页) | 归因于广告的网页加入购物车操作总价值。 |
| 开始结账   |  |  |  |
#| initiate_checkout | string | 开始结账次数(网页) | 归因于广告的网页开始结账操作次数。 |
#| value_per_initiate_checkout | string | 开始结账平均价值(网页) | 归因于广告的网页开始结账操作平均价值。 |
#| total_initiate_checkout_value | string | 开始结账价值(网页) | 归因于广告的网页开始结账操作总价值。 |

线下指标

线下指标衡量归因于广告的线下操作,例如实体店中的付费。

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
|---|---|---|---|
| 付费 | | | |
#| offline_shopping_events | string | 付费次数(线下) | 归因于广告的线下付费操作次数。 |
#| value_per_offline_shopping_event | string | 付费平均价值(线下) | 归因于广告的线下付费操作的平均价值。 |
#| offline_shopping_events_value | string | 付费价值(线下) | 归因于广告的线下付费操作的总价值。 |

归因数据指标

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

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
|---|---|---|---|
| vta_conversion | string | 展示归因转化数 | 归因于展示的转化数 |
| vta_complete_payment | string | 展示归因支付完成数 | 归因于用户仅浏览广告的支付完成事件数 |
| vta_complete_payment_value | string | 展示归因支付完成总价值 | 归因于用户仅浏览广告的支付完成事件的总价值 |
| cta_conversion | string | 点击归因转化数 | 归因于点击的转化数 |
| cta_complete_payment | string | 点击归因支付完成数 | 归因于用户点击广告的支付完成事件数 |
| cta_complete_payment_value | string | 点击归因支付完成总价值 | 归因于用户点击广告的支付完成事件的总价值 |

对于 Dynamic Showcase Ads

属性指标

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

|字段{35%}|类型{10%}|描述{55%}|
|-----|-----|------|
|catalog_name|string|商品库名称|
|product_set_name|string|商品系列名称|
|product_name|string|商品名称|
|campaign_name|string|推广系列名称,推广系列、广告组、广告层级支持|
|campaign_id|string|推广系列ID,广告组、广告层级支持|
|adgroup_name|string|广告组名称,广告组、广告层级支持|
|placement_type|string|版位,广告组、广告层级支持|
|adgroup_id|string|广告组ID,仅广告层级支持|
|ad_name|string|广告名称,仅广告层级支持|
|ad_text|string|广告标题,仅广告层级支持|
|product_image|string|商品图片URL。仅广告层级支持|
|tt_app_id|string|推广应用ID,仅广告组、广告层级支持,当推广对象为App时有值|
|tt_app_name|string|推广应用名称,仅广告组、广告层级支持,当推广对象为App时有值|
|mobile_app_id|string|推广应用在GooglePlay或AppleAppStore中的ID,仅广告组、广告层级支持,当推广对象为App时有值|
|promotion_type|string|推广类型。枚举值:app(应用),website(网站)和others(其他)。广告组和广告层级支持。同步报表和异步报表都支持本指标。|
|dpa_target_audience_type|string|DPA广告的目标受众类型。广告组和广告层级支持。同步报表和异步报表都支持本指标。|

基础数据指标

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

| 字段{35%}| 类型{10%}| 描述{55%}|
| ----- | ----- | ------ |
| impressions | string | 广告展现次数。 |
| clicks | string |点击量(目标页面)。用户点击广告并进入广告主指定的目标页面的次数。 <br><p><span style="color:darkred"><b>注意</b></span>:从 7 月 6 日开始,异步报表中的指标名称已从“点击量”更新为“点击量(目标页面)”。 |
| spend| string | 总消耗。 在所选择的时间内投放广告产生的花费金额。 |
| conversion| string | 转化数。广告达成目标转化的次数,目标转化会根据创建时的投放设置有所不同(计数结果基于展示时间点统计)。 |
| cost_per_conversion | string | 转化成本。广告花费平均到单次转化的成本(计数结果基于展示时间点统计)。 |
| conversion_rate| 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 | 转化率(展示)。 转化次数占广告获得的总展示次数的百分比。<br>(总计数是根据每次广告展示的时间计算的。) |
| ctr | string | CTR(目标页面) (%) 。广告展现中产生了点击(目标页面)的次数占比。<br><p><span style="color:darkred"><b>注意</b></span>:从 7 月 6 日开始,异步报表中的指标名称已从“CTR”更新为“CTR(目标页面)”。 |
| cpc | string | CPC(目标页面)。广告花费平均到单次点击(目标页面)的成本。<br><p><span style="color:darkred"><b>注意</b></span>:从 7 月 6 日开始,异步报表中的指标名称已从“CPC”更新为“CPC(目标页面)”。  |
| cpm | string | CPM。每千次展现您所产生的平均花费。 |
| real_time_result | string | 实时成效。广告最终实现成效的次数,与您的优化目标相对应。(计数结果基于转化事件发生的时间统计) |
| real_time_cost_per_result| string | 实时单次成效费用。获得单次成效的成本。(计数结果基于转化事件发生的时间统计)|
| real_time_result_rate | string | 实时成效率 (%) 。广告观看或点击过程中获得成效的占比。(计数结果基于转化事件发生的时间统计) |
| result | string | 广告最终实现成效的次数,与您的优化目标相对应。(计数结果基于展示时间点统计) |
| cost_per_result| string | 单次成效费用。获得单次成效的成本。(计数结果基于展示时间点统计) |
| result_rate | string | 成效率 (%) 。广告观看或点击过程中获得成效的占比。(计数结果基于展示时间点统计) |
| currency | string | 货币代码,比如USD。请注意如果要使用`currency`作为指标,则请求中的`dimensions`字段必须包含`adgroup_id`/`ad_id`/`campaign_id`/`advertiser_id`。|

应用内事件数据指标

应用内事件数据指标是应用内转化事件的相关数据。

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
| ---| --- |--- | --- |
|实时应用安装| | | |
#| real_time_app_install | string | 实时应用安装 | 用户在app中激活并归因到您的广告的次数。(计数结果基于转化事件发生的时间统计) |
#| real_time_app_install_cost | string | 实时应用安装成本| 单次app安装的成本。(计数结果基于转化事件发生的时间统计) |
|应用安装| | | |
#| app_install | string | 应用安装| 用户在app中激活并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_app_install| string | 应用安装成本 | 单次app安装的成本。(计数结果基于展示时间点统计。)|
|注册||||
#| registration| string | 去重注册数 | 去重后的用户在app中注册并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_registration | string | 去重注册成本 | 去重后的单次注册的成本。(计数结果基于展示时间点统计。)|
#| registration_rate| string | 注册率 (%) | 去重后的用户的注册量与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_registration  | string | 总注册数| 总注册数(计数结果基于展示时间点统计。) |
#| cost_per_total_registration| string | 每个注册成本 | 每个注册成本(计数结果基于展示时间点统计。)  |
|购买| | | |
#| purchase  | string | 唯一购买  | 您的广告的唯一购买事件数。 (计数结果基于展示时间点统计。) |
#| cost_per_purchase| string | 每次唯一购买的成本   | 平均每次唯一购买事件的成本。 (计数结果基于展示时间点统计。) |
#| purchase_rate  | string | 购买率 (%) | 所有应用安装事件中唯一购买事件所占的百分比。 (计数结果基于展示时间点统计。) |
#| total_purchase | string | 购买总数 | 购买总数 (计数结果基于展示时间点统计。) |
#| cost_per_total_purchase  | string |每次唯一购买的成本 | 平均每次唯一购买事件的成本。 (计数结果基于展示时间点统计。)  |
#| value_per_total_purchase | string | 每次唯一购买的价值 | 平均每次唯一购买事件的价值。 (计数结果基于展示时间点统计。)  |
#| total_purchase_value| string | 购买总价值 | 从所有购买事件返回的总价值。 (计数结果基于展示时间点统计。) |
#| total_active_pay_roas | string | 购买事件广告投资回报率 | 购买事件广告投资回报率(计数结果基于展示时间点统计。) |
|加入购物车| | | |
#| app_event_add_to_cart | string | 唯一加入购物车 | 您的广告的唯一加入购物车事件数。 (计数结果基于展示时间点统计。) |
#| cost_per_app_event_add_to_cart| string | 每次唯一加入购物车的成本 | 平均每次唯一加入购物车事件的成本。 (计数结果基于展示时间点统计。) |
#| app_event_add_to_cart_rate | string | 唯一加入购物车率  (%)| 所有应用安装事件中唯一加入购物车事件所占的百分比。 (计数结果基于展示时间点统计。) |
#| total_app_event_add_to_cart| string | 总加入购物车数  | 总加入购物车数(计数结果基于展示时间点统计。)|
#| cost_per_total_app_event_add_to_cart | string |每次加入购物车的成本 |平均每次加入购物车事件的成本。(计数结果基于展示时间点统计。) |
#| value_per_total_app_event_add_to_cart| string | 单次加入购物车价值| 单次加入购物车价值(计数结果基于展示时间点统计。) |
#| total_app_event_add_to_cart_value  | string | 加入购物车总价值| 加入购物车总价值(计数结果基于展示时间点统计。)|
|下单| | | |
#| checkout  | string | 去重下单数 | 去重后的用户在app中下单并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_checkout| string | 去重下单成本 | 去重后的单次下单的成本。(计数结果基于展示时间点统计。)|
#| checkout_rate  | string | 下单率 (%) | 去重后的用户下单与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_checkout | string | 总下单数| 总下单数(计数结果基于展示时间点统计。) |
#| cost_per_total_checkout  | string | 每个下单成本 | 每个下单成本(计数结果基于展示时间点统计。)  |
#| value_per_checkout  | string | 单次下单价值 | 单次下单价值(计数结果基于展示时间点统计。)  |
#| total_checkout_value| string | 下单总价值 | 下单总价值(计数结果基于展示时间点统计。) |
|查看内容| | | |
#| view_content| string | 唯一查看内容   | 您的广告的唯一查看内容事件数。 (计数结果基于展示时间点统计。) |
#| cost_per_view_content | string | 每次唯一查看内容的成本 |平均每次唯一查看内容事件的成本。 (计数结果基于展示时间点统计。) |
#| view_content_rate| string | 唯一查看内容率  (%)  | 所有应用安装事件中唯一查看内容事件所占的百分比。(计数结果基于展示时间点统计。) |
#| total_view_content  | string | 查看内容总数 | 您的广告的查看内容事件数。(计数结果基于展示时间点统计。)  |
#| cost_per_total_view_content| string | 每次唯一查看内容的成本 | 平均每次唯一查看内容事件的成本。 (计数结果基于展示时间点统计。)|
#| value_per_total_view_content  | string | 单次查看详情价值| 单次查看详情价值(计数结果基于展示时间点统计。)|
#| total_view_content_value | string |查看内容总价值  | 从所有查看内容事件返回的总价值。 (计数结果基于展示时间点统计。)|
|次日留存| | | |
#| next_day_open  | string | 去重次日留存数  | 去重后的用户在app中次日留存并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_next_day_open| string | 去重次日留存成本| 去重后的单次次日留存的成本。(计数结果基于展示时间点统计。) |
#| next_day_open_rate  | string | 次日留存率 (%)  | 去重后的用户次日留存与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_next_day_open | string | 总次日留存数 | 总次日留存数(计数结果基于展示时间点统计。)  |
#| cost_per_total_next_day_open| string | 每个次日留存成本| 每个次日留存成本(计数结果基于展示时间点统计。)|
|添加支付信息| | | |
#| add_payment_info | string | 去重添加付款信息数| 去重后的用户在app中添加付款信息并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_add_payment_info| string | 去重添加付款信息成本 | 去重后的单次添加付款信息的成本。(计数结果基于展示时间点统计。) |
#| add_payment_info_rate | string | 添加付款信息率 (%)| 去重后的用户添加付款信息与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_add_payment_info| string | 总添加付款信息数| 总添加付款信息数(计数结果基于展示时间点统计。)|
#| cost_total_add_payment_info| string | 每个添加付款信息成本 | 每个添加付款信息成本(计数结果基于展示时间点统计。) |
|加入心愿单| | | |
#| add_to_wishlist| string | 去重加入心愿单数| 去重后的用户在app中添加心愿单并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_add_to_wishlist | string | 去重加入心愿单成本| 去重后的单次加入心愿单的成本。(计数结果基于展示时间点统计。) |
#| add_to_wishlist_rate| string | 加入心愿单率 (%)| 去重后的用户加入心愿单与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_add_to_wishlist | string | 总加入心愿单数  | 总加入心愿单数(计数结果基于展示时间点统计。)|
#| cost_per_total_add_to_wishlist| string | 每个加入心愿单成本| 每个加入心愿单成本(计数结果基于展示时间点统计。) |
#| value_per_total_add_to_wishlist | string | 单次加入心愿单价值| 单次加入心愿单价值(计数结果基于展示时间点统计。) |
#| total_add_to_wishlist_value| string | 加入心愿单总价值| 加入心愿单总价值(计数结果基于展示时间点统计。)|
|打开应用| | | |
#| launch_app| string | 去重打开app数| 去重后的用户在app中打开并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_launch_app | string | 去重打开app成本 | 去重后的单次打开app的成本。(计数结果基于展示时间点统计。)  |
#| launch_app_rate| string | 打开app率 (%)| 去重后的用户app打开与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_launch_app | string | 总打开app数| 总打开app数(计数结果基于展示时间点统计。)|
#| cost_per_total_launch_app| string | 每个打开app成本 | 每个打开app成本(计数结果基于展示时间点统计。) |
|完成教程 | | | |
#| complete_tutorial| string | 去重完成新手教程数| 去重后的用户在app中完成新手教程并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_complete_tutorial | string | 去重完成新手教程成本 | 去重后的单次完成新手教程的成本。(计数结果基于展示时间点统计。) |
#| complete_tutorial_rate| string | 完成新手教程率 (%)| 去重后的用户下单与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_complete_tutorial  | string | 总完成新手教程数| 总完成新手教程数(计数结果基于展示时间点统计。)|
#| cost_per_total_complete_tutorial| string | 每个完成新手教程成本 | 每个完成新手教程成本(计数结果基于展示时间点统计。) |
#| value_per_total_complete_tutorial  | string | 单次完成新手教程价值 | 单次完成新手教程价值(计数结果基于展示时间点统计。) |
#| total_complete_tutorial_value | string | 完成新手教程总价值| 完成新手教程总价值(计数结果基于展示时间点统计。) |
|创建组 | | | |
#| create_group| string | 去重创建战队数  | 去重后的用户在app中创建战队并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_create_group | string | 去重创建战队成本| 去重后的单次创建战队的成本。(计数结果基于展示时间点统计。) |
#| create_group_rate| string | 创建战队率 (%)  | 去重后的用户创建战队与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_create_group  | string | 总创建战队数 | 总创建战队数(计数结果基于展示时间点统计。)  |
#| cost_per_total_create_group| string | 每个创建战队成本| 每个创建战队成本(计数结果基于展示时间点统计。)|
#| value_per_total_create_group  | string | 单次创建战队价值| 单次创建战队价值(计数结果基于展示时间点统计。)|
#| total_create_group_value | string | 创建战队总价值  | 创建战队总价值(计数结果基于展示时间点统计。)|
|加入组| | | |
#| join_group| string | 去重加入战队数  | 去重后的用户在app中加入战队并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_join_group | string | 去重加入战队成本| 去重后的单次加入战队的成本。(计数结果基于展示时间点统计。) |
#| join_group_rate| string | 加入战队率 (%)  | 去重后的用户加入战队与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_join_group | string | 总加入战队数 | 总加入战队数(计数结果基于展示时间点统计。)  |
#| cost_per_total_join_group| string | 每个加入战队成本| 每个加入战队成本(计数结果基于展示时间点统计。)|
#| value_per_total_join_group | string | 单次加入战队价值| 单次加入战队价值(计数结果基于展示时间点统计。)|
#| total_join_group_value| string | 加入战队总价值  | 加入战队总价值(计数结果基于展示时间点统计。)|
|创建角色| | | |
#| create_gamerole| string | 去重创建角色数  | 去重后的用户在app中创建角色并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_create_gamerole | string | 去重创建角色成本| 去重后的单次创建角色的成本。(计数结果基于展示时间点统计。) |
#| create_gamerole_rate| string | 创建角色率 (%)  | 去重后的用户创建角色与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_create_gamerole | string | 总创建角色数 | 总创建角色数(计数结果基于展示时间点统计。)  |
#| cost_per_total_create_gamerole| string | 每个创建角色成本| 每个创建角色成本(计数结果基于展示时间点统计。)|
#| value_per_total_create_gamerole | string | 单次创建角色价值| 单次创建角色价值(计数结果基于展示时间点统计。)|
#| total_create_gamerole_value| string | 创建角色总价值  | 创建角色总价值(计数结果基于展示时间点统计。)|
|花费点数| | | |
#| spend_credits  | string | 去重花费点数数  | 去重后的用户在app中花费点数并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_spend_credits| string | 去重花费点数成本| 去重后的单次花费点数的成本。(计数结果基于展示时间点统计。) |
#| spend_credits_rate  | string | 花费点数率 (%)  | 去重后的用户花费点数与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_spend_credits | string | 总花费点数数 | 总花费点数数(计数结果基于展示时间点统计。)  |
#| cost_per_total_spend_credits  | string | 每个花费点数成本| 每个花费点数成本(计数结果基于展示时间点统计。)|
#| value_per_total_spend_credits | string | 单次花费点数价值| 单次花费点数价值(计数结果基于展示时间点统计。)|
#| total_spend_credits_value| string | 花费点数总价值  | 花费点数总价值(计数结果基于展示时间点统计。)|
|达到等级| | | |
#| achieve_level  | string | 去重达到等级数  | 去重后的用户在app中达到等级并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_achieve_level| string | 去重达到等级成本| 去重后的单次达到等级的成本。(计数结果基于展示时间点统计。) |
#| achieve_level_rate  | string | 达到等级率 (%)  | 去重后的用户达到等级与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_achieve_level | string | 总达到等级数 | 总达到等级数(计数结果基于展示时间点统计。)  |
#| cost_per_total_achieve_level  | string | 每个达到等级成本| 每个达到等级成本(计数结果基于展示时间点统计。)|
#| value_per_total_achieve_level | string | 单次达到等级价值| 单次达到等级价值(计数结果基于展示时间点统计。)|
#| total_achieve_level_value| string | 达到等级总价值  | 达到等级总价值(计数结果基于展示时间点统计。)|
|解锁关卡| | | |
#| unlock_achievement  | string | 去重解锁关卡数  | 去重后的用户在app中解锁关卡并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_unlock_achievement| string | 去重解锁关卡成本| 去重后的单次解锁关卡的成本。(计数结果基于展示时间点统计。) |
#| unlock_achievement_rate  | string | 解锁关卡率 (%)  | 去重后的用户解锁关卡与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_unlock_achievement | string | 总解锁关卡数 | 总解锁关卡数(计数结果基于展示时间点统计。)  |
#| cost_per_total_unlock_achievement  | string | 每个解锁关卡成本| 每个解锁关卡成本(计数结果基于展示时间点统计。)|
#| value_per_total_unlock_achievement | string | 单次解锁关卡价值| 单次解锁关卡价值(计数结果基于展示时间点统计。)|
#| total_unlock_achievement_value| string | 解锁关卡总价值  | 解锁关卡总价值(计数结果基于展示时间点统计。)|
|收集线索| | | |
#| sales_lead| string | 去重获得销售线索数| 去重后的用户在app中产生销售线索并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_sales_lead | string | 去重获得销售线索成本 | 去重后的单次获得销售线索的成本。(计数结果基于展示时间点统计。) |
#| sales_lead_rate| string | 获得销售线索率 (%)| 去重后的用户产生销售线索与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_sales_lead | string | 总获得销售线索数| 总获得销售线索数(计数结果基于展示时间点统计。)|
#| cost_per_total_sales_lead| string | 每个获得销售线索成本 | 每个获得销售线索成本(计数结果基于展示时间点统计。) |
#| value_per_total_sales_lead | string | 单次获得销售线索价值 | 单次获得销售线索价值(计数结果基于展示时间点统计。) |
#| total_sales_lead_value| string | 获得销售线索总价值| 获得销售线索总价值(计数结果基于展示时间点统计。) |
|应用内广告点击| | | |
#| in_app_ad_click| string | 去重应用内广告点击数 | 去重后的用户在app中点击广告并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_in_app_ad_click | string | 去重应用内广告点击成本 | 去重后的单次应用内广告点击的成本。(计数结果基于展示时间点统计。) |
#| in_app_ad_click_rate| string | 应用内广告点击率 (%) | 去重后的用户被展示应用内广告与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_in_app_ad_click | string | 总应用内广告点击数| 总应用内广告点击数(计数结果基于展示时间点统计。) |
#| cost_per_total_in_app_ad_click| string | 每个应用内广告点击成本 | 每个应用内广告点击成本(计数结果基于展示时间点统计。)  |
#| value_per_total_in_app_ad_click | string | 单次应用内广告点击价值 | 单次应用内广告点击价值(计数结果基于展示时间点统计。)  |
#| total_in_app_ad_click_value| string | 应用内广告点击总价值 | 应用内广告点击总价值(计数结果基于展示时间点统计。) |
|应用内广告展示| | | |
#| in_app_ad_impr | string | 去重应用内广告展示数 | 去重后的用户在app中被展示广告并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_in_app_ad_impr  | string | 去重应用内广告展示成本 | 去重后的单次应用内广告展示的成本。(计数结果基于展示时间点统计。) |
#| in_app_ad_impr_rate | string | 应用内广告展示率 (%) | 去重后的用户被展示应用内广告与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_in_app_ad_impr| string | 总应用内广告展示数| 总应用内广告展示数(计数结果基于展示时间点统计。) |
#| cost_per_total_in_app_ad_impr | string | 每个应用内广告展示成本 | 每个应用内广告展示成本(计数结果基于展示时间点统计。)  |
#| value_per_total_in_app_ad_impr| string | 单次应用内广告展示价值 | 单次应用内广告展示价值(计数结果基于展示时间点统计。)  |
#| total_in_app_ad_impr_value | string | 应用内广告展示总价值 | 应用内广告展示总价值(计数结果基于展示时间点统计。) |
|贷款申请| | | |
#| loan_apply| string | 去重申请贷款数  | 去重后的用户在app中申请贷款并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_loan_apply | string | 去重申请贷款成本| 去重后的单次申请贷款的成本。(计数结果基于展示时间点统计。) |
#| loan_apply_rate| string | 申请贷款率 (%)  | 去重后的用户申请贷款与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_loan_apply | string | 总申请贷款数 | 总申请贷款数(计数结果基于展示时间点统计。)  |
#| cost_per_total_loan_apply| string | 每个申请贷款成本| 每个申请贷款成本(计数结果基于展示时间点统计。)|
|贷款批准| | | |
#| loan_credit | string | 去重授信数 | 去重后的用户在app中被授信并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_loan_credit| string | 去重授信成本 | 去重后的单次授信的成本。(计数结果基于展示时间点统计。)|
#| loan_credit_rate | string | 授信率 (%) | 去重后的用户被授信与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_loan_credit| string | 总授信数| 总授信数(计数结果基于展示时间点统计。) |
#| cost_per_total_loan_credit | string | 每个授信成本 | 每个授信成本(计数结果基于展示时间点统计。)  |
|贷款发放| | | |
#| loan_disbursement| string | 去重放款数 | 去重后的用户在app中被放款并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_loan_disbursement | string | 去重放款成本 | 去重后的单次放款的成本。(计数结果基于展示时间点统计。)|
#| loan_disbursement_rate| string | 放款率 (%) | 去重后的用户被放款与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_loan_disbursement  | string | 总放款数| 总放款数(计数结果基于展示时间点统计。) |
#| cost_per_total_loan_disbursement| string | 每个放款成本 | 每个放款成本(计数结果基于展示时间点统计。)  |
|登录| | | |
#| login| string | 去重登录数 | 去重后的用户在app中登录并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_login | string | 去重登录成本 | 去重后的单次登录的成本。(计数结果基于展示时间点统计。)|
#| login_rate| string | 登录率 (%) | 去重后的用户登录与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_login | string | 总登录数| 总登录数(计数结果基于展示时间点统计。) |
#| cost_per_total_login| string | 每个登录成本 | 每个登录成本(计数结果基于展示时间点统计。)  |
|评价| | | |
#| ratings| string | 去重评价数 | 去重后的用户在app中评价并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_ratings | string | 去重评价成本 | 去重后的单次评价的成本。(计数结果基于展示时间点统计。)|
#| ratings_rate| string | 评价率 (%) | 去重后的用户评价与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_ratings  | string | 总评价数| 总评价数(计数结果基于展示时间点统计。) |
#| cost_per_total_ratings| string | 每个评价成本 | 每个评价成本(计数结果基于展示时间点统计。)  |
#| value_per_total_ratings  | string | 单次评价价值 | 单次评价价值(计数结果基于展示时间点统计。)  |
#| total_ratings_value | string | 评价总价值 | 评价总价值(计数结果基于展示时间点统计。) |
|搜索| | | |
#| search | string | 去重搜索数 | 去重后的用户在app中搜索并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_search| string | 去重搜索成本 | 去重后的单次搜索的成本。(计数结果基于展示时间点统计。)|
#| search_rate | string | 搜索率 (%) | 去重后的用户搜索与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_search| string | 总搜索数| 总搜索数(计数结果基于展示时间点统计。) |
#| cost_per_total_search | string | 每个搜索成本 | 每个搜索成本(计数结果基于展示时间点统计。)  |
|开始试用| | | |
#| start_trial | string | 去重开始试用数  | 去重后的用户在app中开始试用并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_start_trial| string | 去重开始试用成本| 去重后的单次开始试用的成本。(计数结果基于展示时间点统计。) |
#| start_trial_rate | string | 开始试用率 (%)  | 去重后的用户开始试用与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_start_trial| string | 总开始试用数 | 总开始试用数(计数结果基于展示时间点统计。)  |
#| cost_per_total_start_trial | string | 每个开始试用成本| 每个开始试用成本(计数结果基于展示时间点统计。)|
|订阅| | | |
#| subscribe | string | 去重订阅数 | 去重后的用户在app中订阅并归因到您的广告的次数。(计数结果基于展示时间点统计。) |
#| cost_per_subscribe  | string | 去重订阅成本 | 去重后的单次订阅的成本。(计数结果基于展示时间点统计。)|
#| subscribe_rate | string | 订阅率 (%) | 去重后的用户订阅与app激活的占比。(计数结果基于展示时间点统计。) |
#| total_subscribe| string | 总订阅数| 总订阅数(计数结果基于展示时间点统计。) |
#| cost_per_total_subscribe | string | 每个订阅成本 | 每个订阅成本(计数结果基于展示时间点统计。)  |
#| value_per_total_subscribe| string | 单次订阅价值 | 单次订阅价值(计数结果基于展示时间点统计。)  |
#| total_subscribe_value | string | 订阅总价值 | 订阅总价值(计数结果基于展示时间点统计。) |

网页事件数据指标

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

| 指标名称{35%}  | 数据类型{10%}| 简要描述{25%}| 详细描述{30%}|
| --------- | ------ |-------- | --------- |
|支付完成事件的广告支出回报率| | | |
#| complete_payment_roas | string | 支付完成广告支出回报率 | 用户发生支付完成事件的广告支出回报率|
|支付完成| | | |
#| complete_payment | string | 支付完成总数| 支付完成事件发生的次数 |
#| cost_per_complete_payment| string | 支付完成平均成本 | 支付完成事件的平均成本 |
#| complete_payment_rate | string | 支付完成率 (%)  | 支付完成事件在点击事件后发生的概率  |
#| value_per_complete_payment | string | 支付完成平均价值| 用户发生支付完成事件的单次价值 |
#| total_complete_payment_rate| string | 支付完成总价值  | 用户发生支付完成事件的总价值|
|按钮点击| | | |
#| value_per_button_click| string | 单次按钮点击价值| 用户发生按钮点击事件的单次价值 |
#| total_button_click_value | string | 按钮点击总价值  | 用户发生按钮点击事件的总价值|
|完成注册| | | |
#| user_registration| string | 用户注册| 用户注册事件发生的次数|
#| cost_per_user_registration | string | 用户注册成本 | 用户注册事件的平均成本|
#| user_registration_rate| string | 用户注册率 (%)  | 用户注册事件在点击事件后发生的概率|
#| value_per_user_registration| string | 单次用户注册价值| 用户注册事件的单次价值|
#| total_user_registration_value | string | 用户注册总价值  | 用户注册事件的总价值 |
|加入购物车| | | |
#| web_event_add_to_cart | string | 加入购物车总数 | 加入购物车事件发生的次数  |
#| cost_per_web_event_add_to_cart| string | 加入购物车平均成本  | 加入购物车事件的平均成本  |
#| web_event_add_to_cart_rate | string | 加入购物车率 (%)| 加入购物车事件在点击事件后发生的概率|
#| value_per_web_event_add_to_cart | string | 加入购物车平均价值| 用户加入购物车事件的单次价值|
#| total_web_event_add_to_cart_value  | string | 加入购物车总价值| 用户发生加入购物车事件的总价值 |
|下单| | | |
#| on_web_order| string | 下单  | 下单事件发生的次数|
#| cost_per_on_web_order | string | 下单成本| 下单事件的平均成本|
#| on_web_order_rate| string | 下单率 (%) | 下单事件在点击事件后发生的概率 |
#| value_per_on_web_order| string | 单次下单价值 | 用户发生下单事件的单次价值|
#| total_on_web_order_value | string | 下单总价值 | 用户发生下单事件的总价值  |
|开始结账| | | |
#|initiate_checkout | string |开始结账总数  | 开始结账事件发生并归因到您的广告的次数 |
#|cost_per_initiate_checkout |string |开始结账平均成本 | 开始结账事件的平均成本 |
#|initiate_checkout_rate |string |开始结账率 (%) | 开始结账事件次数与点击事件的占比|
#|value_per_initiate_checkout | string |开始结账平均价值  | 开始结账事件的单次价值|
#| total_initiate_checkout_value | string |开始结账总价值  | 开始结账事件的总价值|
|添加支付信息| | | |
#| add_billing | string |添加支付信息总数 | 您的广告的“添加支付信息”事件数 |
#| cost_per_add_billing | string |添加支付信息平均成本 | 添加支付信息事件的平均成本 |
#|add_billing_rate | string |添加支付信息率 (%) | 添加支付信息事件在点击事件后发生的概率 |
#| value_per_add_billing | string |添加支付信息平均价值 | 用户发生添加支付信息事件的单次价值 |
#|total_add_billing_value | string |添加支付信息总价值 | 用户发生添加支付信息事件的总价值 |
|搜索| | | |
#|page_event_search | string |搜索总数  | 搜索事件发生的次数 |
#|cost_per_page_event_search | string |搜索成本 | 搜索事件的平均成本 |
#| page_event_search_rate | string |搜索率 (%) | 搜索事件在点击事件后发生的概率 |
#| value_per_page_event_search | string |单次搜索价值 | 用户发生搜索事件的单次价值 |
#| total_page_event_search_value | string |搜索总价值 | 用户发生搜索事件的总价值 |
|表单填写| | | |
#| form | string | 表单填写总数 |您的广告的表单填写事件数 |
#| cost_per_form | string | 每次表单填写的成本 | 平均每次表单填写事件的成本 |
#| form_rate | string | 表单填写率(%) | 表单填写事件占所有点击事件的百分比|
#| value_per_form | string | 每次表单填写的价值 | 平均从每次表单填写事件返回的价值 |
#| total_form_value | string |表单填写总价值 | 从所有表单填写事件返回的总价值 |
|下载| | | |
#| download_start | string | 点击下载(应用推广) | 点击下载(应用推广)事件发生的次数  |
#|cost_per_download_start| string | 点击下载(应用推广)成本 | 点击下载(应用推广)事件的平均成本|
#| download_start_rate | string | 点击下载(应用推广)率 (%)| 点击下载(应用推广)事件在点击事件后发生的概率|
#| value_per_download_start | string | 单次点击下载(应用推广)价值| 用户发生点击下载(应用推广)事件的单次价值 |
#| total_download_start_value | string | 点击下载(应用推广)总价值| 用户发生点击下载(应用推广)事件的单次价值 |
|加入心愿单| | | |
#|on_web_add_to_wishlist|string| 去重加入心愿单数| 加入心愿单事件发生并归因到您的广告的次数。|
#|cost_per_on_web_add_to_wishlist|string| 去重加入心愿单成本| 加入心愿单事件的平均成本。|
#|on_web_add_to_wishlist_per_click|string|加入心愿单率 (%)| 加入心愿单事件次数与点击事件的占比。|
#|value_per_on_web_add_to_wishlist|string|去重加入心愿单价值| 加入心愿单事件的单次价值。 |
#|total_on_web_add_to_wishlist_value|string|去重加入心愿单总价值|加入心愿单事件的总价值。 |
|订阅| | | |
#|on_web_subscribe|string|去重订阅数| 订阅事件发生并归因到您的广告的次数。|
#|cost_per_on_web_subscribe|string|去重订阅单次成本|订阅事件的平均成本。|
#|on_web_subscribe_per_click|string|订阅率 (%)|订阅事件次数与点击事件的占比。|
#|value_per_on_web_subscribe|string|去重订阅单次价值|订阅事件的单次价值。|
#|total_on_web_subscribe_value|string|去重订阅总价值|订阅事件的总价值。|

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