# カスタムアダプターレポート API

> Custom Adapters Reporting API を実装して、Unity LevelPlay がネットワーク収益データを取得できるようにし、パブリッシャーにネットワークワークのパフォーマンスを可視性化します。

カスタム アダプタ レポート API を使用すると、Unity LevelPlay はネットワークの収益データを取得できるため、パブリッシャーは Monetization レポートでそのデータにアクセスできます。推奨されるベストプラクティスは、この機能を有効にしてパブリッシャーにネットワークワークの価値を可視性化することです。次のステップに従って使用を開始します。

## 前提条件

* [ネットワーク登録フォーム](https://ironsrc.formtitan.com/Custom-Adapter#/)に記入し、専用エンドポイントのサーバ アドレスを含めるようにしてください。
* レポート API ドメインは、この構造体 'https\://\custom ネットワーク ドメイン' に基づく必要があります (`https://api.exmaple.io` など)

> **Note:**
>
> 以前にフォームを送信したことがある場合は、[接触](https://ironsrc.formtitan.com/contact-us#/)してエンドポイントを追加します。

## レポートリクエスト

ironsource は、特定のアカウントと日付の呼び出しごとに、1 日に数回、エンドポイントに要求を送信します。

## リクエストの例

GET `https://www.CustomNetworkEndPoint.com?date=2021-09-01\\\&apiKey=value1\\\&myUser=value2`

## レスポンス

反応を次のように構造体し、Ironsource が処理できるようにします。

* 日付 (リクエストに基づく)
* 国およびインスタンス ID ごとのデータ配列

以下のベストプラクティスを検討してください。

* [ISO 3166-1 アルファ 2](https://www.iso.org/iso-3166-country-codes.html) に従って、国フィールドを 2 文字の国コードで形式
* レポート収益 (USD)
* 日付集計に UTC タイムゾーンを使用する
* アプリケーションレベルと広告単位(広告形式)レベルの分割はサポートされていないため、一意のインスタンス識別子を使用する

## レスポンスの例

```json
{
	"date":"2021-12-01",
	"data": [{
			"instanceKey":"1233",
			"revenue":0.3,
			"country": "US"
		},
		{
			"instanceKey":"2522",
			"revenue":0.4,
			"country": "CN"
		},
		{
			"instanceKey":"2523",
			"revenue":0.4,
			"country": "AU",
		},
		{
			"instanceKey":"2524",
			"revenue":0.4,
			"country": "FR"
		},
		{
			"instanceKey":"2525",
			"revenue":0.4,
			"country": "JP"
		}
	]
}
```