Ad Info를 포함한 레벨플레이 리스너 연동

레벨플레이 AdInfo 클래스는 가장 최근에 성공적으로 로드된 광고의 정보를 전달합니다. 로드된 광고가 없기 때문에, 로드 실패 콜백에서는 전달되지 않습니다.

AdInfo 데이터 연동

레벨플레이 리스너를 구현하면 리스너로 수신하는 AdInfo 데이터를 앱 내에서 사용할 수 있습니다.

LevelPlayAdInfo에서 전달 가능한 데이터가 존재하지 않을 경우, adInfo 내의 문자열 파라미터는 빈 문자열 값을 반환하며, 숫자 파라미터들은 0을 반환합니다.

 public void onAdLoaded(@NonNull LevelPlayAdInfo adInfo)
 {
      String AdUnit = adInfo.getAdUnit();
      String AuctionId = adInfo.getAuctionId();
      String AdNetwork = adInfo.getAdNetwork();
      String Ab = adInfo.getAb();
      String Country = adInfo.getCountry();
      String InstanceId = adInfo.getInstanceId();
      String InstanceName = adInfo.getInstanceName();
      String SegmentName = adInfo.getSegmentName();
      Double Revenue = adInfo.getRevenue();
      String Precision = adInfo.getPrecision();
      String EncryptedCPM = adInfo.getEncryptedCPM();
 }
  • Light theme
  • Dark theme
  • Copy to clipboard

Ad Info 필드

아래는 새로운 AdInfo 객체에 포함되어 전달되는 데이터 필드의 상세 설명 및 타입 등의 정보입니다:

파라미터 명칭 설명 데이터 타입
auctionId 각 광고 경매 (또는 waterfall) 별 고유 ID String
adUnit 광고 포맷 (Rewarded Video/Interstitial/Banner) String
adNetwork 광고를 제공한 광고 네트워크의 명칭 String
instanceName 레벨플레이 플랫폼 상에 정의된 광고 네트워크 인스턴스 명칭. 비딩 네트워크의 경우 이 명칭은 ‘Bidding’으로 반환됨 String
instanceId 각 광고 네트워크에서 사용되는 광고 슬롯의 고유 구별자로, 광고 네트워크의 인스턴스 ID, 플레이스먼트, Zone 등이 이에 해당함. String
country ISO 3166-1 포맷으로 정의된 국가 코드 String
revenue 각 광고 노출로 생성된 수익 (USD). 이 수익 값의 경우 precision 값에 따라 예측 수치 또는 확정 수치일 수 있. (precision 필드 설명 참조) Double
precision revenue 필드의 산출 근거 정보 분류 값:
BID – 수익 값이 실시간 경매에서 산출됨 (Meta Audience Network 비딩은 지원 불가)
RATE – 퍼블리셔가 레벨플레이 플랫폼에서 인스턴스 별로 직접 할당한 수치
CPM – 인스턴스의 과거 퍼포먼스 이력을 근거로 레벨플레이 플랫폼에서 산출됨
String
ab 레벨플레이 플랫폼에서 A/B 테스트 진행 중 여부를 표시 String
segmentName 사용자가 속한 세그먼트. SDK에서 세그먼트 메서드로 정의한 내용에 따라 구분됨. String
encryptedCPM Meta Audience Network 광고에만 해당하며, Meta Audience Network에서 클로즈 베타 기간동안 승인받은 퍼블리셔들에게만 전송됩니다. String
creativeId 광고 캠페인의 소재 ID. 기본 값은 빈 문자열 값. String