# 自定义适配器报告 API

> 通过设置报告终端，启用 ironSource 可以检索网络的收入数据以显示在发布者报告中。

自定义适配器报告 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 每天会向您的终端发送几次请求，每次调用都针对指定的帐户和日期。

## 请求示例

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

## 响应

响应的结构如下所示，以便 ironSource 可以对其进行处理：

* 日期（基于请求）
* 按国家和实例标识符中断的数据数组

请考虑以下最佳实践：

* 根据 [ISO 3166-1 Alpha-2](https://www.iso.org/iso-3166-country-codes.html) 使用 2 字母国家代码格式化国家/地区字段
* 报告收入（美元）
* 使用 UTC 时区进行日期聚合
* 使用唯一实例标识符，因为不支持 app 级别和广告单元（广告格式）级别细分

## 响应示例

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