展示机会层级的广告收入

发生展示时,Google 移动广告 SDK 会提供与该次展示相关联的广告收入数据。您可以使用此数据来计算用户的生命周期价值,也可以将其传送到下游的其他相关系统。

本指南旨在帮助您在 Unity 项目中实现获取展示机会层级的广告收入数据的功能。

前提条件

实现付费事件处理脚本

每种广告格式都有一个 OnPaidEvent 事件。在广告事件的生命周期内,Google 移动广告 SDK 会监控展示事件,并用赚取的价值调用处理脚本。

以下代码演示了如何处理激励广告的付费事件:


RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

如需详细了解胜出的广告来源,请参阅检索有关广告响应的信息

与应用归因合作伙伴 (AAP) 集成

如需全面了解如何将广告收入数据转发到分析平台,请参阅相应的合作伙伴指南:

合作伙伴 SDK
调整
AppsFlyer
单数
天津

植入方面的最佳做法

  • 在创建或有权访问广告对象后立即设置 OnPaidEvent 事件,且一定要在展示广告之前进行设置。这样可以确保您不会错过任何回调。
  • 立即通过 OnPaidEvent 处理程序将展示机会层级的广告收入信息发送到您的首选分析服务器。这样可以确保您不会意外丢掉任何回调,并能避免数据差异。

AdValue

AdValue 是一个类,用于表示展示某个广告可赚取的货币价值,它包括价值的货币代码及精度类型,代码说明如下。

AdValue.PrecisionType 说明
Unknown 广告价值未知。如果启用了生命周期价值回 ping,但可用数据不足,就会返回此错误。
Estimated 广告价值是根据汇总数据估算的。
PublisherProvided 广告价值是由发布商提供的,例如中介组中的人工每千次展示费用。
Precise 此广告的精确价值。

使用中介时,AdMob 会尝试为经过优化的广告来源提供 ESTIMATED 值。对于未经优化的广告来源,或者如果没有足够多的汇总数据,无法报告有意义的估算值,系统会返回 PUBLISHER_PROVIDED 值。