# 展示级别收入 SDK API

> 使用展示级别收入(ILR) SDK API 可接收所有聚合网络的实时展示级别数据，从而与第三方报告工具和专有优化系统集成。

展示级别收入 (ILR) SDK API 使用 LevelPlay SDK 为所有聚合网络提供展示级别数据。这是通过服务器器端 API 使用 ILR 数据的替代方法，可与它一起使用。开发者可以通过服务器 API、SDK API 或两者集成 ILR。

通过服务器 API 使用 ILR 可提供延时 1 天的数据。使用 ILR SDK API 可在展示广告时立即启用时间 ILR 数据，并允许将app程序的展示量数据与第三方报告工具或专有优化工具和数据库集成。

SDK 7.0.3+ 支持适用于 Android、iOS 和 Unity 的 ILR SDK API，仅在竞价实例作为瀑布流的一部分包含在内时才提供。

## 如何使用 ILR SDK API##how-to-use-the-ilr-sdk-api

1. 确保已集成 LevelPlay SDK 7.0.3+，并且瀑布流中至少有一个出价者实例。
2. 注册 LevelPlay impressionData Listeners

### 步骤 1：集成 LevelPlay SDK##step-1:-integrate-levelplay-sdk

集成 LevelPlay SDK 7.0.3+：

* [Android](/grow/levelplay/sdk/android/sdk-integration.md)
* [iOS](/grow/levelplay/sdk/ios/sdk-integration.md)
* [Unity](/grow/levelplay/sdk/unity/package-integration.md)

### 步骤 2：注册到 LevelPlay 监听器##step-2:-register-to-levelplay-listener

LevelPlay SDK 会触发多个事件来告知有关展示数据的信息。此监听器是可选的，您应该仅将其作为 ILR 实现过程的一部分。此监听器将提供有关所有广告单位的信息，您可以使用展示量收入识别不同的广告服务。

有关更多信息：

* [Android ImpressionDataListener](/grow/levelplay/sdk/android/impression-level-revenue-integration.md)
* [iOS ImpressionDataDelegate](/grow/levelplay/sdk/ios/impression-level-revenue-integration.md)
* [Unity ImpressionDataListener](/grow/levelplay/sdk/unity/impression-level-revenue-integration.md)

## ILR 字段##ilr-fields

展示级别收入作为 ImpressionData 对象的一部分返回。以下是相关数据字段的列表，包括描述和类型。

| 参数名称            | 描述                                                                                                             | 数据类型 |
| --------------- | -------------------------------------------------------------------------------------------------------------- | ---- |
| auctionId       | 拍卖的唯一标识符                                                                                                       | 字符串  |
| adUnit          | 显示的广告单元（奖励视频/插页/横幅）                                                                                            | 字符串  |
| adNetwork       | 投放广告的广告网络名称                                                                                                    | 字符串  |
| instanceName    | 平台上定义的广告网络实例名称。对于竞价源，实例名称将为“Bidding”                                                                           | 字符串  |
| instanceId      | 每个网络的标识符，包括广告网络的实例 ID/放置/位置/区域                                                                                 | 字符串  |
| country         | 国家代码 ISO 3166-1 格式                                                                                             | 字符串  |
| placement       | 用户相关的放置/位置                                                                                                     | 字符串  |
| 收入              | 广告展示产生的收入（美元）。收入值根据精度进行估算或精确估算（请参阅精度字段描述）                                                                      | 双倍   |
| 精度              | Revenue 字段的音频源值：BID – 时间拍卖中提供的收入（不受 FAN 出价者支持） 速率 – 发布者分配给 LevelPlay 平台中实例的手动价格 CPM – LevelPlay 平台根据历史实例性能进行计算 | 字符串  |
| ab              | 指示是否通过 LevelPlay 平台激活了 A/B 测试                                                                                  | 字符串  |
| segmentName     | 用户相关的细分段（根据细分方法定义）                                                                                             | 字符串  |
| lifetimeRevenue | 用户广告收入的累积值                                                                                                     | 双倍   |
| encryptedCPM    | 仅与 Meta Audience Network 提供的广告服务相关，并将在封闭测试版内报告给 Meta Audience Network 批准的发布者                                   | 字符串  |
| creativeId      | 广告系列的创意 ID。默认为空字字符串。                                                                                           | 字符串  |

> **Note:**
>
> ILR SDK 回传信息不包括可从设备本身检索的数据，例如 IDFA/GAID、设备模型或设备制造商。

## 如何在应用程序中使用 ILR##how-to-use-ilr-within-your-application

集成 LevelPlay SDK 7.0.3+ 并实现监听器和回调后，即可处理相关数据。impressionData 将作为回调信息的一部分在展示成功（广告正确显示）时返回给您。ImpressionData 包括用于单独获取每个字段的简便 API，或返回 JSON 表示的字符串的 allData API。

有关更多信息：

* [Android ImpressionDataListener](/grow/levelplay/sdk/android/impression-level-revenue-integration.md)
* [iOS ImpressionDataDelegate](/grow/levelplay/sdk/ios/impression-level-revenue-integration.md)
* [Unity ImpressionDataListener](/grow/levelplay/sdk/unity/impression-level-revenue-integration.md)