橫幅廣告是會佔用應用程式版面配置一部分的矩形廣告。使用者與應用程式互動時,這類廣告會固定顯示在畫面頂端或底部,或在使用者捲動瀏覽內容時,持續顯示在畫面上。橫幅廣告會在一段時間後自動重新整理。詳情請參閱 橫幅廣告總覽。
本指南將說明如何開始使用 錨定自動調整橫幅廣告,這項功能會根據您指定的廣告寬度,為每種裝置調整出最佳廣告大小,盡可能提高成效。
錨定自動調整橫幅廣告
錨定自動調整橫幅廣告是固定的顯示比例廣告,而非一般固定大小的廣告。長寬比與 320*50 業界標準類似。指定可用完整寬度後,系統便會傳回與該寬度最理想高度的廣告。不同裝置的請求之間,最佳高度不會改變,周圍檢視畫面也不需要在廣告重新整理時移動。
必要條件
- 完成入門指南。
一律使用測試廣告進行測試
建構及測試應用程式時,請務必使用測試廣告,而非正式版廣告。否則可能導致帳戶遭到停權。
如要載入測試廣告,最簡單的方法是使用 iOS 橫幅廣告專用的測試廣告單元 ID:
ca-app-pub-3940256099942544/2435281174
我們已特別將每個請求設為傳回測試廣告;編寫程式碼、測試及偵錯時,您可以在自己的應用程式中自由使用這項工具。但請注意,發布應用程式前,請務必先將它換成自己的廣告單元 ID。
如要進一步瞭解 Mobile Ads SDK 測試廣告的運作方式,請參閱「測試廣告」一文。
建立 GADBannerView
橫幅廣告會顯示在 GADBannerView
物件中,因此整合橫幅廣告的第一步,是在檢視區塊階層中加入 GADBannerView
。這項作業通常透過程式或 Interface Builder 完成。
透過程式輔助方式
GADBannerView
也可以直接例項化。以下範例說明如何建立 GADBannerView
,並與螢幕安全區域的底部置中對齊:
Swift
import GoogleMobileAds import UIKit class ViewController: UIViewController { var bannerView: GADBannerView! override func viewDidLoad() { super.viewDidLoad() let viewWidth = view.frame.inset(by: view.safeAreaInsets).width // Here the current interface orientation is used. Use // GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth or // GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth if you prefer to load an ad of a // particular orientation, let adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth) bannerView = GADBannerView(adSize: adaptiveSize) addBannerViewToView(bannerView) } func addBannerViewToView(_ bannerView: GADBannerView) { bannerView.translatesAutoresizingMaskIntoConstraints = false view.addSubview(bannerView) view.addConstraints( [NSLayoutConstraint(item: bannerView, attribute: .bottom, relatedBy: .equal, toItem: view.safeAreaLayoutGuide, attribute: .bottom, 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]; // Here safe area is taken into account, hence the view frame is used after the // view has been laid out. CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets); CGFloat viewWidth = frame.size.width; // Here the current interface orientation is used. If the ad is being preloaded // for a future orientation change or different orientation, the function for the // relevant orientation should be used. GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth); // In this case, we instantiate the banner with desired ad size. self.bannerView = [[GADBannerView alloc] initWithAdSize:adaptiveSize]; [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.view.safeAreaLayoutGuide attribute:NSLayoutAttributeBottom multiplier:1 constant:0], [NSLayoutConstraint constraintWithItem:bannerView attribute:NSLayoutAttributeCenterX relatedBy:NSLayoutRelationEqual toItem:self.view attribute:NSLayoutAttributeCenterX multiplier:1 constant:0] ]]; } @end
請注意,在本例中,我們沒有設定寬度或高度限制,因為提供的廣告大小將為橫幅廣告提供內建的內容大小。
介面建構工具
您可以將 GADBannerView
新增至分鏡腳本或 xib 檔案。使用這個方法時,請務必只在橫幅上新增位置限制。舉例來說,在畫面底部顯示自動調整橫幅廣告時,請將橫幅廣告檢視畫面的底部設為與「底部版面配置指南」頂端相同,然後將中心 X 設為超級檢視畫面的中央 X。
橫幅廣告的大小仍是以程式輔助方式設定:
Swift
bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
Objective-C
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
載入廣告
GADBannerView
設定完成並設定了屬性後,就可以開始載入廣告了。方法是對 GADRequest
物件呼叫 loadRequest:
:
Swift
override func viewDidLoad() { super.viewDidLoad() ... // Set the ad unit ID and view controller that contains the GADBannerView. bannerView.adUnitID = "ca-app-pub-3940256099942544/2435281174" bannerView.rootViewController = self bannerView.load(GADRequest()) }
Objective-C
- (void)viewDidLoad { [super viewDidLoad]; ... // Set the ad unit ID and view controller that contains the GADBannerView. self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2435281174"; self.bannerView.rootViewController = self; [self.bannerView loadRequest:[GADRequest request]]; }
GADRequest 物件代表單一廣告請求,包含指定目標資訊等屬性。
如果廣告無法載入,只要您將廣告單元設為重新整理,就不必明確請求另一個廣告;Google Mobile Ads SDK 會遵循您在 AdMob使用者介面中指定的任何重新整理頻率。如果尚未啟用重新整理功能,就必須提出新要求。
廣告事件
透過使用 GADBannerViewDelegate
,您可以監聽生命週期事件,例如廣告關閉或使用者離開應用程式時。
註冊橫幅廣告事件
如要註冊橫幅廣告事件,請將 GADBannerView
上的 delegate
屬性設為導入 GADBannerViewDelegate
通訊協定的物件。一般來說,導入橫幅廣告的類別也會做為委派類別,在這種情況下,delegate
屬性可設為 self
。
Swift
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
中的每個方法都標示為選用,因此您只需實作所需方法。以下範例會實作每個方法,並將訊息記錄至主控台:
Swift
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"); }
請參閱 Ad Delegate 範例,瞭解如何在 iOS API 試用版應用程式中導入橫幅廣告委派方法。
用途
以下舉例說明這些廣告事件方法的應用方式。
收到廣告後,在檢視區塊階層中加入橫幅
因此,建議您在收到廣告之後,才將 GADBannerView
加入檢視區塊階層。您可以監聽 bannerViewDidReceiveAd:
事件來達到此效果:
Swift
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:
事件,在系統傳回橫幅廣告後建立動畫動畫,如以下範例所示:
Swift
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: |
其他資源
GitHub 上的範例
- 錨定自動調整橫幅廣告範例:Swift | Objective-C
- 進階功能示範:Swift | Objective-C
後續步驟
可收合橫幅廣告
可收合橫幅廣告是指最初以較大的重疊廣告方式呈現的橫幅廣告,其中包含可將廣告收合為較小的尺寸的按鈕。建議您利用這項功能進一步最佳化效能。詳情請參閱可收合橫幅廣告。
內嵌自動調整橫幅廣告
與錨定自動調整橫幅廣告相比,內嵌自動調整橫幅廣告會尺寸更大、圖示也更高。它們的高度可變,而且高度與裝置螢幕高度一樣。如果應用程式會在可捲動內容中刊登橫幅廣告,建議採用內嵌自動調整橫幅廣告,而非錨定自動調整橫幅廣告。詳情請參閱內嵌自動調整橫幅廣告。