曝光層級廣告收益

廣告曝光時，Google Mobile Ads SDK 會提供該次曝光的相關廣告收益資料。您可以運用這項資料，計算使用者的生命週期價值，或將資料往下游轉送至其他相關系統。

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

必要條件

處理付費事件

每種廣告格式的委託通訊協定都包含 didRecordPaidEventWithAdValue: 方法。在廣告生命週期中，Google Mobile Ads SDK 會監控曝光事件，並使用取得的 GADAdValue 物件呼叫這個委派方法。

以下示範如何處理獎勵廣告付費事件：

Swift

func ad(_ ad: FullScreenPresentingAd, didRecordPaidEventWith adValue: AdValue) {
  // 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 currencyCode = adValue.currencyCode
  let precision = adValue.precision

  print(
    "Ad paid event. Value: \(value) \(currencyCode), with precision: \(precision)."
  )
}

Objective-C

- (void)ad:(id<GADFullScreenPresentingAd>)ad didRecordPaidEventWithAdValue:(GADAdValue *)adValue {
  // 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 = adValue.value;
  NSString *currencyCode = adValue.currencyCode;
  GADAdValuePrecision precision = adValue.precision;

  NSLog(@"Ad paid event. Value: %@ %@, with precision: %ld.", value, currencyCode, (long)precision);
}

辨識自訂事件的廣告來源名稱

對於自訂事件廣告來源，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
}

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

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

導入最佳做法

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

GADAdValue

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

GADAdValuePrecision 說明
GADAdValuePrecisionUnknown 廣告價值不明。啟用 LTV 自動參照通知，但資料不足時，系統會傳回此值。
GADAdValuePrecisionEstimated 從匯總資料估算出的廣告價值。
GADAdValuePrecisionPublisherProvided 發布商提供的廣告價值，例如中介服務群組中的手動千次曝光出價。
GADAdValuePrecisionPrecise 該廣告帶來的精確收益金額。

測試公開出價的曝光次數

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

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

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