Halaman ini diterjemahkan oleh Cloud Translation API.

Mengintegrasikan WebView API untuk Ads

WebView API untuk Iklan memungkinkan monetisasi iklan dalam aplikasi menggunakan WebViewController. Jika Anda menampilkan konten web yang menerapkan iklan dengan kode AdSense atau Tag Google Publisher di aplikasi melalui WebViewController, Anda harus menggunakan API ini untuk mengaktifkan monetisasi iklan. Untuk mempelajari lebih lanjut, lihat Kebijakan AdSense dan Ad Manager.

Melakukan monetisasi dengan membuat permintaan iklan menggunakan Google Mobile Ads SDK

Anda dapat memonetisasi aplikasi dengan membuat permintaan iklan ke Ad Manager dengan Google Mobile Ads SDK dengan menerapkan format iklan untuk aplikasi seluler.
Pelajari lebih lanjut.
Memonetisasi dengan menggunakan WebView API untuk Iklan

Jika aplikasi Anda menggunakan WebViewController untuk menampilkan konten web yang menayangkan iklan dari Ad Manager atau AdSense, gunakan WebView API for Ads untuk mendaftarkan objek WebViewController dengan Google Mobile Ads SDK. JavaScript dalam kode AdSense atau Tag Google Publisher membuat dan mengirim permintaan iklan sehingga Anda tidak perlu membuat permintaan iklan apa pun dengan SDK. Perhatikan bahwa hanya format inventaris web seluler dan web desktop yang tersedia menggunakan API ini.

Jika bukan pemilik konten web di WebViewController, Anda tetap dianjurkan untuk menggunakan API ini untuk membantu melindungi pengiklan dari spam dan meningkatkan monetisasi bagi penayang web yang menyediakan konten tersebut.

Perhatikan bahwa Anda dapat melakukan salah satu opsi, atau bahkan keduanya, di aplikasi yang sama.

Panduan ini ditujukan untuk membantu Anda mengintegrasikan WebView API untuk Iklan ke dalam aplikasi iOS.

Sebelum memulai

Sebelum mulai menggunakan WebView API untuk Iklan, pastikan Anda melakukan hal berikut:

Gunakan plugin Google Mobile Ads SDK untuk Flutter dengan versi 3.0.0 atau yang lebih tinggi di aplikasi Anda.
Tambahkan webview_flutter sebagai dependensi dalam file pubspec.yaml.
Tambahkan webview_flutter_android dengan versi 3.7.0 atau yang lebih baru di aplikasi Anda.

Abaikan pemeriksaan ID aplikasi

Android

Tambahkan tag <meta-data> berikut di file AndroidManifest.xml untuk mengabaikan pemeriksaan APPLICATION_ID. Jika Anda melewatkan langkah ini, Google Mobile Ads SDK mungkin menampilkan IllegalStateException saat aplikasi dimulai.

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

iOS

Update file Runner/Info.plist dengan kunci dan nilai string di bawah untuk mengabaikan pemeriksaan GADApplicationIdentifier. Jika Anda melewatkan langkah ini, Google Mobile Ads SDK mungkin menampilkan GADInvalidInitializationException saat aplikasi dimulai.

<!-- Bypass GADApplicationIdentifier check for WebView API for Ads -->
<key>GADIntegrationManager</key>
<string>webview</string>

Mendaftarkan WebViewController

Untuk meningkatkan monetisasi iklan dalam aplikasi pada iklan dalam WebViewController yang menggunakan kode AdSense atau Tag Google Publisher, ikuti langkah-langkah yang tercantum di bawah:

Aktifkan JavaScript di WebViewController. Jika hal ini tidak dilakukan, iklan tidak akan dimuat.
Untuk meningkatkan pengalaman iklan pengguna dan konsisten dengan kebijakan cookie Chrome, aktifkan cookie pihak ketiga pada instance AndroidWebViewController Anda.
Daftarkan instance WebViewController dengan memanggil metode registerWebView() yang disediakan oleh Google Mobile Ads SDK.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';

@override
class WebViewExampleState extends State<WebViewExample> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();

    createWebView();
  }

  void createWebView() async {
    controller = WebViewController();
    // 1. Enable JavaScript in the web view.
    await controller.setJavaScriptMode(JavaScriptMode.unrestricted);

    // 2. Enable third-party cookies for Android.
    if (controller.platform is AndroidWebViewController) {
      AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
        const PlatformWebViewCookieManagerCreationParams());
      await cookieManager.setAcceptThirdPartyCookies(
        controller.platform as AndroidWebViewController, true);
    }

    // 3. Register the web view.
    await MobileAds.instance.registerWebView(controller);
  }
}

Memuat URL

Anda kini dapat memuat URL dan menampilkan konten web melalui WebViewController. Sebaiknya muat URL pengujian ini: https://webview-api-for-ads-test.glitch.me/ untuk menguji integrasi sebelum menggunakan URL Anda sendiri. Halaman web akan menampilkan error jika JavaScript tidak diaktifkan.

import 'package:google_mobile_ads/google_mobile_ads.dart';
import 'package:webview_flutter/webview_flutter.dart';
import 'package:webview_flutter_android/webview_flutter_android.dart';

@override
class WebViewExampleState extends State<WebViewExample> {
  late final WebViewController controller;

  @override
  void initState() {
    super.initState();

    createWebView();
  }

  void createWebView() async {
    controller = WebViewController();
    // 1. Enable JavaScript in the web view.
    await controller.setJavaScriptMode(JavaScriptMode.unrestricted);

    // 2. Enable third-party cookies for Android.
    if (controller.platform is AndroidWebViewController) {
      AndroidWebViewCookieManager cookieManager = AndroidWebViewCookieManager(
        const PlatformWebViewCookieManagerCreationParams());
      await cookieManager.setAcceptThirdPartyCookies(
        controller.platform as AndroidWebViewController, true);
    }

    // 3. Register the web view.
    await MobileAds.instance.registerWebView(controller);

    // 4. Load the URL.
    await controller.loadRequest(Uri.parse('https://webview-api-for-ads-test.glitch.me/'));
  }

URL pengujian menampilkan status bar hijau untuk integrasi yang berhasil jika kondisi berikut berlaku:

WebView terhubung ke Google Mobile Ads SDK
JavaScript diaktifkan
Cookie pihak ketiga berfungsi (tidak diharapkan di perangkat iOS)
Cookie pihak pertama berfungsi

Lihat kode sumber URL pengujian kami. Anda dapat mengganti URL pengujian dengan URL Anda. Anda juga dapat menggunakan alat proxy seperti Charles untuk merekam traffic HTTPS aplikasi dan memeriksa permintaan iklan untuk parameter &scar=.