داده‌های تبلیغات را با مکان‌ها تقسیم کنید

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا) جدید-منتخب اندروید، آی‌او‌اس

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

این راهنما تنظیم شناسه قرارگیری در GMA Next-Gen SDK و مشاهده گزارش عملکرد تبلیغ را پوشش می‌دهد.

پیش‌نیازها

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

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

شناسه قرارگیری را تنظیم کنید

برای تقسیم‌بندی داده‌های عملکرد تبلیغ خود، باید یک شناسه‌ی قرارگیری (placement ID) را به یکی از روش‌های زیر تنظیم کنید:

  • هنگام بارگذاری تبلیغ.
  • قبل از نمایش تبلیغ.

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

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

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

مثال زیر یک شناسه قرارگیری برای یک تبلیغ بینابینی در زمان بارگذاری تعیین می‌کند:

کاتلین 

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

جاوا 

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 با شناسه واحد تبلیغاتی شما.
  • PLACEMENT_ID با شناسه قرارگیری شما.

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

این بخش شامل تنظیم شناسه قرارگیری در زمان نمایش برای همه قالب‌های تبلیغاتی است. قالب‌های تبلیغاتی مورد نظر خود را از بخش‌های زیر انتخاب کنید:

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

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

تبلیغات تمام صفحه

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

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

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

تبلیغات بومی

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

مثال زیر یک شناسه قرارگیری برای یک تبلیغ بومی در زمان نمایش تعیین می‌کند:

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

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

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