集成适用于广告的 WebView API

适用于广告的 WebView API 可将应用信号提供给WKWebView中的代码,帮助提供内容的发布商提升创收效果,并保护广告客户免受垃圾内容的侵扰。这些应用信号(例如应用 ID 和应用版本)有助于启用报告定位应用内浏览器广告资源用例,而这些用例在其他情况下仅适用于应用流量。

运作方式

只有在响应以下任一事件触发的广告事件时,才会与 Google 移动广告 SDK 进行通信:

SDK 会向已注册的WKWebView 添加消息处理脚本,以监听这些广告事件。如需更好地了解其运作方式,请查看测试页面的源代码

前提条件

  • Google 移动广告 SDK 9.6.0 或更高版本。
  • 使用以下键和字符串值更新 Info.plist 文件。这会绕过 Google 移动广告 SDK 对 GADApplicationIdentifier 值的检查,该检查适用于在网页视图之外植入广告的开发者。如果您不执行此步骤,并且未提供 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 方法中执行。MainActivity

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.
    GADMobileAds.sharedInstance().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://webview-api-for-ads-test.glitch.me#api-for-ads-tests

如果满足以下条件,测试网址会显示绿色状态栏,表示集成成功:

  • WKWebView 已连接到 Google 移动广告 SDK

后续步骤

  • WKWebView中征求用户意见。Google Ads 的 WebView API 不会将使用 IAB TCF v2.0IAB CCPA 合规框架在移动应用情境中收集的意见传播到网页视图中的代码。如果您希望作为WKWebView 及其用于创收的相应网站内容的所有者,实现单一意见征求流程,请与您的意见征求管理平台合作,在 WKWebView 情境中征求用户意见。