展示机会层级的广告收入

发生展示时，Google 移动广告 SDK 会用相关联的收入数据调用付费事件处理脚本。通过实现该处理脚本，您可以使用此数据来计算用户的生命周期价值，也可以将此数据传送到下游的其他相关系统。

本指南旨在帮助您在 iOS 应用中启用获取生命周期价值数据的功能。

前提条件

• 确保您已在 AdMob 界面中启用展示机会层级的广告收入功能。

• 导入 Google 移动广告 SDK 9.10.0 或更高版本。
• 完成入门指南。

• 您需要先植入以下至少一种广告格式，然后才能收到任何展示机会层级的广告收入数据：

  • 横幅广告
  • 插页式广告
  • 激励广告
  • 插页式激励广告
  • 原生代码

实现付费事件处理脚本

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

class ViewController: UIViewController, GADFullScreenContentDelegate {
  var rewardedAd: GADRewardedAd?
  func requestRewardedAd() {
    GADRewardedAd.load(
      withAdUnitID: "AD_UNIT_ID", request: GADRequest()
    ) { (ad, error) in
      if let error = error {
        print("Rewarded ad failed to load with error: \(error.localizedDescription)")
        return
      }
      if let ad = ad {
        self.rewardedAd = ad
        self.rewardedAd?.paidEventHandler = { adValue in
          // TODO: Send the impression-level ad revenue information to your preferred analytics
          // server directly within this callback.

          // Extract the impression-level ad revenue data.
          let value = adValue.value
          let precision = adValue.precision
          let currencyCode = adValue.currencyCode

          // Get the ad unit ID.
          let adUnitId = ad.adUnitID

          let responseInfo = ad.responseInfo
          let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
          let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
          let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
          let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
          let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
          let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
          let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
        }
      }
    }
  }
}

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()
@property(nonatomic, strong) GADRewardedAd *rewardedAd;
@end

@implementation ViewController
- (void)requestRewardedAd {
  __weak ViewController *weakSelf = self;

  GADRequest *request = [GADRequest request];
  [GADRewardedAd
   loadWithAdUnitID:@"AD_UNIT_ID"
   request:request
   completionHandler:^(GADRewardedAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
      return;
    }
    self.rewardedAd = ad;
    self.rewardedAd.paidEventHandler = ^void(GADAdValue *_Nonnull value){
      ViewController *strongSelf = weakSelf;
      // TODO: Send the impression-level ad revenue information to your preferred analytics
      // server directly within this callback.

      // Extract the impression-level ad revenue data.
      NSDecimalNumber *value; = value.value;
      NSString *currencyCode = value.currencyCode;
      GADAdValuePrecision precision = value.precision;

      // Get the ad unit ID.
      NSString *adUnitId = strongSelf.rewardedAd.adUnitID;

      GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo =
          strongSelf.rewardedAd.responseInfo.loadedAdNetworkResponseInfo;
      NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
      NSString *adSourceID = loadedAdNetworkResponseInfo.adSourceID;
      NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
      NSString *adSourceInstanceID = loadedAdNetworkResponseInfo.adSourceInstanceID;
      NSDictionary<NSString *, id> *extras = strongSelf.rewardedAd.responseInfo.extrasDictionary;
      NSString *mediationGroupName = extras["mediation_group_name"];
      NSString *mediationABTestName = extras["mediation_ab_test_name"];
      NSString *mediationABTestVariant = extras["mediation_ab_test_variant"];
    };
  ]};
}

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

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

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

植入方面的最佳实践

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

GADAdValue

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

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

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

• GADAdValuePrecisionUnknown：表示精度类型。

• 0：表示广告价值。

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

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