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

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

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

این راهنما تنظیم شناسه قرارگیری در Google Mobile Ads SDK و مشاهده گزارش عملکرد تبلیغ را پوشش می‌دهد.

پیش‌نیازها

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

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

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

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

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

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

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

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

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

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

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

  • AD_UNIT_ID با شناسه واحد تبلیغاتی شما.
  • PLACEMENT_ID با شناسه قرارگیری شما.

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

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

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

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

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

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

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

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

تبلیغات بومی

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

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

کاتلین 

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

AdPlacementsSnippets.kt

جاوا 

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

AdPlacementsSnippets.java

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

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