שנתחיל?

要展示广告并赚取收入，第一步是将 Google 移动广告 SDK 集成到应用中。集成该 SDK 后，您就可以进而实施一种或多种支持的广告格式。

前提条件

• 使用 Xcode 15.3 或更高版本
• 定位到 iOS 12.0 或更高版本

导入移动广告 SDK

使用以下任一方法导入 Google 移动广告 SDK。

CocoaPods（首选）

如要将该 SDK 导入 iOS 项目，最简便的方法就是使用 CocoaPods。请打开项目的 Podfile 并将下面这行代码添加到应用的目标中：

pod 'Google-Mobile-Ads-SDK'

然后使用命令行运行以下命令：

pod install --repo-update

如果您刚开始接触 CocoaPods，请参阅其官方文档，了解如何创建和使用 Podfile。

Swift Package Manager

要点 ：Swift Package Manager 尚不支持中介适配器库。如果您使用中介，我们建议您与 CocoaPods 集成。

Google 移动广告 SDK 支持 9.0.0 及更高版本的 Swift Package Manager。请按照以下步骤导入 Swift 软件包：

注意 ：如果从基于 CocoaPods 的项目迁移，请运行 pod deintegrate，从您的 Xcode 项目中移除 CocoaPods。之后便可以安全地删除 CocoaPods 生成的 .xcworkspace 文件。如果您是首次在项目中添加 Google 移动广告 SDK，则可以忽略此步骤。

1. 在 Xcode 中，依次前往 File（文件）> Add Packages（添加软件包），安装 Google 移动广告 Swift 软件包。

2. 在显示的提示中，搜索 Google 移动广告 Swift 软件包的 GitHub 代码库：

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

3. 选择您要使用的 Google 移动广告 Swift 软件包版本。 对于新项目，我们建议使用 Up to Next Major Version。

完成之后，Xcode 将开始解析您的软件包依赖项，并在后台下载它们。如需详细了解如何添加软件包依赖项，请参阅 Apple 的文章。

手动下载

1. 下载 Google 移动广告 SDK，并Embed & Sign将以下框架导入您的 Xcode 项目中：

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. 在项目的 build 设置中：

   • 将 /usr/lib/swift 路径添加到 Runpath Search Paths。
   • 将 -ObjC 链接器标志添加到 Other Linker Flags。

更新您的 Info.plist

请更新应用的 Info.plist 文件以添加以下两个键：

1. 一个字符串值为您的Ad Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########的 GADApplicationIdentifier 键。

2. 一个 SKAdNetworkItems 键，其中 SKAdNetworkIdentifier 值为 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>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。

初始化移动广告 SDK

加载广告之前，请先调用 GADMobileAds.sharedInstance 的 startWithCompletionHandler: 方法，该方法将初始化相应 SDK，并在初始化完成后或 30 秒超时后回调完成处理程序。此操作只需执行一次，最好是在应用启动时执行。您应尽早调用 startWithCompletionHandler:。

警告 ：在调用 startWithCompletionHandler: 时，移动广告 SDK 或中介合作伙伴 SDK 可能会预加载广告。如果您需要获得欧洲经济区 (EEA) 用户的同意，请设置任何专门用于特定请求的标记（例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent），或者在加载广告之前采取任何其他相关操作，并确保在初始化移动广告 SDK 之前先完成这些操作。

以下示例演示了如何在 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

注意 ：如果您使用了中介功能，请等到调用完成处理程序后再加载广告，以确保初始化所有中介适配器。

选择广告格式

移动广告 SDK 现已导入并初始化，您随时可以植入广告了。 Ad Manager 提供了许多不同的广告格式，您可以根据您应用的用户体验选择最契合的一款。

对于 SwiftUI 开发者，请按照我们的 SwiftUI 指南操作。

横幅

横幅广告单元展示会占用应用的部分布局的矩形广告。它们可以在设定时段后自动刷新。也就是说，即使用户停留在应用中的同一个屏幕上，他们也会每隔一段时间就看到新广告。此种广告格式也是最容易植入的。

植入横幅广告

插页式广告

插页式广告单元用于在您的应用中展示全屏广告。请将这些广告单元放置在应用界面中的自然停顿点和过渡点，比如在游戏应用中过关后。

植入插页式广告

原生

原生广告是一种广告格式，您可以通过这种广告格式指定素材资源（如标题和号召性用语）在应用中的呈现方式。您可以自行设置广告样式，呈现出自然、不突兀的广告展示效果，从而使用户体验更加丰富。

Google Ad Manager 提供了两种植入原生广告的方法：原生样式和通过自定义呈现的标准原生广告。

原生样式旨在简化原生广告的植入过程。如果您刚接触原生广告，那么此方法是不错的选择。自定义呈现旨在为您提供尽可能大的自由发挥空间来呈现广告展示效果。

以原生样式植入 以原生广告（自定义呈现）植入

激励广告

激励广告单元可让用户通过玩游戏、接受调查或观看视频来获得游戏代币、额外的生命或积分等应用内奖励。您可以针对不同广告单元设置不同的奖励，并指定用户将会获得的奖励价值和奖品。

植入激励广告

插页式激励广告

插页式激励广告是一种激励用户的新型广告格式，采用这种格式时，您可以通过在应用中的自然过渡点自动展示的广告向用户提供奖励，如金币或额外的生命数。

与激励广告不同，用户无需自行选择即可观看插页式激励广告。

与激励广告中的选择观看提示不同，激励插页式广告需要一个介绍画面，其中显示提供的奖励，并可以让用户选择退出广告（如果他们想要退出）。

植入插页式激励广告

开屏广告

开屏广告是一种在用户打开或切换回您的应用时展示的广告格式。广告会叠加在加载屏幕上。

植入开屏广告