Как сегментировать данные объявлений по местам размещения

Чтобы сегментировать данные отчетов об эффективности объявлений, используйте функцию мест размещения объявлений. Места размещения позволяют сегментировать данные о показах в отчете без использования дополнительных рекламных блоков. Чтобы использовать функцию мест размещения, вам нужен идентификатор места размещения. Подробнее о местах размещения…

В этом руководстве рассказывается, как задать идентификатор места размещения в Google Mobile Ads SDK (Legacy) и посмотреть отчет об эффективности объявлений.

Требования

Прежде чем продолжить, сделайте следующее:

  • Завершите настройку Google Mobile Ads SDK (Legacy).
  • Установлена версия Google Mobile Ads SDK (Legacy) 24.5.0 или более поздняя.
  • Получите доступ к функции идентификатора места размещения. Чтобы запросить доступ, обратитесь к менеджеру аккаунта.
  • Создайте идентификатор места размещения для приложения.

Как задать идентификатор места размещения

Чтобы сегментировать данные об эффективности объявлений, задайте идентификатор места размещения одним из следующих способов:

  • При загрузке объявления.
  • Перед показом объявления.

При необходимости вы можете изменить идентификатор места размещения. Когда Google Mobile Ads SDK (Legacy) регистрирует показ объявления, используется последний заданный идентификатор места размещения.

Как задать идентификатор места размещения во время загрузки

В этом разделе рассказывается, как задать идентификатор места размещения во время загрузки. Этот рабочий процесс применяется ко всем форматам объявлений.

В примере ниже показано, как задать идентификатор места размещения для межстраничного объявления во время загрузки.

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)
      }
    },
  )
}

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

Замените следующие значения:

  • AD_UNIT_ID на идентификатор рекламного блока.
  • PLACEMENT_ID – идентификатор места размещения.

Как задать идентификатор места размещения во время показа

В этом разделе рассказывается, как задать идентификатор места размещения при показе объявлений всех форматов. Выберите нужные форматы объявлений в следующих разделах:

Для баннеров идентификатор места размещения задается до добавления представления объявления в иерархию представлений. В следующем примере идентификатор места размещения задается для баннера во время показа:

Kotlin

private fun showBannerView(adView: AdView, parentView: ViewGroup) {
  adView.placementId = PLACEMENT_ID
  parentView.addView(adView)
}

Java

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

Полноэкранные объявления

Для полноэкранных форматов объявлений идентификатор места размещения задается перед показом объявления. Этот рабочий процесс применяется к следующим форматам:

В следующем примере показано, как задать идентификатор места размещения для межстраничного объявления во время показа:

Kotlin

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

Java

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

Нативные объявления

Для нативных объявлений идентификатор места размещения задается после загрузки объявления и до его регистрации в представлении.

В примере ниже показано, как задать идентификатор места размещения для нативного объявления во время показа:

Kotlin

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

Java

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

Посмотреть отчет о местах размещения

После того как вы зададите идентификатор места размещения, в интерфейсе AdMob появится отчет с параметром "Идентификатор места размещения". Чтобы посмотреть отчет, следуйте инструкциям в разделе Как посмотреть места размещения.