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

API chế độ xem web dành cho quảng cáo giúp các tín hiệu ứng dụng có sẵn cho các 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 mánh khoé tăng thứ hạng.

Cách hoạt động

Hoạt động giao tiếp với SDK Quảng cáo của Google trên thiết bị di động chỉ diễn ra khi có quảng cáo sự kiện được kích hoạt bởi bất kỳ yếu tố nào sau đây:

SDK thêm trình xử lý thông báo vào WebView để theo dõi các sự kiện quảng cáo này. Để có trải nghiệm tốt 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 thử nghiệm.

Đ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 20.6.0 trở lên.
  • Android API cấp 21 trở lên.

  • Thêm thẻ <meta-data> sau đây trong tệp AndroidManifest.xml của bạn vào bỏ qua việc kiểm tra APPLICATION_ID. Nếu bạn bỏ lỡ bước này và không cung cấp thẻ <meta-data>, SDK quảng cáo trên thiết bị di động của Google sẽ gửi IllegalStateException khi khởi động ứng dụng.

    <!-- Bypass APPLICATION_ID check for web view APIs for ads -->
     <meta-data
         android:name="com.google.android.gms.ads.INTEGRATION_MANAGER"
         android:value="webview"/>
    

Đăng ký chế độ xem trên web

Gọi điện 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 WebView phiên bản. Chiến dịch này cần được thực hiện càng sớm càng tốt, chẳng hạn như trong Phương thức onCreate() cho MainActivity của bạn.

Java

import android.webkit.CookieManager;
import android.webkit.WebView;
import com.google.android.gms.ads.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);
  }
}

Kotlin

import android.webkit.CookieManager
import android.webkit.WebView
import com.google.android.gms.ads.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)

    // Enable third-party cookies.
    CookieManager.getInstance().setAcceptThirdPartyCookies(webView, true)
    // Enable JavaScript in the WebView.
    webView.settings.javaScriptEnabled = true
    // Enable DOM storage in the WebView.
    webView.settings.domStorageEnabled = true
    // Enable videos to play automatically.
    webView.settings.mediaPlaybackRequiresUserGesture = 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 đây để kiểm tra tích hợp:

https://webview-api-for-ads-test.glitch.me#api-for-ads-tests

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

  • WebView đã 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