WKWebView-Klickverhalten optimieren

Wenn in deiner iOS AppWKWebView zur Anzeige von Webinhalten verwendet wird, solltest du das Klickverhalten aus folgenden Gründen optimieren:

• WKWebView unterstützt -Tab-Browser. Klicks auf Anzeigen, mit denen versucht wird, einen neuen Tab zu öffnen, haben standardmäßig keine Auswirkungen.

• Durch Anzeigenklicks, die im selben Tab geöffnet werden, wird die Seite neu geladen. Sie können 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.

• AutoFill unterstützt keine Kreditkartendaten in WKWebView. Dies könnte für Werbetreibende zu weniger E-Commerce-Conversions führen, was sich negativ auf die Monetarisierung der Webinhalte auswirkt.

• Google Log-in in WKWebViewnicht unterstützt.

In diesem Leitfaden finden Sie empfohlene Schritte, um das Klickverhalten in mobilen Webansichten zu optimieren und gleichzeitig den Inhalt der Webansicht beizubehalten.

Voraussetzungen

• Folgen Sie der Anleitung zum Einrichten der Webansicht.

Implementierung

Für Anzeigenlinks kann das Zielattribut href auf _blank, _top, _self oder _parent festgelegt sein. 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	Standard-Klickverhalten (WKWebView)
target="_blank"	Der Link wird in der Webansicht nicht verarbeitet.
target="_top"	Link in der vorhandenen Webansicht aktualisieren.
target="_self"	Link in der vorhandenen Webansicht aktualisieren.
target="_parent"	Link in der vorhandenen Webansicht aktualisieren.
JavaScript-Funktion	Standard-Klickverhalten (WKWebView)
window.open(url, "_blank")	Der Link wird in der Webansicht nicht verarbeitet.

So optimieren Sie das Klickverhalten in derWKWebView -Instanz:

1. Legen Sie WKUIDelegate auf der WKWebView-Instanz fest.

   • Implementieren Sie webView(_:createWebViewWith:for:windowFeatures:).

2. Legen Sie WKNavigationDelegate auf Ihrer WKWebView-Instanz fest.

   • Implementieren Sie webView(_:decidePolicyFor:decisionHandler:).
   Wichtig :Beide Bevollmächtigte müssen so eingestellt sein, dass href- und JavaScript-Klicks erfasst werden.

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

   • Prüfen Sie, ob die Eigenschaft navigationType des WKNavigationAction-Objekts ein Klicktyp ist, den Sie optimieren möchten. Das Code-Snippet sucht nach .linkActivated, was nur für Klicks auf einen Link mit einem href-Attribut gilt.

     Hinweis: JavaScript-Klicks wie window.open(...) sind vom Typ .other.

   • Prüfen Sie das Attribut targetFrame des WKNavigationAction-Objekts. Wird nil zurückgegeben, bedeutet dies, dass das Ziel der Navigation ein neues Fenster ist. 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 geöffnet werden, die die Website verlassen, indem ein SFSafariViewController eingefügt wird.

Codebeispiel

Das folgende Code-Snippet zeigt, wie Sie das Klickverhalten für Webaufrufe optimieren können. Es wird beispielsweise 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? {
    guard let url = navigationAction.request.url,
        let currentDomain = webView.url?.host,
        let targetDomain = url.host else { return nil }

    // 3. Determine whether to optimize the behavior of the click URL.
    if didHandleClickBehavior(
        url: url,
        currentDomain: currentDomain,
        targetDomain: targetDomain,
        navigationAction: navigationAction) {
      print("URL opened in SFSafariViewController.")
    }

    return nil
  }

  // Implement the WKNavigationDelegate method.
  func webView(
      _ webView: WKWebView,
      decidePolicyFor navigationAction: WKNavigationAction,
      decisionHandler: @escaping (WKNavigationActionPolicy) -> Void)
  {
    guard let url = navigationAction.request.url,
        let currentDomain = webView.url?.host,
        let targetDomain = url.host else { return decisionHandler(.cancel) }

    // 3. Determine whether to optimize the behavior of the click URL.
    if didHandleClickBehavior(
        url: url,
        currentDomain: currentDomain,
        targetDomain: targetDomain,
        navigationAction: navigationAction) {
      return decisionHandler(.cancel)
    }

    decisionHandler(.allow)
  }

  // Implement a helper method to handle click behavior.
  func didHandleClickBehavior(
      url: URL,
      currentDomain: String,
      targetDomain: String,
      navigationAction: WKNavigationAction) -> Bool {
    // Check if the navigationType is a link with an href attribute or
    // if the target of the navigation is a new window.
    guard 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 else { return false }

    // 4.  Open the URL in a SFSafariViewController.
    let safariViewController = SFSafariViewController(url: url)
    present(safariViewController, animated: true)
    return true
  }
}

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 {
  NSURL *url = navigationAction.request.URL;
  NSString *currentDomain = webView.URL.host;
  NSString *targetDomain = navigationAction.request.URL.host;

  // 3. Determine whether to optimize the behavior of the click URL.
  if ([self didHandleClickBehaviorForURL: url
      currentDomain: currentDomain
      targetDomain: targetDomain
      navigationAction: navigationAction]) {
    NSLog(@"URL opened in SFSafariViewController.");
  }

  return nil;
}

// Implement the WKNavigationDelegate method.
- (void)webView:(WKWebView *)webView
    decidePolicyForNavigationAction:(WKNavigationAction *)navigationAction
                    decisionHandler:
                        (void (^)(WKNavigationActionPolicy))decisionHandler {
  NSURL *url = navigationAction.request.URL;
  NSString *currentDomain = webView.URL.host;
  NSString *targetDomain = navigationAction.request.URL.host;

  // 3. Determine whether to optimize the behavior of the click URL.
  if ([self didHandleClickBehaviorForURL: url
      currentDomain: currentDomain
      targetDomain: targetDomain
      navigationAction: navigationAction]) {

    decisionHandler(WKNavigationActionPolicyCancel);
    return;
  }

  decisionHandler(WKNavigationActionPolicyAllow);
}

// Implement a helper method to handle click behavior.
- (BOOL)didHandleClickBehaviorForURL:(NSURL *)url
                       currentDomain:(NSString *)currentDomain
                        targetDomain:(NSString *)targetDomain
                    navigationAction:(WKNavigationAction *)navigationAction {
  if (!url || !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:url];
    [self presentViewController:safariViewController animated:YES
        completion:nil];
    return YES;
  }

  return NO;
}

Seitennavigation testen

Um Ihre Änderungen an der Seitennavigation zu testen, laden Sie

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

in Ihrer Webansicht angezeigt. Klicken Sie auf die verschiedenen Linktypen, um zu sehen, wie sie sich in Ihrer App verhalten.

Überprüfen Sie Folgendes:

• Über jeden Link wird die entsprechende URL geöffnet.
• Bei der Rückkehr zur App wird der Zähler der Testseite nicht auf null zurückgesetzt, um zu prüfen, ob der Seitenstatus beibehalten wurde.