기술 자료

Unity 레벨플레이

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

Unity 레벨플레이

보고 API

레벨플레이 Ads Reporting API 대한 필터링된 GET 호출 통해 광고 형식과 차원의 수익화 데이터를 가져올 수 있습니다.
읽는 시간 1분최근 업데이트: 22일 전
중요
이전 API 버전은 2025년 8월 15일부로 지원이 사용 중단 예정 예정입니다. 서비스 중단 없이 해당 기간 전에 최신 버전으로 업데이트합니다.
이 API 사용하여 레벨플레이 또는 Ironsource 광고와 함께 제공하는 수익화 광고 형식의 모든 리포트 데이터를 수신할 수 있습니다. 여기에는 매출, 노출, 액티브 사용자 등 다양한 분석 지표 선택적 필터가 포함됩니다.
참고
리포트 API 1시간마다 8,000개의 요청으로 제한됩니다.

Authentication 유형

Bearer API 인증

메서드

GET
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.
모든 국가
adFormat
문자열
  • rewarded
  • offerwall
  • interstitial
  • banner
모든 광고 형식
adNetwork
문자열(쉼표 구분)
Ironsource Ads를 포함한 Mediation 광고 네트워크
레벨플레이 API 명명 및 설정을 참조하십시오.
모든 광고 소스
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
문자열(쉼표 구분)
지원되는 분석 섹션 참조하십시오.
date
page
숫자
표시할 페이지 번호
1
resultsPerPage
숫자
각 페이지에 표시할 결과 수
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}