Impression Level 매출 SDK API
Impression Level 매출 (ILR) SDK API를 사용하여 모든 Mediation 네트워크에 대한 실시간 노출 수준 데이터를 수신하여 타사 보고 도구 및 독점 최적화 시스템과 통합할 수 있습니다.
읽는 시간 3분최근 업데이트: 8시간 전
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 사용 방법
- 레벨플레이 SDK 7.0.3 이상을 연동하고 워터폴에 입찰자 인스턴스 하나 이상 있는지 확인합니다.
- 레벨플레이 impressionData Listeners에 등록
1단계: 레벨플레이 SDK 연동
Integrate LevelPlay SDK 7.0.3+:
2단계: 레벨플레이 리스너에 등록합니다.
레벨플레이 SDK는 노출 데이터에 대해 알려주는 여러 이벤트를 작동시킵니다. 이 리스너는 선택 사항이며 ILR 구현 프로세스의 일부로만 사용해야 합니다. 이 리스너는 모든 광고 유닛에 대한 정보를 제공하며, 노출 수준 매출 사용하여 다양한 광고를 식별 수 있습니다.
자세한 내용은 다음과 같습니다.
ILR 필드
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입니다. 기본값은 빈 문자열입니다. | 문자열 |
참고
ILR SDK 포스트백 정보에는 IDFA/GAID, 기기 모델 또는 기기 제조사와 같이 기기 자체에서 가져올 수 있는 데이터가 포함되지 않습니다.
애플리케이션 ILR을 사용하는 방법
레벨플레이 SDK 7.0.3 이상을 연동하고 리스너와 콜백을 구현한 후 관련 데이터를 처리할 수 있습니다. impressionData는 노출 성공 시(광고가 올바르게 표시되었음) 콜백 정보의 일부로 반환됩니다. ImpressionData에는 각 필드를 별도로 가져오기 위한 손쉬운 액세스, 접근 API 또는 JSON으로 표시된 문자열을 반환하는 allData API가 포함되어 있습니다.
자세한 내용은 다음과 같습니다.