橫幅廣告佔據應用佈局中的一個位置,位於設備屏幕的頂部或底部。當用戶與應用程序交互時,它們會停留在屏幕上,並且可以在一段時間後自動刷新。如果您不熟悉移動廣告,那麼它們是一個很好的起點。案例研究。
本指南向您展示如何將AdMob 中的橫幅廣告集成到 iOS 應用程序中。除了代碼片段和說明之外,它還包括有關正確調整橫幅大小的信息以及指向其他資源的鏈接。
先決條件
- 單獨或作為 Firebase 的一部分導入Google Mobile Ads SDK。
始終使用測試廣告進行測試
在構建和測試您的應用程序時,請確保您使用的是測試廣告,而不是實際的生產廣告。否則可能會導致您的帳戶被暫停。
加載測試廣告的最簡單方法是使用我們的 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 演示應用程序中實現橫幅委託方法的信息,請參閱廣告委託示例。
用例
以下是這些廣告事件方法的一些示例用例。
收到廣告後,將橫幅添加到視圖層次結構
您可能希望延遲將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
方法。
要捕獲所有類型的疊加演示或外部瀏覽器調用,而不僅僅是來自廣告點擊的那些,您的應用最好監聽UIViewController
或UIApplication
上的等效方法。下表顯示了與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 上的示例
橫幅廣告示例: Swift | Objective-C
高級功能演示: Swift | Objective-C
GitHub 上的橫幅 UITableView 示例: Swift | Objective-C