曝光層級廣告收益

曝光發生時，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 這則廣告的精確價值。

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

測試公開出價的曝光

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

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

先前，您可能會將精確度類型視為 Unknown 以外的值，以及超過 0 的廣告值。

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