Pobieranie informacji o odpowiedzi na reklamę

W celu debugowania i rejestrowania wczytanych reklam reklamy, które zostały wczytane, udostępniają obiekt GADResponseInfo. Ten obiekt zawiera informacje o wczytanej reklamie oraz o kaskadowym zapośredniczeniu, które służyło do jej wczytania.

W przypadku wczytania reklamy obiekt reklamy ma właściwość GADResponseInfo. Na przykład: GADInterstitialAd.responseInfo pobiera informacje o odpowiedzi dla załadowanej reklamy pełnoekranowej.

W przypadku, gdy reklamy nie wczytują się i wyświetla się tylko błąd, możesz użyć klucza GADErrorUserInfoKeyResponseInfo w słowniku userInfo błędu.GADResponseInfo

Swift

fileprivate func loadInterstitial() {
  GADInterstitialAd.load(
    withAdUnitID: "ca-app-pub-3940256099942544/4411468910", request: request
  ) { (ad, error) in
    if let error = error {
      let responseInfo = (error as NSError).userInfo[GADErrorUserInfoKeyResponseInfo] as? GADResponseInfo
      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);
  }];
}

Informacje o odpowiedzi

Oto przykładowy wynik z danymi debugowania zwróconymi po wczytaniu reklamy:

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

Właściwości w GADResponseInfo:

Właściwość Opis
adNetworkInfoArray Zwraca listę GADAdNetworkResponseInfozawierającą metadane każdego adaptera uwzględnionego w odpowiedzi na reklamę. Można ich używać do debugowania zapośredniczenia kaskadowego i określania stawek. Kolejność na liście odpowiada kolejności kaskady zapośredniczenia w przypadku tego żądania reklamy.

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

loadedAdNetworkResponseInfo Zwraca wartość GADAdNetworkResponseInfo odpowiadającą adapterowi, który wczytał reklamę.
adNetworkClassName Zwraca nazwę klasy pośredniczącego adaptera sieci reklamowej, która wczytała reklamę.
responseIdentifier Identyfikator odpowiedzi to niepowtarzalny identyfikator reakcji na reklamę. Możesz użyć tego identyfikatora do zidentyfikowania i zablokowania reklamy w Centrum oceny reklam.
extrasDictionary

Zwraca dodatkowe informacje o odpowiedzi na reklamę. Dodatkowe informacje 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 testach A/B zapośredniczenia (jeśli dotyczy).

Swift

fileprivate func loadInterstitial() {
  GADInterstitialAd.load(
    withAdUnitID: "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"];
  }];
}

Informacje o odpowiedziach adaptera

GADAdNetworkResponseInfo zawiera metadane każdego adaptera uwzględnionego w odpowiedzi na żądanie reklamy. Można ich użyć do debugowania pośredniczenia i wyznaczania stawek w ramach kaskady. Kolejność na liście odpowiada kolejności kaskady zapośredniczenia żądania reklamy.

Oto przykładowe dane wyjściowe GADAdNetworkResponseInfo:

    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

W przypadku każdej sieci reklamowej GADAdNetworkResponseInfo udostępnia te właściwości:

Właściwość Opis
error Błąd związany z żądaniem wysłanym do sieci. Zwraca nil, jeśli sieć załadowała reklamę, lub jeśli nie podjęto próby załadowania reklamy.
adSourceId Identyfikator źródła reklamy powiązany z tą odpowiedzią adaptera. W przypadku kampanii parametr 6060308706800320801 jest zwracany w przypadku celu typu „Zapośredniczone reklamy”, a parametr 7068401028668408324 – w przypadku celów typu „Wyświetlenia” i „Kliknięcia”. Aby poznać listę możliwych identyfikatorów źródeł reklam, gdy sieć reklamowa wyświetla reklamę, zobacz Źródła reklam.
adSourceInstanceId Identyfikator instancji źródła reklamy powiązany z tą odpowiedzią adaptera.
adSourceInstanceName Nazwa wystąpienia źródła reklam powiązanego z tą odpowiedzią adaptera.
adSourceName Źródło reklamy reprezentujące konkretną sieć reklamową, która wyświetla wyświetlenie. W przypadku kampanii: Mediated House Ads jest zwracany w przypadku reklam pośredniczących w celu kampanii, a Reservation Campaign – w przypadku celów związanych z wyświetleniem i kliknięciem. Aby poznać listę możliwych nazw źródeł reklam, gdy sieć reklamowa wyświetla reklamę, zapoznaj się z artykułem Źródła reklam.
adNetworkClassName Nazwa klasy adaptera sieci reklamowej, który wczytał reklamę.
adUnitMapping Konfiguracja sieci ustawiona w interfejsie AdMob.
latency Czas wczytywania reklamy przez sieć reklamową. Zwraca wartość 0, jeśli nie podjęto próby połączenia z siecią.

Swift

fileprivate func loadInterstitial() {
  GADInterstitialAd.load(
    withAdUnitID: "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;
  }];
}