Ta strona została przetłumaczona przez Cloud Translation API.

Pobieranie informacji o odpowiedzi na reklamę

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

W przypadku, gdy reklama się uda, obiekt reklamowy korzysta z metody GetResponseInfo(). Na przykład InterstitialAd.GetResponseInfo() pobiera informacje o odpowiedzi w przypadku wczytanej reklamy pełnoekranowej.

Jeśli reklamy się nie wczytają i pojawi się tylko błąd, informacje o odpowiedzi są dostępne w AdFailedToLoadEventArgs.LoadAdError.GetResponseInfo().

InterstitialAd ad;

private void RequestInterstitial()
{
    ad = new InterstitialAd("AD_UNIT_ID");
    this.interstitial.OnAdLoaded += OnAdLoaded;
    this.interstitial.OnAdFailedToLoad += HandleOnAdFailedToLoad;
    AdRequest request = new AdRequest.Builder().Build();
    this.interstitial.LoadAd(request);
}

private void OnAdLoaded(object sender, EventArgs args)
{
    ResponseInfo info = ad.GetResponseInfo();
}

private void OnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
    ResponseInfo info = args.LoadAdError.GetResponseInfo();
}

Informacje o odpowiedzi

Oto przykładowe dane wyjściowe zwrócone przez funkcję ResponseInfo.ToString() z danymi debugowania zwróconymi dla wczytanej reklamy:

Android

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

iOS

 ** Response Info **
    Response ID: CIzs0ZO5kPoCFRqWAAAdJMINpQ
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID: 7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

  ** Extras Dictionary **
    {
        "mediation_group_name" = Campaign;
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name: Reservation campaign
    Ad Source ID:7068401028668408324
    Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
    Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
    AdUnitMapping:
    {
    }
    Error: (null)
    Latency: 0.391

Metody dostępne w obiekcie ResponseInfo to:

Metoda	Opis
`GetAdapterResponses`	Zwraca listę `AdapterResponseInfo` zawierającą metadane dla każdego adaptera uwzględnionego w odpowiedzi na reklamę. Można jej używać do debugowania zapośredniczenia kaskadowego i ustalania stawek. Kolejność na liście jest taka sama jak kolejność w kaskadzie zapośredniczenia w przypadku danego żądania reklamy. Więcej informacji znajdziesz w artykule Informacje o odpowiedzi adaptera.
`GetLoadedAdapterResponseInfo`	Zwraca wartość `AdapterResponseInfo` odpowiadającą adapterowi, który załadował reklamę.
`GetMediationAdapterClassName`	Zwraca nazwę klasy adaptera zapośredniczenia sieci reklamowej, która wczytała reklamę.
`GetResponseId`	Identyfikator odpowiedzi to unikalny identyfikator odpowiedzi na reklamę. Ten identyfikator może służyć do identyfikowania i blokowania reklamy w Centrum oceny reklam.
`GetResponseExtras`	Beta: ten interfejs API jest w wersji beta. Zwracane wartości mogą się zmienić bez wersji pakietu SDK. 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 (w stosownych przypadkach). `mediation_ab_test_variant`: wariant używany w teście A/B zapośredniczenia (w stosownych przypadkach).

Oto przykładowe wartości odczytu z wczytanego zasobu ResponseInfo:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo info = ad.GetResponseInfo();

  string responseId = responseInfo.GetResponseId();
  string mediationAdapterClassName = responseInfo.GetMediationAdapterClassName();
  List<AdapterResponseInfo> adapterResponses = responseInfo.GetAdapterResponses();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.GetLoadedAdapterResponseInfo();
  Dictionary<string, string> extras = responseInfo.GetResponseExtras();
  string mediationGroupName = extras["mediation_group_name"];
  string mediationABTestName = extras["mediation_ab_test_name"];
  string mediationABTestVariant = extras["mediation_ab_test_variant"];
}

Informacje o odpowiedzi adaptera

