Track Webviews

It is essential that you inject your WebViews in viewWillAppear().

Additionally, when setting a delegate on your WebView, ensure that it is implemented and set before calling Contentsquare.register(webView: WKWebView). If this order is not respected, your delegate will not receive any callbacks.

Use the following API:

// Start tracking the given WKWebView
Contentsquare.register(webView: WKWebView)

// Start tracking the given WKWebView
Contentsquare registerWithWebView:(WKWebView * _Nonnull)];

1. Automatic tag injection - The SDK automatically injects the CS Tag from the project configuration in WebView mode if it is not already present. This gathers data on all your webviews, even when the user is offline or on pages showing local HTML.
2. Manual tag injection - To complete the implementation, inject the CS Tag in WebView mode on your pages. See 📚 Mobile Apps WebView Tracking Documentation.

Let’s illustrate our implementation with a UIViewController. In your viewWillAppear() method, add the following:

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)

    // Inject the Bridge between the CS Tag in WebView mode and the SDK
    Contentsquare.register(webView: webView)
}

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];

    // Inject the Bridge between the CS Tag in WebView mode and the SDK
    [Contentsquare registerWithWebView:self.webView];
}

Once you open the screen with the tracked WebView in your app, you should see the following log:

CSLIB ℹ️ Info: WebView tracking enabled on native side for page: [URL]. Waiting for Web Tracking Tag messages…

Once the web page is loaded in the WebView, you should see the following log:

CSLIB ℹ️ Info: WebView navigated to new page: [URL]. Waiting for Web Tracking Tag messages…

Once the Web Tracking tag is detected in the web page, you should see the following log:

CSLIB ℹ️ Info: Web Tracking Tag is detected on page: [URL]

Page views sent through the Web Tracking Tag are displayed the same way as native screen views:

CSLIB ℹ️ Info: Screenview - Screen name: "{{page name given}}" - Screen number: 11

Taps and swipes detected by the Web Tracking Tag are also displayed the same way as taps and swipe on native elements, but the end of the target contains HTML DOM elements:

CSLIB ℹ️ Info: Tap - Target: ...>UIViewControllerWrapperView:eq(0)>UIView:eq(0)>WKWebView:eq(0)|webview|img#picture-holder