Если ваше приложение использует WKWebView для показа веб-контента, вам может потребоваться оптимизировать поведение при кликах по следующим причинам:
-
WKWebViewне поддерживает просмотр страниц на вкладках. По умолчанию при нажатии на объявление, которое пытается открыть новую вкладку, ничего не происходит.
При клике по объявлению, которое открывается на той же вкладке, страница перезагружается. Вы можете настроить открытие объявлений вне
WKWebView, например если вы размещаете игры H5 и хотите сохранить состояние каждой игры.Автозаполнение не поддерживает данные кредитных карт в
WKWebView. Это может привести к снижению количества конверсий в интернет-магазинах и негативно повлиять на монетизацию контента сайта.
- Вход с аккаунтом Google
не поддерживается в
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, выполните следующие действия:
Задайте значение
WKUIDelegateдля экземпляраWKWebView.- Реализуйте
webView(_:createWebViewWith:for:windowFeatures:).
- Реализуйте
Задайте значение
WKNavigationDelegateдля экземпляраWKWebView.- Реализуйте
webView(_:decidePolicyFor:decisionHandler:).
- Реализуйте
Определите, нужно ли оптимизировать поведение URL клика.
Проверьте, является ли свойство
navigationTypeобъектаWKNavigationActionтипом клика, который вы хотите оптимизировать. В примере кода проверяется.linkActivated, который применяется только к кликам по ссылке с атрибутомhref.Проверьте свойство
targetFrameобъектаWKNavigationAction. Если возвращается значениеnil, это означает, что целевой объект навигации – новое окно. ПосколькуWKWebViewне может обработать это нажатие, его нужно обработать вручную.
Выберите, где открывать 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.
- Когда вы возвращаетесь в приложение, счетчик на тестовой странице не сбрасывается до нуля, чтобы подтвердить, что состояние страницы сохранилось.