Page event

The page event records whenever a user views a page on your website or a screen in your mobile app. Both the web SDK and mobile SDK emit page events with channel set to "web" or "mobile" respectively. On web, page properties are automatically collected from the browser. On mobile, the screen name is mapped to page-equivalent fields (page_title, page_path, page_url) so that web and mobile views are processed through the same analytics pipeline.

Properties

Property	Type	Description	Web SDK	Mobile SDK
`url`	String	Full URL of the page.	`window.location.href`	Not set
`path`	String	Path component of the URL (without query string or hash).	`window.location.pathname`	Not set
`hash`	String	Hash fragment of the URL (e.g., `#section`).	`window.location.hash`	Not set
`query`	String	Query string of the URL (without the leading `?`).	`window.location.search`	Not set
`name`	String	Name of the page or screen.	Caller-provided	Screen name (required)
`category`	String	Category of the page or screen.	Caller-provided	Caller-provided
`title`	String	Title of the page.	Caller-provided	Not set

On web, any non-UTM query-string parameters are also added as individual properties. The SDKs additionally auto-collect the following context fields:

Context field	Web SDK	Mobile SDK
`context.page_url`	`window.location.href`	`app://{screenName}`
`context.page_title`	`document.title`	Screen name
`context.page_path`	Not set (derived in backend)	Not set (derived in backend)
`context.referrer`	`document.referrer`	From deep link (if set)
`context.user_agent`	Browser user agent	Device user agent (if available)
`context.locale`	Browser language	Device locale
`context.timezone`	Resolved IANA timezone	Resolved IANA timezone
`context.location`	Country derived from timezone	Country derived from timezone
`context.library_name`	`"Formo Web SDK"`	`"Formo React Native SDK"`
`context.library_version`	SDK version	SDK version
`context.browser`	Detected browser name	Not set
`context.screen_width`	`window.screen.width`	`Dimensions.get("screen").width`
`context.screen_height`	`window.screen.height`	`Dimensions.get("screen").height`
`context.screen_density`	`window.devicePixelRatio`	`Dimensions.get("screen").scale`
`context.viewport_width`	`window.innerWidth`	Not set
`context.viewport_height`	`window.innerHeight`	Not set
`context.os_name`	Not set	`ios` or `android`
`context.os_version`	Not set	OS version string
`context.device_model`	Not set	Device model (e.g., `iPhone 14 Pro`)
`context.device_manufacturer`	Not set	Device manufacturer (e.g., `Apple`)
`context.device_name`	Not set	Device name
`context.device_type`	Not set	`mobile` or `tablet`
`context.app_name`	Not set	From native config or options
`context.app_version`	Not set	From native config or options
`context.app_build`	Not set	From native config or options
`context.app_bundle_id`	Not set	From native config or options
`context.network_wifi`	Not set	`true` if connected via WiFi
`context.network_cellular`	Not set	`true` if connected via cellular
`context.network_carrier`	Not set	Cellular carrier name (when on cellular)
`channel`	`"web"`	`"mobile"`

Sample Payload (Web)

{
    "type": "page",
    "channel": "web",
    "context": {
        "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36",
        "locale": "en-US",
        "timezone": "Asia/Saigon",
        "location": "ID",
        "referrer": "https://chatgpt.com/",
        "utm_source": "chatgpt.com",
        "utm_medium": "",
        "utm_campaign": "",
        "utm_term": "",
        "utm_content": "",
        "page_url": "https://formo.so/faucets?utm_source=chatgpt.com",
        "page_title": "Free testnet faucets",
        "library_name": "Formo Web SDK",
        "library_version": "1.30.1",
        "browser": "chrome",
        "screen_width": 1920,
        "screen_height": 1080,
        "screen_density": 1,
        "viewport_width": 1920,
        "viewport_height": 969
    },
    "properties": {
        "url": "https://formo.so/faucets?utm_source=chatgpt.com",
        "path": "/faucets",
        "hash": "",
        "query": "utm_source=chatgpt.com",
        "name": "Faucets",
        "category": "Docs",
        "title": "Free testnet faucets"
    }
}

Sample Payload (Mobile)

Screen events from the mobile SDK are sent as page events with channel: "mobile":

{
    "type": "page",
    "channel": "mobile",
    "version": "0",
    "session_id": "117b982a451dc22edea6413b8e20958216c0a5b3baaa1d90699c42dbf4e74e33",
    "anonymous_id": "c2bc0ebe-d852-49d1-9efd-e45744850ae0",
    "context": {
        "library_name": "Formo React Native SDK",
        "library_version": "1.0.0",
        "page_title": "Wallet",
        "page_url": "app://Wallet",
        "locale": "en-US",
        "timezone": "America/New_York",
        "location": "US",
        "os_name": "ios",
        "os_version": "17.0",
        "device_model": "iPhone 14 Pro",
        "device_manufacturer": "Apple",
        "device_name": "Yos's iPhone",
        "device_type": "mobile",
        "app_name": "MyDeFiApp",
        "app_version": "2.1.0",
        "app_build": "42",
        "app_bundle_id": "com.example.mydefiapp",
        "network_wifi": true,
        "network_cellular": false,
        "screen_width": 393,
        "screen_height": 852,
        "screen_density": 3
    },
    "properties": {
        "name": "Wallet",
        "category": "Main"
    }
}

Methodology

Data

Data Warehouse

Properties

Sample Payload (Web)

Sample Payload (Mobile)

​Properties

​Sample Payload (Web)

​Sample Payload (Mobile)

Properties

Sample Payload (Web)

Sample Payload (Mobile)