集成适用于广告的 WebView API

适用于广告的网页视图 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>
    

注册网页视图

在主线程上调用 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.
    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 的网页视图 API 不会将使用 IAB TCF v2.0IAB CCPA 合规性框架在移动应用上下文中收集的用户意见征求传送到网站数据视图中的代码。如果您有兴趣以WKWebView 及其要用于创收的相应 Web 内容的所有者的身份实施单一的意见征求流程,请与您的意见征求管理平台配合使用,在 WKWebView 情境中征求用户意见。