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

플랫폼 선택: Android (베타) New-selected Android iOS Unity Flutter

정상적으로 로드된 광고는 디버깅 및 로깅을 위해 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": "COOllLGxlPoCFdAx4Aod-Q4A0g",
  "Mediation Adapter Class Name": "com.google.ads.mediation.admob.AdMobAdapter",
  "Adapter Responses": [
    {
      "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
      "Latency": 328,
      "Ad Source Name": "Reservation campaign",
      "Ad Source ID": "7068401028668408324",
      "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
      "Ad Source Instance ID": "4665218928925097",
      "Credentials": {},
      "Ad Error": "null"
    }
  ],
  "Loaded Adapter Response": {
    "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
    "Latency": 328,
    "Ad Source Name": "Reservation campaign",
    "Ad Source ID": "7068401028668408324",
    "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
    "Ad Source Instance ID": "4665218928925097",
    "Credentials": {},
    "Ad Error": "null"
  },
  "Response Extras": {
    "mediation_group_name": "Campaign"
  }
}

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

메서드 설명
getAdSourceResponses 광고 응답에 포함된 각 광고 소스의 메타데이터를 포함하는 AdSourceResponseInfo 목록을 반환합니다. 폭포식 구조 미디에이션 및 입찰 실행을 디버깅하는 데 사용될 수 있습니다. 목록의 순서는 이 광고 요청의 연쇄 광고 호출 조정 순서와 일치합니다.

자세한 내용은 광고 소스 응답 정보를 참고하세요.

getLoadedAdSourceResponse 광고를 로드한 광고 소스에 해당하는 AdSourceResponseInfo 를 반환합니다.
getAdapterClassName 광고를 로드한 광고 소스의 미디에이션 어댑터 클래스 이름을 반환합니다.
getResponseId 응답 식별자는 광고 응답의 고유 식별자입니다. 이 식별자는 광고 심사 센터에서 광고를 식별하고 차단할 때 사용될 수 있습니다. 광고 심사 센터 (ARC).
getResponseExtras 광고 응답에 대한 추가 정보를 반환합니다. 추가 정보는 다음 키를 반환할 수 있습니다.
  • mediation_group_name: 미디에이션 그룹의 이름
  • mediation_ab_test_name: 미디에이션 A/B 테스트의 이름( 해당하는 경우)
  • mediation_ab_test_variant: 미디에이션 A/B 테스트에 사용된 대안(해당하는 경우)

Kotlin 

override fun onAdLoaded(interstitialAd: InterstitialAd) {
  val responseInfo = interstitialAd.responseInfo

  val responseId = responseInfo.responseId
  val adapterClassName = responseInfo.adapterClassName
  val adSourceResponses = responseInfo.adSourceResponses
  val loadedAdSourceResponse = responseInfo.loadedAdSourceResponse
  val extras = 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 

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  MyActivity.this.interstitialAd = interstitialAd;

  ResponseInfo responseInfo = interstitialAd.getResponseInfo();
  String responseId = responseInfo.getResponseId();
  String adapterClassName = responseInfo.getAdapterClassName();
  List<AdSourceResponseInfo> adSourceResponses = responseInfo.getAdSourceResponses();
  AdSourceResponseInfo loadedAdSourceResponse = responseInfo.getLoadedAdSourceResponse();
  Bundle extras = responseInfo.getResponseExtras();
  String mediationGroupName = extras.getString("mediation_group_name");
  String mediationABTestName = extras.getString("mediation_ab_test_name");
  String mediationABTestVariant = extras.getString("mediation_ab_test_variant");
}

광고 소스 응답 정보

AdSourceResponseInfo 에는 광고 응답의 개별 광고 소스에 대한 응답 정보가 포함됩니다.

다음 샘플 AdSourceResponseInfo 출력은 로드된 광고의 메타데이터를 보여줍니다.

