本頁面由 Cloud Translation API 翻譯而成。

插頁式廣告

插頁式廣告是全螢幕廣告，會覆蓋應用程式介面，直到使用者關閉的內容這類廣告通常出現在應用程式的流程，例如活動之間或切換期間遊戲關卡使用者可選擇在應用程式顯示插頁式廣告時讓使用者輕觸廣告前往到達網頁，或關閉廣告並返回加入 App Engine 應用程式個案研究。

本指南說明如何將插頁式廣告整合至 iOS 應用程式。

必要條件

Google Mobile Ads SDK 8.0.0 以上版本。
完成入門指南。

一律使用測試廣告進行測試

建構及測試應用程式時，請務必使用測試廣告，而非現場及正式環境廣告否則可能導致帳戶遭到停權。

要載入測試廣告，最簡單的方法就是使用專屬測試廣告單元編號 iOS 插頁式廣告：
/21775744923/example/interstitial

這項機制經過特別設定，可針對每個請求傳回測試廣告在您的程式設計、測試和偵錯時，可以免費使用應用程式。只需製作務必先用廣告單元 ID 取代廣告單元，再發布應用程式。

若要進一步瞭解 Mobile Ads SDK 測試廣告的運作方式，請參閱：測試廣告。

導入作業

整合插頁式廣告的主要步驟如下：

載入廣告。
註冊回呼。
顯示廣告並處理獎勵事件。

載入廣告

系統會使用 load(adUnitID:request) 方法 GAMInterstitialAd 類別。

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var interstitial: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()

    Task {
      do {
        interstitial = try await GAMInterstitialAd.load(
          withAdUnitID: "/21775744923/example/interstitial", request: GAMRequest())
      } catch {
        print("Failed to load interstitial ad with error: \(error.localizedDescription)")
      }
    }
  }
}

SwiftUI

import GoogleMobileAds

class InterstitialViewModel: NSObject, GADFullScreenContentDelegate {
  private var interstitialAd: GADInterstitialAd?

  func loadAd() async {
    do {
      interstitialAd = try await GADInterstitialAd.load(
        withAdUnitID: "ca-app-pub-3940256099942544/4411468910", request: GADRequest())
      interstitialAd?.fullScreenContentDelegate = self
    } catch {
      print("Failed to load interstitial ad with error: \(error.localizedDescription)")
    }
  }InterstitialViewModel.swift

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GAMInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdManagerAdUnitID:@"/21775744923/example/interstitial"
      request:request
      completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
  }];
}

註冊回呼

您必須執行 GADFullScreenContentDelegate 通訊協定並指派給傳回廣告的 fullScreenContentDelegate 屬性。GADFullScreenContentDelegate 通訊協定會處理廣告呈現成功或失敗，以及廣告關閉時的回呼。下列程式碼顯示如何執行通訊協定，並將其指派給廣告：

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {

  private var interstitial: GAMInterstitialAd?

  override func viewDidLoad() {
    super.viewDidLoad()

    Task {
      do {
        interstitial = try await GAMInterstitialAd.load(
          withAdUnitID: "/21775744923/example/interstitial", request: GAMRequest())
        interstitial?.fullScreenContentDelegate = self
      } catch {
        print("Failed to load interstitial ad with error: \(error.localizedDescription)")
      }
    }
  }

  /// Tells the delegate that the ad failed to present full screen content.
  func ad(_ ad: GADFullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
    print("Ad did fail to present full screen content.")
  }

  /// Tells the delegate that the ad will present full screen content.
  func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad will present full screen content.")
  }

  /// Tells the delegate that the ad dismissed full screen content.
  func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad did dismiss full screen content.")
  }
}

SwiftUI

將 fullScreenContentDelegate 屬性指派給傳回的廣告：

interstitialAd?.fullScreenContentDelegate = selfInterstitialViewModel.swift

實作通訊協定：

func adDidRecordImpression(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidRecordClick(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func ad(
  _ ad: GADFullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("\(#function) called")
}

func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func adWillDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
}

func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
  print("\(#function) called")
  // Clear the interstitial ad.
  interstitialAd = nil
}InterstitialViewModel.swift

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController () <GADFullScreenContentDelegate>

