按展示位置细分广告数据

请选择平台： 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 界面中看到展示位置 ID 维度的报告。如需查看该报告，请按照查看您的展示位置部分中介绍的步骤操作。