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
WKWebView
nicht 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.
In Ad Manager können Sie das Zielattribut auf _blank
oder _top
festlegen, indem Sie Anzeigen so konfigurieren, dass sie auf einem neuen Tab oder in einem neuen 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.
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:
Legen Sie
WKUIDelegate
auf derWKWebView
-Instanz fest.- Implementieren Sie
webView(_:createWebViewWith:for:windowFeatures:)
.
- Implementieren Sie
Legen Sie
WKNavigationDelegate
auf IhrerWKWebView
-Instanz fest.- Implementieren Sie
webView(_:decidePolicyFor:decisionHandler:)
.
- Implementieren Sie
Ermitteln Sie, ob das Verhalten der Klick-URL optimiert werden soll.
Prüfen Sie, ob die Eigenschaft
navigationType
desWKNavigationAction
-Objekts ein Klicktyp ist, den Sie optimieren möchten. Das Code-Snippet sucht nach.linkActivated
, was nur für Klicks auf einen Link mit einemhref
-Attribut gilt.Prüfen Sie das Attribut
targetFrame
desWKNavigationAction
-Objekts. Wirdnil
zurückgegeben, bedeutet dies, dass das Ziel der Navigation ein neues Fenster ist. DaWKWebView
diesen Klick nicht verarbeiten kann, müssen diese Klicks manuell verarbeitet werden.
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 einSFSafariViewController
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.