数据报表
1. 数据说明
1.1 数据类型及定义
| 数据类型 | 定义解释 |
|---|---|
| ToBid 统计指标 | ToBid SDK通过打点采集上报的数据，可通过实时数据计算实时呈现 |
| API 指标 | 各广告网络通过Report API回传给ToBid的数据 注：其中Sigmob平台数据默认回传，其他广告网络需要授权，具体操作请见【第三方广告网络操作指南】 |
| 数据GAP | (ToBid 统计数据 - API数据) / API数据 注：数据GAP率合理指标在5%以内，如果超过10%，请联系商务或技术支持同学及时查验。 |
| 用户行为指标 | 由ToBid SDK统计的用户级别数据 |
1.2 各广告网络支持的API数据指标
部分广告网络暂不支持所有数据指标的API回传，下表为现在各家广告网络所支持的回传指标
| 广告网络 | 收益 | 请求 | 返回 | 填充率 | 展示 | eCPM | 点击 | 点击率 |
|---|---|---|---|---|---|---|---|---|
| Sigmob | - | - | - | - | √ | √ | √ | √ |
| AdMob | √ | √ | √ | √ | √ | √ | √ | √ |
| AppLovin | √ | - | - | - | √ | √ | √ | √ |
| 百度联盟 | √ | √ | √ | √ | √ | √ | √ | √ |
| 穿山甲 | √ | √ | √ | √ | √ | √ | √ | √ |
| ironSource | √ | √ | √ | √ | √ | √ | √ | √ |
| 快手 | √ | - | - | - | √ | √ | √ | √ |
| Mintegral | √ | √ | √ | √ | √ | √ | √ | √ |
| 腾讯广告 | √ | √ | √ | √ | √ | √ | √ | √ |
| Unity Ads | √ | - | - | - | √ | √ | √ | √ |
| Vungle | √ | - | √ | √ | √ | √ | √ | √ |
| 游可赢 | √ | √ | √ | √ | √ | √ | √ | √ |
2. 整体概况
点击【数据报表】-【整体概况】可查看通过第三方广告网络的report api回传数据。
| 表格能力描述 | 解析 |
|---|---|
| 披露数据类型 | 仅API指标 |
| 数据更新时间 | T+1，每天多个时间点从各广告网络拉取数据进行更新，确保数据拉取的完整性 |
| 支持的数据维度 | 时间、操作系统、应用、聚合广告位类型、聚合广告位、广告网络 |
| 披露的数据指标 | 收益API、展示API、点击API、点击率API、eCPM API |
3. 综合报表
点击【数据报表】-【综合报表】可查看账号下变现应用的核心变现数据。
| 表格能力描述 | 解析 |
|---|---|
| 披露数据类型 | ToBid 统计指标 + API指标 |
| 数据更新时间 | 每小时更新 |
| 支持的数据维度 | 时间、操作系统、应用、聚合广告位类型、聚合广告位、广告网络、流量分组、IDFA状态、广告源类型、广告源、聚合SDK版本、APP版本 |
| 披露的数据指标 | - ToBid 统计指标：预估收益、流量请求量、流量返回量、流量填充率、展示量、流量展示率、广告请求量、广告返回量、广告填充率、广告展示率、点击量、点击率、eCPM - API指标：收益API、请求API、返回API、填充率API、展示API、点击API、点击率API、eCPM API - 数据GAP：请求GAP率、返回GAP率、展示GAP率、点击GAP率、eCPM GAP率 |
3.1 数据指标解析
| 属性 | 属性值 | 描述 |
|---|---|---|
| ToBid统计指标 | 预估收益 | 普通广告源预估收益=SUM(瀑布流中设置的期望eCPM*ToBid统计的展示量/1000)，应用内竞价广告源预估收益=SUM(每次展示的实时价格) |
| 流量请求量 | 应用向ToBid发送请求的次数，一次流量请求可能触发多次广告请求 | |
| 流量返回量 | 应用向ToBid发送请求后，返回成功的次数 | |
| 流量填充率 | 应用向ToBid发送请求后，返回成功次数的占比，计算公式：流量返回/流量请求 | |
| 展示量 | ToBid依赖广告展示回调接口统计的广告曝光次数。由于统计口径差异、网络丢包等因素，ToBid统计的展示量与广告网络统计的展示量可能存在差异 | |
| 流量展示率 | 计算公式：展示量/流量返回量 | |
| 广告请求量 | 普通广告源表示广告请求，即ToBid向广告网络发送请求的次数，一次流量请求可能触发多次广告请求；竞价广告源表示竞价请求数，即应用内竞价广告源向第三方广告网络发起询价的次数 | |
| 广告返回量 | 普通广告源表示广告返回，即ToBid向广告网络发送请求后，返回成功的次数；竞价广告源表示竞价响应数，即应用内竞价广告源向第三方广告网络发起询价后，返回了价格的次数 | |
| 广告填充率 | 普通广告源表示广告填充率，即ToBid向广告网络发送请求后，返回成功的占比；竞价广告源表示竞价响应率，即竞价响应数/竞价请求数 | |
| 广告展示率 | 计算公式：展示量/广告返回量 | |
| 点击量 | ToBid依赖广告点击回调接口统计的广告点击数，由于部分广告网络不提供点击回调，ToBid统计的点击数据与广告网络统计的点击数可能存在差异 | |
| 点击率 | 计算公式：点击量/展示量 | |
| eCPM | 在选择的时间范围内，每1000次广告展示所获得的预估收益。计算方法是按选定时间范围的eCPM加权平均进行计算。例如：前7天的eCPM= (收入_Day1 + 收入_Day2 + ... 收入_Day7) / (展示_Day1 + 展示_Day_2 + ... + 展示_Day7) * 1000 | |
| API指标 | 收益API | 通过Reporting API拉取的收益，经实时汇率换算成账号币种称 |
| 请求API | 通过Reporting API拉取的请求量，一些广告网络不会回传此字段 | |
| 返回API | 通过Reporting API拉取的返回量，一些广告网络不会回传此字段 | |
| 填充率API | 计算公式：返回API/请求API | |
| 展示API | 通过Reporting API拉取的展示量 | |
| 点击API | 通过Reporting API拉取的点击量，一些广告网络不会回传此字段 | |
| 点击率API | 计算公式：点击API/展示API | |
| eCPM API | 通过Reporting API拉取的请求量，一些广告网络不会回传此字段 | |
| GAP指标 | 请求GAP率 | Windmll统计的广告请求量与各广告网络统计的广告请求的差异，计算公式：(广告请求量-请求API)/请求API |
| 返回GAP率 | Windmll统计的广告返回量与各广告网络统计的广告返回的差异，计算公式：(广告返回量-返回API)/返回API | |
| 展示GAP率 | Windmll统计的广告展示量与各广告网络统计的广告展示的差异，计算公式：(展示量-展示API)/展示API | |
| 点击GAP率 | Windmll统计的广告点击量与各广告网络统计的广告点击的差异，计算公式：(点击量-点击API)/点击API段 | |
| eCPM GAP率 | Windmll口径计算的eCPM与依赖于广告网络的回传数据计算的eCPM的差异，计算公式：(eCPM-eCPM API)/eCPM API |
3.2 注意事项
- 流量层级数据指标的最细颗粒度是流量分组，所以在勾选**【广告网络/广告源类型/广告源】**中任意维度时，数据报表将自动隐藏流量层级数据的相关指标。
- 在勾选**【聚合SDK版本/APP版本】**中任意维度时，数据报表将自动隐藏API的相关指标数据和GAP率数据指标。
- 在勾选**【广告网络/广告源类型/广告源】和【聚合SDK版本/APP版本】**任意组合时，系统将自动隐藏流量层级数据、API相关数据和GAP率相关的全部数据。
- 流量层级数据指标包括：流量请求量、流量返回量、流量填充率、流量展示率。
4. 分小时报表
点击【数据报表】-【分小时报表】可查看小时数据报表。
| 表格能力描述 | 解析 |
|---|---|
| 披露数据类型 | ToBid 统计指标 |
| 数据更新时间 | 每2~3分钟更新 |
| 支持的数据维度 | 时间、操作系统、应用、聚合广告位类型、聚合广告位、广告网络、流量分组、IDFA状态、广告源类型、广告源、聚合SDK版本、APP版本 |
| 披露的数据指标 | ToBid 统计指标：预估收益、流量请求量、流量返回量、流量填充率、展示量、流量展示率、广告请求量、广告返回量、广告填充率、广告展示率、点击量、点击率、eCPM |
4.1 注意事项
- 流量层级数据指标的最细颗粒度是流量分组，所以在勾选**【广告网络/广告源类型/广告源】**中任意维度时，数据报表将自动隐藏流量层级数据的相关指标。
- 分小时报表仅可查询近90天内，时间跨度为3天的数据。
5. 应用内竞价分析报表
点击【漏斗分析】-【应用内竞价分析】竞价漏斗分析页面，可查看广告在头部竞价广告请求链路产生的数据。
| 表格能力描述 | 解析 |
|---|---|
| 披露数据类型 | ToBid 统计指标 + API指标 |
| 数据更新时间 | 每小时更新 |
| 支持的数据维度 | APP -> 聚合广告位 -> 流量分组 -> A/B分组 -> 广告源 |
| 披露的数据指标 | - ToBid 统计指标：预估收益、竞价请求数、竞价响应数、竞价胜出数、竞价响应率、竞价胜出率、广告物料请求量、广告物料返回量、广告物料展示量、广告物料点击量、广告物料填充率、广告物料展示率、广告物料点击率、竞价请求平均耗时、eCPM、竞价响应平均出价 - API指标：收益API、请求API、返回API、填充率API、展示API、点击API、点击率API、eCPM API |
5.1 特殊指标说明
| 指标名称 | 指标说明 |
|---|---|
| 竞价请求数 | 应用内竞价广告源向第三方广告网络发起询价的次数 |
| 竞价响应数 | 应用内竞价广告源向第三方广告网络发起询价后，返回了价格的次数 |
| 竞价胜出数 | 应用内竞价广告源的竞价响应数中，在整体瀑布流排序中胜出的次数 |
| 竞价响应率 | 计算公式：竞价响应数/竞价请求数 |
| 竞价胜出率 | 计算公式：竞价胜出数/竞价响应数 |
| 广告物料请求量 | 应用内竞价广告源在竞价胜出后，向第三方广告网络发送的广告请求，用于加载广告物料 |
| 广告物料返回量 | 应用内竞价广告源在竞价胜出后，向第三方广告网络发送的物料请求后，返回成功的次数 |
| 广告物料填充率 | 计算公式：物料返回量/物料请求量 |
| 竞价请求平均耗时 | 应用内竞价广告源发起竞价请求到接收竞价响应的平均响应耗时 |
| 竞价响应平均出价 | 应用内竞价广告源竞价响应中的平均出价 |
6. 用户行为报表
点击【数据报表】-【用户行为报表】可查看用户行为报表。
| 表格能力描述 | 解析 |
|---|---|
| 披露数据类型 | ToBid 统计指标 + API指标 |
| 数据更新时间 | T+1 |
| 支持的数据维度 | 时间、操作系统、应用、聚合广告位类型、聚合广告位、流量分组、IDFA状态、聚合SDK版本、APP版本 |
| 披露的数据指标 | - ToBid 统计指标：DAU、DEU、渗透率、展示量、DAU人均展示、预估收益、DEU人均展示、ARPDAU、eCPM - API指标：展示API、DAU人均展示API、DEU人均展示API、收益API、ARPDAU API、eCPM API |
6.1 注意事项
- 在汇总行可披露DAU指标时，指标计算方式为多日平均值
- 在选择【流量分组】、【广告位类型】、【聚合广告位】等维度时，汇总行的DAU无实际含义，系统将自动隐藏汇总行数据
7. 瀑布流数据报表
点击【聚合管理】-【瀑布流管理】进入瀑布流管理页面，可对所选的APP-聚合广告位，进行流量分组、广告源的设定，并可查看瀑布流下的详细数据。 
| 表格能力描述 | 解析 |
|---|---|
| 披露数据类型 | ToBid 统计指标 + API指标 |
| 数据更新时间 | 每小时更新 |
| 支持的数据维度 | APP -> 聚合广告位 -> 流量分组 -> A/B分组 |
| 披露的数据指标 | - ToBid 统计指标：预估收益、请求量、返回量、填充率、展示量、展示率点击量、点击率、eCPM、填充耗时、预估收益占比、展示占比、点击占比 - API指标：收益API、请求API、返回API、填充率API、展示API、点击API、点击率API、eCPM API、收入API占比、展示API占比、点击API占比 - 数据GAP：请求GAP率、返回GAP率、展示GAP率、点击GAP率、eCPM GAP率 |
7.1 特殊数据指标解析
| 指标名称 | 指标说明 |
|---|---|
| 请求量 | 汇总行表示流量请求，即应用向ToBid发送请求的次数；其余行的普通广告源表示广告请求，即ToBid向广告网络发送请求的次数；其余行的竞价广告源表示竞价请求数，即应用内竞价广告源向第三方广告网络发起询价的次数 |
| 返回量 | 汇总行表示流量返回，即应用向ToBid发送请求后，返回成功的次数；其余行的普通广告源表示广告返回，即ToBid向广告网络发送请求后，返回成功的次数；其余行的竞价广告源表示竞价响应数，即应用内竞价广告源向第三方广告网络发起询价后，返回了价格的次数 |
| 填充率 | 汇总行表示流量填充率，即应用向ToBid发送请求后，返回成功次数的占比；其余行的普通广告源表示广告填充率，即ToBid向广告网络发送请求后，返回成功的占比；其余行的竞价广告源表示竞价响应率，即竞价响应数/竞价请求数 |
| 展示率 | 汇总行表示流量展示率，计算公式=展示量/流量返回量；其余行的普通广告源表示广告展示率，计算公式=展示量/广告返回量；其余行的竞价广告源表示广告物料展示率，即物料展示量/物料返回量 |
| 填充耗时 | 汇总行表示流量填充耗时，即应用向ToBid发起广告请求后，拉取到广告填充的耗时；其余行表示广告填充耗时，即ToBid向广告网络发送请求后，拉取到广告填充的耗时，因Unity存在自填充行为，无法准确统计填充耗时，暂不显示Unity广告源的耗时数据 |
7.2 注意事项
在瀑布流开启A/B Test后，系统会自动生成新的试验id来记录每次A/B Test的数据结果。所以在开启/关闭当次A/B Test后，瀑布流将不再保留本次A/B Test试验前的数据，仅会披露当次A/B 试验开启以后的数据。历史详细数据可在【综合报表】中查看。
举例说明：
| 时间顺序 | 瀑布流披露数据 |
|---|---|
| 5月15日 12:30查看瀑布流数据 | 选择时间段为5月15日，披露截至12:00的全部数据 |
| 5月15日 13:00开启A/B Test | 因为刚刚开启A/B Test，生成新的试验ID，所以选择任意时间段，报表披露数据全部为空 |
| 5月15日 16:00查看瀑布流数据 | - 选择时间段为5月15日，披露13:00~16:00期间 A组或B组分别产生的数据 - 选择时间段为5月15日以前，披露数据为空，因为当前的试验ID，在15日13点以前无任何数据产生 |
| 5月15日 17:30进行A/B Test的全量操作，全量使用A组配置 | - 选择时间段为5月15日，披露13:00~17:00，A组试验数据 - 选择时间段为5月15日以前，披露数据为空，因为当前全量使用A组试验数据的试验ID，在5月15日以前没有产生数据 |
8. 数据差异及常见问题
8.1 ToBid预估数据与API数据GAP很大，原因是什么？
- ToBid SDK会依赖各家广告网络SDK提供的展示、返回、点击等回调接口统计SDK数据。由于统计口径差异、网络丢包、排重等因素，ToBid统计的指标会与第三方广告网络统计的指标存在差异。
- 广告网络后台数据，仅包含其认为有效的数据，如频繁请求、作弊、网络问题等无效流量，会在第三方广告网络统计的数据中过滤掉，但是该部分数据，已在ToBid 预估数据中统计。
- 通常情况下，数据GAP率合理指标在5%以内，如果超过10%，请联系商务或技术支持同学及时查验。
8.2 为什么有时候部分广告网络的API数据10点还没有更新？
- 每家广告网络出数的时间不稳定，聚合平台会每间隔1小时通过第三方广告网络的Report API接口进行拉数重试。如在每天中午12点以后还未在报表上查看API维度数据，可联系对接商务同学寻求帮助并查看原因。
8.3 在平台删除了广告位或广告源，报表内还会显示数据么？
- 会的，所有在平台上创建的广告位或广告源，将会永久保留数据。已删除的广告位或广告源，虽然平台上做了删除操作，但是实际业务表现是逻辑删除，在数据报表上如果勾选相应的数据维度时，会有“已删除”的字样呈现。
已删除的广告位或广告源，由于删除了操作路径上的根节点，所以无法点击相应的ID进行页面跳转
8.4 预估收益和收益API的关系是什么？
| 数据指标 | 指标定义 |
|---|---|
| 预估收益 | - 普通广告源预估收益=SUM(瀑布流中设置的期望eCPM x ToBid统计的展示量/1000) - 应用内竞价广告源预估收益=SUM(每次展示的实时价格) |
| 收益API | 通过report api拉取的收益 |
在ToBid 统计的展示量与三方广告网络统计的展示量GAP极小或无GAP的情况下，在瀑布流中对广告源填写的排序eCPM价格，就成为了预估收益计算的关键指标。
排序价格的定义：该价格仅用于广告请求时的优先级排序和ToBid统计指标预估收益的计算。如果在广告网络设置了eCPM底价，建议此处填写的价格与设置的底价保持一致。
瀑布流在实际运作中，排序价格将作为广告请求、广告展示的唯一排序来源。