@property(nonatomic, strong) GAMInterstitialAd *interstitial;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  GAMRequest *request = [GAMRequest request];
  [GAMInterstitialAd loadWithAdManagerAdUnitID:@"/21775744923/example/interstitial"
      request:request
      completionHandler:^(GAMInterstitialAd *ad, NSError *error) {
    if (error) {
      NSLog(@"Failed to load interstitial ad with error: %@", [error localizedDescription]);
      return;
    }
    self.interstitial = ad;
    self.interstitial.fullScreenContentDelegate = self;
  }];
}

/// Tells the delegate that the ad failed to present full screen content.
- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
    NSLog(@"Ad did fail to present full screen content.");
}

/// Tells the delegate that the ad will present full screen content.
- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad will present full screen content.");
}

/// Tells the delegate that the ad dismissed full screen content.
- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"Ad did dismiss full screen content.");
}

GAMInterstitialAd 是一次性的物件。這個這表示插頁式廣告一旦顯示，就無法再次顯示。最佳是在影片播放器中載入另一則插頁式廣告 GADFullScreenContentDelegate 的 adDidDismissFullScreenContent: 方法，因此上一個插頁式廣告剛好載入已關閉。

顯示廣告

插頁式廣告必須在應用程式流程中的自然暫停期間顯示。在遊戲關卡之間，或是使用者完成任務後，就是不錯的範例。

Swift

guard let interstitial = interstitial else {
  return print("Ad wasn't ready.")
}

// The UIViewController parameter is an optional.
interstitial.present(fromRootViewController: nil)

SwiftUI

監聽檢視畫面中的 UI 事件，決定廣告顯示的時機。

var body: some View {
  // ...
  }
  .onChange(of: countdownTimer.isComplete) { newValue in
    showGameOverAlert = newValue
  }
  .alert(isPresented: $showGameOverAlert) {
    Alert(
      title: Text("Game Over"),
      message: Text("You lasted \(countdownTimer.countdownTime) seconds"),
      dismissButton: .cancel(
        Text("OK"),
        action: {
          viewModel.showAd()
        }))InterstitialContentView.swift

從檢視模型呈現插頁式廣告：

func showAd() {
  guard let interstitialAd = interstitialAd else {
    return print("Ad wasn't ready.")
  }

  interstitialAd.present(fromRootViewController: nil)
}InterstitialViewModel.swift

Objective-C

if (self.interstitial) {
  // The UIViewController parameter is nullable.
  [self.interstitial presentFromRootViewController:nil];
} else {
  NSLog(@"Ad wasn't ready");
}

最佳做法

請思考插頁式廣告是否適合您應用程式的廣告類型。: 插頁式廣告最適合包含自然轉換點的應用程式。應用程式內的工作結論，例如分享圖片或完成就是所謂的遊戲層級由於使用者預期在您就能輕鬆顯示插頁式廣告，而且不會中斷無須專人管理請務必考慮在應用程式工作流程中的哪個階段顯示插頁式廣告以及使用者的回應方式
提醒您，顯示插頁式廣告時應將動作暫停。: 插頁式廣告有許多不同類型，包括文字、圖像、影片等。請務必確認應用程式顯示也會暫時停止使用部分資源，以便讓廣告善加利用這些原則舉例來說，如果您呼叫以顯示插頁式廣告，請務必暫停應用程式產生的任何音訊輸出。您可在以下位置繼續播放音效： adDidDismissFullScreenContent:敬上事件處理常式，系統會在使用者完成互動時叫用這個處理常式與廣告相關。此外，建議您暫時停止像是遊戲迴圈等作業這能確保使用者不會遇到執行速度緩慢或沒有回應的圖像，或發生延遲的情形影片。
提供足夠的載入時間。: 同樣重要的是，務必在並確保使用者不必費心等待載入完成在要顯示廣告之前先行載入，可確保應用程式在顯示插頁式廣告時，已準備好完整載入廣告。
不要讓應用程式廣告氾濫。: 雖然增加應用程式內插頁式廣告的顯示頻率，不但有助於增加收益，也可能損及使用者體驗導致點閱率降低確認使用者不常使用幹擾到使用者無法繼續使用您的應用程式。
請勿使用載入完成回呼來顯示插頁式廣告。: 這會對使用者體驗造成負面影響。請在表示需要出示的標誌接著檢查 canPresentFromRootViewController:error: 方法。「GAMInterstitialAd」看看是否已準備好。

GitHub 上的範例

查看您偏好的語言的完整插頁式廣告範例：

後續步驟

進一步瞭解廣告指定目標和插頁式廣告規範。
進一步瞭解使用者隱私權。