Informationen zur Anzeigenantwort abrufen

Zu Debugging- und Protokollierungszwecken bieten erfolgreich geladene Anzeigen eine ResponseInfo-Objekt. Dieses Objekt enthält Informationen zu der geladenen Anzeige. zusätzlich zu den Informationen zur Vermittlungsabfolge, die zum Laden der Anzeige verwendet wird.

Wenn eine Anzeige erfolgreich geladen wird, hat das Anzeigenobjekt die Methode GetResponseInfo(). Beispiel: InterstitialAd.GetResponseInfo() die Antwortinformationen für eine geladene Interstitial-Anzeige erhält.

Wenn Anzeigen nicht geladen werden und nur ein Fehler angezeigt wird, sind die Antwortinformationen über AdFailedToLoadEventArgs.LoadAdError.GetResponseInfo() verfügbar.

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();
}

Antwortinformationen

Hier ist eine von ResponseInfo.ToString() zurückgegebene Beispielausgabe mit dem Debugging-Daten, die für eine geladene Anzeige zurückgegeben werden:

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

Zu den Methoden für das ResponseInfo-Objekt gehören:

Methode Beschreibung
GetAdapterResponses Liste der AdapterResponseInfo mit Metadaten für jeden in der Anzeigenantwort enthaltenen Adapter. Kann zur Fehlerbehebung bei abfolgebasierte Vermittlung und Bidding-Ausführungen. Die Reihenfolge der Liste stimmt mit der Reihenfolge der Vermittlungsabfolge für diese Anzeigenanfrage.

Weitere Informationen finden Sie unter Antwortinformationen des Adapters. Informationen.

GetLoadedAdapterResponseInfo Gibt das AdapterResponseInfo-Objekt zurück, das dem Adapter entspricht über die die Anzeige geladen wurde.
GetMediationAdapterClassName Gibt den Namen der Vermittlungsadapterklasse des Werbenetzwerks zurück, das die Anzeige geladen hat.
GetResponseId Die Antwort-ID ist eine eindeutige Kennung für die Anzeigenantwort. Anhand dieser Kennung kann die Anzeige im Überprüfungszentrum für Anzeigen identifiziert und blockiert werden.
GetResponseExtras Gibt zusätzliche Informationen zur Anzeigenantwort zurück. Extras können die folgenden Schlüssel:
  • mediation_group_name: Name der Vermittlungsgruppe
  • mediation_ab_test_name: Name des A/B-Tests mit Vermittlung falls zutreffend
  • mediation_ab_test_variant: In den A/B-Test mit Vermittlungsgruppen, falls zutreffend

Hier ist ein Beispiel, wie Werte aus einem geladenen ResponseInfo gelesen werden:

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"];
}

Informationen zur Adapterantwort

AdapterResponseInfo enthält Metadaten für jeden in der Anzeige enthaltenen Adapter. Antwort, mit der sich Fehler in der abfolgebasierten Vermittlung und Bidding beheben lassen Ausführung. Die Reihenfolge der Liste entspricht der Reihenfolge der Vermittlungsabfolge für die Anzeigenanfrage.

Hier ist eine von AdapterResponseInfo zurückgegebene Beispielausgabe:

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

Für jedes Werbenetzwerk bietet AdapterResponseInfo die folgenden Methoden:

Methode Beschreibung
AdError Ruft den mit der Anfrage an das Netzwerk verbundenen Fehler ab. Rückgaben null, wenn eine Anzeige erfolgreich geladen wurde oder wenn der Netzwerkverbindung wurde nicht versucht.
AdSourceId Ruft die Anzeigenquelle-ID ab, die dieser Adapterantwort zugeordnet ist. Für Kampagnen: Bei vermittelten Anzeigen wird 6060308706800320801 zurückgegeben. Zielvorhabentyp der Kampagne und 7068401028668408324 wird für Impression und Klick zurückgegeben. Zielvorhabentypen. Siehe Anzeigenquellen. finden Sie die Liste möglicher Anzeigenquellen-IDs, wenn die Anzeige von einem Werbenetzwerk ausgeliefert wird.
AdSourceInstanceId Ruft die mit diesem Adapter verknüpfte Anzeigenquelleninstanz-ID ab Antwort.
AdSourceInstanceName Ruft den Namen der Anzeigenquelleninstanz ab, der diesem Adapter zugeordnet ist Antwort.
AdSourceName Ruft die Anzeigenquelle ab, die das spezifische Werbenetzwerk darstellt, von dem die Impression. Für Kampagnen: Bei vermittelten Anzeigen wird Mediated House Ads zurückgegeben. Zielvorhabentyp der Kampagne und Reservation Campaign wird für Impression und Klick zurückgegeben. Zielvorhabentypen. Unter Anzeigenquellen finden Sie eine Liste der möglichen Namen von Anzeigenquellen, wenn die Anzeige über ein Werbenetzwerk ausgeliefert wird.
AdapterClassName Ruft einen Klassennamen ab, der das Werbenetzwerk identifiziert.
AdUnitMapping Ruft den Netzwerkkonfigurationssatz von der AdMob-Benutzeroberfläche ab.
LatencyMillis Gibt an, wie lange das Werbenetzwerk für das Laden einer Anzeige benötigt hat. Gibt 0 zurück, wenn kein Netzwerkverbindungsversuch unternommen wurde.

Hier ist ein Beispiel, wie Werte aus einem geladenen AdapterResponseInfo gelesen werden:

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;
}