WebView のクリック動作を最適化する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
アプリで WebView
を使用してウェブ コンテンツを表示する場合は、次の理由からクリック動作の最適化を検討することをおすすめします。
WebView
は、クリックのリンク先が別のアプリの場合に広告で返される可能性があるカスタム URL スキームをサポートしていません。たとえば、Google Play のクリックスルー URL で market://
が使用されることがあります。
このガイドでは、ウェブビューのコンテンツを維持しながら、モバイル ウェブビューでのクリック動作を最適化するためのおすすめの手順について説明します。
前提条件
実装
WebView
インスタンスのクリック動作を最適化する手順は次のとおりです。
WebViewClient
で shouldOverrideUrlLoading()
をオーバーライドします。このメソッドは、現在の WebView
で URL が読み込まれようとしているときに呼び出されます。
クリック URL の動作をオーバーライドするかどうかを指定します。
コード例では、現在のドメインがターゲット ドメインと異なるかどうかを確認します。これは 1 つのアプローチにすぎません。使用する条件は異なる場合があります。
外部ブラウザ、Android カスタムタブ、または既存のウェブビュー内で URL を開くかどうかを決定します。このガイドでは、Android カスタムタブを起動して、サイトから移動する URL を開く方法について説明します。
サンプルコード
まず、モジュール レベルの build.gradle
ファイル(通常は app/build.gradle
)に androidx.browser
依存関係を追加します。カスタムタブには次のものが必要です。
dependencies {
implementation 'androidx.browser:browser:1.5.0'
}
次のコード スニペットは、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 and no scheme, return early.
if (request.getUrl().getHost() == null && request.getUrl().getScheme() == 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 and no scheme, return early.
if (request?.url?.host == null && request.url.scheme == null) {
return false
}
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
}
val targetDomain = request.url.host
// 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
}
}
}
}
ページ ナビゲーションをテストする
ページ ナビゲーションの変更をテストするには、
https://google.github.io/webview-ads/test/#click-behavior-tests
ウェブビューに渡すことができます。さまざまなリンクタイプをクリックして、アプリでの動作を確認します。
その際は、次の点をよくご確認ください。
- 各リンクは、意図した URL を開きます。
- アプリに戻ると、テストページのカウンタがゼロにリセットされず、ページの状態が保持されたことを確認できます。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-31 UTC。
[null,null,["最終更新日 2025-08-31 UTC。"],[[["\u003cp\u003eAndroid \u003ccode\u003eWebView\u003c/code\u003e has limitations with click behavior, like opening links in external browsers instead of within the app.\u003c/p\u003e\n"],["\u003cp\u003eThis guide provides steps to optimize click behavior by overriding \u003ccode\u003eshouldOverrideUrlLoading()\u003c/code\u003e in your \u003ccode\u003eWebViewClient\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize click handling to open links in external browsers, Custom Tabs, or within the \u003ccode\u003eWebView\u003c/code\u003e itself, based on the target URL.\u003c/p\u003e\n"],["\u003cp\u003eThe code examples demonstrate how to implement this functionality in both Java and Kotlin.\u003c/p\u003e\n"],["\u003cp\u003eTest your implementation using the provided test page to ensure links open as intended and the web view state is preserved.\u003c/p\u003e\n"]]],["`WebView` has limitations, including no tabbed browsing, no custom URL scheme support, and incompatibility with Google/Facebook Sign-in. To improve click behavior, override `shouldOverrideUrlLoading()` in `WebViewClient`. Check if the click URL's domain differs from the current domain. For external URLs, use Android Custom Tabs to maintain web view state. Custom URL schemes should launch corresponding apps via intent. Add the `androidx.browser` dependency. Test page navigation using `webview-api-for-ads-test.glitch.me`.\n"],null,["If your app utilizes\n[`WebView`](//developer.android.com/reference/android/webkit/WebView) to display web content, you might want\nto consider optimizing click behavior for the following reasons:\n\n- [`WebView`](//developer.android.com/reference/android/webkit/WebView) doesn't support [tabbed browsing](//developer.android.com/develop/ui/views/layout/webapps/webview#HandlingNavigation). Clicking a link opens the content in the default web browser.\n\n\u003c!-- --\u003e\n\n- `WebView` doesn't support [custom URL schemes](//developer.android.com/develop/ui/views/layout/webapps/webview#custom-urls) which could be returned in ads if the click destination is to a separate app. For example, a Google Play click-through URL might use `market://`.\n\n\n- [Google Sign-in](//developers.googleblog.com/2021/06/upcoming-security-changes-to-googles-oauth-2.0-authorization-endpoint.html) and [Facebook Sign-in](//developers.facebook.com/docs/facebook-login/android/deprecating-webviews#deprecating-facebook-login-support-on-android-webviews) aren't supported in `WebView`.\n\nThis guide provides recommended steps to optimize the click behavior in mobile\nweb views while preserving the web view content.\n\nPrerequisites\n\n- Complete the [Set up the web view](/ad-manager/mobile-ads-sdk/android/browser/webview) guide.\n\nImplementation\n\nFollow these steps to optimize the click behavior in your `WebView`\ninstance:\n\n1. Override [`shouldOverrideUrlLoading()`](//developer.android.com/reference/android/webkit/WebViewClient#shouldOverrideUrlLoading(android.webkit.WebView,%20android.webkit.WebResourceRequest))\n on the [`WebViewClient`](//developer.android.com/reference/kotlin/android/webkit/WebViewClient).\n This method is called when a URL is about to be loaded in the current\n `WebView`.\n\n2. Determine whether to override the behavior of the click URL.\n\n The [code example](#code_example) checks if the current domain is different\n than the target domain. This is just one approach as the criteria you use\n could vary.\n3. Decide whether to open the URL in an external browser, [Android Custom\n Tabs](//developer.chrome.com/docs/android/custom-tabs/), or within the\n existing web view. This guide shows how to open URLs navigating away from\n the site by launching Android Custom Tabs.\n\n\nCode example\n\nFirst add the `androidx.browser` dependency to your module-level `build.gradle`\nfile, typically `app/build.gradle`. This is required for Custom Tabs: \n\n dependencies {\n implementation 'androidx.browser:browser:1.5.0'\n }\n\nThe following code snippet shows how to implement `shouldOverrideUrlLoading()`: \n\nJava \n\n public class MainActivity extends AppCompatActivity {\n\n private WebView webView;\n\n protected void onCreate(Bundle savedInstanceState) {\n super.onCreate(savedInstanceState);\n\n // ... Register the WebView.\n\n webView = new WebView(this);\n WebSettings webSettings = webView.getSettings();\n webSettings.setJavaScriptEnabled(true);\n webView.setWebViewClient(\n new WebViewClient() {\n // 1. Implement the web view click handler.\n @Override\n public boolean shouldOverrideUrlLoading(\n WebView view,\n WebResourceRequest request) {\n // 2. Determine whether to override the behavior of the URL.\n // If the target URL has no host and no scheme, return early.\n if (request.getUrl().getHost() == null && request.getUrl().getScheme() == null) {\n return false;\n }\n\n // Handle custom URL schemes such as market:// by attempting to\n // launch the corresponding application in a new intent.\n if (!request.getUrl().getScheme().equals(\"http\")\n && !request.getUrl().getScheme().equals(\"https\")) {\n Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());\n // If the URL cannot be opened, return early.\n try {\n MainActivity.this.startActivity(intent);\n } catch (ActivityNotFoundException exception) {\n Log.d(\"TAG\", \"Failed to load URL with scheme:\" + request.getUrl().getScheme());\n }\n return true;\n }\n\n String currentDomain;\n // If the current URL's host cannot be found, return early.\n try {\n currentDomain = new URI(view.getUrl()).toURL().getHost();\n } catch (URISyntaxException | MalformedURLException exception) {\n // Malformed URL.\n return false;\n }\n String targetDomain = request.getUrl().getHost();\n\n // If the current domain equals the target domain, the\n // assumption is the user is not navigating away from\n // the site. Reload the URL within the existing web view.\n if (currentDomain.equals(targetDomain)) {\n return false;\n }\n\n // 3. User is navigating away from the site, open the URL in\n // Custom Tabs to preserve the state of the web view.\n CustomTabsIntent intent = new CustomTabsIntent.Builder().build();\n intent.launchUrl(MainActivity.this, request.getUrl());\n return true;\n }\n });\n }\n }\n\nKotlin \n\n class MainActivity : AppCompatActivity() {\n\n private lateinit var webView: WebView\n\n override fun onCreate(savedInstanceState: Bundle?) {\n super.onCreate(savedInstanceState)\n\n // ... Register the WebView.\n\n webView.webViewClient = object : WebViewClient() {\n // 1. Implement the web view click handler.\n override fun shouldOverrideUrlLoading(\n view: WebView?,\n request: WebResourceRequest?\n ): Boolean {\n // 2. Determine whether to override the behavior of the URL.\n // If the target URL has no host and no scheme, return early.\n if (request?.url?.host == null && request.url.scheme == null) {\n return false\n }\n val currentDomain = URI(view?.url).toURL().host\n\n // Handle custom URL schemes such as market:// by attempting to\n // launch the corresponding application in a new intent.\n if (!request.url.scheme.equals(\"http\") &&\n !request.url.scheme.equals(\"https\")) {\n val intent = Intent(Intent.ACTION_VIEW, request.url)\n // If the URL cannot be opened, return early.\n try {\n this@MainActivity.startActivity(intent)\n } catch (exception: ActivityNotFoundException) {\n Log.d(\"TAG\", \"Failed to load URL with scheme: ${request.url.scheme}\")\n }\n return true\n }\n\n val targetDomain = request.url.host\n\n // If the current domain equals the target domain, the\n // assumption is the user is not navigating away from\n // the site. Reload the URL within the existing web view.\n if (currentDomain.equals(targetDomain)) {\n return false\n }\n\n // 3. User is navigating away from the site, open the URL in\n // Custom Tabs to preserve the state of the web view.\n val customTabsIntent = CustomTabsIntent.Builder().build()\n customTabsIntent.launchUrl(this@MainActivity, request.url)\n return true\n }\n }\n }\n }\n\nTest your page navigation\n\nTo test your page navigation changes, load \n\n https://google.github.io/webview-ads/test#click-behavior-tests\n\ninto your web view. Click each of the different link types to see how they\nbehave in your app.\n\nHere are some things to check:\n\n- Each link opens the intended URL.\n- When returning to the app, the test page's counter doesn't reset to zero to validate the page state was preserved."]]