# 보고 API

> 레벨플레이 Ads Reporting API 대한 필터링된 GET 호출 통해 광고 형식과 차원의 수익화 데이터를 가져올 수 있습니다.

> **Important:**
>
> 이전 API 버전은 2025년 8월 15일부로 지원이 사용 중단 예정 예정입니다. 서비스 중단 없이 해당 기간 전에 최신 버전으로 업데이트합니다.

이 API 사용하여 레벨플레이 또는 Ironsource 광고와 함께 제공하는 수익화 광고 형식의 모든 리포트 데이터를 수신할 수 있습니다. 여기에는 매출, 노출, 액티브 사용자 등 다양한 분석 지표 선택적 필터가 포함됩니다.

> **Note:**
>
> 리포트 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 | 설명                  | Default |
| ----------- | ---- | ------------------- | ------- |
| `startDate` | 문자열  | YYYY-MM-DD(UTC 시간대) | *       |
| `endDate`   | 문자열  | YYYY-MM-DD(UTC 시간대) | -       |

### 파라미터(선택 사항)

Ironsource 광고 보고 API 사용하면 리포트를 선택적 파라미터를 기준으로 필터링할 수 있습니다. 이렇게 하면 필터에 대한 직접 매치를 검색할 수 있습니다.

| 이름                     | Type       | 설명                                                                                                                              | Default            |
| ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `appKey`               | 문자열(쉼표 구분) | 애플리케이션 키(레벨플레이 및 Ironsource 광고 플랫폼에서 확인)                                                                                        | 모든 앱 키             |
| `country`              | 문자열(쉼표 구분) | 두 글자 국가 코드입니다.Refer to [ISO 3166-1 Alpha-2](http://www.iso.org/iso/country_names_and_code_elements).                            | 모든 국가              |
| `adFormat`             | 문자열        | * `rewarded`
* `offerwall`
* `interstitial`
* `banner`                                                                          | 모든 광고 형식           |
| `adNetwork`            | 문자열(쉼표 구분) | Ironsource Ads를 포함한 Mediation 광고 네트워크[레벨플레이 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`       | 문자열(쉼표 구분) | Mediation 그룹(레벨플레이 플랫폼에서 볼 수 있음)                                                                                                | 모든 그룹              |
| `mediationAdUnitId`    | 문자열(쉼표 구분) | 매출 발생한 광고 유닛의 ID                                                                                                                | 모든 Mediation 광고 유닛 |
| `metrics`              | 문자열(쉼표 구분) | \[지원 지표]\(#supported- 지표) 섹션을 참조하십시오.                                                                                           | 모든 지표              |
| `breakdowns`           | 문자열(쉼표 구분) | [지원되는 분석](#supported-breakdowns) 섹션 참조하십시오.                                                                                     | date               |
| `page`                 | 숫자         | 표시할 페이지 번호                                                                                                                      | 1                  |
| `resultsPerPage`       | 숫자         | 각 페이지에 표시할 결과 수                                                                                                                 | 5000               |

### 지원되는 중단

* 날짜(일) /주/월
* 앱
* platform
* adNetwork
* isBidder
* adFormat
* 인스턴스
* country
* mediationGroup
* mediationAdUnit
* 세그먼트
* placement
* osVersion
* sdkVersion
* appVersion
* att
* idfa
* 기울기
* abTest
* isLevelPlayMediation
* bannerSize

> **Note:**
>
> 기간을 지정하지 않으면 반환된 데이터가 특정 기간을 기준으로 분할되지 않고 요청된 지표 모든 과거 데이터가 분할됩니다.

### 지원 지표

* 매출
* impressions
* eCPM
* 클릭
* clickThroughRate
* 세션
* engagedSessions
* impressionPerEngagedSessions
* impressionsPerSession
* activeUsers
* revenuePerActiveUser
* sessionsPerActiveUser
* impressionsPerActiveUser
* engagedUsers
* revenuePerEngagedUser
* impressionsPerEngagedUser
* engagedUsersRate
* appFills
* appFillRate
* useRate
* appRequest
* 완료
* completionRateImpBased
* revenuePerCompletion
* adSourceChecks
* adSourceResponses
* adSourceAvailabilityRate

### 요약 제한

아래의 분석 결과를 조합 확인 오류가 발생합니다.

* 인스턴스
* 세그먼트
* placement
* bannerSize
* Idfa
* 게이드(Gaid)
* 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
}
```