WKWebView-Klickverhalten optimieren

Plattform auswählen: Android iOS Android (Legacy)

Wenn in Ihrer App WKWebView zum Anzeigen von Webinhalten verwendet wird, sollten Sie das Klickverhalten aus den folgenden Gründen optimieren:

  • WKWebView unterstützt kein Tabbed-Browsing. Anzeigenklicks, bei denen versucht wird, einen neuen Tab zu öffnen, haben standardmäßig keine Auswirkungen.

  • Bei Anzeigenklicks, die im selben Tab geöffnet werden, wird die Seite neu geladen. Sie können erzwingen, dass Anzeigenklicks außerhalb des WKWebView geöffnet werden, z. B. wenn Sie H5-Spiele hosten und den Status jedes Spiels beibehalten möchten.

  • In WKWebView werden Kreditkartendaten nicht automatisch ausgefüllt. Dies könnte 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 Webansichten, ohne dass der Inhalt der Webansicht beeinträchtigt wird.

Vorbereitung

Implementierung

Für das Zielattribut href von Anzeigenlinks kann _blank, _top, _self oder _parent festgelegt werden. In Ad Manager können Sie das Zielattribut auf _blank oder _top festlegen, indem Sie Anzeigen so einstellen, dass sie in einem neuen Tab oder Fenster geöffnet 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.

Zielattribut href Standardmäßiges Klickverhalten für WKWebView
target="_blank" Der Link wird von der WebView 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 Klickverhalten für WKWebView
window.open(url, "_blank") Der Link wird von der WebView 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 das Attribut navigationType des WKNavigationAction-Objekts ein Klicktyp ist, den Sie optimieren möchten. Im Codebeispiel wird nach .linkActivated gesucht. Das gilt nur für Klicks auf einen Link mit einem href-Attribut.

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

  4. Entscheiden Sie, ob die URL in einem externen Browser (SFSafariViewController) oder in der vorhandenen Webansicht geöffnet werden soll. Das Code-Snippet zeigt, wie URLs, die von der Website wegführen, durch Präsentieren eines SFSafariViewController geöffnet werden.

Codebeispiel

Das folgende Code-Snippet zeigt, wie Sie das Klickverhalten in der Webansicht optimieren können. Beispielsweise wird geprüft, ob sich die aktuelle Domain von der Zieldomain unterscheidet. Dies ist nur ein Ansatz, da die von Ihnen 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 verschiedenen Linktypen, um zu sehen, wie sie sich in Ihrer App verhalten.

Überprüfen Sie Folgendes:

  • Jeder Link öffnet die gewünschte URL.
  • Wenn Sie zur App zurückkehren, wird der Zähler der Testseite nicht auf null zurückgesetzt, um zu bestätigen, dass der Seitenstatus beibehalten wurde.
Zurück
WebView API für Anzeigen einbinden