橫幅廣告是矩形廣告,顯示時會占去應用程式的部分版面。使用者與應用程式互動時,這類廣告會在畫面頂端或底部固定顯示,或在使用者捲動畫面時隨著內容移動。橫幅廣告每過一段時間會自動重新整理,詳情請參閱「橫幅廣告總覽」一文。
本指南說明如何使用錨定自動調整橫幅廣告,讓這類廣告根據您指定的廣告寬度,在不同裝置上顯示合適大小的廣告,盡可能提高成效。
錨定自動調整橫幅廣告
不同於一般的固定大小廣告,錨定自動調整橫幅廣告採用固定顯示比例 (近似業界標準比例 320x50)。您指定最大可用寬度後,系統會根據該寬度傳回高度適中的廣告。只要是同一部裝置發出的請求,每次載入的廣告高度都會相同,重新整理廣告也不會造成周圍內容位移。
必備條件
- 完成入門指南的步驟。
請務必使用測試廣告進行測試
建構及測試應用程式時,請務必使用測試廣告,而非實際運作中的廣告,否則可能導致帳戶遭停權。
載入測試廣告最簡單的方法,是使用 iOS 橫幅廣告專用的測試廣告單元 ID:
ca-app-pub-3940256099942544/2435281174
這種 ID 經特別設定,會針對每個請求傳回測試廣告。您可在編寫程式碼、測試及偵錯時,在自家應用程式中使用測試用 ID。但別忘了在發布應用程式前,將這類 ID 替換為自己的廣告單元 ID。
如要進一步瞭解 Mobile Ads SDK 測試廣告的運作方式,請參閱「測試廣告」。
建立 GADBannerView
橫幅廣告會顯示在 GADBannerView
物件中,因此整合橫幅廣告時,首先需要將 GADBannerView
加入檢視區塊階層。這項作業通常可以透過程式輔助方式或 Interface Builder 完成。
程式輔助方式
您也可以直接將 GADBannerView
例項化。以下範例說明如何建立 GADBannerView
:
Swift
// Initialize the BannerView.
bannerView = BannerView()
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),
])
SwiftUI
如要使用 BannerView
,請先建立 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)
}
將 UIViewRepresentable
加入檢視區塊階層後,請指定 height
和 width
值:
var body: some View {
Spacer()
// Request an anchored adaptive banner with a width of 375.
let adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
BannerViewContainer(adSize)
.frame(width: adSize.size.width, height: adSize.size.height)
}
Objective-C
// Initialize the GADBannerView.
self.bannerView = [[GADBannerView alloc] init];
self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:self.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
[self.bannerView.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor],
// Center the banner horizontally in the view
[self.bannerView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
]];
Interface Builder
您可以將 GADBannerView
加入分鏡腳本或 xib 檔案。使用這個方法時,只能在橫幅廣告上新增位置限制。舉例來說,如要在畫面底部顯示自動調整橫幅廣告,請將橫幅廣告檢視區塊的底端,設為等同 BottomLayoutGuide 的頂端,而且為 centerX
限制設定的值,也應與上層檢視區塊的 centerX
一致。
設定廣告大小
請將 GADSize
設為錨定自動調整橫幅廣告,並指定寬度:
Swift
// Request an anchored adaptive banner with a width of 375.
bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
Objective-C
// Request an anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(375);
載入廣告
建立 GADBannerView
並設定其屬性 (例如 adUnitID
) 後,即可載入廣告,方法是呼叫 GADRequest
物件的 loadRequest:
:
Swift
bannerView.load(Request())
SwiftUI
banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
Objective-C
[self.bannerView loadRequest:[GADRequest request]];
GADRequest
物件代表單一廣告請求,當中包含指定目標資訊等屬性。
重新整理廣告
如已設定廣告單元重新整理功能,廣告載入失敗時,就不需要請求其他廣告。Google Mobile Ads SDK 會套用您在 AdMob UI 指定的重新整理頻率。如果您未啟用重新整理功能,請發出新請求。請參閱「為橫幅廣告使用自動重新整理功能」一文,進一步瞭解廣告單元重新整理功能 (例如設定重新整理頻率)。
處理螢幕方向改變的狀況
應用程式的畫面方向改變時 (例如從 portrait
模式變成橫向),橫幅的可用寬度通常也會隨之更改,因此須請求新的橫幅廣告,確保新版面配置中顯示的廣告大小適當。如果橫幅寬度固定,或是版面配置限制能自行調整大小,可略過這個步驟。
Swift
override func viewWillTransition(
to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator
) {
coordinator.animate(alongsideTransition: { _ in
// Load a new ad for the new orientation.
})
}
Objective-C
- (void)viewWillTransitionToSize:(CGSize)size
withTransitionCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator {
[coordinator animateAlongsideTransition:^(id<UIViewControllerTransitionCoordinatorContext> context) {
// Load a new ad for the new orientation.
} completion:nil];
}
廣告事件
您可以利用 GADBannerViewDelegate
監聽各種生命週期事件,例如廣告何時關閉,或使用者何時離開應用程式。
註冊橫幅廣告事件
為註冊橫幅廣告事件,請在導入了 GADBannerViewDelegate
通訊協定的物件中,設定 GADBannerView
的 delegate
屬性。一般來說,導入橫幅廣告的類別同時也是委派類別,在這種情況中,可以將 delegate
屬性設為 self
。
Swift
bannerView.delegate = self
SwiftUI
banner.delegate = context.coordinator
Objective-C
self.bannerView.delegate = self;
導入橫幅廣告事件
GADBannerViewDelegate
中的都是選用方法,因此只要導入想使用的方法即可。下列範例會導入每個方法,並在控制台中記錄訊息:
Swift
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
print(#function)
}
func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
print(#function + ": " + error.localizedDescription)
}
func bannerViewDidRecordClick(_ bannerView: BannerView) {
print(#function)
}
func bannerViewDidRecordImpression(_ bannerView: BannerView) {
print(#function)
}
func bannerViewWillPresentScreen(_ bannerView: BannerView) {
print(#function)
}
func bannerViewWillDismissScreen(_ bannerView: BannerView) {
print(#function)
}
func bannerViewDidDismissScreen(_ bannerView: BannerView) {
print(#function)
}
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:
事件,方法如下:
Swift
func bannerViewDidReceiveAd(_ bannerView: BannerView) {
// Add banner to view and add constraints.
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: BannerView) {
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
有相同作用的方法。下表列出的 iOS 方法可與 GADBannerViewDelegate
方法同時叫用,且作用完全一樣。
GADBannerViewDelegate 方法 | iOS 方法 |
---|---|
bannerViewWillPresentScreen: |
UIViewController 的 viewWillDisappear: |
bannerViewWillDismissScreen: |
UIViewController 的 viewWillAppear: |
bannerViewDidDismissScreen: |
UIViewController 的 viewDidAppear: |
其他資源
GitHub 上的範例
- 錨定自動調整橫幅廣告範例:Swift | SwiftUI | Objective-C
- 進階功能示範:Swift | Objective-C
後續步驟
可收合橫幅廣告
「可收合橫幅廣告」一開始顯示時,會以較大尺寸重疊在畫面上,當使用者點按收合按鈕,廣告就會恢復為較小尺寸。建議使用這項功能,進一步提升成效。詳情請參閱「可收合橫幅廣告」一文。
內嵌自動調整橫幅廣告
與錨定式自動調整橫幅廣告相比,內嵌自動調整橫幅廣告的版面更大、更高,且高度可變,甚至可與裝置螢幕同高。如果應用程式會在可捲動內容中放送橫幅廣告,內嵌自動調整橫幅廣告會是比錨定式更好的選擇。詳情請參閱「內嵌自動調整橫幅廣告」一文。