노출 수준 매출 서버 측 API
ILR 서버 측 API 통해 일일 CSV 리포트에 액세스하여 노출 및 기기 레벨에서 광고 매출 트래킹할 수 있습니다.
읽는 시간 1분최근 업데이트: 8시간 전
ILR(노출 수준 매출) 솔루션은 레벨플레이 Mediation 광고의 기기 레벨과 노출 수준 데이터를 모두 제공합니다. 두 개의 API가 있습니다.
- 기기 레벨 데이터를 가져오는 하나
- 1은 노출 수준 데이터를 가져옵니다.
매출 앱, 네트워크, 국가, 인스턴스 따라 각 노출의 eCPM을 기준으로 계산됩니다.
자세히 알아보기
- 다음 단계를 완료하여 노출 수준 및 사용자 수준 데이터를 가져옵니다.
- 리포트를 다운로드하는 URL 링크를 반환하는 API 요청을 만듭니다.
- 제공된 링크를 클릭하여 리포트를 다운로드합니다.
- 각 API 호출 단일 앱과 단일 날짜에 대해 이루어져야 합니다.
- 각 날짜의 데이터는 14일 동안 저장되어 확인할 수 있습니다.
- 예제: 1월 1일 데이터는 1월 14일까지 이용 가능합니다.
- 매일 오전 10시(UTC 기준)부터 어제의 데이터를 확인할 수 있습니다. 매일 오전 10:00 UTC 이후에만 API 호출 합니다.
- 예제: 1월 1일 데이터는 1월 2일 오전 10:00(UTC 기준) 이후에만 이용 가능합니다.
- 매일 어제와 어제 전날의 데이터를 업데이트합니다. 데이터는 2일 후 변경되지 않습니다.
- 예제: 1월 1일 데이터는 1월 2일과 1월 3일에 업데이트됩니다. 1월 3일 이후에는 데이터가 업데이트되지 않습니다.
- 날짜 및 앱 키는 보고서별로 고유하기 때문에 노출 및 사용자 수준 보고서에 포함되지 않습니다(파일).
노출 레벨
리포트 URL을 위한 API 요청
참고
유효한 API 요청 시 요청한 파일의 링크가 반환됩니다. 파일은 1시간 동안만 다운로드 가능합니다.
Authentication 유형
메서드
필수 파라미터
Name | Type | Description |
|---|---|---|
| 문자열 | YYYY-MM-DD(UTC 시간대) |
| 문자열 | 애플리케이션 키(플랫폼에서 확인 가능) |
요청 예시 URL
응답 예제 URL
{"urls": ["https://user-ad-revenue.s3.amazonaws.com/data/bi_databases/arm/tables/mediation/report_version%3Dv1/publisher_id%3D551399/application_id%3D225509/day%3D2020-03-31/report.csv.gz?AWSAccessKeyId=AKIAILCCGIXP5G2XNXBA&Expires=1585751272&Signature=bONL8mMc%2B0kdtekXzmXRT4shidQ%3D"],"expiration": "2020-03-31 14:27:52"}
보고서 다운로드
리포트를 다운로드 URL을 선택합니다.
필드 정의 v3
필드 | Description | 예시 |
|---|---|---|
| UTC 기준 노출의 정확한 날짜와 시간 | 2020-03-30 09:33:58 |
| 기기 광고 ID - GAID 또는 IDFA | fdbe7b9b-d183-4c7c-9bb5-59c9df8c35aa |
| 기기 광고 공급업체 ID - 앱 설정 ID 또는 IDFV | A0810F0B-16C2-474B-B765-77B3A3113AA2 |
| 개발자가 설정하는 사용자 ID | 135920 |
| 매출 창출한 광고 형식 | 보상형 비디오 |
| 광고 네트워크 이름 | Admob |
| 광고 캠페인의 소재 ID입니다. 기본값은 빈 문자열입니다(Google, Meta, Digital Turbine, Mintegral 네트워크에는 포함되지 않음). | 65af8c5f9dd504dba89ea38e |
| 플랫폼에 정의된 광고 네트워크 인스턴스 이름입니다. 입찰 소스의 인스턴스 이름은 '입찰'입니다. | High |
| 국가 코드 2자리(ISO 3166-1 알파-2) | CN |
| 플랫폼에 정의된 대로 사용자 연결된 플레이스먼트 | 홈 화면 |
| 사용자 세그먼트화 방법에 따라 정의된 대로 연결된 세그먼트. 자세한 내용 | 계층 1 |
| 사용자 할당된 A/B 테스트 그룹('A','B','N/A'일 수 있음) | A, B, N/A |
| 사용자가 생성한 매출(USD). 매출 값은 추정(CPM/율) 또는 정확(FAN을 제외한 입찰자 인스턴스) | 0.5 |
| 매출 발생한 광고 유닛의 ID | fgx25t56dq201bd2 |
| 매출 발생한 광고 유닛의 이름 |
사용자 레벨
리포트 URL을 위한 API 요청
유효한 API 요청 시 요청한 파일의 링크가 반환됩니다. 파일은 1시간 동안만 다운로드 가능합니다.
인증 유형
메서드
GET:
platform.ironsrc.com/partners/userAdRevenue/v3
필수 파라미터
Name | Type | Description |
|---|---|---|
| 문자열 | YYYY-MM-DD(UTC 시간대) |
| 문자열 | 애플리케이션 키(플랫폼에서 확인 가능) |
| 정수 | 다양한 리포트 유형 지원 현재 는 항상 1로 설정되어야 합니다. |
요청 예제 URL
https://platform.ironsrc.com/partners/userAdRevenue/v3?appKey=12345678&date=2018-12-15&reportType=1
응답 예제 URL
https://user-ad-revenue.s3.amazonaws.com/data/bi 데이터베이스/uar/tables/network/report version%3Dv1/ 퍼블리셔 id%3D138101/애플리케이션 id%3D100411/day%3D2018-07-13/000000.gz?AWSAccessKeyId=AKIAILCCGIXP5G2XNXBA&Expires=1532524582&Signature=1U%2FbrLmb%2F7TwXXdoHtb%2F%2FQjrm0%3D
보고서 다운로드
리포트를 다운로드 URL을 선택합니다. 다음 섹션 다양한 보고서 필드의 정의를 간략하게 설명합니다.
필드 정의
필드 | Description | 예시 |
|---|---|---|
| 매출 창출된 광고 유닛입니다. | 보상형 비디오 |
| 사용자 기기 고유 ID | 21d0e51a-772d-4b23-9fc4-296126b4f123 |
| 사용자 기기 고유 ID 유형 | IDFA/IDFV/GAID |
| 개발자가 설정하는 사용자 ID | 135920 |
| 사용자 세분화에 따라 정의된 대로 연결된 세그먼트 |