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

API khung hiển thị web cho quảng cáo cung cấp tín hiệu ứng dụng cho các thẻ trongWKWebView, giúp cải thiện khả năng kiếm tiền cho các 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 phù 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 để 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:

SDK sẽ thêm trình xử lý thông báo vàoWKWebView đã đă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 tính năng này, hãy xem mã nguồn của trang kiểm thử.

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

  • SDK quảng cáo trên thiết bị di động của Google 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 sẽ bỏ qua quy trình kiểm tra mà SDK quảng cáo của Google trên thiết bị di động thực hiện đối với giá trị GADApplicationIdentifier áp dụng cho các nhà phát triển triển khai quảng cáo bên ngoài khung hiển thị web. Nếu bạn bỏ qua bước này và không cung cấp GADApplicationIdentifier, SDK Quảng cáo của Google trên thiết bị di động sẽ gửi 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ý thành phần 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 thực thể 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 trình điều khiển thành phần hiển thị. Phương thức

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

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 tính năng tích hợp:

https://webview-api-for-ads-test.glitch.me#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 quá trình tích hợp thành công nếu các điều kiện sau đây được áp dụng:

  • WKWebView đã 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 thành phần hiển thị web cho Ads không truyền tín hiệu đồng ý được thu thập trong ngữ cảnh ứng dụng di động bằng cách sử dụng các khung tuân thủ IAB TCF phiên bản 2.0 hoặc IAB CCPA cho các thẻ trong thành phần hiển thị web. 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 làm việc với nền tảng quản lý sự đồng ý để thu thập sự đồng ý trong ngữ cảnh WKWebView .