橫幅廣告

橫幅廣告佔據應用佈局中的一個位置,位於設備屏幕的頂部或底部。當用戶與應用程序交互時,它們會停留在屏幕上,並且可以在一段時間後自動刷新。如果您不熟悉移動廣告,那麼它們是一個很好的起點。案例研究

本指南向您展示如何將AdMob 中的橫幅廣告集成到 iOS 應用程序中。除了代碼片段和說明之外,它還包括有關正確調整橫幅大小的信息以及指向其他資源的鏈接。

先決條件

始終使用測試廣告進行測試

在構建和測試您的應用程序時,請確保您使用的是測試廣告,而不是實際的生產廣告。否則可能會導致您的帳戶被暫停。

加載測試廣告的最簡單方法是使用我們的 iOS 橫幅專用測試廣告單元 ID:ca-app-pub-3940256099942544/2934735716

它經過特殊配置,可針對每個請求返回測試廣告,您可以在編碼、測試和調試時在自己的應用程序中自由使用它。只需確保在發布應用之前將其替換為您自己的廣告單元 ID。

有關移動廣告 SDK 的測試廣告如何工作的更多信息,請參閱測試廣告

創建一個 GADBannerView

橫幅廣告顯示在GADBannerView對像中,因此集成橫幅廣告的第一步是在視圖層次結構中包含一個GADBannerView 。這通常使用 Interface Builder 或以編程方式完成。

界面生成器

GADBannerView可以像任何典型視圖一樣添加到情節提要或 xib 文件中。使用此方法時,請務必添加寬度和高度限制以匹配您要展示的廣告尺寸。例如,當顯示橫幅 (320x50) 時,使用 320 磅的寬度約束和 50 磅的高度約束。

以編程方式

GADBannerView也可以直接實例化。下面是一個如何創建GADBannerView的示例,它與屏幕安全區域的底部中心對齊,橫幅大小為 320x50:

迅速

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    
    // In this case, we instantiate the banner with desired ad size.
    bannerView = GADBannerView(adSize: GADAdSizeBanner)

    addBannerViewToView(bannerView)
  }

  func addBannerViewToView(_ bannerView: GADBannerView) {
    bannerView.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(bannerView)
    view.addConstraints(
      [NSLayoutConstraint(item: bannerView,
                          attribute: .bottom,
                          relatedBy: .equal,
                          toItem: bottomLayoutGuide,
                          attribute: .top,
                          multiplier: 1,
                          constant: 0),
       NSLayoutConstraint(item: bannerView,
                          attribute: .centerX,
                          relatedBy: .equal,
                          toItem: view,
                          attribute: .centerX,
                          multiplier: 1,
                          constant: 0)
      ])
   }
   
}

Objective-C

@import GoogleMobileAds;

@interface ViewController ()

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  
  // In this case, we instantiate the banner with desired ad size.
  self.bannerView = [[GADBannerView alloc]
      initWithAdSize:GADAdSizeBanner];

  [self addBannerViewToView:self.bannerView];
}

- (void)addBannerViewToView:(UIView *)bannerView {
  bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:bannerView];
  [self.view addConstraints:@[
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeBottom
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.bottomLayoutGuide
                               attribute:NSLayoutAttributeTop
                              multiplier:1
                                constant:0],
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeCenterX
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.view
                               attribute:NSLayoutAttributeCenterX
                              multiplier:1
                                constant:0]
                                ]];
}
  


@end

請注意,在這種情況下,我們不提供寬度或高度限制,因為提供的廣告尺寸將為橫幅提供固有的內容尺寸以調整視圖的大小。

如果您不想使用由常量定義的標準尺寸,可以使用GADAdSizeFromCGSize設置自定義尺寸。有關詳細信息,請參閱橫幅尺寸部分

配置 GADBannerView 屬性

為了加載和顯示廣告, GADBannerView需要設置一些屬性。

  • rootViewController - 此視圖控制器用於在點擊廣告時呈現疊加層。它通常應該設置為包含GADBannerView的視圖控制器。
  • adUnitID - 這是GADBannerView應該從中加載廣告的廣告單元 ID。

下面是一個代碼示例,展示瞭如何在 UIViewController 的viewDidLoad方法中設置兩個必需的屬性:

迅速

override func viewDidLoad() {
  super.viewDidLoad()
  ...

  bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716"
  bannerView.rootViewController = self
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  ...

  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2934735716";
  self.bannerView.rootViewController = self;
}

加載廣告

一旦GADBannerView就位並配置了它的屬性,就可以加載廣告了。這是通過在GADRequest對像上調用loadRequest:來完成的:

