WKWebView-Klickverhalten optimieren

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

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

Anzeigenklicks, die auf demselben Tab geöffnet werden, laden die Seite neu. 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 zum automatischen Ausfüllen unterstützt keine Kreditkartendaten in WKWebView. Dies kann zu weniger E-Commerce-Conversions für Werbetreibende führen und sich negativ auf die Monetarisierung der Webinhalte auswirken.

Die Google-Anmeldung wird in WKWebView nicht unterstützt.

In dieser Anleitung finden Sie empfohlene Schritte zur Optimierung des Klickverhaltens in mobilen Webansichten, wobei die Inhalte der Webansicht beibehalten werden.

Vorbereitung

Führen Sie die Schritte in der Anleitung zum Einrichten der Webansicht aus.

Implementierung

Für Anzeigenlinks kann das Zielattribut href auf _blank, _top, _self oder _parent festgelegt werden. In Ad Manager können Sie das Zielattribut auf _blank oder _top festlegen, indem Sie festlegen, dass Anzeigen 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 `WKWebView`-Klickverhalten
`target="_blank"`	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")`	Link wird von der Webansicht nicht verarbeitet.

So optimieren Sie das Klickverhalten in Ihrer WKWebView-Instanz:

Legen Sie WKUIDelegate für Ihre WKWebView -Instanz fest.
- Implementieren Sie webView(_:createWebViewWith:for:windowFeatures:).
Legen Sie WKNavigationDelegate für Ihre WKWebView Instanz fest.
- Implementieren Sie webView(_:decidePolicyFor:decisionHandler:).
Wichtig: Beide Delegaten müssen festgelegt werden, um href und JavaScript Klicks zu erfassen.
Legen Sie fest, ob das Verhalten der Klick-URL optimiert werden soll.
- Prüfen Sie, ob die navigationType Property des Objekts WKNavigationAction ein Klicktyp ist, den Sie optimieren möchten. Das Codebeispiel prüft auf .linkActivated , was nur für Klicks auf einen Link mit einem href Attribut gilt.
  
  **Hinweis**: JavaScript-Klicks wie window.open(...) haben den Typ .other.
- Prüfen Sie die targetFrame Property des WKNavigationAction Objekts. 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.
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 Sie das Klickverhalten der Webansicht optimieren. Als Beispiel 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. 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 integrieren