Ottimizza il comportamento dei clic di WebView

Se la tua app utilizza WebView per visualizzare 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 rimanda a 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 web su dispositivi mobili, preservando al contempo i contenuti della visualizzazione web.

Prerequisiti

Implementazione

Per ottimizzare il comportamento dei clic nella tua WebView istanza:

  1. Sostituisci shouldOverrideUrlLoading() su WebViewClient. Questo metodo viene chiamato quando un URL sta per essere caricato nelWebView corrente.

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

    L'esempio di codice controlla se il dominio corrente è diverso da quello 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 Android o all'interno della visualizzazione web esistente. Questa guida mostra come aprire gli URL quando esci dal sito avviando Custom Tabs per Android.

Esempio di codice

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

Testare la navigazione nelle pagine

Per testare le modifiche alla navigazione nella pagina, carica

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

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