ILRD(노출 수준 수익 데이터)

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

얻을 수 있는 데이터

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

필드

유형

설명

ad_unit_id

문자열

고유한 광고 단위 ID.

adType

문자열

광고 유형:

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

currency

문자열

광고 네트워크 통화.

revenue

문자열

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

revenue_USD

문자열

USD로 환산된 노출당 수익.

precision

문자열

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

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

network.name

문자열

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

network.ad_unit_id

문자열

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

ILRD 활성화

  1. 지침에 따라 Mobile Ads SDK 버전 5.0.0 이상을 통합합니다(Yandex Advertising Network: Flutter, 모바일 미디에이션: Flutter).

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

    배너 광고 작업을 할 때는 onImpression 콜백을 사용하세요. 전체 화면 형식의 경우(InterstitialAd, RewardedAd, AppOpenAd), ImpressionData 파라미터가 있는 onAdImpression 콜백을 사용합니다. 노출이 기록되면 콜백이 트리거됩니다. ImpressionData 객체는 ILRD가 포함된 JSON 문자열을 반환하는 getRawData() 메서드를 제공합니다.

    final interstitialAd = await InterstitialAd.load(
      adUnitId: 'your-ad-unit-id',
    );
    
    interstitialAd.setAdEventListener(
      eventListener: InterstitialAdEventListener(
        onAdImpression: (ImpressionData impressionData) {
          final rawData = impressionData.getRawData();
          // ILRD 처리 중
          print('Impression data: $rawData');
        },
      ),
    );