Mobile apps and PWAs

ProductLense tracks native apps with its SDKs and web pages with its script, and reports both side by side: the Hostname breakdown shows each app's bundle id next to your website.

Progressive web apps#

An installed PWA loads the same pages, so the same tag works with no changes. Navigation inside the app is recorded like any single-page app.

• A PWA launched from the home screen usually has no referrer, so its visits count as direct. Add UTM tags to the manifest's start URL to tell them apart: "start_url": "/?utm_source=pwa&utm_medium=app".
• Events made while the device is offline are not queued for later. They are lost, like any request that cannot be sent.
• If a service worker caches pages, make sure it does not cache https://api.productlense.app/a.js forever: let it follow the Cache-Control header, which is one day.

{
  "name": "Example",
  "start_url": "/?utm_source=pwa&utm_medium=app",
  "display": "standalone"
}

Web views in a native app#

Pages opened in WKWebView, Android WebView or a React Native WebView run the script normally; the React Native guide shows how to pass the signed-in user into one. Two things differ:

• Each web view has its own storage, so an identify made in the browser does not carry into the app. Call identify inside the web view once the user is known.
• Some apps strip the referrer when they open a web view. Add UTM tags to the URLs your app opens.

Native screens from your backend#

Without an SDK (native Swift or Kotlin apps, for now), send events from your backend with the Events API, passing the user id and the device's IP address and user agent as your API saw them. This needs an API key with the events scope, which stays on your server. Never put an API key in an app binary.

curl https://api.productlense.app/api/v1/events \
  -H "Authorization: Bearer $PL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"s":"SITE_ID","e":"Trial started","u":"https://example.com/app/trial","uid":"user_123","ip":"203.0.113.7","ua":"ExampleApp/2.4 (iPhone; iOS 19.0)"}'

The u field must be a URL on one of your site's hostnames. Use a path that names the screen, such as /app/trial. In-app purchases made through Apple or Google are read by the RevenueCat connection; payments through your web checkout or the Payment API are attributed too.

Verify your installation#

1. For a PWA or web view, open the app on a device and load a page.
2. Open the Live page in the ProductLense dashboard. The visit appears within a few seconds.
3. For backend events, the Events API answers 204, and the event shows in the Live page and under Goals.

If nothing appears, follow Verify your installation.