‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

راه‌اندازی آگهی‌های برنمایی

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

آگهی‌های برنما آگهی‌های مستطیلی هستند که بخشی از چیدمان برنامه را اشغال می‌کنند. برنماهای تطبیقی ثابت همیشه روی صفحه هستند و به بالا یا پایین صفحه با حداکثر ارتفاع ۲۰٪ اندازه صفحه با حداکثر ارتفاع ۱۵۰ پیکسل ثابت می‌شوند. برای بهینه‌سازی اندازه آگهی برای هر دستگاه، از برنمای تطبیقی استفاده کنید.

این راهنما بار کردن آگهی برنما تطبیقی لنگرانداخته را در برنامه iOS پوشش می‌دهد.

پیش‌نیازها

پیش‌از ادامه دادن، Google Mobile Ads SDK را راه‌اندازی کنید.

همیشه با آگهی‌های آزمایشی آزمایش کنید

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

ساده‌ترین راه برای بار کردن آگهی‌های آزمایشی، استفاده از شناسه واحد آگهی آزمایشی اختصاصی ما برای برنمای iOS است:

/21775744923/example/adaptive-banner

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

برای اطلاعات بیشتر درباره نحوه عملکرد آگهی‌های آزمایشی Google Mobile Ads SDK، به آگهی‌های آزمایشی مراجعه کنید.

ایجاد GAMBannerView

آگهی‌های برنما در اشیاء GAMBannerView نمایش داده می‌شوند، بنابراین اولین گام برای ادغام آگهی‌های برنما، گنجاندن GAMBannerView در سلسله‌مراتب نمای شما است. این کار معمولاً به‌صورت برنامه‌نویسی‌شده یا ازطریق Interface Builder انجام می‌شود.

برنامه‌ریزی‌شده

GAMBannerView را می‌توان مستقیماً نیز نمونه‌سازی کرد. مثال زیر GAMBannerView را ایجاد می‌کند:

Swift

// Initialize the banner view.
bannerView = AdManagerBannerView()
bannerView.delegate = self

bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
NSLayoutConstraint.activate([
  // Align the banner's bottom edge with the safe area's bottom edge
  bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
  // Center the banner horizontally in the view
  bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
])AdManagerBannerSnippets.swift

SwiftUI

برای استفاده از AdManagerBannerView، UIViewRepresentable ایجاد کنید:

private struct BannerViewContainer: UIViewRepresentable {
  typealias UIViewType = BannerView
  let adSize: AdSize

  init(_ adSize: AdSize) {
    self.adSize = adSize
  }

