展示机会层级的广告收入

发生展示时,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&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

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

要详细了解胜出的广告来源,请参阅在 Google Ads 中检索 广告响应简介

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

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

合作伙伴 SDK
调整
AppsFlyer
单数
Tenjin

植入方面的最佳做法

  • 在创建或访问OnPaidEvent 而且一定要在展示广告之前进行这样可以确保您不会错过任何回调。
  • 将展示机会层级的广告收入信息发送到您的首选分析工具 服务器。OnPaidEvent这可确保您 意外丢弃所有回调并避免数据差异。

AdValue

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

AdValue.PrecisionType 说明
Unknown 广告值未知。当生命周期价值回 ping 为 但系统没有足够的可用数据。
Estimated 广告价值是根据汇总数据估算的。
PublisherProvided 广告价值是由发布商提供的,例如中介组中的人工每千次展示费用。
Precise 此广告的确切价值。

对于中介,Ad Manager 会尝试为广告提供 ESTIMATED 值 已启用自动数据收集功能的来源。如需了解详情,请参阅 自动收集数据。对于 广告来源未开启自动收集数据功能,或是在某种情况下 如果没有足够的汇总数据来报告有意义的估算值, PUBLISHER_PROVIDED 值。

测试通过公开出价功能获得的展示机会

通过测试请求为公开出价广告来源触发展示机会级广告收入事件后,您只会收到以下值:

  • Unknown:表示精度类型。
  • 0:表示广告价值。

之前,您可能会看到精确度类型为 Unknown 以外的值,并且广告价值超过 0

有关发送测试广告请求的详情,请参见 启用测试设备