适用于广告的 WebView API 可让 WKWebView 中的代码使用应用信号,从而帮助提供内容的发布商提升创收效果,并保护广告客户免受垃圾内容的侵扰。 这些应用信号(例如应用 ID 和应用版本)有助于启用报告和定位应用内浏览器广告资源用例,而这些用例原本仅适用于应用流量。
运作方式
与 Google 移动广告 SDK 的通信仅在响应由以下任一因素触发的广告事件时发生:
SDK 会向已注册的 WKWebView
添加消息处理程序,以监听这些广告事件。如需更好地了解其运作方式,请查看测试页面的源代码。
前提条件
- Google 移动广告 SDK 9.6.0 或更高版本。
使用以下键和字符串值更新
Info.plist
文件。这会绕过 Google 移动广告 SDK 对GADApplicationIdentifier
值的检查,该值适用于在 WebView 之外实现广告的开发者。如果您不执行此步骤,未提供GADApplicationIdentifier
,Google 移动广告 SDK 会在应用启动时抛出GADInvalidInitializationException
。<!-- Indicate Google Mobile Ads SDK usage is only for web view APIs for ads --> <key>GADIntegrationManager</key> <string>webview</string>
注册 WebView
在主线程上调用 register(_:)
,以在每个 WKWebView
实例中与 AdSense 代码或 Google 发布商代码中的 JavaScript 处理程序建立连接。应尽早执行此操作,例如在视图控制器的 viewDidLoad
方法中执行。
Swift
import WebKit
class ViewController: UIViewController {
var webView: WKWebView!
override func viewDidLoad() {
super.viewDidLoad()
// Initialize a WKWebViewConfiguration object.
let webViewConfiguration = WKWebViewConfiguration()
// Let HTML videos with a "playsinline" attribute play inline.
webViewConfiguration.allowsInlineMediaPlayback = true
// Let HTML videos with an "autoplay" attribute play automatically.
webViewConfiguration.mediaTypesRequiringUserActionForPlayback = []
// Initialize the WKWebView with your WKWebViewConfiguration object.
webView = WKWebView(frame: view.frame, configuration: webViewConfiguration)
view.addSubview(webView)
// Register the web view.
MobileAds.shared.register(webView)
}
}
Objective-C
@import WebKit;
#import "ViewController.h"
@interface ViewController ()
@property(nonatomic, strong) WKWebView *webView;
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
// Initialize a WKWebViewConfiguration object.
WKWebViewConfiguration *webViewConfiguration = [[WKWebViewConfiguration alloc] init];
// Let HTML videos with a "playsinline" attribute play inline.
webViewConfiguration.allowsInlineMediaPlayback = YES;
// Let HTML videos with an "autoplay" attribute play automatically.
webViewConfiguration.mediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypeNone;
// Initialize the WKWebView with your WKWebViewConfiguration object.
self.webView = [[WKWebView alloc] initWithFrame:self.view.frame configuration:webViewConfiguration];
[self.view addSubview:self.webView];
// Register the web view.
[GADMobileAds.sharedInstance registerWebView:self.webView];
}
测试您的集成
在使用自己的网址之前,我们建议您加载以下网址来测试集成:
https://google.github.io/webview-ads/test/#api-for-ads-tests
如果符合以下条件,测试网址会显示绿色状态栏,表示集成成功:
WKWebView
已连接到 Google 移动广告 SDK
后续步骤
- 在
WKWebView
中征求用户意见。适用于广告的 WebView API 不会使用 IAB TCF v2.0 或 IAB CCPA 合规性框架将在移动应用情境中收集的用户意见传播到 WebView 中的代码。如果您是WKWebView
及其相应创收 Web 内容的所有者,并希望实现单一的意见征求流程,请与您的意见征求管理平台合作,在WKWebView
情境中征求用户意见。