  func makeUIView(context: Context) -> BannerView {
    let banner = BannerView(adSize: adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(Request())
    banner.delegate = context.coordinator
    return banner
  }

  func updateUIView(_ uiView: BannerView, context: Context) {}

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }BannerContentView.swift

UIViewRepresentable را به سلسله‌مراتب نما اضافه کنید و مقادیر height و width را مشخص کنید:

var body: some View {
  Spacer()
  // Request an anchored adaptive banner with a width of 375.
  let adSize = largeAnchoredAdaptiveBanner(width: 375)
  BannerViewContainer(adSize)
    .frame(width: adSize.size.width, height: adSize.size.height)
}BannerContentView.swift

آبجکتیو-سی

// Initialize the banner view.
GAMBannerView *bannerView = [[GAMBannerView alloc] init];
bannerView.delegate = self;
UIView *view = self.view;

bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[view addSubview:bannerView];

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
[NSLayoutConstraint activateConstraints:@[
  // Align the banner's bottom edge with the safe area's bottom edge
  [bannerView.bottomAnchor
      constraintEqualToAnchor:view.safeAreaLayoutGuide.bottomAnchor],
  // Center the banner horizontally in the view
  [bannerView.centerXAnchor constraintEqualToAnchor:view.centerXAnchor],
]];

self.bannerView = bannerView;AdManagerBannerSnippets.m

سازنده میانای کاربری

می‌توانید GAMBannerView را به فایل xib یا داستان مصور اضافه کنید. هنگام استفاده از این روش، حتماً فقط محدودیت‌های موقعیت را به برنما اضافه کنید. برای مثال، وقتی برنمای تطبیقی در پایین صفحه نمایش داده می‌شود، پایین نمای برنما را برابر با بالای «راهنمای چیدمان پایین» تنظیم کنید، و قید centerX را برابر با centerX نمای فرادست تنظیم کنید.

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

برنماهای تطبیقی بزرگ قالب بزرگ‌تری را ارائه می‌دهند که برای چیدمان‌های غیرپیمایشی طراحی شده است. درمقایسه با برنمای تطبیقی لنگرانداخته استاندارد، این برنماها حداکثر ارتفاع بلندتری را مجاز می‌کنند (تا ۲۰٪ ارتفاع صفحه‌نمایش، بین ۵۰ و ۱۵۰ نقطه). این فضای افزایش‌یافته برای محتوای ویدیویی بهینه‌سازی شده است.

مثال زیر اندازه برنمای تطبیقی لنگرانداخته بزرگ را دریافت می‌کند:

Swift

// Request a large anchored adaptive banner with a width of 375.
bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)AdManagerBannerSnippets.swift

آبجکتیو-سی

// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);AdManagerBannerSnippets.m

اندازه آگهی را کوچک‌تر یا مساوی اندازه صفحه‌نمایش دستگاه تنظیم کنید. برای تعیین حداکثر اندازه صفحه‌نمایش در iOS 26 و نسخه‌های جدیدتر، از UIWindowScene.effectiveGeometry.coordinateSpace دارایی استفاده کنید. در iOS نسخه ۱۸ و قدیمی‌تر، از خصوصیت UIWindowScene.coordinateSpace استفاده کنید. برای جزئیات مربوط به محدودیت‌های اندازه، به عیب‌یابی ظهورهای پرنشده در Ad Manager مراجعه کنید.

بار کردن آگهی

وقتی GAMBannerView در جای خود قرار گرفت و ویژگی‌های آن، مانند adUnitID، پیکربندی شد، وقت آن است که آگهی بار شود. این کار با فراخوانی loadRequest: در شیء GAMRequest انجام می‌شود:

Swift

func loadBannerAd(bannerView: AdManagerBannerView) {
  // Request a large anchored adaptive banner with a width of 375.
  bannerView.adSize = largeAnchoredAdaptiveBanner(width: 375)
  bannerView.load(AdManagerRequest())
}AdManagerBannerSnippets.swift

SwiftUI

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())BannerContentView.swift

آبجکتیو-سی

// Request a large anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADLargeAnchoredAdaptiveBannerAdSizeWithWidth(375);

[self.bannerView loadRequest:[GAMRequest request]];AdManagerBannerSnippets.m

اشیاء GAMRequest نشان‌دهنده یک درخواست آگهی واحد هستند و حاوی ویژگی‌هایی برای مواردی مانند اطلاعات هدف‌یابی هستند.

بازآوری آگهی

اگر واحد آگهی‌تان را برای بازآوری پیکربندی کرده‌اید، وقتی آگهی بار نمی‌شود، لازم نیست آگهی دیگری درخواست کنید. Google Mobile Ads SDK از هر نرخ بازآوری که در واسط کاربر Ad Manager مشخص کرده‌اید پیروی می‌کند. اگر بازآوری را فعال نکرده‌اید، درخواست جدیدی صادر کنید. برای جزئیات بیشتر درباره بازآوری واحد آگهی، مثل تنظیم نرخ بازآوری، به نرخ بازآوری برای آگهی‌ها در برنامه‌های تلفن همراه مراجعه کنید.

مدیریت تغییرات جهت

