曝光層級廣告收益

選取平台： Android iOS Unity

廣告曝光時，Google Mobile Ads SDK 會呼叫付費事件處理常式，並傳送曝光的相關收益資料。導入這個處理常式，您就能取得資料來計算使用者的生命週期價值，也可以將資料傳送至後續系統處理。

本指南說明如何在 iOS 應用程式中導入 LTV 資料擷取功能。

必備條件

• 務必先在 AdMob UI 啟用曝光層級廣告收益功能。

• 匯入 Google Mobile Ads SDK 9.10.0 以上版本。
• 完成入門指南的步驟。

• 須先導入下列至少一種廣告格式，才能接收曝光層級廣告收益資料：

  • 橫幅廣告
  • 插頁式廣告
  • 獎勵廣告
  • 插頁式獎勵廣告
  • 原生廣告

導入付費事件處理常式

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

Swift

class ViewController: UIViewController, FullScreenContentDelegate {
  var rewardedAd: RewardedAd?
  func requestRewardedAd() {
    RewardedAd.load(
      with: "AD_UNIT_ID", request: Request()
    ) { (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?.extras["mediation_group_name"]
          let mediationABTestName = responseInfo?.extras["mediation_ab_test_name"]
          let mediationABTestVariant = responseInfo?.extras["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<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"];
    };
  ]};
}

找出自訂事件廣告來源名稱

針對自訂事件廣告來源，adSourceName 屬性會傳回廣告來源名稱 Custom event。如果有多個自訂事件，將無法只憑廣告來源名稱細分事件。因此請完成下列步驟，找出特定自訂事件：

1. 取得 adNetworkClassName 屬性。
2. 設定專屬的廣告來源名稱。

以下示範如何為自訂事件設定專屬的廣告來源名稱：

Swift

func uniqueAdSourceName(for loadedAdNetworkResponseInfo: AdNetworkResponseInfo) -> String {
  var adSourceName: String = loadedAdNetworkResponseInfo.adSourceName ?? ""
  if adSourceName == "Custom Event" {
    if loadedAdNetworkResponseInfo.adNetworkClassName
      == "MediationExample.SampleCustomEventSwift"
    {
      adSourceName = "Sample Ad Network (Custom Event)"
    }
  }
  return adSourceName
}
ResponseInfoSnippets.swift

Objective-C

- (NSString *)uniqueAdSourceNameForAdNetworkResponseInfo:
    (GADAdNetworkResponseInfo *)loadedAdNetworkResponseInfo {
  NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
  if ([adSourceName isEqualToString:@"Custom Event"]) {
    if ([loadedAdNetworkResponseInfo.adNetworkClassName isEqualToString:@"SampleCustomEvent"]) {
      adSourceName = @"Sample Ad Network (Custom Event)";
    }
  }
  return adSourceName;
}
ResponseInfoSnippets.m

請參閱「擷取廣告回應的相關資訊」，進一步瞭解勝出的廣告來源。

與應用程式歸因合作夥伴 (AAP) 整合

若想詳盡全面地瞭解如何將廣告收益資料轉送至數據分析平台，請參閱合作夥伴指南：

合作夥伴 SDK
Adjust
AppsFlyer
Singular
Tenjin

導入最佳做法

• 建立或取得廣告物件後，立即設定處理常式，且務必在顯示廣告前完成，以免錯過任何付費事件回呼。
• 在系統呼叫 paidEventHandler 方法時，立即將付費事件資訊傳送至您慣用的數據分析伺服器，以免不小心錯過任何回呼，並避開資料不一致的問題。

GADAdValue

GADAdValue 類別代表廣告賺取的金額價值，當中包含貨幣代碼和精確度類型，編碼方式如下。

重點：GADAdValue.value 的數值為小數，表示每則廣告的價值，例如 0.005 是指廣告預估價值為 $0.005 美元。

GADAdValuePrecision	說明
GADAdValuePrecisionUnknown	廣告價值不明。如已啟用生命週期價值 (LTV) 自動參照通知，但資料不足，則系統會傳回此值。
GADAdValuePrecisionEstimated	根據匯總資料預估的廣告價值。
GADAdValuePrecisionPublisherProvided	發布商提供的廣告價值，例如中介服務群組中的手動千次曝光出價。
GADAdValuePrecisionPrecise	為此廣告支付的精確價值。

重點：如果是中介服務，AdMob 會先嘗試提供 GADAdValuePrecisionEstimated。若匯總資料不足，無法回報有意義的值，則改為提供 GADAdValuePrecisionPublisherProvided。

測試出價廣告來源的曝光

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

• GADAdValuePrecisionUnknown：表示精確度類型。

• 0：表示廣告價值。

您先前可能看過不是 GADAdValuePrecisionUnknown 的精確度類型值，且廣告價值大於 0。

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