曝光層級廣告收益

曝光發生時，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<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;

    Dictionary<string, 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
調整
AppsFlyer
Singular
Tenjin

導入最佳做法

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

AdValue

AdValue 類別代表廣告賺取的金錢價值，包括值的貨幣代碼及其精確度類型 (編碼如下所示)。

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

如果是中介服務，AdMob 會嘗試為最佳化的廣告來源提供 ESTIMATED 值。如果是未最佳化的廣告來源，或是匯總資料不足以回報有意義的預估值，系統會傳回 PUBLISHER_PROVIDED 值。