開始使用

本指南的適用對象為想透過 AdMob 透過 iOS 應用程式營利,但他們不是使用 Firebase 的發布商。如果您打算在您的應用程式中加入 Firebase (或考慮考慮採用),請改為參閱本指南的 AdMob 與 Firebase 版本。

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

必要條件

  • 使用 Xcode 13.2.1 或更高版本
  • 指定 iOS 10.0 以上版本

匯入 Mobile Ads SDK

CocoaPods (建議使用)

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

pod 'Google-Mobile-Ads-SDK'

接著,透過指令列執行:

pod install --repo-update

如果你是初次使用 CocoaPods,請參閱官方說明文件,瞭解如何建立及使用 Podfiles。

Swift 套件管理員

從 9.0.0 版開始,Google Mobile Ads SDK 支援 Swift Package Manager。請按照下列步驟匯入 Swift 套件。

  1. 在 Xcode 中,瀏覽至 File > Add Packages...,然後安裝 Google Mobile Ads Swift Package。

  2. 在顯示的提示訊息中,搜尋 Google Mobile Ads Swift Package GitHub 存放區:

    https://github.com/googleads/swift-package-manager-google-mobile-ads.git
    
  3. 選取您要使用的 Google Mobile Ads Swift Package 版本。 如果是新專案,建議您使用至下一個主要版本

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

手動下載

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

    • GoogleAppMeasurement.xcframework
    • GoogleAppMeasurementIdentitySupport.xcframework
    • GoogleMobileAds.xcframework
    • GoogleUtilities.xcframework
    • nanopb.xcframework
    • PromisesObjC.xcframework
    • UserMessagingPlatform.xcframework
  2. -ObjC 連接器標記新增至專案的建構設定中的「其他連接器標記」

更新您的 Info.plist

更新應用程式的 Info.plist 檔案,即可新增兩個金鑰:

  1. 包含AdMob 應用程式 ID 字串值的 GADApplicationIdentifier 金鑰 (在AdMob UI 中可辨識)。
  2. 具有 Google SKAdNetworkIdentifier 值的 SKAdNetworkItems 金鑰 (cstr6suwn9.skadnetwork),並選取其他買家向 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>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>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>3sh42y64q3.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>prcb7njmu6.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>9rd848q2bz.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>n6fk4nfna4.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>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>av6w8kgt66.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>424m5254lk.skadnetwork</string>
    </dict>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>uw77j35x4d.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>3qcr597p9d.skadnetwork</string>
    </dict>
  </array>

如果您尚未建立 AdMob 帳戶註冊應用程式,現在就是絕佳的好時機。

初始化 Mobile Ads SDK

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

以下示範如何在 AppDelegate 中呼叫 startWithCompletionHandler: 方法:

AppDelegate.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)