Informationen zur Anzeigenantwort abrufen

Plattform auswählen: Android (Beta) Neu Android iOS Unity Flutter

Zu Debugging- und Protokollierungszwecken stellen erfolgreich geladene Anzeigen ein GADResponseInfo Objekt bereit. Dieses Objekt enthält Informationen zur geladenen Anzeige sowie zur Vermittlungsabfolge, die zum Laden der Anzeige verwendet wurde.

Wenn eine Anzeige erfolgreich geladen wird, hat das Anzeigenobjekt die Eigenschaft GADResponseInfo. Mit GADInterstitialAd.responseInfo werden beispielsweise die Antwortinformationen für eine geladene Interstitial-Anzeige abgerufen.

Wenn Anzeigen nicht geladen werden können und nur ein Fehler verfügbar ist, ist GADResponseInfo über den Schlüssel GADErrorUserInfoKeyResponseInfo im userInfo-Wörterbuch des Fehlers verfügbar.

Swift

fileprivate func loadInterstitial() {
  InterstitialAd.load(
    with: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    if let error = error {
      let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? ResponseInfo
      print("\(String(describing: responseInfo))")
      return
    }
    let responseInfo = ad?.responseInfo
    print("\(String(describing: responseInfo))")
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    if (error) {
      GADResponseInfo *responseInfo = error.userInfo[GADErrorUserInfoKeyResponseInfo];
      NSLog(@"%@", responseInfo.description);
      return;
    }
    GADResponseInfo *responseInfo = ad.responseInfo;
    NSLog(@"%@", responseInfo.description);
  }];
}

Antwortinformationen

Hier sehen Sie ein Beispiel für die Debugging-Daten, die für eine geladene Anzeige zurückgegeben werden:

  ** Response Info **
    Response ID: CLz5r-KMtfoCFQvv7QodfGAMHw
    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.357

  ** 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.357

Die Eigenschaften von GADResponseInfo umfassen:

Attribut Beschreibung
adNetworkInfoArray Gibt die Liste von GADAdNetworkResponseInfo zurück, die Metadaten für jeden in der Anzeigenantwort enthaltenen Adapter enthält. Kann verwendet werden, um die Vermittlungsabfolge und die Bidding-Ausführung zu debuggen. Die Reihenfolge in der Liste entspricht der Reihenfolge der Vermittlungsabfolge für diese Anzeigenanfrage.

Weitere Informationen finden Sie unter Informationen zur Adapterantwort für weitere Informationen.

loadedAdNetworkResponseInfo Gibt GADAdNetworkResponseInfo zurück, das dem Adapter entspricht, der die Anzeige geladen hat.
adNetworkClassName Gibt den Klassennamen des Vermittlungsadapters des Werbenetzwerks zurück, das die Anzeige geladen hat.
responseIdentifier Die Antwort-ID ist eine eindeutige ID für die Anzeigenantwort. Diese ID kann verwendet werden, um die Anzeige im Überprüfungszentrum für Anzeigen zu identifizieren und zu blockieren.
extrasDictionary Gibt zusätzliche Informationen zur Anzeigenantwort zurück. Extras können die folgenden Schlüssel zurückgeben:
  • mediation_group_name: Der Name der Vermittlungsgruppe
  • mediation_ab_test_name: Der Name des A/B-Tests mit Vermittlungsgruppen, falls zutreffend
  • mediation_ab_test_variant: Die im A/B-Test mit Vermittlungsgruppen verwendete Variante, falls zutreffend

Swift

fileprivate func loadInterstitial() {
  InterstitialAd.load(
    with: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    let responseInfo = ad?.responseInfo

    let responseIdentifier = responseInfo?.responseIdentifier
    let adNetworkClassName = responseInfo?.adNetworkClassName
    let adNetworkInfoArray = responseInfo?.adNetworkInfoArray
    let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo
    let mediationGroupName = responseInfo?.extrasDictionary["mediation_group_name"]
    let mediationABTestName = responseInfo?.extrasDictionary["mediation_ab_test_name"]
    let mediationABTestVariant = responseInfo?.extrasDictionary["mediation_ab_test_variant"]
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    GADResponseInfo *responseInfo = ad.responseInfo;

    NSString *responseIdentifier = responseInfo.responseIdentifier;
    NSString *adNetworkClassName = responseInfo.adNetworkClassName;
    NSArray *adNetworkInfoArray = responseInfo.adNetworkInfoArray;
    GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo;
    NSString *mediationGroupName = responseInfo.extrasDictionary[@"mediation_group_name"];
    NSString *mediationABTestName = responseInfo.extrasDictionary[@"mediation_ab_test_name"];
    NSString *mediationABTestVariant = responseInfo.extrasDictionary[@"mediation_ab_test_variant"];
  }];
}

