Эта страница переведена с помощью Cloud Translation API.

Оптимизация поведения щелчков WKWebView

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

WKWebView не поддерживает просмотр вкладок. Клики по рекламе, которые пытаются открыть новую вкладку, по умолчанию ничего не делают.

Клики по рекламе, которые открываются в той же вкладке, перезагружают страницу. Вы можете захотеть принудительно открыть клики по рекламе за пределами WKWebView , например, если вы размещаете игры H5 и хотите сохранить состояние каждой игры.
AutoFill не поддерживает информацию о кредитных картах в WKWebView . Это может привести к снижению конверсий электронной коммерции для рекламодателей, что негативно скажется на монетизации веб-контента.

Вход через Google не поддерживается в WKWebView .

В этом руководстве приведены рекомендуемые шаги по оптимизации поведения при нажатии в мобильных веб-представлениях с сохранением содержимого веб-представления.

Предпосылки

Выполните руководство по настройке веб-просмотра .

Выполнение

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

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

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

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

Установите WKUIDelegate для вашего экземпляра WKWebView .
- Реализуйте webView(_:createWebViewWith:for:windowFeatures:) .
Установите WKNavigationDelegate для вашего экземпляра WKWebView .
- Реализуйте webView(_:decidePolicyFor:decisionHandler:) .
Важно: оба делегата должны быть настроены на захват кликов href и JavaScript.
Определите, следует ли оптимизировать поведение URL-адреса клика.
- Проверьте, является ли свойство navigationType объекта WKNavigationAction типом щелчка, который вы хотите оптимизировать. В примере кода проверяется .linkActivated , который применяется только к щелчкам по ссылке с атрибутом href .
  Примечание: щелчки JavaScript, такие как window.open(...) имеют тип .other .
- Проверьте свойство targetFrame объекта WKNavigationAction . Если оно возвращает nil , это означает, что целью навигации является новое окно. Поскольку WKWebView не может обработать этот щелчок, эти щелчки должны быть обработаны вручную.
Решите, следует ли открывать URL-адрес во внешнем браузере, SFSafariViewController или существующем веб-представлении. Фрагмент кода показывает, как открывать URL-адреса, уходящие с сайта, представляя SFSafariViewController .

Пример кода

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

Быстрый

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://webview-api-for-ads-test.glitch.me#click-behavior-tests

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

Вот некоторые вещи, которые следует проверить:

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

WKWebView API для рекламы