Things to Consider While Integrating VWO Insights for WebView-Based Mobile Apps

This article helps you decide which of the VWO Insights integrations is suitable for tracking user behavior on your WebView-based or native mobile app.

Overview

If your mobile application relies on WebView for rendering web content, you may be unsure whether to integrate VWO Web Insights or VWO Mobile App Insights. This article outlines key considerations, limitations, and recommendations to help you choose the right product.

When to Use VWO Web Insights

It is recommended to use Web Insights if your mobile application is majorly or entirely WebView-based, meaning the entire user interface and interactions are driven by content within a WebView. 

You must consider the following points if you use Web Insights for tracking behavior on your WebView-based app:

• Web Insights are designed to capture user interactions with web content displayed inside WebView.
• JavaScript must be enabled within the WebView for Web Insights to work correctly.
• WebView is powered by Chrome on most devices, so modern web technologies are supported seamlessly.
• On older Android devices, outdated Chrome versions may lead to compatibility issues.
• If your web content is hosted on an internal network or behind a firewall, snapshots of assets (CSS, images, etc.) may not render during session playback.

For detailed integration steps, refer to Configuring the VWO SmartCode for Your Website.

When to Use VWO Mobile App Insights

It is recommended to use VWO Mobile App Insights if your mobile app includes native screens as well as WebViews.

If you rely solely on Web Insights to analyze user behavior in a native app, it will only track interactions within WebViews and overlook activity on native screens. With Mobile App Insights, you get a complete view of the user journey (both native screens and WebViews), though there are some platform-specific limitations inside WebViews:

• View Hiding - Individual elements inside WebView cannot be hidden. You can only hide the entire WebView using the native view-hiding capability.
• Heatmaps - Dynamic heatmaps are not supported for web content inside WebView. For example:
  • Scroll positions and attributes within WebView are not tracked.
  • Heatmap visualizations will remain static for WebView content.

For detailed integration steps, refer to Configuring the VWO Mobile Insights in Your Mobile App.

Recommendation

• If your app is entirely WebView-driven, use VWO Web Insights.
• If your app is a mix of native + WebView screens, use VWO Mobile App Insights.

Need more help?

For further assistance or more information, contact VWO Support.