Troubleshooting

In order for Contentsquare to work, you need to make sure the following endpoints are not blocked by your network (VPN):

If the following message appears in the logs:

CSLIB ℹ️ Info:⚠️ Contentsquare SDK cannot execute operation because it hasn't been started.

It means SDK API calls were done incorrectly.

In this case: gestures and lifecycle events won’t be tracked by the SDK.

Two possible explanations exist for this issue:

• The SDK is manually started and API calls were made before call to start.
• The SDK is automatically started and API calls were made before the AppDelegate.willFinishLaunchingWithOptions. Ensure that it doesn’t happen or contact our support team if you have a specific need.

1. Build your app for iOS device (not simulator)
2. Open the product folder for your app
3. Copy the .app from Debug-iphoneos and send it to the Contentsquare team

When using Manual tag injection for dual context (WebView and Browser tracking on the same webpage), the SDK injects a script that may load after the page, causing the wrong tag to load in the WebView. Use one of the following solutions:

• Add your own user script before the webview loads the page:

  let userScript = WKUserScript(
     source: "window.isWebView = true;",
     injectionTime: .atDocumentStart,
     forMainFrameOnly: false
  )
  
  webView.configuration.userContentController.addUserScript(userScript)

  Then make sure to include the added script variable in the webview check on the page itself:

  function isWebView() {
     return navigator.userAgent.indexOf('CS_WebView') !== -1 ||
     typeof CSJavascriptBridge != 'undefined' ||
     window.CS_isWebView ||
     window.isWebView; // Your added variable
  }
  
  /// ...

• Add a query parameter to the URL of the page you are loading in the WebView:

  URL(string: "https://www.apple.com/?isWebView=1")

  Then add it to the conditions in the page script itself:

  function isWebView() {
     return navigator.userAgent.indexOf('CS_WebView') !== -1 ||
     typeof CSJavascriptBridge != 'undefined' ||
     window.CS_isWebView ||
     new URLSearchParams(window.location.search).get('isWebView') === '1';
  }
  
  /// ...