展示层级收入数据 (ILRD)

通过展示层级收入数据 (ILRD),您可以处理详细的收入数据。从 Mobile Ads SDK 5.0.0 开始,SDK 为您提供每次广告展示的收入信息以及有关投放广告的广告网络(如果使用移动聚合)的信息。此信息在设备上的发布商应用中实时提供。您可以直接处理这些数据或将其传输给第三方分析服务提供商。

可以获得哪些数据

发布商可以获得以下数据:

字段

类型

描述

ad_unit_id

字符串

唯一的广告单元 ID。

adType

字符串

广告类型:

  • 横幅广告
  • 插屏广告
  • 原生广告
  • 激励广告

currency

字符串

广告网络币种。

revenue

字符串

以广告网络币种表示的每次展示收入。使用 currency 字段值。

revenue_USD

字符串

转换为美元的每次展示收入。

precision

字符串

revenue 值的准确性。可接受的值:

  • publisher_defined:该值考虑了聚合界面的 CPM 价格。
  • estimated:基于自动策略的值。

network.name

字符串

投放广告的网络名称(适用于 Yandex 聚合)。

network.ad_unit_id

字符串

投放广告的网络中的唯一广告单元 ID(适用于 Yandex 聚合)。

启用ILRD

  1. 按照说明启用 5.0.0 或更高版本的 Mobile Ads SDK(YAN:Android,Yandex 聚合:Android)。

  2. 实施用于事件跟踪的客户端接口/协议。

    实施 BannerAdEventListener、InterstitialAdEventListener、NativeAdEventListener 和 RewardedAdEventListener 接口时,请使用带有 ImpressionData 参数的 onImpression 方法。计算展示次数时会调用 onImpression 方法。ImpressionData 资产具有单一方法 getRawData,它会返回带有 ILRD 的 JSON 字符串。

      class ExampleNativeAdEventListener : NativeAdEventListener {
         // ...
         override fun onImpression(impressionData: ImpressionData?) {
             val rawData = impressionData?.rawData
            // ...
         }
         // ...
      }
    
      public class ExampleNativeAdEventListener implements NativeAdEventListener {
         // ...
         @Override
         public void onImpression(@Nullable final ImpressionData impressionData) {
             final String rawData = impressionData.getRawData();
            // ...
         }
         // ...
      }