Track WebViews

Enable tracking in WebViews

Inject the Bridge between the CS Tag in WebView mode and the SDK

This step will inject our JavaScript Bridge in order to connect the CS Tag in WebView mode and our SDK.

In order to inject this JavaScript, you will use our CSWebView component to render your WebView, as detailed bellow.

Here is a screen with a react-native-webview WebView component. Let’s detail how we will inject it with the Contentsquare JavaScript WebView interface.

import { WebView } from "react-native-webview";
const WebviewWithTagScreen = () => {
  return (
    <>
      <WebView source={{ uri: "https://www.mywebpage.com" }} />
    </>
  );
};
export default WebviewWithTagScreen;

1. Use CSWebView component to render your WebView

CSWebView component will perform all the needed task to inject and remove the injection from the WebView. Import CSWebView component (1) and move your current WebView implementation to the renderWebView prop (2) in CSWebView. The renderWebView prop’s callBack exposes an onLayout parameter which will be used to extract the WebView tag needed for the injection. Pass the onLayout parameter to the WebView’s onLayout callBack (3).

import React from "react";
import { WebView } from "react-native-webview";
import { CSWebView } from "@contentsquare/react-native-bridge"; // (1)

const WebviewWithTagScreen = () => {
  return (
    <CSWebView // (1)
      renderWebView={(onLayout, webViewUrl) => {
        // (2)
        return (
          <WebView
            onLayout={onLayout} // (3)
            source={{ uri: "https://www.mywebpage.com" }}
          />
        );
      }}
    />
  );
};

export default WebviewWithTagScreen;

2. Setting CSWebView URL

CSWebView handles internally setting the URL state. For this pass the URL to CSWebView (1) then renderWebView callBack will expose a URL (2) to be set on your webview (3)

import React, { useState } from "react";
import { WebView } from "react-native-webview";
import { CSWebView } from "@contentsquare/react-native-bridge";

const WebviewWithTagScreen = () => {
  return (
    <CSWebView
      url="https://www.mywebpage.com" // (1)
      renderWebView={(onLayout, webViewUrl) => {
        // (2)
        return (
          <WebView
            onLayout={onLayout}
            source={{ uri: webViewUrl }} // (3)
          />
        );
      }}
    />
  );
};

export default WebviewWithTagScreen;

If you have a more complex use for your webviews such as static HTML, you can use our CSWebview API with the source prop (1). Then, the renderWebView callBack will expose a new source object (2) to be passed on to your webview (3)

import { CSWebView } from "@contentsquare/react-native-bridge";
import React from "react";
import WebView from "react-native-webview";

const htmlPage = `<html lang="en">
    ...
  </html>`;

const WebViewWithTagHTML = () => {
  return (
    <CSWebView
      source={{
        // (1)
        html: htmlPage,
      }}
      renderWebView={(onLayout, source) => {
        // (2)
        return <WebView onLayout={onLayout} source={source} />; // (3)
      }}
    />
  );
};

export default WebViewWithTagHTML;