보고 API
레벨플레이 Ads Reporting API 대한 필터링된 GET 호출 통해 광고 형식과 차원의 수익화 데이터를 가져올 수 있습니다.
읽는 시간 1분최근 업데이트: 11시간 전
중요
이전 API 버전은 2025년 8월 15일부로 지원이 사용 중단 예정 예정입니다. 서비스 중단 없이 해당 기간 전에 최신 버전으로 업데이트합니다.
이 API 사용하여 레벨플레이 또는 Ironsource 광고와 함께 제공하는 수익화 광고 형식의 모든 리포트 데이터를 수신할 수 있습니다. 여기에는 매출, 노출, 액티브 사용자 등 다양한 분석 지표 선택적 필터가 포함됩니다.
참고
리포트 API 1시간마다 8,000개의 요청으로 제한됩니다.
Authentication 유형
메서드
필수 파라미터
|
|
|
|
|---|---|---|---|
| 문자열 | YYYY-MM-DD(UTC 시간대) | |
| 문자열 | YYYY-MM-DD(UTC 시간대) |
파라미터(선택 사항)
Ironsource 광고 보고 API 사용하면 리포트를 선택적 파라미터를 기준으로 필터링할 수 있습니다. 이렇게 하면 필터에 대한 직접 매치를 검색할 수 있습니다.
|
|
|
|
|---|---|---|---|
| 문자열(쉼표 구분) | 애플리케이션 키(레벨플레이 및 Ironsource 광고 플랫폼에서 확인) | 모든 앱 키 |
| 문자열(쉼표 구분) | 두 글자 국가 코드입니다. Refer to ISO 3166-1 Alpha-2. | 모든 국가 |
| 문자열 |
| 모든 광고 형식 |
| 문자열(쉼표 구분) | Ironsource Ads를 포함한 Mediation 광고 네트워크 레벨플레이 API 명명 및 설정을 참조하십시오. | 모든 광고 소스 |
| 문자열(부울) | 2024년 3월 1일부로 지원됨. Ironsource Ads 네트워크에만 해당됩니다. 옵션은
| 모두 |
| 문자열(부울) | 옵션은
| 모두 |
| 문자열 | 옵션은
| 모두 |
| 문자열 | 옵션은
| 모두 |
| 문자열(쉼표 구분) | Mediation 그룹(레벨플레이 플랫폼에서 볼 수 있음) | 모든 그룹 |
| 문자열(쉼표 구분) | 매출 발생한 광고 유닛의 ID | 모든 Mediation 광고 유닛 |
| 문자열(쉼표 구분) | [지원 지표](#supported- 지표) 섹션을 참조하십시오. | 모든 지표 |
| 문자열(쉼표 구분) | 지원되는 분석 섹션 참조하십시오. | date |
| 숫자 | 표시할 페이지 번호 | 1 |
| 숫자 | 각 페이지에 표시할 결과 수 | 5000 |
지원되는 중단
- 날짜(일) /주/월
- 앱
- platform
- adNetwork
- isBidder
- adFormat
- 인스턴스
- country
- mediationGroup
- mediationAdUnit
- 세그먼트
- placement
- osVersion
- sdkVersion
- appVersion
- att
- idfa
- 기울기
- abTest
- isLevelPlayMediation
- bannerSize
참고
기간을 지정하지 않으면 반환된 데이터가 특정 기간을 기준으로 분할되지 않고 요청된 지표 모든 과거 데이터가 분할됩니다.
지원 지표
- 매출
- 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
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}