整合廣告適用的 WebView API

WebView API for Ads 可讓應用程式信號提供給WKWebView中的代碼,協助提供內容的發布商改善營利,並保護廣告客戶免受垃圾內容干擾。

運作方式

與 Google Mobile Ads SDK 的通訊僅會在下列任一事件觸發時發生:

SDK 會將訊息處理常式新增至已註冊的WKWebView ,以便監聽這些廣告事件。如要進一步瞭解這項功能的運作方式,請查看測試頁面的原始碼

必要條件

  • Google Mobile Ads SDK 7.67.0 以上版本 9.6.0 。
  • 請使用下列鍵和字串值更新 Info.plist 檔案。這會略過 Google Mobile Ads SDK 對 GADApplicationIdentifier 值的檢查,適用於在網頁檢視畫面外部導入廣告的開發人員。如果您未完成這個步驟,且未提供 GADApplicationIdentifier,Google Mobile Ads SDK 就會在應用程式啟動時擲回 GADInvalidInitializationException

    <!-- Indicate Google Mobile Ads SDK usage is only for web view APIs for ads -->
    <key>GADIntegrationManager</key>
    <string>webview</string>
    

註冊網頁檢視畫面

在主執行緒上呼叫 register(_:) ,以便與 AdSense 程式碼中的 JavaScript 處理常式或各個 WKWebView 例項中的 Google 發布者代碼建立連線。這項操作應盡早完成,例如在 View Controller 的 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 Mobile Ads SDK

後續步驟

  • WKWebView中收集同意聲明。廣告的網路檢視畫面 API 不會將使用 IAB 資訊公開和同意聲明架構第 2.0 版IAB 消費者隱私權和安全法案 法規遵循架構,在行動應用程式情境中收集到的同意聲明,傳播至網路檢視畫面中的代碼。如果您想在實施單一同意聲明流程時,同時擁有WKWebView 和對應的網站內容,並且要將這些內容營利,請與同意聲明管理平台合作,在 WKWebView 情境中收集同意聲明。