Pobieranie informacji o odpowiedzi na reklamę

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

Jeśli reklama została wczytana, obiekt reklamy ma właściwość GADResponseInfo. Na przykład: GADInterstitialAd.responseInfo pobiera informacje o odpowiedzi w przypadku wczytanej reklamy pełnoekranowej.

W przypadkach, gdy reklamy nie zostaną wczytane i dostępny jest tylko błąd, 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 zawierające dane debugowania zwrócone dla 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 w GADResponseInfo:

Właściwość Opis
adNetworkInfoArray Zwraca listę GADAdNetworkResponseInfo zawierającą metadane każdego adaptera uwzględnionego w odpowiedzi na reklamę. Można go 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 artykule 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 użyć tego identyfikatora do zidentyfikowania i zablokowania reklamy w Centrum oceny reklam.
extrasDictionary Zwraca dodatkowe informacje o odpowiedzi na reklamę. Dodatki mogą zwracać te klucze:
  • creative_id: identyfikator kreacji wybranej reklamy. Zwracane tylko w przypadku reklam z rezerwacji.
  • line_item_id: identyfikator elementu zamówienia wybranej reklamy. Zwracane tylko w przypadku reklam z rezerwacji.

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óre można wykorzystać do debugowania zapośredniczenia kaskadowego i 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 wartość nil, jeśli sieć pomyślnie wczytała reklamę lub jeśli nie podjęto próby wczytania reklamy 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 instancji źródła reklam powiązana z tą odpowiedzią adaptera. Jeśli nie zostanie wypełniony przez grupę zysku, zwraca pusty ciąg znaków.
adSourceName Źródło reklam reprezentujące konkretną sieć reklamową, która wyświetla reklamę.
adNetworkClassName Nazwa klasy adaptera sieci reklamowej, który wczytał reklamę.
adUnitMapping Konfiguracja sieci ustawiona w interfejsie Ad Managera.
latency Czas, który sieć reklamowa poświęciła na wczytanie reklamy. Zwraca wartość 0, jeśli nie podjęto próby połączenia z siecią.

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