横幅广告是占据应用部分布局的矩形广告。他们 当用户与应用互动时停留在屏幕上（锚定在 或在用户滚动屏幕时内嵌到屏幕的顶部或底部。横幅 广告可以在一段时间后自动刷新。查看横幅广告概览 。
本指南介绍了如何开始使用锚定广告 自适应横幅广告 该功能可针对每种设备优化广告尺寸 指定广告宽度
锚定自适应横幅广告
锚定自适应横幅广告是宽高比固定的广告，而非常规的 固定尺寸广告。宽高比类似于业界标准的 320*50。一次 您指定了可用的全宽，系统会为您返回 高度。无论从哪个请求发送， 广告，并且当广告展示时，周围的视图无需移动 刷新。
前提条件
- 完成入门指南。
始终使用测试广告进行测试
在构建和测试应用时，请务必使用测试广告， 实际投放的广告。否则，可能会导致您的账号被暂停。
加载测试广告最简便的方法就是使用 iOS 专用的测试广告单元 ID
横幅广告：
/6499/example/adaptive-banner
该测试广告单元 ID 已经过专门配置，可为每个请求返回测试广告， 在自己应用的编码、测试和调试过程中随意使用。只需制作 请务必在发布应用前用您自己的广告单元 ID 替换该测试广告单元。
如需详细了解移动广告 SDK 的测试广告如何运作，请参阅测试 广告。
创建 GAMBannerView
横幅广告在GAMBannerView中展示
对象，因此集成横幅广告的第一步是添加一个 GAMBannerView
在视图层次结构中这通常通过编程方式
使用 Interface Builder
以程序化方式
您也可以直接将 GAMBannerView 实例化。
以下示例展示了如何创建 GAMBannerView。
与屏幕安全区域的底部中心对齐：
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController {
var bannerView: GAMBannerView!
override func viewDidLoad() {
super.viewDidLoad()
let viewWidth = view.frame.inset(by: view.safeAreaInsets).width
// Here the current interface orientation is used. Use
// GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth or
// GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth if you prefer to load an ad of a
// particular orientation,
let adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
bannerView = GAMBannerView(adSize: adaptiveSize)
addBannerViewToView(bannerView)
}
func addBannerViewToView(_ bannerView: GAMBannerView) {
bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)
view.addConstraints(
[NSLayoutConstraint(item: bannerView,
attribute: .bottom,
relatedBy: .equal,
toItem: view.safeAreaLayoutGuide,
attribute: .bottom,
multiplier: 1,
constant: 0),
NSLayoutConstraint(item: bannerView,
attribute: .centerX,
relatedBy: .equal,
toItem: view,
attribute: .centerX,
multiplier: 1,
constant: 0)
])
}
}
Objective-C
@import GoogleMobileAds;
@interface ViewController ()
@property(nonatomic, strong) GAMBannerView *bannerView;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Here safe area is taken into account, hence the view frame is used after the
// view has been laid out.
CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
CGFloat viewWidth = frame.size.width;
// Here the current interface orientation is used. If the ad is being preloaded
// for a future orientation change or different orientation, the function for the
// relevant orientation should be used.
GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
// In this case, we instantiate the banner with desired ad size.
self.bannerView = [[GAMBannerView alloc] initWithAdSize:adaptiveSize];
[self addBannerViewToView:self.bannerView];
}
- (void)addBannerViewToView:(UIView *)bannerView {
bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:bannerView];
[self.view addConstraints:@[
[NSLayoutConstraint constraintWithItem:bannerView
attribute:NSLayoutAttributeBottom
relatedBy:NSLayoutRelationEqual
toItem:self.view.safeAreaLayoutGuide
attribute:NSLayoutAttributeBottom
multiplier:1
constant:0],
[NSLayoutConstraint constraintWithItem:bannerView
attribute:NSLayoutAttributeCenterX
relatedBy:NSLayoutRelationEqual
toItem:self.view
attribute:NSLayoutAttributeCenterX
multiplier:1
constant:0]
]];
}
@end
请注意，在此示例中，我们没有指定宽度或高度限制，因为 将为横幅广告指定固有内容尺寸， 视图。
Interface Builder
可将 GAMBannerView 添加到故事板或 xib 中
文件。使用此方法时，请确保仅在
。例如，在
将横幅广告视图的底部设置为与底部对齐
布局指南，将中心 X 设置为与父视图的中心 X 相等。
横幅广告的广告尺寸仍以编程方式设置：
Swift
bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
Objective-C
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
加载广告
GAMBannerView 设置完毕及其属性后
就可以加载广告了可通过对loadRequest:
GAMRequest
对象：
Swift
override func viewDidLoad() {
super.viewDidLoad()
...
// Set the ad unit ID and view controller that contains the GAMBannerView.
bannerView.adUnitID = "/6499/example/adaptive-banner"
bannerView.rootViewController = self
bannerView.load(GAMRequest())
}
Objective-C
- (void)viewDidLoad {
[super viewDidLoad];
...
// Set the ad unit ID and view controller that contains the GAMBannerView.
self.bannerView.adUnitID = @"/6499/example/adaptive-banner";
self.bannerView.rootViewController = self;
[self.bannerView loadRequest:[GAMRequest request]];
}
GAMRequest 对象代表单个广告请求，而 包含定位信息等内容的属性。
如果您的广告加载失败，您无需再明确请求另一个广告，因为 但前提是您已将广告单元配置为刷新Google 移动广告 SDK 采用您在 Ad Manager 中指定的任何刷新率 界面。如果您尚未启用刷新，则需要发出新的请求。
广告事件
通过使用 GADBannerViewDelegate，您可以监听生命周期事件，
例如，当广告关闭或用户离开应用时。
注册横幅广告事件
要注册横幅广告事件，请将 delegate 属性设为
将 GAMBannerView 附加到实现
GADBannerViewDelegate 协议。一般情况下，使用横幅广告的类
ads 也充当代理类，在这种情况下，delegate 属性可以
设为 self。
Swift
import GoogleMobileAds
import UIKit
class ViewController: UIViewController, GADBannerViewDelegate {
var bannerView: GAMBannerView!
override func viewDidLoad() {
super.viewDidLoad()
...
bannerView.delegate = self
}
}
Objective-C
@import GoogleMobileAds;
@interface ViewController () <GADBannerViewDelegate>
@property(nonatomic, strong) GAMBannerView *bannerView;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
...
self.bannerView.delegate = self;
}
实现横幅广告事件
GADBannerViewDelegate 中的每个方法都标记为可选，因此您需要
只需实现您需要的方法即可。本示例实现了
并将消息记录到控制台：
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
print("bannerViewDidReceiveAd")
}
func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: Error) {
print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)")
}
func bannerViewDidRecordImpression(_ bannerView: GADBannerView) {
print("bannerViewDidRecordImpression")
}
func bannerViewWillPresentScreen(_ bannerView: GADBannerView) {
print("bannerViewWillPresentScreen")
}
func bannerViewWillDismissScreen(_ bannerView: GADBannerView) {
print("bannerViewWillDIsmissScreen")
}
func bannerViewDidDismissScreen(_ bannerView: GADBannerView) {
print("bannerViewDidDismissScreen")
}
Objective-C
- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
NSLog(@"bannerViewDidReceiveAd");
}
- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}
- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
NSLog(@"bannerViewDidRecordImpression");
}
- (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
NSLog(@"bannerViewWillPresentScreen");
}
- (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
NSLog(@"bannerViewWillDismissScreen");
}
- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
NSLog(@"bannerViewDidDismissScreen");
}
有关横幅广告委托方法的实现，请参阅广告委托示例 iOS API 演示应用。
使用场景
以下是这些广告事件方法的一些使用情形示例。
在收到广告后将横幅广告添加到视图层次结构中
您可能需要延迟将 GAMBannerView 添加到
视图层次结构，直到接收到广告为止。为此，您可以聆听
为 bannerViewDidReceiveAd: 事件添加以下代码：
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
// Add banner to view and add constraints as above.
addBannerViewToView(bannerView)
}
Objective-C
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
// Add bannerView to view and add constraints as above.
[self addBannerViewToView:self.bannerView];
}
以动画方式展示横幅广告
您还可以使用 bannerViewDidReceiveAd: 事件，为横幅广告设置一次动画效果
如下例所示：
Swift
func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
bannerView.alpha = 0
UIView.animate(withDuration: 1, animations: {
bannerView.alpha = 1
})
}
Objective-C
- (void)bannerViewDidReceiveAd:(GAMBannerView *)bannerView {
bannerView.alpha = 0;
[UIView animateWithDuration:1.0 animations:^{
bannerView.alpha = 1;
}];
}
暂停和恢复应用
GADBannerViewDelegate 协议提供了用于向您发送事件通知的方法，例如
就像点击会导致呈现或关闭叠加层一样。如果您想
跟踪这些事件是否由广告所致，注册这些事件
GADBannerViewDelegate 方法。
要捕获所有类型的叠加层演示或外部浏览器调用，
那么您的应用最好能监听用户点击广告后
UIViewController 或 UIApplication 上的等效方法。这是一张表格
显示了与
GADBannerViewDelegate 方法：
| GADBannerViewDelegate 方法 | iOS 方法 |
|---|---|
bannerViewWillPresentScreen: |
UIViewController 的 viewWillDisappear: |
bannerViewWillDismissScreen: |
UIViewController 的 viewWillAppear: |
bannerViewDidDismissScreen: |
UIViewController 的 viewDidAppear: |
手动统计展示
如果您有特殊的广告请求，可以手动向 Ad Manager 发送展示 ping
应记录展示的条件。为此，首先
在广告加载前为手动展示启用 GAMBannerView：
Swift
bannerView.enableManualImpressions = true
Objective-C
self.bannerView.enableManualImpressions = YES;
当您确定某个广告已成功返回并展示在屏幕上时 则可以手动触发展示：
Swift
bannerView.recordImpression()
Objective-C
[self.bannerView recordImpression];
应用事件
借助应用事件，您可以制作能够向应用代码发送消息的广告。通过 应用可以根据这些消息执行操作。
您可以使用 GADAppEventDelegate 监听 Ad Manager 所特有的应用事件。
这些事件可能会发生在广告生命周期内的任何时间，甚至是在调用
调用 GADBannerViewDelegate 对象的 bannerViewDidReceiveAd:。
Swift
// Implement your app event within this method. The delegate will be
// notified when the SDK receives an app event message from the ad.
// Called when the banner receives an app event.
optional public func bannerView(_ banner: GAMBannerView,
didReceiveAppEvent name: String, withInfo info: String?)
Objective-C
// Implement your app event within this method. The delegate will be
// notified when the SDK receives an app event message from the ad.
@optional
// Called when the banner receives an app event.
- (void)bannerView:(GAMBannerView *)banner
didReceiveAppEvent:(NSString *)name
withInfo:(NSString *)info;
您可以在视图控制器中实现应用事件方法：
Swift
import GoogleMobileAds
class ViewController: UIViewController, GADAppEventDelegate {
}
Objective-C
@import GoogleMobileAds;
@interface ViewController : UIViewController <GADAppEventDelegate> {
}
@end
请务必先使用 appEventDelegate 属性设置委托，然后再执行
请求广告
Swift
bannerView.appEventDelegate = self
Objective-C
self.bannerView.appEventDelegate = self;
以下示例展示了如何通过 通过应用事件指定颜色：
Swift
func bannerView(_ banner: GAMBannerView, didReceiveAppEvent name: String,
withInfo info: String?) {
if name == "color" {
guard let info = info else { return }
switch info {
case "green":
// Set background color to green.
view.backgroundColor = UIColor.green
case "blue":
// Set background color to blue.
view.backgroundColor = UIColor.blue
default:
// Set background color to black.
view.backgroundColor = UIColor.black
}
}
}
Objective-C
- (void)bannerView:(GAMBannerView *)banner
didReceiveAppEvent:(NSString *)name
withInfo:(NSString *)info {
if ([name isEqual:@"color"]) {
if ([info isEqual:@"green"]) {
// Set background color to green.
self.view.backgroundColor = [UIColor greenColor];
} else if ([info isEqual:@"blue"]) {
// Set background color to blue.
self.view.backgroundColor = [UIColor blueColor];
} else
// Set background color to black.
self.view.backgroundColor = [UIColor blackColor];
}
}
}
另外，以下是向
appEventDelegate:
<html>
<head>
<script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
<script>
document.addEventListener("DOMContentLoaded", function() {
// Send a color=green event when ad loads.
admob.events.dispatchAppEvent("color", "green");
document.getElementById("ad").addEventListener("click", function() {
// Send a color=blue event when ad is clicked.
admob.events.dispatchAppEvent("color", "blue");
});
});
</script>
<style>
#ad {
width: 320px;
height: 50px;
top: 0px;
left: 0px;
font-size: 24pt;
font-weight: bold;
position: absolute;
background: black;
color: white;
text-align: center;
}
</style>
</head>
<body>
<div id="ad">Carpe diem!</div>
</body>
</html>
有关应用事件的实现方式，请参阅 Ad Manager 应用事件示例 iOS API 演示应用。
其他资源
GitHub 上的示例
- 锚定自适应横幅广告示例： Swift | Objective-C
- 高级功能演示： Swift | Objective-C
后续步骤
折叠式横幅广告
折叠式横幅广告是一种横幅广告，初始展示时采用较大的 叠加层，以及一个可将广告合拢为较小尺寸的按钮。考虑使用 进一步优化广告效果如需了解详情，请参阅折叠式横幅广告。
内嵌自适应横幅广告
与锚定自适应横幅广告相比，内嵌自适应横幅广告是一种更大、更高的横幅广告 横幅广告。它们的高度可以调整，可以达到设备屏幕的高度。 对于以下情况，我们建议采用内嵌自适应横幅广告（而非锚定自适应横幅广告） 在可滚动内容中投放横幅广告的应用。请参阅内联自适应 横幅 。