Troubleshooting

Contentsquare SDK is not compatible with hybrid applications. See the Supported Platforms documentation for more information.

The in-app features requires a specific configuration on iOS. See the In-app features documentation for more information.

Contentsquare SDK uses zoning identifier that relies heavily on the structure of the widget tree. Consequently, changes to the widget tree, such as moving, nesting, or removing a widget, may result in the loss of tracking data.

The Contentsquare Flutter SDK offers a ReliableTarget widget, designed to encapsulate the widget intended for reliable tracking.
See the Reliable Targets documentation for more information.

A common mistake is to trigger the sending when the confirmation screen is displayed. This leads to triggering the transaction each time the user puts the app in background and then in foreground on the confirmation screen.

By default, the ContentsquareRoot widget masks all types of content (texts, text fields, and images) during Session Replays. It achieves this by providing a default MaskingConfig object if none is specified.
The default configuration masks everything, ensuring that sensitive information is protected.
However, you can override the default masking behavior by providing your own MaskingConfig object when creating a ContentsquareRoot widget. This allows you to customize the masking rules for your app according to your requirements. See the Masking documentation for more information.

The masking / unmasking of Session Replay through the in-app features settings is not yet supported by the Flutter SDK.

It is also important to remember also that the masking / unmasking Session Replay through the in-app features settings is intended to be used for debugging purposes only. See the Masking documentation for more information.

Put your app in background as this will trigger the sending of the session to the server. Take note that Session Replay is not instantaneous and can take time to be available. (from 5 minutes to 30 minutes)

For Session Replay to work, you also need the session to be tracked.

For a session to be tracked, Contentsquare SDK requires the following:

• First screenview has to be sent. See more at: Track screens
• Current user has to opt-in to have their actions tracked. See more at Handling User Consent

There is no collection of the user’s screen, but rather a reconstruction interactions based on the data collected by the SDK.
The rendering may not be pixel-perfect, but it should give you a good idea of how users interact with your app. There are some known limitations to the Session Replay feature, see the Session Replay documentation for more information.

If you notice a limitation that is not referenced in the documentation, contact us.

If you struggle to watch a replay collected on an emulator/simulator, it may be due to some network constraints applied on your computer (VPN, company network restrictions, etc.). Check your configuration or use a real device.

See following sections for more information about our endpoints and requests:

• Android - Requests are failing
• iOS - Requests are failing

It is important to remember that an app kill does not end a session.
See Session definition for more information.
If you leave the simulator/emulator running with the app in foreground, the session will not end, even if you are inactive. To better reflect actual end user behavior and avoid unusually long sessions (last hours), put the app in background or kill it.

During the initialization, the Contentsquare SDK overrides the HttpOverrides.global property. Avoid overriding HttpOverrides.global in your app. If you have to, see Use a custom HttpOverrides.

There is a known issue with the background_locator ↗ plugin which causes Contentsquare plugin to be registered twice. This issue has been mitigated and you can ignore this warning.

If you are not using the background_locator plugin and encounter this warning, contact us.

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