依刊登位置劃分廣告資料

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

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

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

必要條件

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

  • 完成 設定GMA Next-Gen SDK。
  • 使用 GMA Next-Gen SDK 以上版本。
  • 取得刊登位置 ID 功能的存取權 如需存取權，請與客戶經理聯絡。
  • 為應用程式建立刊登位置 ID。

設定刊登位置 ID

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

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

如有需要可更新刊登位置 ID。GMA Next-Gen SDK 記錄廣告曝光時，會使用最新的刊登位置 ID。

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

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

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

Kotlin

private fun loadInterstitial() {
  val adRequest = AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build()
  InterstitialAd.load(
    adRequest,
    object : AdLoadCallback<InterstitialAd> {
      override fun onAdLoaded(ad: InterstitialAd) {
        Log.d(TAG, "Placement ID: " + ad.placementId)
      }
    },
  )
}

AdPlacementsSnippets.kt

Java

private void loadInterstitial() {
  AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID").setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      adRequest,
      new AdLoadCallback<>() {
        @Override
        public void onAdLoaded(InterstitialAd ad) {
          Log.d(TAG, "Placement ID: " + ad.getPlacementId());
        }
      });
}

AdPlacementsSnippets.java

替換下列值：

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

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

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

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

Kotlin

private fun showBannerView(ad: BannerAd, parentView: ViewGroup, activity: Activity) {
  ad.placementId = PLACEMENT_ID
  parentView.addView(ad.getView(activity))
}

AdPlacementsSnippets.kt

Java

private void showBannerView(BannerAd ad, ViewGroup parentView, Activity activity) {
  ad.setPlacementId(PLACEMENT_ID);
  parentView.addView(ad.getView(activity));
}

AdPlacementsSnippets.java

全螢幕廣告

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

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

Kotlin

private fun showAd(activity: Activity, ad: InterstitialAd) {
  ad.placementId = PLACEMENT_ID
  ad.show(activity)
}

AdPlacementsSnippets.kt

Java

private void showAd(Activity activity, InterstitialAd ad) {
  ad.setPlacementId(PLACEMENT_ID);
  ad.show(activity);
}

AdPlacementsSnippets.java

原生廣告

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

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

Kotlin

private fun showNativeAd(nativeAdView: NativeAdView, nativeAd: NativeAd, mediaView: MediaView) {
  nativeAd.placementId = PLACEMENT_ID
  nativeAdView.registerNativeAd(nativeAd, mediaView)
}

AdPlacementsSnippets.kt

Java

private void showNativeAd(NativeAdView nativeAdView, NativeAd nativeAd, MediaView mediaView) {
  nativeAd.setPlacementId(PLACEMENT_ID);
  nativeAdView.registerNativeAd(nativeAd, mediaView);
}

AdPlacementsSnippets.java

查看刊登位置報表

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