此页面由 Cloud Translation API 翻译。

展示机会层级的广告收入

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

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

前提条件

确保您已在 AdMob 界面中启用展示机会层级的广告收入功能。
Unity 插件 5.0.0 或更高版本。
完成入门指南。您的 Unity 应用应该已经导入了 Google 移动广告 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"];
}

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

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

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

合作伙伴 SDK
调整
AppsFlyer
Singular
Tenjin

植入方面的最佳实践

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

AdValue

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

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

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

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

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

Unknown：表示精度类型。

0：表示广告价值。

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