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

開始使用

在應用程式中整合 Google Mobile Ads SDK 是顯示廣告及賺取收益的第一步。整合 SDK 後，您就可以繼續導入一或多種支援的廣告格式。

必要條件

使用 Xcode 15.3 以上版本
指定 iOS 12.0 以上版本

匯入 Mobile Ads SDK

請使用下列任一方法匯入 Google Mobile Ads SDK。

CocoaPods (建議)

如要將 SDK 匯入 iOS 專案，最簡單的方法是使用 CocoaPods。開啟專案的 Podfile，然後將這行程式碼新增至應用程式的目標：

pod 'Google-Mobile-Ads-SDK'

然後在指令列中執行：

pod install --repo-update

如果您是 CocoaPods 新手，請參閱官方文件，瞭解如何建立及使用 Podfile。

Swift Package Manager

Google Mobile Ads SDK 9.0.0 以上版本支援 Swift Package Manager。請按照下列步驟匯入 Swift 套件：

在 Xcode 中，依序點選「File」>「Add Packages...」，即可安裝 Google 行動廣告 Swift Package。
在隨即顯示的提示中，搜尋 Google Mobile Ads Swift Package GitHub 存放區：
```
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
```
選取要使用的 Google Mobile Ads Swift 套件版本。對於新專案，建議您使用升級至下一個主要版本。

完成後，Xcode 就會開始解析套件依附元件，並在背景下載這些依附元件。如要進一步瞭解如何新增套件依附元件，請參閱 Apple 的文章。

手動下載

下載 Google Mobile Ads SDK 和 Embed & Sign 以下框架至 Xcode 專案：
- GoogleMobileAds.xcframework
- UserMessagingPlatform.xcframework
在專案的建構設定中：
- 將 /usr/lib/swift 路徑新增至「Runpath Search Paths」。
- 將 -ObjC 連結器旗標新增至「Other Linker Flags」。

更新 Info.plist

更新應用程式的 Info.plist 檔案，新增兩個鍵：

GADApplicationIdentifier 鍵，其字串值為Ad Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########。
SKAdNetworkItems 鍵，其中包含 Google (cstr6suwn9.skadnetwork) 和選定第三方買家的 SKAdNetworkIdentifier 值，這些買家已將這些值提供給 Google。

完整程式碼片段

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

為獲得最佳初始化效能，請務必將收益群組與其使用的特定應用程式建立關聯。針對 iOS 指定且未與任何特定應用程式建立關聯的收益群組設定，會傳送至帳戶中的所有 iOS 應用程式，這可能會延長初始化所需的時間。

在實際應用程式中，請將範例應用程式 ID 替換為實際的Ad Manager 應用程式 ID。如果您只是在 Hello World 應用程式中嘗試使用 SDK，可以使用範例 ID。

初始化 Mobile Ads SDK

請在載入廣告之前，對 GADMobileAds.sharedInstance 呼叫 startWithCompletionHandler: 方法，以便在初始化完成後 (或 30 秒逾時後) 初始化 SDK 並回呼完成處理常式。這項作業只需執行一次，最好是在應用程式啟動時執行。您應盡早呼叫 startWithCompletionHandler:。

以下範例說明如何在 AppDelegate 中呼叫 startWithCompletionHandler: 方法：

AppDelegate 範例 (節錄)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

SwiftUI

import GoogleMobileAds

class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

@main
struct YourApp: App {
  // To handle app delegate callbacks in an app that uses the SwiftUI lifecycle,
  // you must create an application delegate and attach it to your `App` struct
  // using `UIApplicationDelegateAdaptor`.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds.sharedInstance startWithCompletionHandler:nil];
  return YES;
}

@end

選取廣告格式

Mobile Ads SDK 現已匯入及初始化，您可以開始導入廣告。 Ad Manager 提供多種不同的廣告格式，您可以選擇最適合應用程式使用者體驗的廣告格式。

如果您是 SwiftUI 開發人員，請參閱 SwiftUI 指南。

橫幅廣告單元會占用應用程式的部分版面來顯示矩形廣告。且會固定在一段時間後自動重新整理。也就是說，即使使用者一直停留在應用程式的同一個畫面，每隔一段時間還是能看見新的廣告。這也是導入方式最簡單的廣告格式。

導入橫幅廣告

插頁式

您可以將插頁式廣告單元安插至使用者操作應用程式的空檔或轉換點 (例如通過遊戲應用程式關卡後)，在應用程式介面上顯示全版廣告。

導入插頁式廣告

原生

原生廣告可讓您自訂應用程式中廣告標題和行動號召等素材資源的呈現方式。您可以自行設定廣告樣式，打造自然且不顯眼的廣告呈現方式，為使用者帶來更豐富的體驗。

Google Ad Manager 提供兩種導入原生廣告的方式：原生樣式和透過自訂顯示的標準原生廣告。

原生樣式旨在簡化原生廣告的導入程序，如果您是這類格式的新手，不妨試試。自訂轉譯功能的設計目的，是讓您在製作簡報時享有最大的自由。

導入原生樣式導入原生廣告 (自訂顯示)

已獲得獎勵

獎勵廣告單元可讓使用者透過玩遊戲、參加問卷調查或觀看影片等方式，贏得應用程式內獎勵，例如金幣、額外生命數或積分。您可以為不同的廣告單元設定不同的獎勵，並指定使用者可獲得的獎勵價值和道具。

導入獎勵廣告

插頁式獎勵廣告

插頁式獎勵廣告是一種全新的獎勵廣告格式，您可在應用程式自然轉換時自動顯示這類廣告，向使用者提供獎勵，例如錢幣或額外生命。

與獎勵廣告不同的是，插頁式獎勵廣告不需要等使用者確定選擇觀看即可放送。

獎勵廣告會顯示選擇觀看的提示，但插頁式獎勵廣告則是顯示獎勵簡介畫面，而使用者可以選擇不要觀看廣告。

導入插頁式獎勵廣告

應用程式開啟

應用程式開啟頁面廣告格式會在使用者開啟或切換回應用程式時顯示，並疊加在載入畫面上。

導入應用程式開啟頁面廣告