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 WebView, 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. Những tín hiệu ứng dụng này (chẳng hạn như mã nhận dạng ứng dụng và phiên bản ứng dụng) giúp kích hoạt các trường hợp sử dụng Báo cáo và Nhắm mục tiêu khoảng không quảng cáo trên trình duyệt trong ứng dụng mà nếu không thì chỉ có trên lưu lượng truy cập ứng dụng.

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 (phiên bản thử nghiệm) chỉ diễn 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ào WebView đã đă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 kiểm thử.

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

Truyền mã ứng dụng đến SDK

Nếu bạn đã có mã ứng dụng Ad Manager, hãy khởi chạy SDK Quảng cáo của Google trên thiết bị di động (beta) bằng mã ứng dụng hiện có.

Nếu bạn không có mã ứng dụng Ad Manager, hãy truyền InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID làm mã ứng dụng khi bạn khởi chạy SDK Quảng cáo của Google trên thiết bị di động (beta).

Kotlin

MobileAds.initialize(
    this@MainActivity,
    // Use this application ID to initialize the Google Mobile Ads SDK (beta) if
    // you don't have an Ad Manager application ID.
    InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
  ) {
    // Adapter initialization complete.
  }

Java

MobileAds.initialize(
    this,
    // Use this application ID to initialize the Google Mobile Ads SDK (beta) if
    // you don't have an Ad Manager application ID.
    new InitializationConfig.Builder(InitializationConfig.WEBVIEW_APIS_FOR_ADS_APPLICATION_ID)
        .build(),
        initializationStatus -> {
          // Adapter initialization is complete.
          });

Đăng ký chế độ xem web

Gọi registerWebView() 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 WebView. 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 onCreate() của MainActivity.

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.libraries.ads.mobile.sdk.MobileAds

class MainActivity : AppCompatActivity() {
  lateinit var webView: WebView

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    webView = findViewById(R.id.webview)

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Let the web view use JavaScript.
    webView.settings.javaScriptEnabled = true
    // Let the web view access local storage.
    webView.settings.domStorageEnabled = true
    // Let HTML videos play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = false

    // Register the web view.
    MobileAds.registerWebView(webView)
  }
}

Java

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.libraries.ads.mobile.sdk.MobileAds;

public class MainActivity extends AppCompatActivity {
  private WebView webView;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    webView = findViewById(R.id.webview);

    // Let the web view accept third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true);
    // Let the web view use JavaScript.
    webView.getSettings().setJavaScriptEnabled(true);
    // Let the web view access local storage.
    webView.getSettings().setDomStorageEnabled(true);
    // Let HTML videos play automatically.
    webView.getSettings().setMediaPlaybackRequiresUserGesture(false);

    // Register the web view.
    MobileAds.registerWebView(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 quy trình tích hợp thành công nếu bạn đáp ứng các điều kiện sau:

  • WebView được kết nối với SDK quảng cáo trên thiết bị di động của Google (thử nghiệm)

Các bước tiếp theo

  • Thu thập sự đồng ý trong WebView. API WebView 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ả WebView 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 WebView.
Trước
Thiết lập WebView
Tiếp
Tối ưu hoá hành vi nhấp chuột