Tích hợp WebView API for Ads (API WebView cho quảng cáo)

API WebView cho quảng cáo cung cấp các tín hiệu ứng dụng cho thẻ trong WKWebView, giúp cải thiện khả năng kiếm tiền cho những nhà xuất bản đã cung cấp nội dung và bảo vệ nhà quảng cáo khỏi nội dung không thích hợp.

Cách hoạt động

Việc giao tiếp với SDK quảng cáo trên thiết bị di động của Google chỉ xảy ra khi phản hồi các sự kiện quảng cáo do bất kỳ sự kiện nào sau đây kích hoạt:

• Mã AdSense
• Thẻ nhà xuất bản của Google
• IMA cho HTML5

SDK sẽ thêm trình xử lý thông báo vào WKWebView đã đăng ký để theo dõi các sự kiện quảng cáo này. Để hiểu rõ hơn về cách hoạt động của chức năng này, hãy xem mã nguồn của trang thử nghiệm.

Cảnh báo: Đừng gọi removeAllScriptMessageHandlers() từ thực thể WKWebView vì điều này sẽ gây ra các hiệu ứng phụ ngoài ý muốn. Nếu cần, hãy gọi removeScriptMessageHandler(forName:) để xoá từng trình xử lý thông báo.

Điều kiện tiên quyết

• SDK Quảng cáo của Google trên thiết bị di động phiên bản 9.6.0 trở lên.

• Cập nhật tệp Info.plist bằng khoá và giá trị chuỗi sau. Thao tác này bỏ qua một bước kiểm tra mà SDK quảng cáo trên thiết bị di động của Google thực hiện đối với giá trị GADApplicationIdentifier áp dụng cho những nhà phát triển triển khai quảng cáo bên ngoài một khung hiển thị web. Nếu bạn bỏ qua bước này và không cung cấp GADApplicationIdentifier, thì SDK Quảng cáo của Google trên thiết bị di động sẽ gửi một GADInvalidInitializationException khi khởi động ứng dụng.

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

Đăng ký khung hiển thị web

Gọi register(_:) trên luồng chính để thiết lập kết nối với các trình xử lý JavaScript trong mã AdSense hoặc Thẻ nhà xuất bản của Google trong mỗi phiên bản WKWebView. Bạn nên thực hiện việc này càng sớm càng tốt, chẳng hạn như trong phương thức viewDidLoad của bộ điều khiển chế độ xem.

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];
}

Kiểm tra quá trình tích hợp

Trước khi sử dụng URL của riêng mình, bạn nên tải URL sau để kiểm tra quá trình tích hợp:

https://google.github.io/webview-ads/test/#api-for-ads-tests

URL kiểm thử sẽ hiển thị các thanh trạng thái màu xanh lục cho một hoạt động tích hợp thành công nếu bạn đáp ứng các điều kiện sau:

• WKWebView được kết nối với SDK Quảng cáo của Google trên thiết bị di động

Các bước tiếp theo

• Thu thập sự đồng ý trong WKWebView. API Web view cho Quảng cáo không truyền sự đồng ý được thu thập trong bối cảnh ứng dụng di động bằng cách sử dụng TCF phiên bản 2.0 của IAB hoặc khuôn khổ tuân thủ CCPA của IAB cho các thẻ trong thành phần hiển thị web của bạn. Nếu bạn muốn triển khai một quy trình đồng ý duy nhất với tư cách là chủ sở hữu của cả WKWebView và nội dung web tương ứng đang được kiếm tiền, hãy hợp tác với nền tảng quản lý sự đồng ý của bạn để thu thập sự đồng ý trong bối cảnh WKWebView.