曝光層級廣告收益

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

本指南說明如何在 Unity 專案中，導入曝光層級廣告收益的資料擷取功能。

先決條件

導入付費事件處理常式

所有廣告格式都有 OnPaidEvent 事件。在廣告事件的生命週期中，Google Mobile Ads SDK 會監控曝光事件，並依據賺取金額價值叫用處理常式。

下方程式碼演示如何處理獎勵廣告的付費事件：

RewardedAd rewardedAd;

private void RequestRewardedAd()
{
   rewardedAd = new RewardedAd("AD_UNIT_ID");
   
   rewardedAd.OnPaidEvent += this.HandleAdPaidEvent;
   
   AdRequest adRequest = new AdRequest();
   rewardedAd.LoadAd(adRequest);
}


public void HandleAdPaidEvent(object sender, AdValueEventArgs args)
{
    // TODO: Send the impression-level ad revenue information to your
    // preferred analytics server directly within this callback.

    AdValue adValue = args.AdValue;
    long valueMicros = adValue.Value;
    string currencyCode = adValue.CurrencyCode;
    PrecisionType precision = adValue.Precision;

    ResponseInfo responseInfo = rewardedAd.GetResponseInfo();
    string responseId = responseInfo.GetResponseId();

    AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
    string adSourceId = loadedAdapterResponseInfo.AdSourceId;
    string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
    string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
    string adSourceName = loadedAdapterResponseInfo.AdSourceName;
    string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
    long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
    Dictionary&ltstring, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary&ltstring, string> extras = responseInfo.GetResponseExtras();
    string mediationGroupName = extras["mediation_group_name"];
    string mediationABTestName = extras["mediation_ab_test_name"];
    string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

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

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

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

合作夥伴 SDK
Adjust
AppsFlyer
Singular
Tenjin

導入最佳做法

  • 建立廣告物件或取得相應存取權後，請務必立刻在顯示廣告前設定 OnPaidEvent 事件，確保不會錯過任何回呼。
  • 在 OnPaidEvent 處理常式中，立即將曝光層級廣告收益資訊傳送至偏好的數據分析伺服器，確保不會意外錯過任何回呼，並避免資料不一致。

AdValue

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

AdValue.PrecisionType 說明
Unknown 廣告價值不明。啟用 LTV 自動參照通知，但資料不足時，系統會傳回這個值。
Estimated 根據匯總資料預估的廣告價值。
PublisherProvided 發布商提供的廣告價值，例如中介服務群組中的手動千次曝光出價。
Precise 這則廣告的精確價值。

如果使用中介服務，且廣告來源已啟用自動資料收集功能，Ad Manager 就會嘗試提供該來源的 ESTIMATED 值。詳情請參閱「自動資料收集」。如果廣告來源未啟用自動資料收集功能，或是匯總資料不足以提供有意義的預估值，系統會傳回 PUBLISHER_PROVIDED 值。

測試公開出價的曝光次數

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

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

先前，您或許遇過精確度類型值不是 Unknown，且廣告價值大於 0 的情況。

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