Jika aplikasi Anda menggunakan WebView
untuk menampilkan konten web, sebaiknya pertimbangkan untuk mengoptimalkan perilaku klik karena alasan berikut:
-
WebView
tidak mendukung penjelajahan dengan tab. Mengklik link akan membuka konten di browser web default.
WebView
tidak mendukung skema URL kustom yang dapat ditampilkan di iklan jika tujuan klik adalah ke aplikasi terpisah. Misalnya, URL klik-tayang Google Play mungkin menggunakanmarket://
.
- Login dengan Google
dan Login dengan Facebook
tidak
didukung di
WebView
.
Panduan ini memberikan langkah-langkah yang direkomendasikan untuk mengoptimalkan perilaku klik di tampilan web seluler sekaligus mempertahankan konten tampilan web.
Prasyarat
- Selesaikan panduan Menyiapkan tampilan web.
Penerapan
Ikuti langkah-langkah berikut untuk mengoptimalkan perilaku klik di instance WebView
:
Ganti
shouldOverrideUrlLoading()
diWebViewClient
. Metode ini dipanggil saat URL akan dimuat diWebView
saat ini.Tentukan apakah akan mengganti perilaku URL klik.
Contoh kode memeriksa apakah domain saat ini berbeda dengan domain target. Ini hanyalah salah satu pendekatan karena kriteria yang Anda gunakan dapat bervariasi.
Tentukan apakah akan membuka URL di browser eksternal, Tab kustom Android, atau dalam tampilan web yang ada. Panduan ini menunjukkan cara membuka URL yang keluar dari situs dengan meluncurkan Tab Kustom Android.
Contoh kode
Pertama, tambahkan dependensi androidx.browser
ke file build.gradle
level modul, biasanya app/build.gradle
. Hal ini diperlukan untuk Tab Kustom:
dependencies {
implementation 'androidx.browser:browser:1.5.0'
}
Cuplikan kode berikut menunjukkan cara mengimplementasikan shouldOverrideUrlLoading()
:
Java
public class MainActivity extends AppCompatActivity {
private WebView webView;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// ... Register the WebView.
webView = new WebView(this);
WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);
webView.setWebViewClient(
new WebViewClient() {
// 1. Implement the web view click handler.
@Override
public boolean shouldOverrideUrlLoading(
WebView view,
WebResourceRequest request) {
// 2. Determine whether to override the behavior of the URL.
// If the target URL has no host, return early.
if (request.getUrl().getHost() == null) {
return false;
}
// Handle custom URL schemes such as market:// by attempting to
// launch the corresponding application in a new intent.
if (!request.getUrl().getScheme().equals("http")
&& !request.getUrl().getScheme().equals("https")) {
Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
// If the URL cannot be opened, return early.
try {
MainActivity.this.startActivity(intent);
} catch (ActivityNotFoundException exception) {
Log.d("TAG", "Failed to load URL with scheme:" + request.getUrl().getScheme());
}
return true;
}
String currentDomain;
// If the current URL's host cannot be found, return early.
try {
currentDomain = new URI(view.getUrl()).toURL().getHost();
} catch (URISyntaxException | MalformedURLException exception) {
// Malformed URL.
return false;
}
String targetDomain = request.getUrl().getHost();
// If the current domain equals the target domain, the
// assumption is the user is not navigating away from
// the site. Reload the URL within the existing web view.
if (currentDomain.equals(targetDomain)) {
return false;
}
// 3. User is navigating away from the site, open the URL in
// Custom Tabs to preserve the state of the web view.
CustomTabsIntent intent = new CustomTabsIntent.Builder().build();
intent.launchUrl(MainActivity.this, request.getUrl());
return true;
}
});
}
}
Kotlin
class MainActivity : AppCompatActivity() {
private lateinit var webView: WebView
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// ... Register the WebView.
webView.webViewClient = object : WebViewClient() {
// 1. Implement the web view click handler.
override fun shouldOverrideUrlLoading(
view: WebView?,
request: WebResourceRequest?
): Boolean {
// 2. Determine whether to override the behavior of the URL.
// If the target URL has no host, return early.
request?.url?.host?.let { targetDomain ->
val currentDomain = URI(view?.url).toURL().host
// Handle custom URL schemes such as market:// by attempting to
// launch the corresponding application in a new intent.
if (!request.url.scheme.equals("http") &&
!request.url.scheme.equals("https")) {
val intent = Intent(Intent.ACTION_VIEW, request.url)
// If the URL cannot be opened, return early.
try {
this@MainActivity.startActivity(intent)
} catch (exception: ActivityNotFoundException) {
Log.d("TAG", "Failed to load URL with scheme: ${request.url.scheme}")
}
return true
}
// If the current domain equals the target domain, the
// assumption is the user is not navigating away from
// the site. Reload the URL within the existing web view.
if (currentDomain.equals(targetDomain)) {
return false
}
// 3. User is navigating away from the site, open the URL in
// Custom Tabs to preserve the state of the web view.
val customTabsIntent = CustomTabsIntent.Builder().build()
customTabsIntent.launchUrl(this@MainActivity, request.url)
return true
}
return false
}
}
}
}
Menguji navigasi halaman
Untuk menguji perubahan navigasi halaman, muat
https://webview-api-for-ads-test.glitch.me#click-behavior-tests
ke tampilan web Anda. Klik setiap jenis link yang berbeda untuk melihat perilakunya di aplikasi Anda.
Berikut ini beberapa hal yang perlu diperiksa:
- Setiap link akan membuka URL yang diinginkan.
- Saat kembali ke aplikasi, penghitung halaman pengujian tidak direset ke nol untuk memvalidasi status halaman yang dipertahankan.