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

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

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

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

پیش‌نیازها

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

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

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

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

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

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

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

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

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

سویفت 

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)")
  }
}
AdPlacementsSnippets.swift

هدف-سی 

- (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;
                      }
                    }];
}
AdPlacementsSnippets.m

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

  • adUnitID با شناسه واحد تبلیغاتی شما.
  • adPlacementID به همراه شناسه‌ی محل قرارگیری شما.

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

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

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

سویفت 

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

هدف-سی 

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

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

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

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

سویفت 

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

هدف-سی 

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

تبلیغات بومی

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

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

سویفت 

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

هدف-سی 

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

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

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