WKWebView-Klickverhalten optimieren

Wenn in Ihrer App WKWebView verwendet wird, um Webinhalte anzuzeigen, sollten Sie das Klickverhalten aus folgenden Gründen optimieren:

  • WKWebView unterstützt keine Tabbed Browsing-Funktion. Bei Anzeigenklicks, mit denen versucht wird, einen neuen Tab zu öffnen, passiert standardmäßig nichts.

  • Bei Anzeigenklicks, die im selben Tab geöffnet werden, wird die Seite neu geladen. Möglicherweise möchten Sie erzwingen, dass Anzeigenklicks außerhalb von WKWebView geöffnet werden, z. B. wenn Sie H5-Spiele hosten und den Status der einzelnen Spiele beibehalten möchten.

  • Die Funktion „Automatisches Ausfüllen“ unterstützt keine Kreditkartendaten in WKWebView. Das kann zu weniger E-Commerce-Conversions für Werbetreibende führen und sich negativ auf die Monetarisierung der Webinhalte auswirken.

In diesem Leitfaden finden Sie empfohlene Schritte zur Optimierung des Klickverhaltens in mobilen Webview-Ansichten, ohne den Webview-Inhalt zu beeinträchtigen.

Vorbereitung

Implementierung

Für Anzeigenlinks kann das Zielattribut href auf _blank, _top, _self oder _parent festgelegt werden. Anzeigenlinks können auch JavaScript-Funktionen wie window.open(url, "_blank") enthalten.

In der folgenden Tabelle wird beschrieben, wie sich die einzelnen Links in einer Webansicht verhalten.

href-Zielattribut Standardmäßiges WKWebView-Klickverhalten
target="_blank" Der Link wird von der Webansicht nicht verarbeitet.
target="_top" Link in der vorhandenen Webansicht neu laden.
target="_self" Link in der vorhandenen Webansicht neu laden.
target="_parent" Link in der vorhandenen Webansicht neu laden.
JavaScript-Funktion Standardmäßiges WKWebView-Klickverhalten
window.open(url, "_blank") Der Link wird von der Webansicht nicht verarbeitet.

So optimieren Sie das Klickverhalten in Ihrer WKWebView-Instanz:

  1. Legen Sie die WKUIDelegate für Ihre WKWebView-Instanz fest.

  2. Legen Sie die WKNavigationDelegate für Ihre WKWebView-Instanz fest.

  3. Legen Sie fest, ob das Verhalten der Klick-URL optimiert werden soll.

    • Prüfen Sie, ob die Property navigationType des Objekts WKNavigationAction ein Klicktyp ist, den Sie optimieren möchten. Im Codebeispiel wird nach .linkActivated gesucht, was nur für Klicks auf einen Link mit einem href-Attribut gilt.

    • Prüfen Sie das Attribut targetFrame des Objekts WKNavigationAction. Wenn nil zurückgegeben wird, bedeutet das, dass das Ziel der Navigation ein neues Fenster ist. Da WKWebView diesen Klick nicht verarbeiten kann, müssen diese Klicks manuell verarbeitet werden.

  4. Legen Sie fest, ob die URL in einem externen Browser SFSafariViewController oder in der vorhandenen Webansicht geöffnet werden soll. Das Code-Snippet zeigt, wie URLs geöffnet werden, die von der Website wegführen, indem ein SFSafariViewController präsentiert wird.

Codebeispiel

Das folgende Code-Snippet zeigt, wie das Klickverhalten in der Webansicht optimiert wird. Beispielsweise wird geprüft, ob sich die aktuelle Domain von der Zieldomain unterscheidet. Dies ist nur ein Ansatz, da die verwendeten Kriterien variieren können.

Swift

import GoogleMobileAds
import SafariServices
import WebKit

class ViewController: UIViewController, WKNavigationDelegate, WKUIDelegate {

  override func viewDidLoad() {
    super.viewDidLoad()

    // ... Register the WKWebView.

    // 1. Set the WKUIDelegate on your WKWebView instance.
    webView.uiDelegate = self;
    // 2. Set the WKNavigationDelegate on your WKWebView instance.
    webView.navigationDelegate = self
  }

  // Implement the WKUIDelegate method.
  func webView(
      _ webView: WKWebView,
      createWebViewWith configuration: WKWebViewConfiguration,
      for navigationAction: WKNavigationAction,
      windowFeatures: WKWindowFeatures) -> WKWebView? {
    // 3. Determine whether to optimize the behavior of the click URL.
    if didHandleClickBehavior(
        currentURL: webView.url,
        navigationAction: navigationAction) {
      print("URL opened in SFSafariViewController.")
    }

    return nil
  }

  // Implement the WKNavigationDelegate method.
  func webView(
      _ webView: WKWebView,
      decidePolicyFor navigationAction: WKNavigationAction,
      decisionHandler: @escaping (WKNavigationActionPolicy) -> Void)
  {
    // 3. Determine whether to optimize the behavior of the click URL.
    if didHandleClickBehavior(
        currentURL: webView.url,
        navigationAction: navigationAction) {
      return decisionHandler(.cancel)
    }

    decisionHandler(.allow)
  }

