曝光發生時,Google Mobile Ads SDK 會提供與該曝光相關的廣告收益資料。您可以使用這些資料計算使用者的生命週期值,或是將資料轉送至其他相關系統。
本指南旨在協助您在 Android 應用程式中導入曝光層級廣告收益資料。
必要條件
- 請確認您已在 AdMob UI 中啟用曝光層級廣告收益功能。
- 匯入 Google Mobile Ads SDK 21.1.0 以上版本。
- 完成入門指南。
您需要導入至少一個廣告格式,才能獲得任何曝光層級的廣告收益:
付費事件處理常式
每種廣告格式都有一個 OnPaidEventListener
。在廣告事件的生命週期期間,Google Mobile Ads SDK 會監控曝光事件,並以衍生的值叫用處理常式。
以下程式碼示範如何處理獎勵廣告的付費事件:
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");
}
});
}
});
}
}
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?) {
AdRequest adRequest = new 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")
}
}
})
}
}
如要進一步瞭解勝出廣告來源,請參閱「擷取廣告回應的相關資訊」一文。
應用程式歸因合作夥伴 (AAP) 整合
如需將廣告收益資料轉送至分析平台的完整詳細資料,請參閱合作夥伴的指南:
合作夥伴 SDK |
---|
調整 |
AppsFlyer |
Singular |
Tenjin |
導入最佳做法
- 在您建立或取得廣告物件的存取權後,立即設定事件監聽器,並在顯示廣告前一律設定。如此可確保您不會錯過任何付費事件回呼。
- 呼叫
onPaidEvent()
方法時,立即將曝光層級的廣告收益資訊傳送至您偏好的分析伺服器。這可確保您不會意外捨棄任何回呼,也能避免資料之間出現差異。
AdValue
AdValue
類別代表廣告所賺取的金額,包括相應值的貨幣代碼及其編碼率 (如下所示)。
PrecisionType | 說明 |
---|---|
UNKNOWN |
未知的廣告值。如果已啟用 LTV 自動參照通知,但可用資料不足,系統就會傳回這個狀態。 |
ESTIMATED |
根據匯總資料估算的廣告價值。 |
PUBLISHER_PROVIDED |
發布商提供的廣告價值,例如中介服務群組中的手動千次曝光出價。 |
PRECISE |
為這則廣告支付的精確值。 |
針對中介服務, AdMob 會嘗試為已最佳化的提供 ESTIMATED
值。
如果是未最佳化的廣告來源,或是匯總資料不足以記錄有意義的預估,系統就會傳回 PUBLISHER_PROVIDED
值。