開始使用

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

必要條件

  • 使用 Xcode 15.1 以上版本
  • 指定 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 新手,請參閱 CocoaPods 的官方說明文件,瞭解如何建立及使用 Podfiles。

Swift 套件管理員

自 9.0.0 版起,Google Mobile Ads SDK 可支援 Swift Package Manager。請按照下列步驟匯入 Swift 套件:

  1. 在 Xcode 中依序前往「File」>「Add Packages...」,安裝 Google Mobile Ads Swift 套件

  2. 在出現的提示中,搜尋 Google Mobile Ads Swift 套件 GitHub 存放區:

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

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

手動下載

  1. 直接下載並擷取 SDK 架構,然後將下列架構匯入您的 Xcode 專案:

    • GoogleMobileAds.xcframework
    • UserMessagingPlatform.xcframework
  2. 在專案建構設定中的「Other Linker Flags」中加入 -ObjC 連結器旗標:

更新 Info.plist

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

  1. 含有Ad Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########字串值的 GADApplicationIdentifier 鍵。

  2. 具有 SKAdNetworkIdentifier 值的 SKAdNetworkItems 鍵,代表 Google (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>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>

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

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

初始化 Mobile Ads SDK

載入廣告前,請先對 GADMobileAds.sharedInstance 呼叫 startWithCompletionHandler: 方法,此方法會初始化 SDK,並在初始化完成後 (或 30 秒逾時後) 回呼完成處理常式。這項動作只需執行一次,理想情況是在應用程式啟動時執行。您應盡快呼叫 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 現已匯入並初始化,可供您導入廣告。 Ad Manager 提供多種廣告格式,有助您選擇最適合應用程式使用者體驗的格式。

顯示在裝置螢幕頂端或底部的矩形廣告。 使用者與應用程式互動時,橫幅廣告會停留在畫面上,且會在一段時間後自動重新整理。如果您是第一次使用行動廣告 不妨從這裡著手

導入橫幅廣告

插頁式

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

導入插頁式廣告

原生

可自訂的廣告能融入應用程式的外觀和風格。廣告出現的方式和位置由您決定,可讓版面配置與應用程式設計更加一致。

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

原生樣式的設計可簡化原生廣告的導入程序,如果您是這種格式新手,不妨使用這個選項。自訂顯示功能的設計宗旨,就是讓您盡可能自由製作簡報。

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

已獲得獎勵

獎勵使用者觀看短片或與可試玩廣告和問卷調查互動的廣告。適合透過免費應用程式營利。

導入獎勵廣告