Pobieranie informacji o odpowiedzi na reklamę

Do celów debugowania i rejestrowania wczytane reklamy udostępniają obiekt ResponseInfo. Ten obiekt zawiera informacje o wczytanej reklamie oraz o kaskadzie zapośredniczenia użytej do jej wczytania.

W przypadkach, gdy reklama została wczytana, obiekt reklamy ma metodę getResponseInfo(). Na przykład: InterstitialAd.getResponseInfo() pobiera informacje o odpowiedzi w przypadku wczytanej reklamy pełnoekranowej.

W przypadkach, gdy reklamy nie wczytują się i dostępny jest tylko błąd, informacje o odpowiedzi są dostępne w LoadAdError.getResponseInfo().

Kotlin

override fun onAdLoaded() {
  val responseInfo = adView.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() {
  ResponseInfo responseInfo = adView.getResponseInfo();
  Log.d(TAG, responseInfo.toString());
}

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

Informacje o odpowiedzi

Oto przykładowe dane wyjściowe zwracane przez ResponseInfo.toString(), które pokazują dane debugowania zwracane w przypadku wczytanej reklamy:

{
  "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"
  }
}

Metody obiektu ResponseInfo obejmują:

Metoda Opis
getAdapterResponses Zwraca listę AdapterResponseInfo zawierającą metadane każdego adaptera uwzględnionego w odpowiedzi na reklamę. Można go używać do debugowania zapośredniczenia kaskadowego i określania stawek. Kolejność na liście odpowiada kolejności w kaskadzie zapośredniczenia w przypadku tego żądania reklamy.

Więcej informacji znajdziesz w artykule Informacje o odpowiedzi adaptera.

getLoadedAdapterResponseInfo Zwraca AdapterResponseInfo odpowiadający adapterowi, który wczytał reklamę.
getMediationAdapterClassName Zwraca nazwę klasy adaptera zapośredniczenia źródła reklam, które wczytało reklamę.
getResponseId Identyfikator odpowiedzi to unikalny identyfikator odpowiedzi na żądanie reklamy. Możesz użyć tego identyfikatora do zidentyfikowania i zablokowania reklamy w Centrum oceny reklam.
getResponseExtras Zwraca dodatkowe informacje o odpowiedzi na reklamę. Dodatki mogą zwracać te klucze:
  • mediation_group_name: nazwa grupy zapośredniczenia.
  • mediation_ab_test_name: nazwa testu A/B zapośredniczenia (jeśli dotyczy).
  • mediation_ab_test_variant: wariant użyty w teście A/B zapośredniczenia (jeśli dotyczy).

Kotlin

override fun onAdLoaded() {
  val responseInfo = adView.responseInfo

  val responseId = responseInfo?.responseId
  val mediationAdapterClassName = responseInfo?.mediationAdapterClassName
  val adapterResponses = responseInfo?.adapterResponses
  val loadedAdapterResponseInfo = responseInfo?.loadedAdapterResponseInfo
  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() {
  ResponseInfo responseInfo = adView.getResponseInfo();

  String responseId = responseInfo.getResponseId();
  String mediationAdapterClassName = responseInfo.getMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.getAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo =
      responseInfo.getLoadedAdapterResponseInfo();
  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");
}

Informacje o odpowiedzi adaptera

AdapterResponseInfo zawiera informacje o odpowiedzi dla pojedynczego źródła reklam w odpowiedzi na żądanie reklamy.

Poniższe przykładowe dane wyjściowe AdapterResponseInfo pokazują metadane wczytanej reklamy:

{
  "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"
}

W przypadku każdego źródła reklam AdapterResponseInfo udostępnia te metody:

Metoda Opis
getAdError Pobiera błąd powiązany z żądaniem wysłanym do źródła reklam. Zwraca wartość null, jeśli źródło reklam pomyślnie wczytało reklamę lub jeśli nie podjęto próby użycia źródła reklam.
getAdSourceId Pobiera identyfikator źródła reklam powiązany z tą odpowiedzią adaptera. W przypadku kampanii zwracana jest wartość 6060308706800320801, jeśli typ celu kampanii to zapośredniczone reklamy, oraz 7068401028668408324, jeśli typ celu to wyświetlenia lub docelowa liczba kliknięć. Listę możliwych identyfikatorów źródeł reklam, które wyświetlają reklamy, znajdziesz w sekcji Źródła reklam.
getAdSourceInstanceId Pobiera identyfikator instancji źródła reklam powiązany z tą odpowiedzią adaptera.
getAdSourceInstanceName Pobiera nazwę instancji źródła reklam powiązaną z tą odpowiedzią adaptera.
getAdSourceName Pobiera nazwę źródła reklam powiązanego z tą odpowiedzią adaptera. W przypadku kampanii zwracana jest wartość Mediated House Ads, jeśli typ celu kampanii to zapośredniczone reklamy, oraz Reservation Campaign, jeśli typ celu to wyświetlenia lub docelowa liczba kliknięć. Listę możliwych nazw źródeł reklam, które wyświetlają reklamę, znajdziesz w sekcji Źródła reklam.
getAdapterClassName Pobiera nazwę klasy adaptera źródła reklam, który wczytał reklamę.
getCredentials Pobiera dane logowania do adaptera źródła reklam określone w interfejsie AdMob.
getLatencyMillis Pobiera czas, jaki adapter źródła reklam poświęcił na wczytanie reklamy. Jeśli nie podjęto próby użycia źródła reklam, zwraca wartość 0.

Kotlin

override fun onAdLoaded() {
  val loadedAdapterResponseInfo = adView.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() {
  AdapterResponseInfo loadedAdapterResponseInfo =
      adView.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();
}