# 노출 수준 매출 서버 측 API > ILR 서버 측 API 통해 일일 CSV 리포트에 액세스하여 노출 및 기기 레벨에서 광고 매출 트래킹할 수 있습니다. 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 요청 > **Note:** > > 유효한 API 요청 시 요청한 파일의 링크가 반환됩니다. 파일은 1시간 동안만 다운로드 가능합니다. ### Authentication 유형 [Bearer API 인증](/grow/levelplay/platform/api/authentication.md.md) ### 메서드 GET [platform.ironsrc.com/partners/adRevenueMeasurements/v4](http://platform.ironsrc.com/partners/AdRevenueMeasurements/v1) ### 필수 파라미터 | **Name** | **Type** | **Description** | | -------- | -------- | --------------------- | | `date` | 문자열 | YYYY-MM-DD(UTC 시간대) | | `appKey` | 문자열 | 애플리케이션 키(플랫폼에서 확인 가능) | #### 요청 예시 URL [https://platform.ironsrc.com/partners/adRevenueMeasurements/v4?appKey=8a95a38d\\\&date=2020-03-31](https://platform.ironsrc.com/partners/adRevenueMeasurements/v4?appKey=8a95a38d\\\&date=2020-03-31) ### 응답 예제 URL ```json { "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** | **예시** | | ------------------------ | -------------------------------------------------------------------------------------------- | ------------------------------------ | | `event timestamp` | UTC 기준 노출의 정확한 날짜와 시간 | 2020-03-30 09:33:58 | | `advertising id` | 기기 광고 ID - GAID 또는 IDFA | fdbe7b9b-d183-4c7c-9bb5-59c9df8c35aa | | `advertising vendor id` | 기기 광고 공급업체 ID - 앱 설정 ID 또는 IDFV | A0810F0B-16C2-474B-B765-77B3A3113AA2 | | `user id` | 개발자가 설정하는 사용자 ID | 135920 | | `ad unit` | 매출 창출한 광고 형식 | 보상형 비디오 | | `ad network` | 광고 네트워크 이름 | Admob | | `creative id` | 광고 캠페인의 소재 ID입니다. 기본값은 빈 문자열입니다(Google, Meta, Digital Turbine, Mintegral 네트워크에는 포함되지 않음). | 65af8c5f9dd504dba89ea38e | | `instance name` | 플랫폼에 정의된 광고 네트워크 인스턴스 이름입니다. 입찰 소스의 인스턴스 이름은 '입찰'입니다. | High | | `country` | [국가 코드 2자리(ISO 3166-1 알파-2)](http://www.iso.org/iso/country_names_and_code_elements) | CN | | `placement` | 플랫폼에 정의된 대로 사용자 연결된 플레이스먼트 | 홈 화면 | | `segment` | 사용자 세그먼트화 방법에 따라 정의된 대로 연결된 세그먼트. [자세한 내용](/grow/levelplay/platform/settings/segments.md.md) | 계층 1 | | `AB Testing` | 사용자 할당된 A/B 테스트 그룹('A','B','N/A'일 수 있음) | A, B, N/A | | `revenue` | 사용자가 생성한 매출(USD). 매출 값은 추정(CPM/율) 또는 정확(FAN을 제외한 입찰자 인스턴스) | 0.5 | | `mediation ad unit id` | 매출 발생한 광고 유닛의 ID | fgx25t56dq201bd2 | | `mediation ad unit name` | 매출 발생한 광고 유닛의 이름 | | ### 사용자 레벨 ### 리포트 URL을 위한 API 요청 유효한 API 요청 시 요청한 파일의 링크가 반환됩니다. 파일은 1시간 동안만 다운로드 가능합니다. ### 인증 유형 [Bearer API 인증](/grow/levelplay/platform/api/authentication.md.md) ### 메서드 GET: ```text platform.ironsrc.com/partners/userAdRevenue/v3 ``` ### 필수 파라미터 | **Name** | **Type** | **Description** | | ------------ | -------- | ----------------------------------- | | `date` | 문자열 | YYYY-MM-DD(UTC 시간대) | | `appKey` | 문자열 | 애플리케이션 키(플랫폼에서 확인 가능) | | `reportType` | 정수 | 다양한 리포트 유형 지원 현재 는 항상 1로 설정되어야 합니다. | ### 요청 예제 URL ```text https://platform.ironsrc.com/partners/userAdRevenue/v3?appKey=12345678&date=2018-12-15&reportType=1 ``` ### 응답 예제 URL ```text 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** | **예시** | | --------------------- | --------------------------- | ------------------------------------ | | `Ad Unit` | 매출 창출된 광고 유닛입니다. | 보상형 비디오 | | `Advertising ID` | 사용자 기기 고유 ID | 21d0e51a-772d-4b23-9fc4-296126b4f123 | | `Advertising ID Type` | 사용자 기기 고유 ID 유형 | IDFA/IDFV/GAID | | `User ID` | 개발자가 설정하는 사용자 ID | 135920 | | `Segment` | 사용자 세분화에 따라 정의된 대로 연결된 세그먼트 | |