بخش‌بندی داده‌های آگهی با جای آگهی‌ها

برای بخش‌بندی داده‌های گزارش‌دهی عملکرد آگهی، از ویژگی جای آگهی استفاده کنید. جایگاه‌های آگهی به شما امکان می‌دهند داده‌های ظهور را در گزارش بدون نیاز به واحدهای آگهی اضافی بخش‌بندی کنید. برای استفاده از ویژگی جایگاه‌های آگهی، به شناسه جایگاه آگهی نیاز دارید. برای جزئیات درباره جایگاه‌های آگهی، درباره جایگاه‌های آگهی را ببینید.

این راهنما تنظیم شناسه جایگاه در Google Mobile Ads SDK (Legacy) و مشاهده گزارش عملکرد آگهی را پوشش می‌دهد.

پیش‌نیازها

پیش‌از ادامه دادن، کارهای زیر را انجام دهید:

  • راه‌اندازی Google Mobile Ads SDK (Legacy) را تکمیل کنید.
  • Google Mobile Ads SDK (Legacy) نسخه ۲۴.۵.۰ یا بالاتر داشته باشید.
  • به ویژگی شناسه جای آگهی دسترسی پیدا کنید. برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
  • شناسه جای آگهی برای برنامه‌تان ایجاد کنید.

تنظیم شناسه جای آگهی

برای بخش‌بندی داده‌های عملکرد آگهی‌تان، شناسه جای آگهی را به یکی از روش‌های زیر تنظیم می‌کنید:

  • هنگام بار کردن آگهی.
  • قبل‌از نمایش آگهی.

درصورت نیاز می‌توانید شناسه جای آگهی را به‌روز کنید. وقتی 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)
      }
    },
  )
}

جاوا

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

جاوا

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

جاوا

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

جاوا

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

مشاهده گزارش جای آگهی‌ها

پس‌از تنظیم شناسه جای آگهی، گزارشی از بُعد شناسه جای آگهی را در رابط کاربری AdMob می‌بینید. برای مشاهده گزارش، مشاهده جای آگهی‌ها را دنبال کنید.