Ottimizza il comportamento dei clic di WebView

Se la tua Android app utilizzaWebView per visualizzare contenuti web, ti consigliamo di ottimizzare il comportamento dei clic per i seguenti motivi:

  • WebView non supporta schemi URL personalizzati che potrebbero essere restituiti negli annunci se la destinazione del clic è un'app separata. Ad esempio, un URL di clickthrough di Google Play potrebbe utilizzare market://.

Questa guida fornisce i passaggi consigliati per ottimizzare il comportamento dei clic nelle visualizzazioni del web mobile, preservando i contenuti della visualizzazione web.

Prerequisiti

Implementazione

Segui questi passaggi per ottimizzare il comportamento dei clic nella tuaWebView istanza:

  1. Esegui l'override di shouldOverrideUrlLoading() nella WebViewClient. Questo metodo viene richiamato quando un URL sta per essere caricato nell'oggetto WebView attuale.

  2. Stabilisci se sostituire il comportamento dell'URL di clic.

    Lo snippet di codice riportato di seguito controlla se il dominio corrente è diverso dal dominio di destinazione. Questo è solo uno degli approcci, in quanto i criteri utilizzati possono variare.

  3. Decidi se aprire l'URL in un browser esterno, nelle schede personalizzate di Android o all'interno della vista web esistente. Questa guida mostra come aprire gli URL che escono dal sito avviando le schede personalizzate Android.

Esempio di codice

Innanzitutto aggiungi la dipendenza androidx.browser al file build.gradle a livello di modulo, in genere app/build.gradle. Questo campo è obbligatorio per le schede personalizzate:

dependencies {
  implementation 'androidx.browser:browser:1.5.0'
}

Il seguente snippet di codice mostra come implementare 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 URL(view.getUrl()).getHost();
            } catch (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 = URL(view?.url).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
      }
    }
  }
}

Testare la navigazione nelle pagine

Per testare le modifiche alla navigazione nelle pagine, carica

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

nella vista web. Fai clic su ciascuno dei diversi tipi di link per vedere come si comportano nella tua app.

Ecco alcuni aspetti da controllare:

  • Ogni link apre l'URL previsto.
  • Quando torni all'app, il contatore della pagina di test non viene reimpostato su zero per confermare che lo stato della pagina è stato mantenuto.