インプレッションレベルの収益サーバー側 API
ILR Server Side APIを使用して日次CSVレポートにアクセスし、インプレッションとデバイスレベルで広告収益を追跡します。
読み終わるまでの所要時間 1 分最終更新 6日前
インプレッションレベル収益（ILR）ソリューションでは、LevelPlay メディエーションで広告のデバイスとインプレッションレベルの両方のデータを提供します。2 つの異なる API があります。
- デバイス レベル データをプルするための1つ
- 1つはインプレッションレベルデータの取得用です。
収益は、アプリケーション、ネットワーク、国、インスタンスに応じて、各インプレッションの eCPM に基づいて計算されます。
しくみ
- インプレッションレベルとユーザーレベルのデータのプルは、以下の手順を実行して実行します。
- API リクエストを送信し、レポートをダウンロードするための URL リンクを取得する
- 提供されたリンクをクリックしてレポートをダウンロードする
- 各 API 呼び出しは、1 つのアプリケーションと 1 つの日付に対して行う必要があります。
- 各日付のデータは保存して 14 日間だけ利用できます。
- 例: 1 月 1 日のデータは 1 月 14 日まで利用可能
- 毎日、昨日のデータは UTC 午前 10:00 から利用できます。API の呼び出しは、毎日 10:00 AM UTC 以降だけにしてください。
- 例: 1 月 1 日のデータは 1 月 2 日の午前 10 時 (日本時間) 以降にのみ利用可能。
- 毎日、昨日と一昨日のデータを更新します。データは 2 日後には変更されません。
- 例: 1 月 1 日のデータは 1 月 2 日と 1 月 3 日に更新される。1 月 3 日以降はデータは変更されない
- Date & アプリケーション キー (日付とアプリキー) はレポート (ファイル) ごとに一意のであるため、インプレッションレポートとユーザーレベルレポートの両方に含まれません。
インプレッションレベル
レポート URL 取得のための API リクエスト
注
正しい API リクエストを送信すると、リクエストしたファイルへのリンクが返されます。このファイルをダウンロードできるのは 1 時間です。
Authenticationタイプ
メソッド
必須パラメーター
名前 | 型 | 説明 |
|---|---|---|
| 文字列 | YYYY-MM-DD (UTC タイムゾーン) |
| 文字列 | アプリケーションキー (プラットフォーム上で表示されるもの) |
リクエストの URL 例
反応の例 URL
{"urls": ["https://user-ad-revenue.s3.amazonaws.com/data/bi_databases/arm/tables/mediation/report_version%3Dv1/publisher_id%3D551399/application_id%3D225509/day%3D2020-03-31/report.csv.gz?AWSAccessKeyId=AKIAILCCGIXP5G2XNXBA&Expires=1585751272&Signature=bONL8mMc%2B0kdtekXzmXRT4shidQ%3D"],"expiration": "2020-03-31 14:27:52"}
レポートのダウンロード
レポートをダウンロードする URL を選択します。
フィールド定義 v3
フィールド | 説明 | 例 |
|---|---|---|
| インプレッションの正確な日時（UTC） | 2020-03-30 09:33:58 |
| デバイス広告 ID - GAID または IDFA | fdbe7b9b-d183-4c7c-9bb5-59c9df8c35aa |
| デバイス広告ベンダーID - アプリケーション セットIDまたはIDFV | A0810F0B-16C2-474B-B765-77B3A3113AA2 |
| 開発者によって設定されているユーザー ID | 135920 |
| 収益が発生した広告の形式 | 動画リワード |
| 広告ネットワーク名 | Admob |
| 広告キャンペーンのクリエイティブ ID。デフォルトは空の文字列です（Google、Meta、Digital Turbine、および Mintegral ネットワークは含まれません）。 | 65af8c5f9dd504dba89ea38e |
| プラットフォームで定義されている広告ネットワークのインスタンス名。入札ソースのインスタンス名は「Bidding」になります。 | High (高) |
| ISO 3166-1 アルファ-2 に基づく 2 文字の国コード | CN |
| プラットフォームで定義されたユーザーに関連する配置 | ホーム画面 |
| ユーザーが関連づけられているセグメント。セグメント化メソッドに基づいて定義されます。詳細を読む | Tier 1 |
| ユーザーが割り当てられている A/B テストグループ (「A」、「B」、「N/A」など) | A、B、N/A |
| ユーザーによって発生した収益 (ドル)。収益値は推定値（CPM / Rate）または正確値（入札者インスタンスの場合、FAN を除く）のいずれかです。 | 0.5 |
| 収益が発生した広告単位のID | fgx25t56dq201bd2 |
| 収益が発生した広告単位の名前 |
ユーザーレベル
レポート URL 取得のための API リクエスト
正しい API リクエストを送信すると、リクエストしたファイルへのリンクが返されます。このファイルをダウンロードできるのは 1 時間です。
認証タイプ
メソッド
GET:
platform.ironsrc.com/partners/userAdRevenue/v3
必須パラメーター
名前 | 型 | 説明 |
|---|---|---|
| 文字列 | YYYY-MM-DD (UTC タイムゾーン) |
| 文字列 | アプリケーションキー (プラットフォーム上で表示されるもの) |
| 整数 | さまざまなレポート タイプのサポート。現在、 は常に 1 に設定する必要があります。 |
リクエスト例 URL
https://platform.ironsrc.com/partners/userAdRevenue/v3?appKey=12345678&date=2018-12-15&reportType=1
反応の例 URL
https://user-ad-revenue.s3.amazonaws.com/data/biデータベース/uar/tables/ネットワーク/レポート バージョン%3Dv1/パブリッシャーID%3D138101/アプリケーションID%3D100411/day%3D2018-07-13/000000.gz?AWSAccessKeyId=AKIAILCCGIXP5G2XNXBA&Expires=1532524582&Signature=1U%2FbrLmb%2F7TwXXdoHtb%2F%2FQjrmz0%3D
レポートのダウンロード
レポートをダウンロードする URL を選択します。以下のセクションでは、各種レポートフィールドの定義の概要を説明します。
フィールド定義
フィールド | 説明 | 例 |
|---|---|---|
| 収益が発生した広告単位 | 動画リワード |
| ユーザーのデバイスの一意の ID | 21d0e51a-772d-4b23-9fc4-296126b4f123 |
| ユーザーのデバイスの一意の ID タイプ | IDFA/IDFV/GAID |
| 開発者によって設定されているユーザー ID | 135920 |
| セグメント化に基づいて定義された、ユーザーに関連するセグメント |