開始使用

本指南適用於想透過 AdMob 透過 AdMob 透過 iOS 應用程式營利，且未使用 Firebase 的發布商。如果您計劃將 Firebase 加入應用程式 (或您打算這麼做)，請改為參閱本指南的「AdMob 搭配 Firebase 」版本。

將 Google Mobile Ads SDK 整合至應用程式，是顯示廣告並賺取收益的第一步。整合 SDK 後，您就可以繼續進行一或多個支援的廣告格式。

必要條件

• 使用 Xcode 14.1 以上版本
• 指定 iOS 11.0 以上版本

• 建議做法：建立 AdMob 帳戶並註冊應用程式。

匯入 Mobile Ads SDK

CocoaPods (建議)

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

pod 'Google-Mobile-Ads-SDK'

接著，從指令列執行：

pod install --repo-update

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

Swift 套件管理員

重點： Swift Package Manager 尚未提供中介服務轉接程式程式庫。如果您使用中介服務，建議與 CocoaPods 整合。

從 9.0.0 版開始，Google Mobile Ads SDK 支援 Swift 套件管理工具。請按照下列步驟匯入 Swift 套件。

注意： 如要從 CocoaPods 為基礎的專案遷移，請執行 pod deintegrate，將 CocoaPods 從您的 Xcode 專案中移除。您可以放心刪除 CocoaPods 產生的 .xcworkspace 檔案。如果您是第一次將 Google Mobile Ads SDK 新增至專案，可以忽略這個步驟。

1. 在 Xcode 中，前往「File」>「Add Packages...」，安裝 Google 行動廣告 Swift 套件。

2. 在隨即顯示的提示中，搜尋 Google Mobile Ads Swift 套件 GitHub 存放區：

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

3. 選取您要使用的 Google 行動廣告 Swift 套件版本。 如果是新專案，建議使用下一個主要版本。

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

手動下載

1. 直接下載 SDK 架構並解壓縮，然後將下列架構匯入 Xcode 專案：

   • GoogleAppMeasurement.xcframework
   • GoogleAppMeasurementIdentitySupport.xcframework
   • GoogleMobileAds.xcframework
   • GoogleUtilities.xcframework
   • nanopb.xcframework
   • PromisesObjC.xcframework
   • UserMessagingPlatform.xcframework

2. 在專案建構設定中的「Other Linker Flags」(其他連結器旗標) 中加入 -ObjC 連結器旗標：

   

更新 Info.plist

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

1. GADApplicationIdentifier 鍵，字串值為AdMob app ID found in the AdMob UI。

2. SKAdNetworkItems 鍵，適用於 Google (cstr6suwn9.skadnetwork) 和特定第三方買方已提供這些值。SKAdNetworkIdentifier

完整程式碼片段

<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>4pfyvq9l8r.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>5a6flpkh64.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>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.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>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.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>n6fk4nfna4.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>eh6m2bh4zr.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>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ecpz2srf59.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>mlmmfzh3r3.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>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>zq492l623r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

如果您尚未建立 AdMob 帳戶並註冊應用程式，現在正是時候。

重點： 在實際的應用程式中，請務必使用實際AdMob 應用程式 ID，而非上列所列的 ID。不過，如果您只想在 Hello World 應用程式中使用 SDK，可以使用上述的範例應用程式 ID。

初始化 Mobile Ads SDK

載入廣告前，請先呼叫 GADMobileAds.sharedInstance 上的 startWithCompletionHandler: 方法，此方法會初始化 SDK，並在初始化完成後 (或 30 秒逾時後) 傳回完成處理常式。只需完成一次即可，最好在應用程式啟動時完成。您應盡早呼叫 startWithCompletionHandler:。

警告： 廣告 SDK 或中介服務合作夥伴 SDK 可能會在呼叫 startWithCompletionHandler: 時預先載入廣告。如需向歐洲經濟區 (EEA) 境內的使用者取得同意聲明、設定任何請求專用的旗標 (例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent)，或在載入廣告前採取行動，請務必先完成相關作業，再初始化 Mobile Ads SDK。

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

AppAssign.m 範例 (摘錄)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

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

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

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

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

@end

如果您目前使用中介服務，請等到呼叫完成處理常式後再載入廣告，這樣可確保所有中介服務轉接程式都會初始化。

選取廣告格式

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

橫幅廣告

顯示在裝置畫面頂端或底部的矩形廣告。 使用者與應用程式互動時，橫幅廣告會留在畫面中，且可以在一段時間後自動重新整理。如果你是行動廣告的新手，不妨先從這裡開始。

導入橫幅廣告

插頁式

覆蓋應用程式介面的全螢幕廣告，直到使用者關閉為止。 這種模式最適合用於應用程式執行流程中的自然暫停點，例如在遊戲關卡之間，或剛完成任務之後才顯示。

導入插頁式廣告

原生

可自訂符合應用程式外觀與風格的可自訂廣告。廣告出現的方式和位置都由您決定，因此可讓廣告和應用程式設計的版面配置更加一致。

導入 Native Ads

已獲得獎勵

為吸引使用者觀看短片、與可試玩廣告及問卷調查互動的廣告提供獎勵。適合透過免費遊戲使用者營利。

導入獎勵廣告

導入獎勵廣告 (新 API)