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

انتخاب پلاتفرم: Android iOS Android (قدیمی)

تماس بگیرید.

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

این راهنما شامل تنظیم شناسه جایگاه در GMA Next-Gen SDK و مشاهده گزارش عملکرد آگهی است.

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را انجام دهید:

  • راه‌اندازی GMA Next-Gen SDK را تکمیل کنید.
  • نسخه GMA Next-Gen SDK یا بالاتر داشته باشید.
  • به ویژگی شناسه جای آگهی دسترسی پیدا کنید. برای درخواست دسترسی، با مدیر حسابتان تماس بگیرید.
  • شناسه جای آگهی برای برنامه‌تان ایجاد کنید.

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

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

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

درصورت نیاز می‌توانید شناسه جای آگهی را به‌روز کنید. وقتی GMA Next-Gen SDK ظهور آگهی را ضبط می‌کند، از جدیدترین شناسه جای آگهی استفاده می‌کند.

شناسه جای آگهی را در زمان بارگذاری تنظیم کنید

این بخش به تنظیم شناسه جای آگهی در زمان بارگذاری می‌پردازد. این گردش کار برای همه قالب‌های آگهی اعمال می‌شود.

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

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

جاوا

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

مقادیر زیر را جایگزین کنید:

  • AD_UNIT_ID با شناسه واحد آگهی شما.
  • ‫PLACEMENT_ID با شناسه جای آگهی‌تان.

شناسه جای آگهی را در زمان نمایش تنظیم کنید

این بخش به تنظیم شناسه جای آگهی در زمان نمایش برای همه قالب‌های آگهی می‌پردازد. قالب‌های آگهی ترجیحی‌تان را از بخش‌های زیر انتخاب کنید:

برای آگهی‌های برنمایی، شناسه جای آگهی را قبل‌از جای‌گذاری نمای آگهی در سلسله مراتب نما تنظیم می‌کنید. مثال زیر شناسه جای آگهی را برای آگهی برنمایی در زمان نمایش تنظیم می‌کند:

Kotlin

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

جاوا

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

آگهی‌های تمام‌صفحه

برای قالب‌های آگهی تمام‌صفحه، شناسه جای آگهی را قبل‌از نمایش آگهی تنظیم می‌کنید. این گردش کار برای قالب‌های زیر اعمال می‌شود:

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

Kotlin

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

جاوا

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

آگهی‌های بومی

برای آگهی‌های بومی، شناسه جای آگهی را پس‌از بار کردن آگهی بومی و قبل‌از ثبت کردن آگهی در نمای آگهی تنظیم می‌کنید.

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

Kotlin

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

جاوا

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

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

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