Pobieranie informacji o odpowiedzi na reklamę

Wybierz platformę: Android Android iOS Unity Flutter

W celach debugowania i rejestrowania pomyślnie wczytane reklamy udostępniają GADResponseInfo obiekt. Zawiera on informacje o wczytanej reklamie oraz o kaskadzie zapośredniczenia użytej do jej wczytania.

W przypadkach, gdy reklama wczytuje się prawidłowo, obiekt reklamy ma właściwość GADResponseInfo. Na przykład, GADInterstitialAd.responseInfo pobiera informacje o odpowiedzi na wczytaną reklamę pełnoekranową.

W przypadkach, gdy reklamy nie wczytują się i dostępny jest tylko błąd, obiekt GADResponseInfo jest dostępny za pomocą klucza GADErrorUserInfoKeyResponseInfo w słowniku userInfo błędu.

Swift

fileprivate func loadInterstitial() {
  AdManagerInterstitialAd.load(
    with: "/21775744923/example/interstitial", 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:@"/21775744923/example/interstitial"
   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ładowe dane wyjściowe pokazujące dane debugowania zwrócone w przypadku wczytanej reklamy:

** Response Info **
    Response ID: BmnCZaSbE_6Mur8P5su8gAY
    Network: GADMAdapterGoogleAdMobAds

  ** Loaded Adapter Response **
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name:AdMob Network
    Ad Source ID:
    Ad Source Instance Name:AdMob (default)
    Ad Source Instance ID:AdMob (default)
    AdUnitMapping:
{
    pubid = "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=b0&caqid=BmnCZZjMEvzpkPIP5cWfQA";
}
    Error: (null)
    Latency: 2.724

  ** Extras Dictionary **
    {
        "creative_id" = "138471856178";
        "line_item_id" = "6707237225";
    }

  ** Mediation line items **
    Entry (1)
    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name:AdMob Network
    Ad Source ID:
    Ad Source Instance Name:AdMob (default)
    Ad Source Instance ID:AdMob (default)
    AdUnitMapping:
{
    pubid = "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=b0&caqid=BmnCZZjMEvzpkPIP5cWfQA";
}
    Error: (null)
    Latency: 2.724

Właściwości GADResponseInfo obejmują:

Właściwość	Opis
adNetworkInfoArray	Zwraca listę GADAdNetworkResponseInfo zawierającą metadane każdego adaptera uwzględnionego w odpowiedzi na żądanie reklamy. Może 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 przypadku tego żądania reklamy. Więcej informacji znajdziesz w sekcji Informacje o odpowiedzi adaptera.
loadedAdNetworkResponseInfo	Zwraca GADAdNetworkResponseInfo odpowiadający adapterowi który wczytał reklamę.
adNetworkClassName	Zwraca nazwę klasy adaptera zapośredniczenia sieci reklamowej, która wczytała reklamę.
responseIdentifier	Identyfikator odpowiedzi to unikalny identyfikator odpowiedzi na żądanie reklamy. Możesz go użyć do zidentyfikowania i zablokowania reklamy w Centrum oceny reklam.
extrasDictionary	Beta: ten interfejs API jest dostępny w wersji beta. Zwracane wartości mogą się zmieniać bez wydania pakietu SDK. Zwraca dodatkowe informacje o odpowiedzi na żądanie reklamy. Dodatkowe informacje mogą zwracać te klucze: creative_id: identyfikator elementu zamówienia wybranej reklamy. Zwracany tylko w przypadku reklam rezerwacyjnych. line_item_id: identyfikator kreacji wybranej reklamy. Zwracany tylko w przypadku reklam rezerwacyjnych.

Swift

fileprivate func loadInterstitial() {
  AdManagerInterstitialAd.load(
    with: "/21775744923/example/interstitial", 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 creativeID = responseInfo?.extrasDictionary["creative_id"]
    let lineItemID = responseInfo?.extrasDictionary["line_item_id"]
  }
}

Objective-C

- (void)loadInterstitial {
  [GADInterstitialAd
   loadWithAdUnitID:@"/21775744923/example/interstitial"
   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 *creativeID = responseInfo.extrasDictionary[@"creative_id"];
    NSString *lineItemID = responseInfo.extrasDictionary[@"line_item_id"];
  }];
}

Informacje o odpowiedzi adaptera

GADAdNetworkResponseInfo zawiera metadane każdego adaptera uwzględnionego w odpowiedzi na żądanie reklamy, których można użyć do debugowania zapośredniczenia kaskadowego i wykonywania określania stawek. Kolejność na liście odpowiada kolejności w kaskadzie zapośredniczenia w przypadku żądania reklamy.

Oto przykładowe dane wyjściowe GADAdNetworkResponseInfo:

    Network: GADMAdapterGoogleAdMobAds
    Ad Source Name:AdMob Network
    Ad Source ID:
    Ad Source Instance Name:AdMob (default)
    Ad Source Instance ID:AdMob (default)
    AdUnitMapping:
{
    pubid = "ca-pub-9939518381636264//21775744923/example/rewarded-interstitial/cak=no_cache&cadc=b0&caqid=BmnCZZjMEvzpkPIP5cWfQA";
}
    Error: (null)
    Latency: 2.724

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 wartość, jeśli sieć pomyślnie wczytała reklamę lub jeśli nie podjęto próby połączenia z siecią.
adSourceId	Identyfikator źródła reklam powiązany z tą odpowiedzią adaptera.
adSourceInstanceId	Identyfikator wystąpienia źródła reklam powiązany z tą odpowiedzią adaptera.
adSourceInstanceName	Nazwa wystąpienia źródła reklam powiązana z tą odpowiedzią adaptera. Jeśli nie jest wypełniona przez grupę zysku, zwraca pusty ciąg znaków.
adSourceName	Źródło reklam reprezentujące konkretną sieć reklamową, która wyświetla wyświetlenie.
adNetworkClassName	Nazwa klasy adaptera sieci reklamowej, która wczytała reklamę.
adUnitMapping	Konfiguracja sieci ustawiona w interfejsie Ad Managera.
latency	Czas, jaki sieć reklamowa poświęciła na wczytanie reklamy. Jeśli nie podjęto próby połączenia z siecią, zwraca wartość 0.

Swift

fileprivate func loadInterstitial() {
  AdManagerInterstitialAd.load(
    with: "/21775744923/example/interstitial", 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:@"/21775744923/example/interstitial"
   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;
  }];
}