展示级别收入数据 (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. 按照说明集成 Mobile Ads SDK 版本 5.0.0 或更高版本(Yandex Advertising Network:React Native,移动聚合:React Native)。

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

    处理横幅广告时,请使用 onImpression 回调。对于全屏格式(InterstitialAdRewardedAdAppOpenAd),请使用带有 ImpressionData 参数的 onAdImpression 回调。当记录一次展示时,将触发此回调。ImpressionData 对象提供 getRawData() 方法,该方法包含一个带有 ILRD 的 JSON 字符串。

    const interstitialAd = new InterstitialAd('your-ad-unit-id');
    
    interstitialAd.onAdImpression = (impressionData) => {
      const rawData = impressionData?.rawData;
      // 处理 ILRD
      console.log('Impression data:', rawData);
    };