橫幅廣告

選取平台: Android iOS Unity Flutter

橫幅廣告是矩形廣告,顯示時會占去應用程式的部分版面。使用者與應用程式互動時,這類廣告會在畫面頂端或底部固定顯示,或在使用者捲動畫面時隨著內容移動。橫幅廣告每過一段時間會自動重新整理,詳情請參閱「橫幅廣告總覽」一文。

本指南說明如何使用錨定自動調整橫幅廣告,讓這類廣告根據您指定的廣告寬度,在不同裝置上顯示合適大小的廣告,盡可能提高成效。

錨定自動調整橫幅廣告

不同於一般的固定大小廣告,錨定自動調整橫幅廣告採用固定顯示比例 (近似業界標準比例 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 加入檢視區塊階層後,請指定 heightwidth 值:

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 通訊協定的物件中,設定 GADBannerViewdelegate 屬性。一般來說,導入橫幅廣告的類別同時也是委派類別,在這種情況中,可以將 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 試用版應用程式中,導入橫幅廣告的委派方法。

Swift Objective-C

應用情境

以下舉幾個例子,說明這些廣告事件方法的應用情境。

將接收到的橫幅廣告加進檢視區塊階層

您可能希望等接收到廣告後,再將 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 方法。

如要接收各種因素 (包括廣告點擊) 觸發的顯示疊加元素或叫用外部瀏覽器事件,建議讓應用程式監聽與 UIViewControllerUIApplication 有相同作用的方法。下表列出的 iOS 方法可與 GADBannerViewDelegate 方法同時叫用,且作用完全一樣。

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

其他資源

GitHub 上的範例

後續步驟

可收合橫幅廣告

「可收合橫幅廣告」一開始顯示時,會以較大尺寸重疊在畫面上,當使用者點按收合按鈕,廣告就會恢復為較小尺寸。建議使用這項功能,進一步提升成效。詳情請參閱「可收合橫幅廣告」一文。

內嵌自動調整橫幅廣告

與錨定式自動調整橫幅廣告相比,內嵌自動調整橫幅廣告的版面更大、更高,且高度可變,甚至可與裝置螢幕同高。如果應用程式會在可捲動內容中放送橫幅廣告,內嵌自動調整橫幅廣告會是比錨定式更好的選擇。詳情請參閱「內嵌自動調整橫幅廣告」一文。

探索其他主題