本頁面由 Cloud Translation API 翻譯而成。

曝光層級廣告收益

曝光發生時，Google Mobile Ads SDK 會提供與該曝光相關的廣告收益資料。您可以使用這項資料計算使用者的終身價值，或將資料轉寄至其他相關系統。

本指南旨在協助您在 Android 應用程式中實作曝光層級廣告收益資料擷取功能。

必要條件

請確認您已在 AdMob 使用者介面中開啟曝光層級廣告收益功能。

匯入 Google Mobile Ads SDK 21.1.0 以上版本。

完成入門指南。
您必須導入至少一種廣告格式，才能獲得曝光層級廣告收益：

付費事件處理常式

每個廣告格式都有一個 OnPaidEventListener。在廣告事件的生命週期中，Google Mobile Ads SDK 會監控曝光事件，並以已賺取的價值叫用處理程序。

以下範例會處理獎勵廣告的付費事件：

Kotlin

import com.google.android.gms.ads.rewarded.RewardedAd

class MainActivity : AppCompatActivity() {
  private var rewardedAd: RewardedAd? = null
  private final var TAG = "MainActivity"

  override fun onCreate(savedInstanceState: Bundle?) {
    val adRequest = AdRequest.Builder().build()

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, object: RewardedAdLoadCallback() {
        override fun onAdLoaded(ad: RewardedAd) {
          rewardedAd = ad
          // Set paid event listener
          rewardedAd.onPaidEventListener = OnPaidEventListener { 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.
            val valueMicros = adValue.valueMicros
            val currencyCode = adValue.currencyCode
            val precision = adValue.precisionType

            // Get the ad unit ID.
            val adUnitId = rewardedAd.adUnitId

            val loadedAdapterResponseInfo = rewardedAd.responseInfo.loadedAdapterResponse
            val adSourceName = loadedAdapterResponseInfo.adSourceName
            val adSourceId = loadedAdapterResponseInfo.adSourceId
            val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
            val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
            val extras = rewardedAd.responseInfo.responseExtras
            val mediationGroupName = extras.getString("mediation_group_name")
            val mediationABTestName = extras.getString("mediation_ab_test_name")
            val mediationABTestVariant = extras.getString("mediation_ab_test_variant")
          }
        }
    })
  }
}

Java

import com.google.android.gms.ads.rewarded.RewardedAd;

public class MainActivity extends Activity {
  private RewardedAd rewardedAd;
  private final String TAG = "MainActivity";

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    AdRequest adRequest = new AdRequest.Builder().build();

    RewardedAd.load(this, "AD_UNIT_ID",
      adRequest, new RewardedAdLoadCallback(){
        @Override
        public void onAdLoaded(@NonNull RewardedAd ad) {
          rewardedAd = ad;
          // Set paid event listener
          rewardedAd.setOnPaidEventListener(new OnPaidEventListener() {
            @Override
            public void onPaidEvent(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.
              long valueMicros = adValue.getValueMicros();
              String currencyCode = adValue.getCurrencyCode();
              int precision = adValue.getPrecisionType();

              // Get the ad unit ID.
              String adUnitId = rewardedAd.getAdUnitId();
              
              AdapterResponseInfo loadedAdapterResponseInfo = rewardedAd.getResponseInfo().
                  getLoadedAdapterResponseInfo();
              String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
              String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
              String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
              String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();

              Bundle extras = rewardedAd.getResponseInfo().getResponseExtras();
              String mediationGroupName = extras.getString("mediation_group_name");
              String mediationABTestName = extras.getString("mediation_ab_test_name");
              String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
            }
          });
        }
    });
  }
}

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

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

如需有關將廣告收益資料轉送至數據分析平台的完整詳細資訊，請參閱合作夥伴指南：

合作夥伴 SDK
調整
AppsFlyer
Singular
Tenjin

導入最佳做法

建立或取得廣告物件存取權後，請立即設定事件監聽器，並務必在顯示廣告前完成。這樣一來，您就不會錯過任何付費事件回呼。
在付費事件回呼時，立即將曝光層級廣告收益資訊傳送至您偏好的數據分析伺服器。這可確保您不會意外捨棄任何回呼，並避免資料不一致。

AdValue

AdValue 是代表廣告所賺取的金錢價值的類別，包括值的幣別代碼和精確度類型，如下所示。

PrecisionType	說明
`UNKNOWN`	不明的廣告值。在啟用 LTV 回報時，如果沒有足夠的資料，系統就會傳回這個值。
`ESTIMATED`	根據匯總資料得出的預估廣告價值。
`PUBLISHER_PROVIDED`	由發布商提供的廣告價值，例如中介服務群組中的手動千次曝光出價。
`PRECISE`	為這則廣告支付的精確費用。

在 AdMob 中介服務的情況下，AdMob 會嘗試為最佳化的廣告來源提供 ESTIMATED 值。

如果是未最佳化的廣告來源，或是沒有足夠的匯總資料可用於回報有意義的預估值，系統就會傳回 PUBLISHER_PROVIDED 值。

測試出價廣告來源的曝光次數

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

UNKNOWN：表示精確度類型。

0：表示廣告價值。

先前，您可能會發現精確度類型是 UNKNOWN 以外的值，且廣告價值大於 0。

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