依刊登位置劃分廣告資料

選取平台： Android (Beta 版) 新推出 Android iOS

如要區隔廣告成效報表資料，請使用廣告刊登位置功能，這樣不用額外的廣告單元，也能劃分報表中的曝光資料。這項功能需要刊登位置 ID 才能使用。 如要進一步瞭解刊登位置，請參閱「刊登位置簡介」。

本指南說明如何在 Google Mobile Ads SDK 中設定刊登位置 ID，以及查看廣告成效報表。

必備條件

繼續操作前，請先執行下列工作：

  • 完成 設定Google Mobile Ads SDK。
  • 使用 Google Mobile Ads SDK 12.9.0 以上版本。
  • 取得刊登位置 ID 功能的存取權。(如需權限，請與客戶經理聯絡)。
  • 為應用程式建立刊登位置 ID。

設定刊登位置 ID

您可以在下列任一時機設定刊登位置 ID，用來區隔廣告成效資料：

  • 載入廣告時。
  • 顯示廣告前。

如有需要可更新刊登位置 ID。Google Mobile Ads SDK 記錄廣告曝光時，會使用最新的刊登位置 ID。

在廣告載入時設定刊登位置 ID

本節說明如何在載入時設定刊登位置 ID，所有的廣告格式都適用這個工作流程。

以下示範如何在載入插頁式廣告時設定刊登位置 ID：

Swift

private func loadInterstitial() async {
  do {
    let interstitial = try await InterstitialAd.load(
      with: "adUnitID", request: Request())
    interstitial.placementID = adPlacementID
    print("Placement ID set to: \(interstitial.placementID)")
  } catch {
    print("Failed to load interstitial ad with error: \(error.localizedDescription)")
  }
}
AdPlacementsSnippets.swift

Objective-C

- (void)loadInterstitial {
  GADRequest *request = [GADRequest request];
  request.placementID = adPlacementID;
  [GADInterstitialAd loadWithAdUnitID:"adUnitID"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
                      if (!error) {
                        NSLog(@"Placement ID: %lld", ad.placementID);
                        return;
                      }
                    }];
}
AdPlacementsSnippets.m

替換下列值：

  • 將 adUnitID 換成您的廣告單元 ID。
  • 將 adPlacementID 換成您的刊登位置 ID。

在廣告顯示時設定刊登位置 ID

本節解說如何在顯示廣告時設定刊登位置 ID。由於內容涵蓋所有的廣告格式，請直接點選想使用的廣告格式：

如果是橫幅廣告，請先設定刊登位置 ID，再將廣告檢視區塊放入檢視區塊階層。以下示範如何在顯示橫幅廣告時設定刊登位置 ID：

Swift

private func showBanner(_ bannerView: BannerView) {
  bannerView.placementID = adPlacementID
  view.addSubview(bannerView)
}
AdPlacementsSnippets.swift

Objective-C

- (void)showBannerView:(GADBannerView *)bannerView {
  bannerView.placementID = adPlacementID;
  [self.view addSubview:bannerView];
}
AdPlacementsSnippets.m

全螢幕廣告

如果是全螢幕廣告格式，請在顯示廣告前設定刊登位置 ID。這個工作流程適用於下列格式：

以下示範如何在顯示插頁式廣告時設定刊登位置 ID：

Swift

private func showInterstitial(_ ad: InterstitialAd) {
  ad.placementID = adPlacementID
  ad.present(from: self)
}
AdPlacementsSnippets.swift

Objective-C

- (void)showAd:(GADInterstitialAd *)ad {
  ad.placementID = adPlacementID;
  [ad presentFromRootViewController:self];
}
AdPlacementsSnippets.m

原生廣告

如果是原生廣告，設定刊登位置 ID 的時機如下：載入原生廣告後，以及向廣告檢視區塊註冊廣告前。

以下示範如何在顯示原生廣告時設定刊登位置 ID：

Swift

private func configureView(_ nativeAdView: NativeAdView, withAd nativeAd: NativeAd) {
  nativeAd.placementID = adPlacementID
  nativeAdView.nativeAd = nativeAd
}
AdPlacementsSnippets.swift

Objective-C

- (void)configureView:(GADNativeAdView *)nativeAdView withNativeAd:(GADNativeAd *)nativeAd {
  nativeAd.placementID = adPlacementID;
  nativeAdView.nativeAd = nativeAd;
}
AdPlacementsSnippets.m

查看刊登位置報表

設定刊登位置 ID 後，您會在 AdMob UI 中看到包含刊登位置 ID 維度的報表。如要查看報表，請按照「查看刊登位置」一文的說明操作。