Informationen zur Adapterantwort

GADAdNetworkResponseInfo enthält Metadaten für jeden in der Anzeigenantwort enthaltenen Adapter, die verwendet werden können, um die Vermittlungsabfolge und die Bidding-Ausführung zu debuggen. Die Reihenfolge in der Liste entspricht der Reihenfolge der Vermittlungsabfolge für die Anzeigenanfrage.

Hier sehen Sie ein Beispiel für die GADAdNetworkResponseInfo-Ausgabe:

    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.277

Für jedes Werbenetzwerk stellt GADAdNetworkResponseInfo die folgenden Eigenschaften bereit:

Attribut Beschreibung
error Der Fehler, der mit der Anfrage an das Netzwerk verbunden ist. Gibt nil zurück, wenn das Netzwerk eine Anzeige erfolgreich geladen hat oder wenn das Netzwerk nicht versucht wurde.
adSourceId Die Anzeigenquellen-ID, die mit dieser Adapterantwort verknüpft ist. Für Kampagnen wird 6060308706800320801 für einen Kampagnenzieltyp für vermittelte Anzeigen und 7068401028668408324 für Zieltypen für Impressionen und Klicks zurückgegeben. Eine Liste der möglichen Anzeigenquellen-IDs, wenn ein Werbenetzwerk die Anzeige ausliefert, finden Sie unter Anzeigenquellen.
adSourceInstanceId Die Anzeigenquelleninstanz-ID, die mit dieser Adapter antwort verknüpft ist.
adSourceInstanceName Der Anzeigenquelleninstanzname, der mit dieser Adapter antwort verknüpft ist.
adSourceName Die Anzeigenquelle, die das spezifische Werbenetzwerk darstellt, das die Impression ausliefert. Für Kampagnen wird Mediated House Ads für einen Kampagnenzieltyp für vermittelte Anzeigen und Reservation Campaign für Zieltypen für Impressionen und Klicks zurückgegeben. Eine Liste der möglichen Anzeigenquellennamen, wenn ein Werbenetzwerk die Anzeige ausliefert, finden Sie unter Anzeigenquellen
adNetworkClassName Der Klassenname des Werbenetzwerkadapters, der die Anzeige geladen hat.
adUnitMapping Die Netzwerkkonfiguration, die über die AdMob-Benutzeroberfläche festgelegt wurde.
latency Die Zeit, die das Werbenetzwerk zum Laden einer Anzeige benötigt hat. Gibt 0 zurück, wenn das Netzwerk nicht versucht wurde.

Swift

fileprivate func loadInterstitial() {
  InterstitialAd.load(
    with: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    let responseInfo = ad?.responseInfo
    let loadedAdNetworkResponseInfo = responseInfo?.loadedAdNetworkResponseInfo

    let adNetworkError = loadedAdNetworkResponseInfo?.error
    let adSourceId = loadedAdNetworkResponseInfo?.adSourceID
    let adSourceInstanceId = loadedAdNetworkResponseInfo?.adSourceInstanceID
    let adSourceInstanceName = loadedAdNetworkResponseInfo?.adSourceInstanceName
    let adSourceName = loadedAdNetworkResponseInfo?.adSourceName
    let adNetworkClassName = loadedAdNetworkResponseInfo?.adNetworkClassName
    let adUnitMapping = loadedAdNetworkResponseInfo?.adUnitMapping
    let latency = loadedAdNetworkResponseInfo?.latency
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"ca-app-pub-3940256099942544/4411468910"
   request:request
   completionHandler:^(GADInterstitialAd *ad, NSError *error) {
    GADResponseInfo *responseInfo = ad.responseInfo;
    GADAdNetworkResponseInfo *loadedAdNetworkResponseInfo = responseInfo.loadedAdNetworkResponseInfo;

    NSError *adNetworkError = loadedAdNetworkResponseInfo.error;
    NSString *adSourceId = loadedAdNetworkResponseInfo.adSourceID;
    NSString *adSourceInstanceId = loadedAdNetworkResponseInfo.adSourceInstanceID;
    NSString *adSourceInstanceName = loadedAdNetworkResponseInfo.adSourceInstanceName;
    NSString *adSourceName = loadedAdNetworkResponseInfo.adSourceName;
    NSString *adNetworkClassName = loadedAdNetworkResponseInfo.adNetworkClassName;
    NSDictionary *adUnitMapping = loadedAdNetworkResponseInfo.adUnitMapping;
    NSTimeInterval latency = loadedAdNetworkResponseInfo.latency;
  }];
}