擷取廣告回應的相關資訊

選取平台： Android iOS Unity Flutter

基於偵錯和記錄目的，成功載入的廣告會提供 GADResponseInfo 物件。內含該廣告的相關資訊，以及用於載入廣告的刊登序列中介服務相關資訊。

如果廣告載入成功，廣告物件會具有 GADResponseInfo 屬性。舉例來說， GADInterstitialAd.responseInfo 會取得已載入插頁式廣告的回應資訊。

如果廣告無法載入，且只有錯誤可用，則可使用錯誤的 userInfo 字典中的鍵 GADErrorUserInfoKeyResponseInfo，取得 GADResponseInfo。

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

回覆資訊

以下是範例輸出，顯示已載入廣告傳回的偵錯資料：

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

GADResponseInfo 包含以下屬性：

屬性 說明
adNetworkInfoArray 傳回 GADAdNetworkResponseInfo 清單，內含廣告回應中每個轉接程式的中繼資料，可用來偵錯刊登序列中介服務和出價執行作業。清單的項目順序會與該廣告請求的中介服務刊登序列順序一致。

詳情請參閱「轉接程式回應資訊」。
loadedAdNetworkResponseInfo 針對載入廣告的轉接程式，此函式會傳回對應該程式的 GADAdNetworkResponseInfo。
adNetworkClassName 針對載入廣告的廣告聯播網，傳回該聯播網的中介服務轉接程式類別名稱。
responseIdentifier 回應 ID 是廣告回應的專屬 ID。您可利用這個 ID 在廣告審核中心 (ARC) 找出特定廣告並將其封鎖。
extrasDictionary 傳回與廣告回應有關的額外資訊，可能傳回的鍵值如下：
  • creative_id：所選廣告的委刊項 ID。 僅適用於預訂廣告。
  • line_item_id：所選廣告的廣告素材 ID。 僅適用於預訂廣告。

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

轉接程式回應資訊

GADAdNetworkResponseInfo 包含廣告回應中每個轉接程式的中繼資料，可用於偵錯刊登序列中介服務和出價執行作業。清單的項目順序會與該廣告請求的中介服務刊登序列順序一致。

以下是 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

GADAdNetworkResponseInfo 會提供每個廣告聯播網的下列屬性：

屬性 說明
error 與聯播網請求相關的錯誤。如果聯播網成功載入廣告或未收到請求，則傳回 nil。
adSourceId 與這個轉接程式回應相關聯的廣告來源 ID。
adSourceInstanceId 與這個轉接程式回應相關聯的廣告來源例項 ID。
adSourceInstanceName 與這個轉接程式回應相關聯的廣告來源例項名稱。如果收益群組未填入值，則會傳回空白字串。
adSourceName 代表放送曝光的特定廣告聯播網。
adNetworkClassName 載入廣告的廣告聯播網轉接程式類別名稱。
adUnitMapping 透過 Ad Manager 使用者介面設定的聯播網設定。
latency 廣告聯播網載入廣告所花費的時間。如果系統未嘗試執行聯播網，則傳回 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;
  }];
}