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

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

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

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

پیش‌نیازها

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

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

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

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

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

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

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

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

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

Swift

private func loadInterstitial() async {
  do {
    let interstitial = try await InterstitialAd.load(
      with: "adUnitID", request: Request())
    interstitial.placementID = adPlacementID
    print("Placement ID set to: \(interstitial.placementID)")
  } catch {
    print("Failed to load interstitial ad with error: \(error.localizedDescription)")
  }
}

آبجکتیو-سی

- (void)loadInterstitial {
  GADRequest *request = [GADRequest request];
  request.placementID = adPlacementID;
  [GADInterstitialAd loadWithAdUnitID:"adUnitID"
                              request:request
                    completionHandler:^(GADInterstitialAd *ad, NSError *error) {
                      if (!error) {
                        NSLog(@"Placement ID: %lld", ad.placementID);
                        return;
                      }
                    }];
}

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

  • adUnitID با شناسه واحد آگهی شما.
  • adPlacementID با شناسه جای آگهی شما.

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

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

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

Swift

private func showBanner(_ bannerView: BannerView) {
  bannerView.placementID = adPlacementID
  view.addSubview(bannerView)
}

آبجکتیو-سی

- (void)showBannerView:(GADBannerView *)bannerView {
  bannerView.placementID = adPlacementID;
  [self.view addSubview:bannerView];
}

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

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

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

Swift

private func showInterstitial(_ ad: InterstitialAd) {
  ad.placementID = adPlacementID
  ad.present(from: self)
}

آبجکتیو-سی

- (void)showAd:(GADInterstitialAd *)ad {
  ad.placementID = adPlacementID;
  [ad presentFromRootViewController:self];
}

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

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

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

Swift

private func configureView(_ nativeAdView: NativeAdView, withAd nativeAd: NativeAd) {
  nativeAd.placementID = adPlacementID
  nativeAdView.nativeAd = nativeAd
}

آبجکتیو-سی

- (void)configureView:(GADNativeAdView *)nativeAdView withNativeAd:(GADNativeAd *)nativeAd {
  nativeAd.placementID = adPlacementID;
  nativeAdView.nativeAd = nativeAd;
}

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

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