# Impression Level 매출 SDK API

> Impression Level 매출 (ILR) SDK API를 사용하여 모든 Mediation 네트워크에 대한 실시간 노출 수준 데이터를 수신하여 타사 보고 도구 및 독점 최적화 시스템과 통합할 수 있습니다.

ILR(Impression Level 매출) SDK API 레벨플레이 SDK를 사용하여 모든 Mediation 네트워크에 대한 노출 수준 데이터를 제공합니다. 서버 측 API 통해 ILR 데이터를 사용하는 것과는 다른 대안이며, 서버 측 API와 함께 사용할 수 있습니다. 개발자는 서버 측 API, SDK API 또는 둘 다를 통해 ILR을 통합할 수 있습니다.

서버 측 API 통해 ILR을 사용하면 데이터가 1일 지연됩니다. ILR SDK API 사용하면 광고가 표시될 때 즉시 실시간 ILR 데이터를 활성화하고 앱의 노출 데이터를 타사 리포트 툴 또는 전용 최적화 툴 및 데이터베이스와 통합할 수 있습니다.

ILR SDK API Android, iOS 및 Unity SDK 7.0.3 이상에서 지원되며, 입찰 인스턴스가 워터폴의 일부로 포함된 경우에만 제공됩니다.

## ILR SDK API 사용 방법##how-to-use-the-ilr-sdk-api

1. 레벨플레이 SDK 7.0.3 이상을 연동하고 워터폴에 입찰자 인스턴스 하나 이상 있는지 확인합니다.
2. 레벨플레이 impressionData Listeners에 등록

### 1단계: 레벨플레이 SDK 연동##step-1:-integrate-levelplay-sdk

Integrate LevelPlay SDK 7.0.3+:

* [Android](/grow/levelplay/sdk/android/sdk-integration.md)
* [iOS](/grow/levelplay/sdk/ios/sdk-integration.md)
* [Unity](/grow/levelplay/sdk/unity/package-integration.md)

### 2단계: 레벨플레이 리스너에 등록합니다.##step-2:-register-to-levelplay-listener

레벨플레이 SDK는 노출 데이터에 대해 알려주는 여러 이벤트를 작동시킵니다. 이 리스너는 선택 사항이며 ILR 구현 프로세스의 일부로만 사용해야 합니다. 이 리스너는 모든 광고 유닛에 대한 정보를 제공하며, 노출 수준 매출 사용하여 다양한 광고를 식별 수 있습니다.

자세한 내용은 다음과 같습니다.

* [Android ImpressionDataListener](/grow/levelplay/sdk/android/impression-level-revenue-integration.md)
* [iOS ImpressionDataDelegate](/grow/levelplay/sdk/ios/impression-level-revenue-integration.md)
* [Unity ImpressionDataListener](/grow/levelplay/sdk/unity/impression-level-revenue-integration.md)

## ILR 필드##ilr-fields

ImpressionData 오브젝트 일부로 노출 수준 매출 반환됩니다. 다음은 설명과 유형을 비롯한 관련 데이터 필드 리스트입니다.

| 파라미터 이름         | 설명                                                                                                                                         | 데이터 유형 |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
| auctionId       | 경매의 고유 식별자                                                                                                                                 | 문자열    |
| adUnit          | 표시된 광고 유닛(보상형 비디오/인터스티셜 광고/배너)                                                                                                             | 문자열    |
| adNetwork       | 광고를 게재한 광고 네트워크 이름                                                                                                                         | 문자열    |
| instanceName    | 플랫폼에 정의된 광고 네트워크 인스턴스 이름입니다. 입찰 소스의 인스턴스 이름은 '입찰'입니다.                                                                                      | 문자열    |
| instanceId      | 네트워크별 식별자. 여기에는 광고 네트워크의 instanceID/placement/zone이 포함됩니다.                                                                                 | 문자열    |
| country         | 국가 코드 ISO 3166-1 형식                                                                                                                        | 문자열    |
| placement       | 사용자 연결된 플레이스먼트                                                                                                                             | 문자열    |
| 매출              | 노출로 발생한 매출(USD)입니다. 매출 값은 정밀도 따라 추정 또는 정확합니다(정밀도 필드 설명 참조).                                                                                | 더블     |
| 정밀도             | 매출(매출) 필드 소스 값: 단가 – 실시간 경매의 일부로 제공되는 매출(FAN 입찰자가 지원하지 않음) RATE – 퍼블리셔 레벨플레이 플랫폼의 인스턴스 할당한 매뉴얼 가격 CPM – 레벨플레이 플랫폼에서 수행한 과거 인스턴스 성과에 기반한 계산 | 문자열    |
| ab              | 레벨플레이 플랫폼을 통해 A/B 테스트가 활성화되었는지 표시                                                                                                          | 문자열    |
| segmentName     | 사용자 세그먼트화 방법에 따라 정의된 대로 연결된 세그먼트                                                                                                           | 문자열    |
| lifetimeRevenue | 사용자 광고 매출 누적 가치                                                                                                                            | 더블     |
| encryptedCPM    | Meta Audience Network에서 제공하는 광고에만 해당하며, 비공개 베타 기간 내에 Meta Audience Network에서 승인한 퍼블리셔에게 보고됩니다.                                             | 문자열    |
| creativeId      | 광고 캠페인의 소재 ID입니다. 기본값은 빈 문자열입니다.                                                                                                           | 문자열    |

> **Note:**
>
> ILR SDK 포스트백 정보에는 IDFA/GAID, 기기 모델 또는 기기 제조사와 같이 기기 자체에서 가져올 수 있는 데이터가 포함되지 않습니다.

## 애플리케이션 ILR을 사용하는 방법##how-to-use-ilr-within-your-application

레벨플레이 SDK 7.0.3 이상을 연동하고 리스너와 콜백을 구현한 후 관련 데이터를 처리할 수 있습니다. impressionData는 노출 성공 시(광고가 올바르게 표시되었음) 콜백 정보의 일부로 반환됩니다. ImpressionData에는 각 필드를 별도로 가져오기 위한 손쉬운 액세스, 접근 API 또는 JSON으로 표시된 문자열을 반환하는 allData API가 포함되어 있습니다.

자세한 내용은 다음과 같습니다.

* [Android ImpressionDataListener](/grow/levelplay/sdk/android/impression-level-revenue-integration.md)
* [iOS ImpressionDataDelegate](/grow/levelplay/sdk/ios/impression-level-revenue-integration.md)
* [Unity ImpressionDataListener](/grow/levelplay/sdk/unity/impression-level-revenue-integration.md)
