Оптимизация поведения кнопок

Выберите платформу: Android iOS Android (устаревшая версия)

Если ваше приложение использует WKWebView для показа веб-контента, вам может потребоваться оптимизировать поведение при кликах по следующим причинам:

  • WKWebView не поддерживает просмотр страниц на вкладках. По умолчанию при нажатии на объявление, которое пытается открыть новую вкладку, ничего не происходит.

  • При клике по объявлению, которое открывается на той же вкладке, страница перезагружается. Вы можете настроить открытие объявлений вне WKWebView, например если вы размещаете игры H5 и хотите сохранить состояние каждой игры.

  • Автозаполнение не поддерживает данные кредитных карт в WKWebView. Это может привести к снижению количества конверсий в интернет-магазинах и негативно повлиять на монетизацию контента сайта.

В этом руководстве рассказывается, как оптимизировать поведение при клике в мобильных представлениях сайта, сохранив при этом контент представления.

Требования

Реализация

Для ссылок в объявлениях можно задать атрибут target href со значением _blank, _top, _self или _parent. Ссылки в объявлениях также могут содержать функции JavaScript, например window.open(url, "_blank").

В таблице ниже описано, как каждый из этих типов ссылок ведет себя в веб-представлении.

href целевой атрибут Поведение по умолчанию при нажатии на значок WKWebView
target="_blank" Ссылка не обрабатывается веб-представлением.
target="_top" Перезагрузить ссылку в существующем веб-представлении.
target="_self" Перезагрузить ссылку в существующем веб-представлении.
target="_parent" Перезагрузить ссылку в существующем веб-представлении.
Функция JavaScript Поведение по умолчанию при нажатии на значок WKWebView
window.open(url, "_blank") Ссылка не обрабатывается веб-представлением.

Чтобы оптимизировать поведение кликов в экземпляре WKWebView, выполните следующие действия:

  1. Задайте значение WKUIDelegate для экземпляра WKWebView.

  2. Задайте значение WKNavigationDelegate для экземпляра WKWebView.

  3. Определите, нужно ли оптимизировать поведение URL клика.

    • Проверьте, является ли свойство navigationType объекта WKNavigationAction типом клика, который вы хотите оптимизировать. В примере кода проверяется .linkActivated, который применяется только к кликам по ссылке с атрибутом href.

    • Проверьте свойство targetFrame объекта WKNavigationAction. Если возвращается значение nil, это означает, что целевой объект навигации – новое окно. Поскольку WKWebView не может обработать это нажатие, его нужно обработать вручную.

  4. Выберите, где открывать URL: во внешнем браузере, SFSafariViewController или в существующем веб-представлении. В этом фрагменте кода показано, как открывать URL, ведущие с сайта, с помощью SFSafariViewController.

Пример кода

В приведенном ниже фрагменте кода показано, как оптимизировать поведение при нажатии в представлении WebView. Например, он проверяет, отличается ли текущий домен от целевого. Это лишь один из возможных подходов, поскольку критерии могут быть разными.

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

Проверьте навигацию по страницам

Чтобы проверить изменения в навигации по страницам, загрузите

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

в веб-представление. Нажимайте на ссылки разных типов, чтобы посмотреть, как они работают в вашем приложении.

Ниже приведены советы, которые помогут вам найти ошибку.

  • Каждая ссылка открывает нужный URL.
  • Когда вы возвращаетесь в приложение, счетчик на тестовой странице не сбрасывается до нуля, чтобы подтвердить, что состояние страницы сохранилось.