  // Implement a helper method to handle click behavior.
  func didHandleClickBehavior(
      currentURL: URL,
      navigationAction: WKNavigationAction) -> Bool {
    guard let targetURL = navigationAction.request.url else {
      return false
    }

    // Handle custom URL schemes such as itms-apps:// by attempting to
    // launch the corresponding application.
    if navigationAction.navigationType == .linkActivated {
      if let scheme = targetURL.scheme, !["http", "https"].contains(scheme) {
        UIApplication.shared.open(targetURL, options: [:], completionHandler: nil)
        return true
      }
    }

    guard let currentDomain = currentURL.host,
      let targetDomain = targetURL.host else {
      return false
    }

    // Check if the navigationType is a link with an href attribute or
    // if the target of the navigation is a new window.
    if (navigationAction.navigationType == .linkActivated ||
      navigationAction.targetFrame == nil) &&
      // If the current domain does not equal the target domain,
      // the assumption is the user is navigating away from the site.
      currentDomain != targetDomain {
      // 4. Open the URL in a SFSafariViewController.
      let safariViewController = SFSafariViewController(url: targetURL)
      present(safariViewController, animated: true)
      return true
    }

    return false
  }
}

Objective-C

@import GoogleMobileAds;
@import SafariServices;
@import WebKit;

@interface ViewController () <WKNavigationDelegate, WKUIDelegate>

@property(nonatomic, strong) WKWebView *webView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];

  // ... Register the WKWebView.

  // 1. Set the WKUIDelegate on your WKWebView instance.
  self.webView.uiDelegate = self;
  // 2. Set the WKNavigationDelegate on your WKWebView instance.
  self.webView.navigationDelegate = self;
}

// Implement the WKUIDelegate method.
- (WKWebView *)webView:(WKWebView *)webView
  createWebViewWithConfiguration:(WKWebViewConfiguration *)configuration
             forNavigationAction:(WKNavigationAction *)navigationAction
                  windowFeatures:(WKWindowFeatures *)windowFeatures {
  // 3. Determine whether to optimize the behavior of the click URL.
  if ([self didHandleClickBehaviorForCurrentURL: webView.URL
      navigationAction: navigationAction]) {
    NSLog(@"URL opened in SFSafariViewController.");
  }

  return nil;
}

// Implement the WKNavigationDelegate method.
- (void)webView:(WKWebView *)webView
    decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction
                    decisionHandler:
                        (void (^)(WKNavigationActionPolicy))decisionHandler {
  // 3. Determine whether to optimize the behavior of the click URL.
  if ([self didHandleClickBehaviorForCurrentURL: webView.URL
      navigationAction: navigationAction]) {
    decisionHandler(WKNavigationActionPolicyCancel);
    return;
  }

  decisionHandler(WKNavigationActionPolicyAllow);
}

// Implement a helper method to handle click behavior.
- (BOOL)didHandleClickBehaviorForCurrentURL:(NSURL *)currentURL
                    navigationAction:(WKNavigationAction *)navigationAction {
  NSURL *targetURL = navigationAction.request.URL;

  // Handle custom URL schemes such as itms-apps:// by attempting to
  // launch the corresponding application.
  if (navigationAction.navigationType == WKNavigationTypeLinkActivated) {
    NSString *scheme = targetURL.scheme;
    if (![scheme isEqualToString:@"http"] && ![scheme isEqualToString:@"https"]) {
      [UIApplication.sharedApplication openURL:targetURL options:@{} completionHandler:nil];
      return YES;
    }
  }

  NSString *currentDomain = currentURL.host;
  NSString *targetDomain = targetURL.host;

  if (!currentDomain || !targetDomain) {
    return NO;
  }

  // Check if the navigationType is a link with an href attribute or
  // if the target of the navigation is a new window.
  if ((navigationAction.navigationType == WKNavigationTypeLinkActivated
      || !navigationAction.targetFrame)
      // If the current domain does not equal the target domain,
      // the assumption is the user is navigating away from the site.
      && ![currentDomain isEqualToString: targetDomain]) {
     // 4. Open the URL in a SFSafariViewController.
    SFSafariViewController *safariViewController =
        [[SFSafariViewController alloc] initWithURL:targetURL];
    [self presentViewController:safariViewController animated:YES
        completion:nil];
    return YES;
  }

  return NO;
}

Seitennavigation testen

Wenn Sie die Änderungen an der Seitennavigation testen möchten, laden Sie

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

in Ihre Webansicht einbinden. Klicken Sie auf die einzelnen Linktypen, um zu sehen, wie sie sich in Ihrer App verhalten.

Überprüfen Sie Folgendes:

  • Über jeden Link wird die gewünschte URL geöffnet.
  • Wenn Sie zur App zurückkehren, wird der Zähler der Testseite nicht auf null zurückgesetzt, um zu prüfen, ob der Seitenstatus beibehalten wurde.
Zurück
WKWebView API für Anzeigen