展示级别收入数据(ILRD)

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

可以获得哪些数据

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

字段

类型

描述

ad_unit_id

字符串

唯一的广告单元 ID。

adType

字符串

广告类型:

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

currency

字符串

广告网络币种。

revenue

字符串

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

revenueUSD

字符串

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

precision

字符串

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

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

network.name

字符串

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

network.ad_unit_id

字符串

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

启用 ILRD

  1. 按照说明集成 Mobile Ads SDK 8.0.0 或更高版本(Yandex Advertising Network:Compose Multiplatform,移动聚合:Compose Multiplatform)。

  2. 实现客户端接口以跟踪事件。

    使用横幅广告时,请使用 BannerEvents 中的 onImpression 回调。对于全屏格式(InterstitialAdRewardedAdAppOpenAd),请在相应事件监听器上使用 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()