展示机会层级的广告收入

请选择平台： Android iOS Unity

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

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

前提条件

实现付费事件处理脚本

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

以下示例处理了激励广告的付费事件：

private void LoadRewardedAd()
{
   // Send the request to load the ad.
   AdRequest adRequest = new AdRequest();
   RewardedAd.Load("AD_UNIT_ID", adRequest, (RewardedAd rewardedAd, LoadAdError error) =>
   {
      // If the operation failed with a reason.
      if (error != null)
      {
         Debug.LogError("Rewarded ad failed to load an ad with error : " + error);
         return;
      }

      rewardedAd.OnAdPaid += this.HandleAdPaidEvent;
   });
}

public void HandleAdPaidEvent(AdValue adValue)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    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"];
}

确定自定义事件广告来源名称

对于自定义事件广告来源，AdSourceName 属性会提供广告来源名称 Custom Event。如果您使用多个自定义事件，则该广告来源名称不够精细，无法区分多个自定义事件。如需查找特定自定义事件，请执行以下步骤：

  1. 获取 AdapterClassName 属性。
  2. 设置唯一的广告来源名称。

以下示例为自定义事件设置了唯一的广告来源名称：

private string GetAdSourceName(AdapterResponseInfo loadedAdapterResponseInfo)
{
    if (loadedAdapterResponseInfo == null)
    {
        return string.Empty;
    }

    string adSourceName = loadedAdapterResponseInfo.AdSourceName;

    if (adSourceName == "Custom Event")
    {

        #if UNITY_ANDROID
            if (loadedAdapterResponseInfo.AdapterClassName ==
                "com.google.ads.mediation.sample.customevent.SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #elif UNITY_IPHONE
            if (loadedAdapterResponseInfo.AdapterClassName == "SampleCustomEvent")
            {
                adSourceName = "Sample Ad Network (Custom Event)";
            }
        #endif

    }
    return adSourceName;
}
ResponseInfoSnippets.cs

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

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

如需全面了解如何将广告收入数据传送到分析平台，请参阅相应的合作伙伴指南：

合作伙伴 SDK
Adjust
AppsFlyer
Singular
Tenjin

实现方面的最佳做法

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

AdValue

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

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

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

测试来自出价广告来源的展示

通过测试请求，触发出价广告来源的展示机会层级的广告收入事件后，您只会收到以下值：

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

之前，您看到的精度类型值可能不是 Unknown，且广告价值超过 0。

如需详细了解如何发送测试广告请求，请参阅启用测试设备。