API tampilan web untuk iklan membuat sinyal aplikasi tersedia untuk tag di
WebView
Anda, sehingga membantu meningkatkan monetisasi bagi
penayang yang menyediakan konten dan melindungi pengiklan dari spam.
Cara kerjanya
Komunikasi dengan Google Mobile Ads SDK hanya terjadi sebagai respons terhadap peristiwa iklan yang dipicu oleh salah satu hal berikut:
SDK menambahkan pengendali pesan keWebView
yang terdaftar untuk memproses peristiwa iklan ini. Untuk memahami
cara kerjanya yang lebih baik, lihat kode sumber
halaman pengujian.
Prasyarat
- Google Mobile Ads SDK versi 20.6.0 atau yang lebih tinggi.
Android API level 21 atau yang lebih tinggi.
Tambahkan tag
<meta-data>
berikut dalam fileAndroidManifest.xml
Anda agar mengabaikan pemeriksaanAPPLICATION_ID
. Jika Anda melewatkan langkah ini dan tidak memberikan tag<meta-data>
, Google Mobile Ads SDK akan menampilkanIllegalStateException
saat aplikasi dimulai.<!-- Bypass APPLICATION_ID check for web view APIs for ads --> <meta-data android:name="com.google.android.gms.ads.INTEGRATION_MANAGER" android:value="webview"/>
Mendaftarkan tampilan web
Panggil
registerWebView()
di thread utama untuk membuat koneksi dengan pengendali JavaScript di
kode AdSense atau Tag Google Publisher dalam setiap WebView
instance. Hal ini
harus dilakukan sedini mungkin, seperti dalam metode
onCreate()
dari MainActivity
Anda.
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)
}
}
Menguji integrasi Anda
Sebelum menggunakan URL Anda sendiri, sebaiknya muat URL berikut untuk menguji integrasi:
https://webview-api-for-ads-test.glitch.me#api-for-ads-tests
URL pengujian menampilkan status bar berwarna hijau untuk integrasi yang berhasil jika kondisi berikut berlaku:
WebView
terhubung ke Google Mobile Ads SDK
Langkah berikutnya
- Kumpulkan izin di
WebView
. Web View API for Ads tidak menerapkan izin yang dikumpulkan dalam konteks aplikasi seluler menggunakan framework kepatuhan TCF v2.0 IAB atau CCPA IAB ke tag di tampilan web Anda. Jika Anda tertarik untuk menerapkan alur izin tunggal sebagai pemilikWebView
dan konten webnya yang sesuai yang dimonetisasi, bekerja samalah dengan platform pengelolaan izin Anda untuk mengumpulkan izin sesuai konteksWebView
.