# レポート API

> LevelPlay Ads Reporting API へのフィルタリングされた GET 呼び出しを使用して、広告フォーマットとディメンション間で Monetization データを取得します。

> **Important:**
>
> 以前のバージョンの API は、2025 年 8 月 15 日に非推奨になります。サービスの中断を避けるために、期限前に最新バージョンに更新してください。

この API を使用して、LevelPlay や Ironsource Ads で提供される Monetization 広告フォーマットからすべてのレポートデータを受け取ります。これには、収益、インプレッション、アクティブユーザーなどの複数の指標が、いくつかの内訳と任意のフィルターにわたって含まれます。

> **Note:**
>
> Reporting API は、1 時間ごとに 8,000 リクエストに制限されます。

### Authenticationタイプ

[Bearer API 認証](/grow/levelplay/platform/api/authentication.md.md)

### メソッド

`GET` [https://platform.ironsrc.com/levelPlay/reporting/v1](https://platform.ironsrc.com/levelPlay/reporting/v1)

### 必須パラメーター

| 名前          | Type (タイプ) | 説明                      | デフォルト |
| ----------- | ---------- | ----------------------- | ----- |
| `startDate` | 文字列        | YYYY-MM-DD (UTC タイムゾーン) | *     |
| `endDate`   | 文字列        | YYYY-MM-DD (UTC タイムゾーン) | -     |

### オプションのパラメーター

ironsource Ads Reporting API では、任意のパラメータのいずれかを使用してレポートをフィルタリングできます。これにより、任意のフィルタへの直接一致を検索できます。

| 名前                     | Type (タイプ)  | 説明                                                                                                                                 | デフォルト              |
| ---------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `appKey`               | 文字列(カンマ区切り) | キーlay と Ironsource Ads プラットプラットフォームで確認)                                                                                            | すべてのアプリケーション       |
| `country`              | 文字列(カンマ区切り) | 2 文字の国コード。[ISO 3166-1 アルファ 2](http://www.iso.org/iso/country_names_and_code_elements) を参照してください。                                   | すべての国              |
| `adFormat`             | 文字列         | * `rewarded`
* `offerwall`
* `interstitial`
* `banner`                                                                             | すべての広告フォーマット       |
| `adNetwork`            | 文字列(カンマ区切り) | ironsource Ads などのメディエーション広告ネットワーク。[LevelPlay API の命名と設定](/grow/levelplay/platform/api/naming-and-configurations.md.md) を参照してください。 | すべての広告ソース          |
| `isLevelPlayMediation` | 文字列 (ブーリアン) | 2024 年 3 月 1 日よりサポートされます。ironsource Ads ネットワークにのみ関連します。オプションは、* `true`
* `false`                                                   | すべて                |
| `isBidder`             | 文字列 (ブーリアン) | オプションは、* `true`
* `false`                                                                                                          | すべて                |
| `platform`             | 文字列         | オプションは、* `android`
* `ios`                                                                                                         | すべて                |
| `abTest`               | 文字列         | オプションは、* `A`
* `B`
* `NULL`
単一の値を想定                                                                                            | すべて                |
| `mediationGroup`       | 文字列(カンマ区切り) | メディエーショングループ (LevelPlay プラットフォームで表示)                                                                                               | すべてのグループ           |
| `mediationAdUnitId`    | 文字列(カンマ区切り) | 収益が発生した広告単位のID                                                                                                                     | すべてのメディエーション広告ユニット |
| `metrics`              | 文字列(カンマ区切り) | [サポートされている指標](#supported-metrics)セクションを参照してください。                                                                                   | すべての指標             |
| `breakdowns`           | 文字列(カンマ区切り) | [サポートされている内訳](#supported-breakdowns)セクションを参照してください。                                                                                | date               |
| `page`                 | number      | ディスプレイするページ番号                                                                                                                      | 1                  |
| `resultsPerPage`       | number      | 各ページにディスプレイする結果の数                                                                                                                  | 5000               |

### サポートされる内訳

* 日付 (日) / 週 / 月
* app
* platform
* adNetwork
* isBidder
* adFormat
* インスタンス
* country
* mediationGroup
* mediationAdUnit
* セグメント
* プレースメント
* osVersion
* sdkVersion
* appVersion
* att
* idfa
* gaid
* abTest
* isLevelPlayMediation
* bannerSize

> **Note:**
>
> 期間を指定しない場合、返されるデータは特定の期間で分割されず、要求された指標のすべての履歴データになります。

### サポートされる指標

* 収益
* 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

```xml
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 反応例

```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
}
```