レポート API
LevelPlay Ads Reporting API へのフィルタリングされた GET 呼び出しを使用して、広告フォーマットとディメンション間で Monetization データを取得します。
読み終わるまでの所要時間 1 分最終更新 6日前
重要
以前のバージョンの API は、2025 年 8 月 15 日に非推奨になります。サービスの中断を避けるために、期限前に最新バージョンに更新してください。
この API を使用して、LevelPlay や Ironsource Ads で提供される Monetization 広告フォーマットからすべてのレポートデータを受け取ります。これには、収益、インプレッション、アクティブユーザーなどの複数の指標が、いくつかの内訳と任意のフィルターにわたって含まれます。
注
Reporting API は、1 時間ごとに 8,000 リクエストに制限されます。
Authenticationタイプ
メソッド
必須パラメーター
|
|
|
|
|---|---|---|---|
| 文字列 | YYYY-MM-DD (UTC タイムゾーン) | |
| 文字列 | YYYY-MM-DD (UTC タイムゾーン) |
オプションのパラメーター
ironsource Ads Reporting API では、任意のパラメータのいずれかを使用してレポートをフィルタリングできます。これにより、任意のフィルタへの直接一致を検索できます。
|
|
|
|
|---|---|---|---|
| 文字列(カンマ区切り) | キーlay と Ironsource Ads プラットプラットフォームで確認) | すべてのアプリケーション |
| 文字列(カンマ区切り) | 2 文字の国コード。 ISO 3166-1 アルファ 2 を参照してください。 | すべての国 |
| 文字列 |
| すべての広告フォーマット |
| 文字列(カンマ区切り) | ironsource Ads などのメディエーション広告ネットワーク。 LevelPlay API の命名と設定 を参照してください。 | すべての広告ソース |
| 文字列 (ブーリアン) | 2024 年 3 月 1 日よりサポートされます。 ironsource Ads ネットワークにのみ関連します。 オプションは、
| すべて |
| 文字列 (ブーリアン) | オプションは、
| すべて |
| 文字列 | オプションは、
| すべて |
| 文字列 | オプションは、
| すべて |
| 文字列(カンマ区切り) | メディエーショングループ (LevelPlay プラットフォームで表示) | すべてのグループ |
| 文字列(カンマ区切り) | 収益が発生した広告単位のID | すべてのメディエーション広告ユニット |
| 文字列(カンマ区切り) | サポートされている指標セクションを参照してください。 | すべての指標 |
| 文字列(カンマ区切り) | サポートされている内訳セクションを参照してください。 | date |
| number | ディスプレイするページ番号 | 1 |
| number | 各ページにディスプレイする結果の数 | 5000 |
サポートされる内訳
- 日付 (日) / 週 / 月
- app
- platform
- adNetwork
- isBidder
- adFormat
- インスタンス
- country
- mediationGroup
- mediationAdUnit
- セグメント
- プレースメント
- osVersion
- sdkVersion
- appVersion
- att
- idfa
- gaid
- abTest
- isLevelPlayMediation
- bannerSize
注
期間を指定しない場合、返されるデータは特定の期間で分割されず、要求された指標のすべての履歴データになります。
サポートされる指標
- 収益
- impressions
- eCPM
- クリック数
- clickThroughRate
- sessions （セッション）
- engagedSessions
- impressionPerEngagedSessions
- impressionsPerSession
- activeUsers
- revenuePerActiveUser
- sessionsPerActiveUser
- impressionsPerActiveUser
- engagedUsers
- revenuePerEngagedUser
- impressionsPerEngagedUser
- engagedUsersRate
- appFills
- appFillRate
- useRate
- appRequests
- 補完
- completionRateImpBased
- revenuePerCompletion
- adSourceChecks
- adSourceResponses
- adSourceAvailabilityRate
内訳の制限
以下の内訳の組み合わせは、検証エラーが発生します。
- インスタンス
- セグメント
- プレースメント
- bannerSize
- イドファ
- ガイド
- Att
- appVersion
- SdkVersion
- osVersion
リクエスト例 URL
https://platform.ironsrc.com/levelPlay/reporting/v1?startDate=2024-12-01&endDate=2024-12-02&metrics=revenue,impressions,activeUsers&breakdowns=date,adFormat&adFormat=rewarded
JSON 反応例
{ "data": [ { "date":"2024-12-01", "adFormat":「報酬型」、 "revenue":96891.75, "impressions":12186156, "activeUsers":13310891 }, { "date":"2024-12-01", "adFormat":「報酬型」、 "revenue":101385.59, "impressions":12478225, "activeUsers":13586039 }, { "date":"2024-12-02", "adFormat":「報酬型」、 "revenue":117979.71, "impressions":13440354, "activeUsers":14540198 } ], "page":1, "pageSize":3, "totalResults":10}