---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ads.yandex.com/helpcenter/en/dev/android/impression-level.md
  - https://ads.yandex.com/helpcenter/ru/dev/android/impression-level.md
  - https://ads.yandex.com/helpcenter/zh/dev/android/impression-level.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ads.yandex.com/helpcenter/zh/llms.txt

# 展示层级收入数据 (ILRD)



<!-- source: zh/dev/_includes/ilrd.md -->
通过展示层级收入数据 (ILRD)，您可以处理详细的收入数据。从 Mobile Ads SDK 5.0.0 开始，SDK 为您提供每次广告展示的收入信息以及有关投放广告的广告网络（如果使用移动聚合）的信息。此信息在设备上的发布商应用中实时提供。您可以直接处理这些数据或将其传输给第三方分析服务提供商。

## 可以获得哪些数据

发布商可以获得以下数据：

#|
|| **字段**        | **类型**         | **描述**   ||
|| `ad_unit_id`| 字符串      | 唯一的广告单元 ID。||
|| `adType`    | 字符串       | 广告类型：
* 横幅广告
* 插屏广告
* 原生广告
* 激励广告  ||
   || `currency`  | 字符串    | 广告网络币种。      ||
   || `revenue`   | 字符串  | 以广告网络币种表示的每次展示收入。使用 `currency` 字段值。  ||
   || `revenueUSD`    | 字符串  | 转换为美元的每次展示收入。||
   || `precision` | 字符串  | `revenue` 值的准确性。可接受的值：
* `publisher_defined`：该值考虑了聚合界面的 CPM 价格。
* `estimated`：基于自动策略的值。||
   || `network.name` | 字符串   | 投放广告的网络名称（适用于 Yandex 聚合）。||
   || `network.ad_unit_id` | 字符串 | 投放广告的网络中的唯一广告单元 ID（适用于 Yandex 聚合）。||
   |#
<!-- endsource: zh/dev/_includes/ilrd.md -->

## 启用ILRD

1. 按照说明启用 5.0.0 或更高版本的 Mobile Ads SDK（YAN：[Android](https://ads.yandex.com/helpcenter/zh/dev/android/quick-start.md)，Yandex 聚合：[Android](https://ads.yandex.com/helpcenter/zh/dev/android/quick-start-mm.md)）。

2. 实施用于事件跟踪的客户端接口/协议。

   实施 BannerAdEventListener、InterstitialAdEventListener、NativeAdEventListener 和 RewardedAdEventListener 接口时，请使用带有 `ImpressionData` 参数的 `onImpression` 方法。计算展示次数时会调用 `onImpression` 方法。`ImpressionData` 资产具有单一方法 `getRawData`，它会返回带有 ILRD 的 JSON 字符串。

   {% list tabs %}

   - Kotlin
      ```kotlin
        class ExampleNativeAdEventListener : NativeAdEventListener {
           // ...
           override fun onImpression(impressionData: ImpressionData?) {
               val rawData = impressionData?.rawData
              // ...
           }
           // ...
        }
      ```

   - Java
      ```java
        public class ExampleNativeAdEventListener implements NativeAdEventListener {
           // ...
           @Override
           public void onImpression(@Nullable final ImpressionData impressionData) {
               final String rawData = impressionData.getRawData();
              // ...
           }
           // ...
        }
      ```

   {% endlist %}