要展示广告并赚取收入,第一步是将 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
从 9.0.0 版开始,Google 移动广告 SDK 支持 Swift Package Manager。如需导入 Swift 软件包,请按以下步骤操作:
在 Xcode 中,依次转到 File(文件)> Add Packages...(添加软件包...),以安装 Google Mobile Ads Swift Package。
在显示的提示中,搜索 Google 移动广告 Swift 软件包 GitHub 代码库:
https://github.com/googleads/swift-package-manager-google-mobile-ads.git
选择您要使用的 Google 移动广告 Swift 软件包版本。 对于新项目,我们建议使用 Up to Next Major Version。
完成之后,Xcode 将开始解析您的软件包依赖项,并在后台下载它们。如需详细了解如何添加软件包依赖项,请参阅 Apple 的文章。
手动下载
下载 Google 移动广告 SDK 并将以下框架
Embed & Sign
下载到您的 Xcode 项目中:GoogleMobileAds.xcframework
UserMessagingPlatform.xcframework
在项目的 build 设置中,将
-ObjC
链接器标志添加到 Other Linker Flags(其他链接器标志):
更新您的 Info.plist
更新应用的 Info.plist
文件以添加两个键:
一个字符串值为Ad Manager app ID found in the Ad Manager UI and of the form
ca-app-pub-################~##########
的GADApplicationIdentifier
键。一个
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>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。
初始化移动广告 SDK
加载广告之前,请先对 GADMobileAds.sharedInstance
调用 startWithCompletionHandler:
方法,该方法会初始化 SDK,并在初始化完成后或 30 秒超时后回调完成处理程序。此操作只需执行一次,最好是在应用启动时执行。您应尽早调用 startWithCompletionHandler:
。
以下示例展示了如何在 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 提供了两种植入原生广告的方法:原生样式和采用自定义呈现的标准原生广告。
原生样式旨在简化原生广告的植入方式,如果您刚开始接触原生广告,这种样式是理想之选。自定义呈现旨在让您自由地制作演示文稿。
已奖励
激励广告单元允许用户玩游戏、参与调查或观看视频,以赚取金币、额外的生命或积分等应用内奖励。您可以为不同的广告单元设置不同的奖励,并指定用户收到的奖励价值和奖品。
插页式激励广告
插页式激励广告是一种激励用户的新型广告格式,采用这种格式时,您可以通过在应用中的自然过渡点自动展示的广告向用户提供奖励,如金币或额外的生命数。
与激励广告不同,用户无需自行选择即可观看插页式激励广告。
与激励广告中的选择观看提示不同,插页式激励广告需要一个介绍画面,用于公告奖励并为用户提供选择退出的选项(如果他们想要退出)。
开屏广告
开屏广告是一种广告格式,会在用户打开或切换回您的应用时显示。广告会叠加在加载屏幕上。