展示层级收入数据 (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:Unity,Yandex 聚合:Unity)。

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

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

    public void HandleImpression(object sender, ImpressionData impressionData)
        {
            var data = impressionData == null ? "null" : impressionData.rawData;
            this.DisplayMessage($"HandleImpression event received with data: {data}");
        }