迅速

override func viewDidLoad() {
  super.viewDidLoad()
  ...

  bannerView.adUnitID = "ca-app-pub-3940256099942544/2934735716"
  bannerView.rootViewController = self
  bannerView.load(GADRequest())
}

Objective-C

- (void)viewDidLoad {
  [super viewDidLoad];
  ...

  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2934735716";
  self.bannerView.rootViewController = self;
  [self.bannerView loadRequest:[GADRequest request]];
}

GADRequest 對象代表單個廣告請求,並包含定位信息等屬性。

廣告事件

通過使用GADBannerViewDelegate ,您可以監聽生命週期事件,例如廣告關閉或用戶離開應用程序時。

報名參加橫幅活動

要註冊橫幅廣告事件,請將GADBannerView上的delegate屬性設置為實現GADBannerViewDelegate協議的對象。通常,實現橫幅廣告的類也充當委託類,在這種情況下, delegate屬性可以設置為self

迅速

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADBannerViewDelegate {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    ...
    bannerView.delegate = self
  }
}

Objective-C

@import GoogleMobileAds;

@interface ViewController () <GADBannerViewDelegate>

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  ...
  self.bannerView.delegate = self;
}

實施橫幅事件

GADBannerViewDelegate中的每個方法都標記為可選,因此您只需要實現您想要的方法即可。此示例實現每個方法並將消息記錄到控制台:

迅速

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  print("bannerViewDidReceiveAd")
}

func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: Error) {
  print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)")
}

func bannerViewDidRecordImpression(_ bannerView: GADBannerView) {
  print("bannerViewDidRecordImpression")
}

func bannerViewWillPresentScreen(_ bannerView: GADBannerView) {
  print("bannerViewWillPresentScreen")
}

func bannerViewWillDismissScreen(_ bannerView: GADBannerView) {
  print("bannerViewWillDIsmissScreen")
}

func bannerViewDidDismissScreen(_ bannerView: GADBannerView) {
  print("bannerViewDidDismissScreen")
}

Objective-C

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

- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}

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

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

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

- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}

有關在 iOS API 演示應用程序中實現橫幅委託方法的信息,請參閱廣告委託示例。

斯威夫特目標-C

用例

以下是這些廣告事件方法的一些示例用例。

收到廣告後,將橫幅添加到視圖層次結構

您可能希望延遲將GADBannerView添加到視圖層次結構,直到收到廣告。您可以通過監聽bannerViewDidReceiveAd:事件來做到這一點:

迅速

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

Objective-C

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

動畫橫幅廣告

您還可以使用bannerViewDidReceiveAd:事件在橫幅廣告返回後為其設置動畫,如以下示例所示:

迅速

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

Objective-C

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

暫停和恢復應用程序

GADBannerViewDelegate協議具有通知您事件的方法,例如當單擊導致顯示或關閉覆蓋時。如果您想跟踪這些事件是否是由廣告引起的,請註冊這些GADBannerViewDelegate方法。

要捕獲所有類型的疊加演示或外部瀏覽器調用,而不僅僅是來自廣告點擊的那些,您的應用最好監聽UIViewControllerUIApplication上的等效方法。下表顯示了與GADBannerViewDelegate方法同時調用的等效 iOS 方法:

GADBannerViewDelegate 方法iOS 方法
bannerViewWillPresentScreen: UIViewController 的viewWillDisappear:
bannerViewWillDismissScreen: UIViewController 的viewWillAppear:
bannerViewDidDismissScreen: UIViewController 的viewDidAppear:

下表列出了標準橫幅尺寸。

以磅為單位的大小 (WxH)描述可用性AdSize 常數
320x50橫幅手機和平板電腦GADAdSizeBanner
320x100大橫幅手機和平板電腦GADAdSizeLargeBanner
300x250 IAB 中長方形手機和平板電腦GADAdSizeMediumRectangle
468x60 IAB 全尺寸橫幅平板電腦GADAdSizeFullBanner
728x90 IAB 排行榜平板電腦GADAdSizeLeaderboard
提供的寬度x自適應高度自適應橫幅手機和平板電腦不適用

自定義廣告尺寸

要定義自定義橫幅尺寸,請使用GADAdSizeFromCGSize設置所需的尺寸,如下所示:

迅速

let adSize = GADAdSizeFromCGSize(CGSize(width: 300, height: 50))

Objective-C

GADAdSize size = GADAdSizeFromCGSize(CGSizeMake(300, 50));

其他資源

GitHub 上的示例

移動廣告庫視頻教程

成功的故事