وقتی جهت صفحه برنامه‌تان تغییر می‌کند، مثلاً از حالت portrait به افقی، عرض دردسترس برای برنما نیز اغلب تغییر می‌کند. برای اینکه مطمئن شوید آگهی با اندازه مناسب برای چیدمان جدید نمایش می‌دهید، برنمای جدیدی درخواست کنید. اگر عرض برنما ثابت است یا اگر محدودیت‌های چیدمان شما می‌تواند تغییر اندازه را مدیریت کند، از این مرحله رد شوید.

Swift

override func viewWillTransition(
  to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator
) {
  coordinator.animate(alongsideTransition: { _ in
    // Load a new ad for the new orientation.
  })
}BannerSnippets.swift

آبجکتیو-سی

- (void)viewWillTransitionToSize:(CGSize)size
       withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
  [coordinator animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext> context) {
    // Load a new ad for the new orientation.
  } completion:nil];
}BannerSnippets.m

رویدادهای آگهی

بااستفاده از GADBannerViewDelegate، می‌توانید به رویدادهای چرخه حیات گوش دهید، مثلاً وقتی آگهی بسته می‌شود یا کاربر برنامه را ترک می‌کند.

ثبت‌نام برای رویدادهای برنمایشی

برای ثبت‌نام در رویدادهای آگهی برنمایی، ویژگی delegate را در GAMBannerView روی شیئی تنظیم کنید که پروتکل GADBannerViewDelegate را پیاده‌سازی می‌کند. به‌طور کلی، کلاسی که آگهی‌های برنمایشی را پیاده‌سازی می‌کند به‌عنوان کلاس نماینده نیز عمل می‌کند، که در این صورت، ویژگی delegate را می‌توان روی self تنظیم کرد.

Swift

bannerView.delegate = selfAdManagerBannerSnippets.swift

SwiftUI

banner.delegate = context.coordinatorBannerContentView.swift

آبجکتیو-سی

bannerView.delegate = self;AdManagerBannerSnippets.m

پیاده‌سازی رویدادهای برنما

هرکدام از روش‌ها در GADBannerViewDelegate به‌عنوان اختیاری علامت‌گذاری شده‌اند، بنابراین فقط باید روش‌هایی را که می‌خواهید پیاده‌سازی کنید. این مثال هر روش را پیاده‌سازی می‌کند و پیامی را در کنسول ثبت می‌کند:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print("Banner ad loaded.")
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print("Banner ad failed to load: \(error.localizedDescription)")
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print("Banner ad recorded an impression.")
}

func bannerViewDidRecordClick(_ bannerView: BannerView) {
  print("Banner ad recorded a click.")
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print("Banner ad will present screen.")
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print("Banner ad will dismiss screen.")
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print("Banner ad did dismiss screen.")
}AdManagerBannerSnippets.swift

آبجکتیو-سی

- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

- (void)bannerView:(GAMBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", error.localizedDescription);
}

