# インプレッションレベル収益SDK API

> インプレッションレベル収益(ILR)SDK APIを使用すると、すべてのメディエーションネットワークのインプレッションレベルデータをリアルタイムに受信できるため、サードパーティ製のレポートツールやプロプライエタリ最適化システムとのインテグレーションが可能になります。

インプレッションレベル収益 (ILR) SDK API は、LevelPlay SDK を使用して、すべてのメディエーションネットワークのインプレッションレベルデータを提供します。これは、サーバー側のAPIを介してILRデータを使用する代替手段であり、併用できます。開発者は、サーバーサイド API、SDK API、またはその両方を使用して ILR を統合できます。

サーバ側の API を介して ILR を使用すると、1 日遅延のデータが得られます。ILR SDK API を使用すると、広告が表示されたときに即座にリアルタイムの ILR データが可能になり、アプリケーションのインプレッションデータをサードパーティの製のレポートツールやプロプライエタリの最適化ツールやデータベースとインテグレーションできます。

ILR SDK API は、Android、iOS、Unity の SDK 7.0.3 以降でサポートされており、入札インスタンスがウォーターフォールの一部として含まれている場合にのみ提供されます。

## ILR SDK API の使用方法##how-to-use-the-ilr-sdk-api

1. LevelPlay SDK 7.0.3 以降を統合し、ウォーターフォールに少なくとも 1 つの入札者インスタンスがあることを確認します。
2. LevelPlay インプレッションデータリスナーに登録

### ステップ 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       | オークションの一意の識別子                                                                                                                                                                    | String |
| adUnit          | 表示される広告単位(動画リワード/インタースティシャル/バナー)                                                                                                                                                 | String |
| adNetwork       | 広告を配信した広告ネットワーク名                                                                                                                                                                 | String |
| instanceName    | プラットフォームで定義されている広告ネットワークのインスタンス名。入札ソースの場合、インスタンス名は「Bidding（入札）」になります。                                                                                                            | String |
| instanceId      | ネットワークごとの識別子。広告ネットワークのインスタンスID/配置/ゾーンが含まれます。                                                                                                                                     | String |
| country         | 国コード ISO 3166-1 形式式                                                                                                                                                              | String |
| プレースメント         | ユーザーが関連する配置                                                                                                                                                                      | String |
| 収益              | インプレッションから生み出される収益（米ドル）。収益値は、精度に応じて推定または正確のいずれかになります (精度フィールドの説明を参照)。                                                                                                            | ダブル    |
| 精度              | revenue フィールドのソース値:BID – リアルタイムオークションの一部として提供された収益 (FAN 入札者はサポートされません) RATE – LevelPlay プラットフォーム CPM でパブリッシャーがインスタンスに割り当てた手動価格 – LevelPlay プラットフォームで実行された履歴インスタンスのパフォーマンスに基づいて計算 | String |
| ab              | A/B テストが LevelPlay プラットフォームを介してアクティブ化されたかどうかを示す                                                                                                                                  | String |
| segmentName     | セグメント化メソッドに基づいて定義された、ユーザーに関連するセグメント                                                                                                                                              | String |
| lifetimeRevenue | ユーザーの広告収益の累計額                                                                                                                                                                    | ダブル    |
| encryptedCPM    | Meta オーディエンス ネットワーク によって提供される広告にのみ関連し、クローズドベータ版内で Meta オーディエンス ネットワーク によって承認されたパブリッシャーにレポートされます。                                                                                 | String |
| creativeId      | 広告キャンペーンのクリエイティブ ID。デフォルトは空の文字列です。                                                                                                                                               | String |

> **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)