曝光層級廣告收益

廣告曝光時，Google Mobile Ads SDK for React Native 會提供該次曝光的相關廣告收益資料。您可以使用這項資料計算使用者的生命週期價值 (LTV)，或將資料轉送至數據分析平台或第三方歸因合作夥伴。

本指南說明如何在 React Native 原生應用程式中，導入曝光層級廣告收益的資料擷取功能。

必要條件

請先完成下列事項，再繼續操作：

每種廣告格式都支援 onAdPaid 事件回呼。在廣告生命週期中，Google Mobile Ads SDK for React Native 會監控曝光事件，並叫用處理常式，傳送賺取的 AdValue 酬載。

以下範例說明如何為獎勵廣告註冊付費事件監聽器、記錄賺取的廣告收益資料，以及顯示廣告：

const rewarded = await RewardedAd.load(adRequest);

rewarded.adEventCallback = {
  onAdPaid(adValue: AdValue) {
    const revenue = adValue.amountMicros / 1000000;
    console.log(`Earned ad revenue: ${revenue} ${adValue.currencyCode}`);
    console.log(`Precision level: ${adValue.precision}`);
  },
};

rewarded.show();

建議您採取下列做法：

  • 如果是全螢幕廣告，請在載入廣告後、顯示廣告前，設定廣告物件的事件監聽器。如果是橫幅和原生廣告，請將 onAdPaid 回呼做為屬性傳遞至 <BannerAdView /> 或 <NativeAdView /> 元件。以免錯過任何付費事件回呼。

  • 當 Google Mobile Ads SDK for React Native 呼叫 onAdPaid 回呼時，將曝光層級廣告收益資訊傳送至偏好的數據分析伺服器。這個程序可確保您不會錯過回呼，並維持資料一致性。

瞭解 AAP 整合

如要進一步瞭解如何將廣告收益資料轉送至數據分析平台，請參閱下列應用程式歸因合作夥伴 (AAP) 指南：

瞭解 AdValue 物件

AdValue 物件代表廣告賺取的金額價值，包含貨幣代碼和精確度類型。下表列出 AdValue 物件屬性：

屬性 說明
amountMicros 以微量單位表示的廣告收益，1000000 微量單位等於 1 單位的實際貨幣，例如$1.00 美元或 €1.00 歐元。
currencyCode 廣告價值的 ISO 4217 貨幣代碼，例如 USD 或 EUR。
precision 廣告價值的精確程度。以下清單詳細說明各個精確度等級：
  • UNKNOWN：未知的廣告價值。啟用 LTV 自動參照通知，但資料不足時，系統會傳回這個值。
  • ESTIMATED：根據匯總資料預估的廣告價值。
  • PUBLISHER_PROVIDED：由發布商提供的廣告價值，例如中介服務群組中的手動千次曝光出價。
  • PRECISE：為廣告支付的精確價值。

在 AdMob 中介服務中，AdMob 會嘗試為已最佳化的廣告來源提供 ESTIMATED 值。詳情請參閱「中介服務刊登序列廣告來源最佳化」。 如果廣告來源未最佳化，或匯總資料不足以計算預估值，Google Mobile Ads SDK for React Native 會傳回 PUBLISHER_PROVIDED 精確度類型。

測試出價廣告來源的曝光

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

  • UNKNOWN：表示精確度類型。
  • 0：表示廣告價值。

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