- (void)bannerViewDidRecordImpression:(GAMBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

- (void)bannerViewWillPresentScreen:(GAMBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

- (void)bannerViewWillDismissScreen:(GAMBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

- (void)bannerViewDidDismissScreen:(GAMBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}
AdManagerBannerSnippets.m

برای پیاده‌سازی روش‌های نماینده برنما در برنامه نمایشی iOS API، نمونه «نماینده آگهی» را ببینید.

Swift Objective-C

موارد استفاده

در اینجا چند نمونه مورد استفاده برای این روش‌های رویداد آگهی آورده شده است.

پس‌از دریافت آگهی، برنمایی به سلسله‌مراتب نما اضافه کنید

بهتر است افزودن GAMBannerView به سلسله مراتب نما را تا پس‌از دریافت آگهی به‌تأخیر بیندازید. می‌توانید این کار را با گوش دادن به رویداد bannerViewDidReceiveAd: انجام دهید:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

آبجکتیو-سی

- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
  // Add bannerView to view and add constraints as above.
  [self addBannerViewToView:self.bannerView];
}

پویاسازی آگهی برنمایی

همچنین می‌توانید از رویداد bannerViewDidReceiveAd: برای پویانمایی آگهی برنمایی پس‌از بازگشت آن استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

آبجکتیو-سی

- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

توقف موقت و ازسرگیری برنامه

پروتکل GADBannerViewDelegate روش‌هایی برای مطلع کردن شما از رویدادها دارد، مثلاً وقتی کلیک باعث می‌شود هم‌پوشانی نمایش داده شود یا بسته شود. اگر می‌خواهید ردیابی کنید که آیا این رویدادها به‌دلیل آگهی‌ها بوده است یا نه، برای این GADBannerViewDelegate روش ثبت‌نام کنید.

برای گرفتن همه انواع ارائه‌های هم‌پوشانی یا فراخوانی‌های مرورگر خارجی، نه فقط آن‌هایی که از کلیک‌های آگهی می‌آیند، بهتر است برنامه‌تان به روش‌های معادل در UIViewController یا UIApplication گوش دهد. در اینجا جدولی نشان‌دهنده روش‌های معادل iOS که هم‌زمان با روش‌های GADBannerViewDelegate فراخوانی می‌شوند ارائه شده است:

روش GADBannerViewDelegate	روش iOS
`bannerViewWillPresentScreen:`	‫`viewWillDisappear:` مربوط به UIViewController
`bannerViewWillDismissScreen:`	‫`viewWillAppear:` مربوط به UIViewController
`bannerViewDidDismissScreen:`	‫`viewDidAppear:` مربوط به UIViewController

شمارش دستی ظهور

اگر شرایط ویژه‌ای برای زمان ثبت ظهور دارید، می‌توانید پینگ‌های ظهور را به‌صورت دستی به Ad Manager ارسال کنید. این کار را می‌توان با فعال کردن ابتدا GAMBannerView برای ظهورهای دستی قبل‌از بار کردن آگهی انجام داد:

Swift

bannerView.enableManualImpressions = trueAdManagerBannerSnippets.swift

آبجکتیو-سی

self.bannerView.enableManualImpressions = YES;AdManagerBannerSnippets.m

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

Swift

bannerView.recordImpression()AdManagerBannerSnippets.swift

آبجکتیو-سی

[self.bannerView recordImpression];AdManagerBannerSnippets.m

رویدادهای برنامه

بااستفاده از GADAppEventDelegate می‌توانید به رویدادهای برنامه ویژه Ad Manager گوش دهید. این رویدادها ممکن است در هر زمانی درطول چرخه حیات آگهی رخ دهند، حتی قبل‌از اینکه bannerViewDidReceiveAd: شیء GADBannerViewDelegate فراخوانی شود.

برای ثبت‌نام در رویدادهای برنامه، ویژگی نماینده را در GAMBannerView روی شیئی تنظیم کنید که پروتکل GADAppEventDelegate را پیاده‌سازی می‌کند. به‌طور کلی، کلاسی که آگهی‌های برنمایی را پیاده‌سازی می‌کند، به‌عنوان کلاس نماینده نیز عمل می‌کند، که در این صورت، ویژگی نماینده را می‌توان روی self تنظیم کرد.

Swift

// Set this property before making the request for an ad.
bannerView.appEventDelegate = selfAdManagerBannerSnippets.swift

آبجکتیو-سی

// Set this property before making the request for an ad.
self.bannerView.appEventDelegate = self;AdManagerBannerSnippets.m

در اینجا مثالی آورده شده است که نشان می‌دهد چگونه رنگ پس‌زمینه برنامه‌تان را با مشخص کردن رنگ از رویداد برنامه تغییر دهید:

Swift

func bannerView(
  _ banner: AdManagerBannerView, didReceiveAppEvent name: String, withInfo info: String?
) {
  if name == "color" {
    if info == "green" {
      // Set background color to green.
      view.backgroundColor = UIColor.green
    } else if info == "blue" {
      // Set background color to blue.
      view.backgroundColor = UIColor.blue
    } else {
      // Set background color to black.
      view.backgroundColor = UIColor.black
    }
  }
}AdManagerBannerSnippets.swift

آبجکتیو-سی

- (void)bannerView:(GAMBannerView *)banner
    didReceiveAppEvent:(NSString *)name
              withInfo:(NSString *)info {
  if ([name isEqual:@"color"]) {
    if ([info isEqual:@"green"]) {
      // Set background color to green.
      self.view.backgroundColor = [UIColor greenColor];
    } else if ([info isEqual:@"blue"]) {
      // Set background color to blue.
      self.view.backgroundColor = [UIColor blueColor];
    } else {
      // Set background color to black.
      self.view.backgroundColor = [UIColor blackColor];
    }
  }
}AdManagerBannerSnippets.m

و در اینجا طرح‌آگهی مربوطه که پیام‌های رویداد برنامه رنگ را به appEventDelegate ارسال می‌کند:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0px;
      left: 0px;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>

برای پیاده‌سازی رویدادهای برنامه در برنامه نمایشی iOS API، نمونه «رویدادهای برنامه Ad Manager» را ببینید.

Swift Objective-C

منابع اضافی

مثال‌ها در GitHub

نمونه آگهی‌های برنمای تطبیقی لنگرانداخته: Swift | SwiftUI | Objective-C

نمونه نمایشی ویژگی‌های پیشرفته: Swift | Objective-C

مراحل بعدی

برنماهای جمع‌شدنی

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

برنماهای تطبیقی به‌خط

برنماهای تطبیقی درون‌خطی نسبت‌به برنماهای تطبیقی لنگردار بزرگ‌تر و بلندتر هستند. ارتفاع آن‌ها متغیر است و می‌تواند به اندازه ارتفاع صفحه‌نمایش دستگاه باشد. برنماهای تطبیقی درون‌خطی برای برنامه‌هایی که آگهی‌های برنمایی را در محتوای پیمایش‌شدنی قرار می‌دهند، نسبت‌به آگهی‌های برنمایی تطبیقی ثابت توصیه می‌شود. برای جزئیات بیشتر، برنمای تطبیقی درون‌خط را ببینید.

کاوش کردن موضوعات دیگر

حریم خصوصی کاربر

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

پیش‌نیازها

همیشه با آگهی‌های آزمایشی آزمایش کنید

ایجاد GAMBannerView

برنامه‌ریزی‌شده

Swift

SwiftUI

آبجکتیو-سی

سازنده میانای کاربری

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

Swift

آبجکتیو-سی

بار کردن آگهی

Swift

SwiftUI

آبجکتیو-سی

بازآوری آگهی

مدیریت تغییرات جهت

Swift

آبجکتیو-سی

رویدادهای آگهی

ثبت‌نام برای رویدادهای برنمایشی

Swift

SwiftUI

آبجکتیو-سی

پیاده‌سازی رویدادهای برنما

Swift

آبجکتیو-سی

موارد استفاده

پس‌از دریافت آگهی، برنمایی به سلسله‌مراتب نما اضافه کنید

Swift

آبجکتیو-سی

پویاسازی آگهی برنمایی

Swift

آبجکتیو-سی

توقف موقت و ازسرگیری برنامه

شمارش دستی ظهور

Swift

آبجکتیو-سی

Swift

آبجکتیو-سی

رویدادهای برنامه

Swift

آبجکتیو-سی

Swift

آبجکتیو-سی

منابع اضافی

مثال‌ها در GitHub

مراحل بعدی

برنماهای جمع‌شدنی

برنماهای تطبیقی به‌خط

کاوش کردن موضوعات دیگر

راه‌اندازی آگهی‌های برنمایی