為了進行偵錯和記錄,已成功載入的廣告會提供 ResponseInfo
物件。除了用於載入廣告的中介服務刊登序列資訊外,這個物件還包含所載入廣告的相關資訊。
如果廣告載入成功,廣告物件就會有 getResponseInfo()
方法。例如,InterstitialAd.getResponseInfo()
會取得已載入的插頁式廣告回應資訊。
如果廣告無法載入,且只顯示錯誤訊息,您可以透過 LoadAdError.getResponseInfo()
取得回應資訊。
Kotlin
override fun onAdLoaded(interstitialAd: InterstitialAd)) {
val responseInfo = interstitialAd.responseInfo
Log.d(TAG, responseInfo.toString())
}
override fun onAdFailedToLoad(adError: LoadAdError) {
val responseInfo = adError.responseInfo
Log.d(TAG, responseInfo.toString())
}
Java
@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
ResponseInfo responseInfo = interstitialAd.getResponseInfo();
Log.d(TAG, responseInfo.toString());
}
@Override
public void onAdFailedToLoad(LoadAdError loadAdError) {
ResponseInfo responseInfo = loadAdError.getResponseInfo();
Log.d(TAG, responseInfo.toString());
}
回應資訊
以下是 ResponseInfo.toString()
傳回的範例輸出內容,顯示為已載入廣告傳回的偵錯資料:
{
"Response ID": "NI3BZZDbGdyQtOUP4o21gAM",
"Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
"Adapter Responses": [
{
"Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
"Latency": 3585,
"Ad Source Name": "AdMob Network",
"Ad Source ID": "",
"Ad Source Instance Name": "AdMob (default)",
"Ad Source Instance ID": "",
"Credentials": {
"pubid": "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
},
"Ad Error": "null"
}
],
"Loaded Adapter Response": {
"Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
"Latency": 3585,
"Ad Source Name": "AdMob Network",
"Ad Source ID": "",
"Ad Source Instance Name": "AdMob (default)",
"Ad Source Instance ID": "",
"Credentials": {
"pubid": "ca-app-pub-3940256099942544\/9257395921\/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
},
"Ad Error": "null"
},
"Response Extras": {}
}
ResponseInfo
物件上的方法包括:
方法 | 說明 |
---|---|
getAdapterResponses |
傳回
AdapterResponseInfo 清單,其中包含廣告回應中每個轉接器的中繼資料。可用於偵錯刊登序列中介服務和出價執行作業。清單的順序符合此廣告請求中介服務刊登序列的順序。
詳情請參閱「轉接器回應資訊」。 |
getLoadedAdapterResponseInfo |
傳回與載入廣告的轉接程式相對應的 AdapterResponseInfo 。 |
getMediationAdapterClassName
|
傳回載入廣告的廣告來源的中介服務轉接器類別名稱。 |
getResponseId |
回應 ID 是廣告回應的專屬 ID。這個 ID 可用來在廣告審核中心識別和封鎖廣告。 |
getResponseExtras |
傳回廣告回應的額外資訊。 |
Kotlin
override fun onAdLoaded(interstitialAd: InterstitialAd)) {
val responseInfo = interstitialAd.responseInfo
val responseId = responseInfo.responseId
val mediationAdapterClassName = responseInfo.mediationAdapterClassName
val adapterResponses = responseInfo.adapterResponses
val loadedAdapterResponseInfo = responseInfo.loadedAdapterResponseInfo
}
Java
@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
MyActivity.this.interstitialAd = interstitialAd;
ResponseInfo responseInfo = interstitialAd.getResponseInfo();
String responseId = responseInfo.getResponseId();
String mediationAdapterClassName = responseInfo.getMediationAdapterClassName();
List<AdapterResponseInfo> adapterResponses = responseInfo.getAdapterResponses();
AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();
}
轉接器回應資訊
AdapterResponseInfo
包含廣告回應中個別廣告來源的回應資訊。
下列 AdapterResponseInfo
輸出內容範例會顯示已載入廣告的結構描述:
{
"Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
"Latency": 3585,
"Ad Source Name": "AdMob Network",
"Ad Source ID": "",
"Ad Source Instance Name": "AdMob (default)",
"Ad Source Instance ID": "",
"Credentials": {
"pubid": "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=8e&caqid=NI3BZfDhGICQtOUP7ayS4Aw"
},
"Ad Error": "null"
}
AdapterResponseInfo
針對每個廣告來源提供下列方法:
方法 | 說明 |
---|---|
getAdError |
取得與廣告來源要求相關的錯誤。如果廣告來源成功載入廣告,或未嘗試廣告來源,則會傳回 null 。 |
getAdSourceId |
取得與這個轉接程式回應相關聯的廣告來源 ID。 |
getAdSourceInstanceId |
取得與此轉接器回應相關聯的廣告來源例項 ID。 |
getAdSourceInstanceName |
取得與此轉接程式回應相關聯的廣告來源例項名稱。 |
getAdSourceName |
取得與此轉接器回應相關聯的廣告來源名稱。 |
getAdapterClassName |
取得載入廣告的廣告來源轉接程式類別名稱。 |
getCredentials |
取得 Ad Manager UI 中指定的廣告來源轉接程式憑證。 |
getLatencyMillis |
取得廣告來源轉接程式載入廣告的時間長度。
如果未嘗試廣告來源,則會傳回 0 。 |
Kotlin
override fun onAdLoaded(interstitialAd: InterstitialAds) {
val loadedAdapterResponseInfo = interstitialAd.responseInfo.loadedAdapterResponseInfo
val adError = loadedAdapterResponseInfo.adError
val adSourceId = loadedAdapterResponseInfo.adSourceId
val adSourceInstanceId = loadedAdapterResponseInfo.adSourceInstanceId
val adSourceInstanceName = loadedAdapterResponseInfo.adSourceInstanceName
val adSourceName = loadedAdapterResponseInfo.adSourceName
val adapterClassName = loadedAdapterResponseInfo.adapterClassName
val credentials = loadedAdapterResponseInfo.credentials
val latencyMillis = loadedAdapterResponseInfo.latencyMillis
}
Java
@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
AdapterResponseInfo loadedAdapterResponseInfo =
interstitialAd.getResponseInfo().getLoadedAdapterResponseInfo();
AdError adError = loadedAdapterResponseInfo.getAdError();
String adSourceId = loadedAdapterResponseInfo.getAdSourceId();
String adSourceInstanceId = loadedAdapterResponseInfo.getAdSourceInstanceId();
String adSourceInstanceName = loadedAdapterResponseInfo.getAdSourceInstanceName();
String adSourceName = loadedAdapterResponseInfo.getAdSourceName();
String adapterClassName = loadedAdapterResponseInfo.getAdapterClassName();
Bundle credentials = loadedAdapterResponseInfo.getCredentials();
long latencyMillis = loadedAdapterResponseInfo.getLatencyMillis();
}