Ottimizza il comportamento dei clic di WebView

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

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

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

Prerequisiti

Implementazione

Per ottimizzare il comportamento dei clic nella tua istanza di WebView:

  1. Ignora shouldOverrideUrlLoading() il giorno WebViewClient. Questo metodo viene chiamato quando un URL sta per essere caricato nel WebView corrente.

  2. Determina se eseguire l'override del comportamento dell'URL di clic.

    L'esempio di codice controlla se il dominio corrente è diverso dal dominio di destinazione. Questo è solo un approccio, in quanto i criteri utilizzati possono variare.

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

Codice di esempio

Innanzitutto, aggiungi la dipendenza androidx.browser al file build.gradle a livello di modulo, in genere app/build.gradle. Questo è necessario 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 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
      }
    }
  }
}

Testare la navigazione nelle pagine

Per testare le modifiche alla navigazione della pagina, carica

https://google.github.io/webview-ads/test/#click-behavior-tests

nella visualizzazione web. Fai clic su ciascun tipo 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 verificare che lo stato della pagina sia stato mantenuto.
Indietro
Integrare l'API WebView per gli annunci