本頁面由 Cloud Translation API 翻譯而成。

曝光層級廣告收益

發生曝光時，Google Mobile Ads SDK 會呼叫付費事件處理常式，並傳遞相關的收益資料。實作這個處理常式後，您就能使用資料計算使用者的終身價值，或將資料轉送至其他相關系統。

本指南旨在協助您在 iOS 應用程式中實作 LTV 資料擷取功能。

必要條件

請確認您已在 AdMob 使用者介面中開啟曝光層級廣告收益功能。

匯入 Google Mobile Ads SDK 9.10.0 以上版本。
完成入門指南。
您必須導入至少一種廣告格式，才能獲得曝光層級廣告收益：

導入付費事件處理常式

每個廣告格式都有 paidEventHandler 屬性，屬性類型為 GADPaidEventHandler。在廣告事件的生命週期內，Google Mobile Ads SDK 會監控曝光事件，並以衍生值叫用處理常式。

Swift

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

Objective-C

@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&lt;NSString *, id&gt; *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) 整合

如要進一步瞭解如何將廣告收益資料轉寄至數據分析平台，請參閱合作夥伴指南：

合作夥伴 SDK
調整
AppsFlyer
Singular
Tenjin

導入最佳做法

建立或取得廣告物件存取權後，請立即設定處理程序，並務必在顯示廣告前設定。這樣可確保您不會錯過任何付費事件回呼。
在呼叫 paidEventHandler 方法時，立即將付費事件資訊傳送至偏好的數據分析伺服器。這可確保您不會意外捨棄任何回呼，並避免資料不一致。

GADAdValue

GADAdValue 是代表廣告所賺取的金錢價值的類別，包括值的幣別代碼和精確度類型，如下所示。

GADAdValuePrecision	說明
`GADAdValuePrecisionUnknown`	未知的廣告值。在啟用 LTV 回報時，如果沒有足夠的資料，系統就會傳回這個值。
`GADAdValuePrecisionEstimated`	根據匯總資料得出的預估廣告價值。
`GADAdValuePrecisionPublisherProvided`	發布商提供的廣告價值，例如中介服務群組中的手動千次曝光出價。
`GADAdValuePrecisionPrecise`	為這則廣告支付的精確費用。

測試來自出價廣告來源的曝光

透過測試請求，出價廣告來源發生曝光層級的廣告收益事件後，您只會收到下列值：

GADAdValuePrecisionUnknown：表示精確度類型。

0：表示廣告價值。

先前，您可能會將精確度類型視為 GADAdValuePrecisionUnknown 以外的值，以及超過 0 的廣告值。

如要進一步瞭解如何傳送測試廣告要求，請參閱「啟用測試裝置」。