依刊登位置劃分廣告資料

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

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

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

必備條件

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

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

設定刊登位置 ID

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

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

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

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

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

請參閱以下範例，瞭解如何在廣告載入時設定插頁式廣告的刊登位置 ID：

Kotlin 

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

AdPlacementsSnippets.kt

Java

public void loadInterstitial(Context context) {
  AdRequest adRequest = new AdRequest.Builder().setPlacementId(PLACEMENT_ID).build();
  InterstitialAd.load(
      context,
      "AD_UNIT_ID",
      adRequest,
      new InterstitialAdLoadCallback() {
        @Override
        public void onAdLoaded(@NonNull 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(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

AdPlacementsSnippets.kt

Java

public void showBannerView(AdView adView, ViewGroup parentView) {
  adView.setPlacementId(PLACEMENT_ID);
  parentView.addView(adView);
}

AdPlacementsSnippets.java

全螢幕廣告

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

請參閱以下範例，瞭解如何在顯示插頁式廣告時設定刊登位置 ID：

Kotlin 

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

AdPlacementsSnippets.kt

Java

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

AdPlacementsSnippets.java

原生廣告

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

請參閱以下範例，瞭解如何在顯示原生廣告時設定刊登位置 ID：

Kotlin 

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

AdPlacementsSnippets.kt

Java

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

AdPlacementsSnippets.java

查看刊登位置報表

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