AdapterResponseInfo zawiera metadane każdego adaptera uwzględnionego w odpowiedzi na reklamę, które mogą służyć do debugowania zapośredniczenia kaskadowego i wykonywania określania stawek. Kolejność na liście odpowiada kolejności w kaskadzie zapośredniczenia w żądaniu reklamy.

Oto przykładowe dane wyjściowe zwracane przez funkcję AdapterResponseInfo:

Android

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

iOS

  Network: GADMAdapterGoogleAdMobAds
  Ad Source Name: Reservation campaign
  Ad Source ID: 7068401028668408324
  Ad Source Instance Name: [DO NOT EDIT] Publisher Test Interstitial
  Ad Source Instance ID: [DO NOT EDIT] Publisher Test Interstitial
  AdUnitMapping:
  {
  }
  Error: (null)
  Latency: 0.391

W przypadku każdej sieci reklamowej AdapterResponseInfo udostępnia te metody:

Metoda	Opis
`AdError`	Pobiera błąd związany z żądaniem do sieci. Zwraca `null`, jeśli sieć wczytała reklamę lub nie nastąpiła próba jej wczytania.
`AdSourceId`	Pobiera identyfikator źródła reklam powiązany z tą odpowiedzią adaptera. W przypadku kampanii w przypadku typu celu kampanii reklam zapośredniczonych zwracana jest wartość `6060308706800320801`, a w przypadku typów celów związanych z wyświetleniami i kliknięciami zwracana jest wartość `7068401028668408324`. Listę możliwych identyfikatorów źródeł reklam, gdy sieć reklamowa wyświetla reklamę, znajdziesz w sekcji Źródła reklam.
`AdSourceInstanceId`	Pobiera identyfikator instancji źródła reklam powiązany z tą odpowiedzią adaptera.
`AdSourceInstanceName`	Pobiera nazwę instancji źródła reklam powiązaną z tą odpowiedzią adaptera.
`AdSourceName`	Pobiera źródło reklam reprezentujące konkretną sieć reklamową, która realizuje wyświetlenie. W przypadku kampanii w przypadku typu celu kampanii reklam zapośredniczonych zwracana jest wartość `Mediated House Ads`, a w przypadku typów celów związanych z wyświetleniami i kliknięciami zwracana jest wartość `Reservation Campaign`. Listę możliwych nazw źródeł reklam, gdy sieć reklamowa wyświetla reklamę, znajdziesz w sekcji Źródła reklam.
`AdapterClassName`	Pobiera nazwę klasy, która identyfikuje sieć reklamową.
`AdUnitMapping`	Pobiera konfigurację sieci z interfejsu AdMob.
`LatencyMillis`	Otrzymuje informacje o czasie, jaki sieć reklamowa spędziła na wczytaniu reklamy. Zwraca wartość `0`, jeśli nie nastąpiła próba połączenia z siecią.

Oto przykładowe wartości odczytu z wczytanego zasobu AdapterResponseInfo:

private void OnAdLoaded(object sender, EventArgs args)
{
  ResponseInfo responseInfo = ad.GetResponseInfo();
  AdapterResponseInfo loadedAdapterResponseInfo = responseInfo.getLoadedAdapterResponseInfo();

  AdError adError = loadedAdapterResponseInfo.AdError;
  string adSourceId = loadedAdapterResponseInfo.AdSourceId;
  string adSourceInstanceId = loadedAdapterResponseInfo.AdSourceInstanceId;
  string adSourceInstanceName = loadedAdapterResponseInfo.AdSourceInstanceName;
  string adSourceName = loadedAdapterResponseInfo.AdSourceName;
  string adapterClassName = loadedAdapterResponseInfo.AdapterClassName;
  Dictionary<string, string> credentials = loadedAdapterResponseInfo.AdUnitMapping;
  long latencyMillis = loadedAdapterResponseInfo.LatencyMillis;
}