광고 응답에 대한 정보를 가져옵니다.

정상적으로 로드된 광고는 디버깅 및 로깅을 위해 ResponseInfo 객체를 제공합니다. 이 객체에는 로드된 광고에 관한 정보가 포함됩니다. 각 광고 형식 클래스에는 응답 정보를 가져오는 메서드가 있습니다. 예를 들어 전면 광고에서는 getResponseInfo() 메서드를 사용합니다.

ResponseInfo 객체의 메서드에는 다음이 포함됩니다.

getAdapterResponses()

광고 응답에 포함된 각 어댑터의 메타데이터를 포함하는 AdapterResponseInfo 목록을 반환하며, 폭포식 구조 미디에이션 및 입찰 실행을 디버깅하는 데 사용될 수 있습니다.

AdapterResponseInfo는 각 광고 네트워크에 대해 다음 메서드를 제공합니다.

메서드	설명
getAdError	네트워크에 보낸 요청과 관련된 오류를 가져옵니다. 네트워크에서 광고를 정상적으로 로드했거나 네트워크에 광고 요청을 보내지 않았으면 null을 반환합니다.
getAdapterClassName	광고 네트워크를 식별하는 클래스 이름을 가져옵니다.
getCredentials	AdMob UI에 설정된 네트워크 구성을 가져옵니다.
getLatencyMillis	광고 네트워크에서 광고를 로드하는 데 걸린 시간을 가져옵니다. 네트워크에 광고 요청을 보내지 않았으면 0이 반환됩니다.

이러한 속성을 쿼리하면 각 광고 요청에 대한 폭포식 구조 미디에이션 및 입찰의 결과를 세부적으로 파악할 수 있습니다.

getLoadedAdapterResponseInfo()

광고를 로드하는 데 사용된 어댑터에 해당하는 AdapterResponseInfo를 반환합니다. 광고가 로드되지 않은 경우 null을 반환합니다. 위의 AdapterResponseInfo에서 제공하는 메서드를 참고하세요.

getMediationAdapterClassName()

현재의 광고를 가져온 광고 네트워크의 클래스 이름입니다. 이 메서드에서 반환될 수 있는 값은 다음과 같습니다.

광고 소스	클래스 이름
Google Ads	com.google.ads.mediation.admob.AdMobAdapter
보상형 맞춤 이벤트	맞춤 이벤트의 클래스 이름
다른 모든 맞춤 이벤트	com.google.ads.mediation.customevent.CustomEventAdapter
미디에이션	미디에이션 어댑터의 클래스 이름

getResponseId()

응답 식별자는 광고 응답의 고유한 식별자이며, 광고 심사 센터(ARC)에서 광고를 식별하고 차단하기 위해 사용할 수 있습니다.

샘플 코드

다음은 AdListener 콜백 구현의 샘플 스니펫입니다.

자바

@Override
public void onAdLoaded() {
    ResponseInfo responseInfo = bannerAdView.getResponseInfo();
    Log.d(TAG, responseInfo.toString());
}

@Override
public void onAdFailedToLoad(LoadAdError loadAdError) {
    ResponseInfo responseInfo = loadAdError.getResponseInfo();
    Log.d(TAG, responseInfo.toString());
}

Kotlin

override fun onAdLoaded() {
    val responseInfo = ad_view.responseInfo
    Log.d(TAG, responseInfo.toString())

}

override fun onAdFailedToLoad(adError: LoadAdError) {
    val responseInfo = adError.responseInfo
    Log.d(TAG, responseInfo.toString())
}

다음은 Google 모바일 광고 SDK 19.4.0 이상을 사용하는 경우의 샘플 출력입니다.

{
  "Response ID": "MwRtX5mnEYqYmLAPwMKFkAk",
  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
  "Adapter Responses": [{
    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
    "Latency": 89,
    "Credentials": {},
    "Ad Error": "null"
    }]
}