{
  "Adapter": "com.google.ads.mediation.admob.AdMobAdapter",
  "Latency": 328,
  "Ad Source Name": "Reservation campaign",
  "Ad Source ID": "7068401028668408324",
  "Ad Source Instance Name": "[DO NOT EDIT] Publisher Test Interstitial",
  "Ad Source Instance ID": "4665218928925097",
  "Credentials": {},
  "Ad Error": "null"
}

AdSourceResponseInfo는 각 광고 소스에 대해 다음 메서드를 제공합니다.

메서드 설명
getAdError 광고 소스에 보낸 요청과 관련된 오류를 가져옵니다. 광고 소스에서 광고를 정상적으로 로드했거나 광고 소스에 광고 요청을 보내지 않았으면 null `null`을 반환합니다.
getId 이 광고 소스 응답과 연결된 광고 소스 ID를 가져옵니다. 캠페인의 경우 6060308706800320801이 미디에이션된 광고 캠페인 목표 유형에 대해 반환되고 7068401028668408324이 노출 및 클릭 목표 유형에 대해 반환됩니다. 광고 소스에서 광고를 게재할 때 사용할 수 있는 광고 소스 ID 목록은 광고 소스 를 참고하세요.
getInstanceId 이 어댑터 응답과 연결된 광고 소스 인스턴스 ID를 가져옵니다.
getInstanceName 이 어댑터 응답과 연결된 광고 소스 인스턴스 이름을 가져옵니다.
getName 이 어댑터 응답과 연결된 광고 소스 이름을 가져옵니다. 캠페인의 경우 미디에이션된 광고 캠페인 목표 유형에 대해 Mediated House Ads가 반환되고 노출 및 클릭 목표 유형에 대해 Reservation Campaign가 반환됩니다. 광고 소스에서 광고를 게재할 때 사용할 수 있는 광고 소스 이름 목록은 광고 소스 를 참고하세요.
getAdapterClassName 광고를 로드한 광고 소스 어댑터의 클래스 이름을 가져옵니다.
getCredentials AdMob UI에 지정된 광고 소스 어댑터 사용자 인증 정보를 가져옵니다.
getLatencyMillis 광고 소스 어댑터에서 광고를 로드하는 데 걸린 시간을 가져옵니다. 광고 소스에 광고 요청을 보내지 않았으면 0을 반환합니다.

Kotlin 

override fun onAdLoaded(interstitialAd: InterstitialAds) {
  val loadedAdSourceResponseInfo = interstitialAd.responseInfo.loadedAdSourceResponse

  val adError = loadedAdSourceResponseInfo.adError
  val adSourceId = loadedAdSourceResponseInfo.id
  val adSourceInstanceId = loadedAdSourceResponseInfo.instanceId
  val adSourceInstanceName = loadedAdSourceResponseInfo.instanceName
  val adSourceName = loadedAdSourceResponseInfo.name
  val adapterClassName = loadedAdSourceResponseInfo.adapterClassName
  val credentials = loadedAdSourceResponseInfo.credentials
  val latencyMillis = loadedAdSourceResponseInfo.latencyMillis
}

Java 

@Override
public void onAdLoaded(@NonNull InterstitialAd interstitialAd) {
  AdSourceResponseInfo loadedAdSourceResponseInfo =
      interstitialAd.getResponseInfo().getLoadedAdSourceResponse();

  AdError adError = loadedAdSourceResponseInfo.getAdError();
  String adSourceId = loadedAdSourceResponseInfo.getId();
  String adSourceInstanceId = loadedAdSourceResponseInfo.getInstanceId();
  String adSourceInstanceName = loadedAdSourceResponseInfo.getInstanceName();
  String adSourceName = loadedAdSourceResponseInfo.getName();
  String adapterClassName = loadedAdSourceResponseInfo.getAdapterClassName();
  Bundle credentials = loadedAdSourceResponseInfo.getCredentials();
  long latencyMillis = loadedAdSourceResponseInfo.getLatencyMillis();
}