노출 단위 수익 데이터(ILRD)

ILRD(노출 수준 수익 데이터)를 사용하여 상세한 수익 데이터를 처리할 수 있습니다. Mobile Ads SDK 5.0.0부터 SDK는 각 광고 노출에 대한 수익 정보와 광고를 제공한 광고 네트워크(모바일 미디에이션가 사용된 경우)에 대한 정보를 제공합니다. 이 정보는 게시자의 앱에서 실시간으로 장치에 제공됩니다. 이 데이터를 직접 처리하거나 타사 분석 제공업체에 전송할 수 있습니다.

얻을 수 있는 데이터

다음과 같은 데이터가 게시자에게 제공됩니다.

필드

유형

설명

ad_unit_id

문자열

고유한 광고 단위 ID.

adType

문자열

광고 유형:

  • 배너 광고
  • 전면 광고
  • 네이티브 광고
  • 보상형 광고

currency

문자열

광고 네트워크 통화.

revenue

문자열

광고 네트워크 통화로 표시된 노출당 수익. currency 필드 값이 사용됩니다.

revenueUSD

문자열

USD로 환산된 노출당 수익.

precision

문자열

revenue 값의 정확도. 허용 가능한 값:

  • publisher_defined: 미디에이션 인터페이스의 CPM 하한을 고려한 값.
  • estimated: 자동 전략을 기반으로 한 값.

network.name

문자열

광고를 제공한 네트워크의 이름(Yandex Mediation용).

network.ad_unit_id

문자열

광고를 제공한 네트워크의 고유 광고 단위 ID(Yandex Mediation용).

ILRD 사용 설정

  1. 안내에 따라 Mobile Ads SDK 8.0.0 이상을 통합합니다(Yandex Advertising Network: Compose Multiplatform, 모바일 미디에이션: Compose Multiplatform).

  2. 이벤트를 추적하려면 클라이언트 측 인터페이스를 구현합니다.

    배너 광고에서는 BannerEventsonImpression 콜백을 사용합니다. 전체 화면 형식(InterstitialAd, RewardedAd, AppOpenAd)에서는 해당 이벤트 리스너의 onAdImpression 콜백을 사용합니다. 콜백은 노출이 기록될 때 호출됩니다. ImpressionData 객체의 rawData에는 ILRD가 담긴 JSON 문자열이 있습니다.

    로드된 전체 화면 광고를 받은 뒤(보통 rememberCoroutineScope()에서 시작한 코루틴 내부), show()를 호출하기 전에 리스너를 연결합니다.

    ad.setAdEventListener(
        object : InterstitialAdEventListener {
            override fun onAdShown() {}
    
            override fun onAdFailedToShow(adError: AdError) {}
    
            override fun onAdDismissed() {}
    
            override fun onAdClicked() {}
    
            override fun onAdImpression(impressionData: ImpressionData?) {
                val rawData = impressionData?.rawData
            }
        },
    )
    ad.show()