# React Native 的印象级别收入集成

> 集成展示级别收入(ILR) SDK API 以收集详细的广告效果数据并将其发送到 React 本地 app 中的数据分析服务工具。

## 先决条件##prerequisites

确保已将 LevelPlay React 原生 SDK 正确集成到应用程序中，如[此处](/grow/levelplay/sdk/react/plugin-integration.md)所述。

使用 SDK 功能和先决条件，进一[步](/grow/levelplay/platform/api/impression-level-revenue-server-side.md)了解展示量收入 (ILR)。

## 实现 ImpressionData 监听器##implement-the-impressiondata-listener

LevelPlay SDK 会触发回传以通知您显示的广告。ImpressionData 监听器是一个可选监听器，可以实现该监听器来接收展示数据。此监听器将为您提供有关所有广告单位的信息，并且您可以使用展示量收入来识别不同的广告服务。

如果要将 ImpressionData 监听器添加到应用程序中，请确保在初始化 LevelPlay SDK 之前声明监听器，以避免任何信息丢失。

### 设置 ImpressionDataListener##set-the-impressiondatalistener

```js
从“Unity-levelplay-mediation”导入 { LevelPlay，输入 LevelPlayImpressionDataListener }

const 监听器：LevelPlayImpressionDataListener = {
  onImpressionSuccess: (impressionData) => {
    // Use the impression data
  },
}
LevelPlay.addImpressionDataListener(listener)
```

LevelPlay SDK 将通知您的监听器与展示数据相关的成功回传。监听器接口为：

```js
interface LevelPlayImpressionDataListener { }
  /**
   * 成功录制广告展示（显示广告）时调用。
   * Android：onImpressionSuccess
   * iOS： impressionDataDidSucceed
   */
  onImpressionSuccess：（impressionData：LevelPlayImpressionData) => void
}
```

## 集成 ILR 数据##integrate-the-ilr-data

实现 ImpressionDataListener 后，您可以使用展示数据并将其发送到您自己的专有 BI 工具和 DWH，或者将其与第三方工具集成。

> **Note:**
>
> 返回的数据可能包括 null 值。确保在分配数据之前添加保护，以避免潜在的崩溃。

您可以引用 `LevelPlayImpressionData` 对象上的每个字段：

```ts
从“Unity-levelplay-mediation”导入类型 { LevelPlayImpressionData }

// LevelPlayImpressionData type:
type LevelPlayImpressionData = {
  auctionId: string | null;
  mediationAdUnitName: string | null;
  mediationAdUnitId: string | null;
  adFormat：字符串 | null;
  country：字符串 | null;
  ab: 字符串 | null;
  segmentName: string | null;
  放置/位置：字符串 | null;
  adNetwork：字符串 | null;
  instanceName: string | null;
  instanceId：字符串 | null;
  revenue: number | null; // 双倍
  precision: 字符串 | null;
  encryptedCPM：字符串 | null;
  conversionValue: number | null; // 双
  creativeId：字符串 | null;
}
```

有关字段和类型的完整列表，请参阅 [Impression Level Revenue SDK API](/grow/levelplay/platform/fundamentals/impression-level-revenue-sdk-api.md) 文档。