Skip to main content

Overview

Here are the 3 core concepts you need to know:
  1. Events are the actions that happen in your app.
  2. Users are the people who performed those actions.
  3. Properties are attributes that add context to your users and events.

1. Events

An event is a data point that represents an interaction between a user and your app. Events capture the details of an action the moment it happens, whether that’s a user viewing a page, connecting a wallet, or submitting a transaction on a DeFi app. The Formo SDK automatically captures and tracks web and wallet events. You can also track custom in-app events and smart contract events.

2. Users

A user is the specific individual who completed an interaction within your app. Each user has a unique identifier that you can use to track their activity. Formo distinguishes between anonymous users and wallets:
  • Anonymous users aren’t tied to any wallets. All users start as anonymous users until they connect a wallet.
  • Wallets are tied to a unique Ethereum or Solana address. When the user connects to these identities, their wallets are identified and tracked.
Multiple wallets that belong to the same user are automatically linked when they are used in the same session. You can see wallet clusters and linked addresses on the Users page.

3. Properties

Properties capture additional context about events and users.
  • Event properties are attributes that describe details specific to a particular action. For example, a Swap Completed event may include the token pair, input amount, output amount, volume, and protocol fee as event properties.
  • User properties describing a wallet or user and apply across all their future events until the properties are modified. Formo’s SDK captures user properties automatically, and you can also set your own custom properties.
Examples:
  • A Connect Wallet event has wallet address and chain ID properties.
  • A Page View event has page URL, referrer, and other page properties.
  • A User has net worth, social handles, lifetime revenue, and attribution (referrers, referral, UTM) properties.