发生展示时,Google 移动广告 SDK 会提供与该次展示相关联的广告收入数据。您可以使用此数据来计算用户的生命周期价值,也可以将其传送到下游的其他相关系统。
本指南旨在帮助您在 Android 应用中实现获取展示机会层级的广告收入数据的功能。
前提条件
- 确保您已在 AdMob 界面中启用展示机会层级的广告收入功能。
- 导入 Google 移动广告 SDK 21.1.0 或更高版本。
- 通读入门指南。
您需要先植入以下至少一种广告格式,然后才能收到任何展示机会层级的广告收入数据:
付费事件处理脚本
每种广告格式都有一个 OnPaidEventListener
。在广告事件的生命周期内,Google 移动广告 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 |
单数 |
天津 |
植入方面的最佳做法
- 在创建或有权访问广告对象后立即设置监听器,且一定要在展示广告之前进行设置。这样可以确保您不会错过任何付费事件回调。
- 在系统调用
onPaidEvent()
方法时,立即将展示机会层级的广告收入信息发送到您的首选分析服务器。这样可以确保您不会意外丢掉任何回调,并能避免数据差异。
AdValue
AdValue
是一个类,用于表示展示某个广告可赚取的货币价值,它包括价值的货币代码及精度类型,代码说明如下。
PrecisionType | 说明 |
---|---|
UNKNOWN |
广告价值未知。如果启用了生命周期价值 Pingback,但可用数据不足,则返回此值。 |
ESTIMATED |
广告价值是根据汇总数据估算的。 |
PUBLISHER_PROVIDED |
广告价值是由发布商提供的,例如中介组中的人工每千次展示费用。 |
PRECISE |
广告价值是为广告支付的费用的精准值。 |
使用中介时, AdMob 会尝试为经过优化的广告来源提供 ESTIMATED
值。
如果广告来源未经优化,或者如果没有足够多的汇总数据,无法报告有意义的估算值,系统会返回 PUBLISHER_PROVIDED
值。