展示级别收入 SDK API
使用展示级别收入(ILR) SDK API 可接收所有聚合网络的实时展示级别数据，从而与第三方报告工具和专有优化系统集成。
阅读时间5 分钟最后更新于 2 天前
展示级别收入 (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
- 确保已集成 LevelPlay SDK 7.0.3+，并且瀑布流中至少有一个出价者实例。
- 注册 LevelPlay impressionData Listeners
步骤 1：集成 LevelPlay SDK
集成 LevelPlay SDK 7.0.3+：
步骤 2：注册到 LevelPlay 监听器
LevelPlay SDK 会触发多个事件来告知有关展示数据的信息。此监听器是可选的，您应该仅将其作为 ILR 实现过程的一部分。此监听器将提供有关所有广告单位的信息，您可以使用展示量收入识别不同的广告服务。
有关更多信息：
ILR 字段
展示级别收入作为 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。默认为空字字符串。 | 字符串 |
注意
ILR SDK 回传信息不包括可从设备本身检索的数据，例如 IDFA/GAID、设备模型或设备制造商。
如何在应用程序中使用 ILR
集成 LevelPlay SDK 7.0.3+ 并实现监听器和回调后，即可处理相关数据。impressionData 将作为回调信息的一部分在展示成功（广告正确显示）时返回给您。ImpressionData 包括用于单独获取每个字段的简便 API，或返回 JSON 表示的字符串的 allData API。
有关更多信息：