שנתחיל?

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

前提条件

• 使用 Xcode 14.1 或更高版本
• 定位到 iOS 11.0 或更高版本

导入移动广告 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. 直接下载并解压缩 SDK 框架，然后将以下框架导入您的 Xcode 项目中：

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

2. 在项目的 build 设置中，将 -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 键，对于 Google (cstr6suwn9.skadnetwork) 以及向 Google 提供这些值的特定第三方买方，该值为 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>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>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>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>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>ecpz2srf59.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.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>gta9lk7p23.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 应用，这可能会延长初始化所需的时间。

要点 ：在真实应用中，请务必使用您的实际Ad Manager 应用 ID，而不是上面列出的 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.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

如果您使用的是中介功能，可能需要等到调用完成处理程序后再加载广告，因为这可确保初始化所有的中介适配器。

选择广告格式

现已导入并初始化移动广告 SDK，您随时可以植入广告了。 Ad Manager 它提供了多种不同的广告格式，您可以从中选择最适合您应用的用户体验的广告格式。

横幅

横幅广告是在设备屏幕的顶部或底部展示的矩形广告。用户与应用互动时，横幅广告会停留在界面上，并且可在一段时间后自动刷新。如果您刚开始接触移动广告，建议从横幅广告着手。

植入横幅广告

插页式广告

插页式广告是全屏广告，它会覆盖整个应用界面，直到用户将其关闭。 在应用执行流程的自然停顿点，例如游戏的不同关卡之间，或一项任务完成后，最适合投放这类广告。

植入插页式广告

原生

与您的应用外观和风格相符的可自定义的广告。您可以决定这类广告的投放方式和位置，从而使布局与应用的设计更加一致。

Google Ad Manager 提供了两种实现原生广告的方法：原生样式和自定义呈现。

原生样式旨在尽可能地简化原生广告的植入过程。如果您刚开始接触原生广告，这是不错的选择。自定义呈现的设计宗旨是尽可能让您能够自由地创建演示文稿。

实现原生样式

实现自定义呈现

已奖励

作为观看短视频以及与试玩广告和调查问卷互动的用户的奖励广告。适用于通过免费游戏用户创收。

植入激励广告

植入激励广告（新 API）