集成适用于广告的 WebView API

适用于广告的 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.0IAB CCPA 合规性框架将在移动应用情境中收集的用户意见传播到 WebView 中的代码。如果您是 WKWebView 及其相应创收 Web 内容的所有者,并希望实现单一的意见征求流程,请与您的意见征求管理平台合作,在 WKWebView 情境中征求用户意见。