WebView のクリック動作を最適化する

アプリで Android WebView ウェブ コンテンツを表示するには、 をご活用ください。

  • WebView は同意しない タブ形式ブラウジングを サポートします。 リンクをクリックすると、デフォルトのウェブブラウザでコンテンツが開きます。
  • WebViewカスタム URL スキームをサポートしていません。 これらの識別子は、クリックのリンク先が別のアプリである場合に広告で返される可能性があります。 たとえば、Google Play のリンク先 URL では market:// を使用できます。

このガイドでは、モバイルでのクリック動作を最適化するための推奨手順を説明します ウェブビューのコンテンツは保持されます。

前提条件

実装

以下の手順で、 WebView インスタンス:

  1. shouldOverrideUrlLoading() をオーバーライドする WebViewClient。 このメソッドは、URL が現在の WebView

  2. クリック URL の動作を上書きするかどうかを指定します。

    以下のコード スニペットでは、現在のドメインが ターゲット ドメインです。使用する基準はさまざまであるため、これはあくまでも 1 つの方法です。

  3. 外部ブラウザの URL(Android カスタム)で開くかどうかを決定します。 タブ内、または クリックしますこのガイドでは、別のドメインに移動する URL を開く方法を Android カスタムタブをリリースします

サンプルコード

まず、androidx.browser 依存関係をモジュール レベルの build.gradle に追加します。 ファイル。通常は app/build.gradle です。これはカスタムタブに必須です。

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, 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
      }
    }
  }
}

ページ ナビゲーションをテストする

ページ ナビゲーションの変更をテストするには、

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

ウェブビューに統合しますそれぞれのリンクタイプをクリックすると、その内容が 確認しましょう

その際は、次の点をよくご確認ください。

  • 各リンクをクリックすると、目的の URL が開きます。
  • アプリに戻ってもテストページのカウンタはゼロにリセットされず、 ページの状態が保持されたことを検証できます。