feat(analytics): add Add Money funnel tracking

bmc08gt · bmc08gt · commit 17a8563df856 · 2026-07-10T12:18:57.000-04:00
Adds a unified 'Add Money' event family, modeled after the existing
transfer events (single terminal event with State/Error properties):

- Add Money: Opened          — Source: Menu | Give Shortfall | Buy Shortfall |
                               Chat | Scanner | Balance
- Add Money: Method Selected — Method: Coinbase | Phantom | Other Wallet | Reserves
- Add Money: Amount Confirmed — Method + amount properties
- Add Money: Payment Invoked  — Method + amount properties
- Add Money: Address Copied   — Mint (Other Wallet path)
- Add Money                   — terminal, State=Success/Failure + Error + amount

Instrumented across the flow:
- MenuScreenViewModel: opened from menu tile
- CashScreenViewModel: opened from give-shortfall alert (USDF only)
- SwapViewModel: opened from buy-shortfall alert, amount confirmed,
  payment invoked (Coinbase order placed / Phantom pre-sign), terminal
  success on balance delivery, terminal failure on order delivery
  failure/timeout, Coinbase web errors, order placement errors, and
  Phantom transaction errors
- ChatViewModel: opened from no-balance prompt when starting a chat
- DepositDelegate: opened from scanner Give action with nothing giveable
- BalanceViewModel: opened from balance screen (AddMoneyUX only)
- InternalPurchaseMethodController: method selected from deposit sheet
- DepositViewModel: address copied

Funnel events only fire when acquiring USDF via an external funding
source; launchpad token buys remain tracked via buy()/sell().

Signed-off-by: Brandon McAnsh &lt;git@bmcreations.dev&gt;
diff --git a/apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/BalanceViewModel.kt b/apps/flipcash/features/balance/src/main/kotlin/com/flipcash/app/balance/internal/BalanceViewModel.kt
@@ -1,6 +1,8 @@
 package com.flipcash.app.balance.internal
 
 import androidx.lifecycle.viewModelScope
+import com.flipcash.app.analytics.Analytics
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.featureflags.FeatureFlag
 import com.flipcash.app.featureflags.FeatureFlagController
@@ -28,6 +30,7 @@ internal class BalanceViewModel @Inject constructor(
     dispatchers: DispatcherProvider,
     purchaseMethodController: PurchaseMethodController,
     featureFlags: FeatureFlagController,
+    analytics: FlipcashAnalyticsService,
 ) : BaseViewModel<BalanceViewModel.State, BalanceViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent,
@@ -68,6 +71,7 @@ internal class BalanceViewModel @Inject constructor(
                     dispatchEvent(Event.OpenScreen(AppRoute.Token.Discovery))
                     return@mapNotNull null
                 }
+                analytics.addMoneyOpened(Analytics.AddMoneySource.Balance)
                 purchaseMethodController.presentDepositOptions(popToRoot = true) }
             .onEach { route -> dispatchEvent(Event.OpenScreen(route)) }
             .launchIn(viewModelScope)
diff --git a/apps/flipcash/features/cash/src/main/kotlin/com/flipcash/app/cash/internal/CashScreenViewModel.kt b/apps/flipcash/features/cash/src/main/kotlin/com/flipcash/app/cash/internal/CashScreenViewModel.kt
@@ -1,6 +1,8 @@
 package com.flipcash.app.cash.internal
 
 import androidx.lifecycle.viewModelScope
+import com.flipcash.app.analytics.Analytics
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.bill.Bill
 import com.flipcash.app.core.tokens.SwapPurpose
@@ -24,6 +26,7 @@ import com.getcode.opencode.model.financial.LocalFiat
 import com.getcode.opencode.model.financial.SendLimit
 import com.getcode.opencode.model.financial.TokenWithLocalizedBalance
 import com.getcode.opencode.model.financial.minus
+import com.getcode.opencode.model.financial.usdf
 import com.getcode.solana.keys.Mint
 import com.getcode.util.resources.ResourceHelper
 import com.getcode.view.BaseViewModel
@@ -55,6 +58,7 @@ internal class CashScreenViewModel @Inject constructor(
     private val verifiedFiatCalculator: VerifiedFiatCalculator,
     tokenCoordinator: TokenCoordinator,
     transactionController: TransactionOperations,
+    analytics: FlipcashAnalyticsService,
     dispatchers: DispatcherProvider,
 ) : BaseViewModel<CashScreenViewModel.State, CashScreenViewModel.Event>(
     initialState = State(),
@@ -272,6 +276,9 @@ internal class CashScreenViewModel @Inject constructor(
             .onEach { shortfall ->
                 // route directly to the swap amount screen, skipping token info
                 val mint = stateFlow.value.selectedTokenAddress!!
+                if (mint == Mint.usdf) {
+                    analytics.addMoneyOpened(Analytics.AddMoneySource.GiveShortfall)
+                }
                 dispatchEvent(
                     Event.OpenScreen(
                         AppRoute.Token.Swap(
diff --git a/apps/flipcash/features/cash/src/test/kotlin/com/flipcash/app/cash/internal/CashScreenViewModelTest.kt b/apps/flipcash/features/cash/src/test/kotlin/com/flipcash/app/cash/internal/CashScreenViewModelTest.kt
@@ -1,6 +1,7 @@
 package com.flipcash.app.cash.internal
 
 import androidx.arch.core.executor.testing.InstantTaskExecutorRule
+import com.flipcash.app.analytics.StubFlipcashAnalytics
 import com.flipcash.app.core.MainCoroutineRule
 import com.flipcash.app.core.dispatchers.TestDispatchers
 import com.flipcash.app.tokens.TokenCoordinator
@@ -78,6 +79,7 @@ class CashScreenViewModelTest {
             verifiedFiatCalculator = verifiedFiatCalculator,
             tokenCoordinator = tokenCoordinator,
             transactionController = transactionController,
+            analytics = StubFlipcashAnalytics(),
             dispatchers = dispatchers,
         )
     }
diff --git a/apps/flipcash/features/deposit/build.gradle.kts b/apps/flipcash/features/deposit/build.gradle.kts
@@ -11,6 +11,7 @@ dependencies {
 
     implementation(project(":libs:messaging"))
 
+    implementation(project(":apps:flipcash:shared:analytics"))
     implementation(project(":apps:flipcash:shared:featureflags"))
     implementation(project(":apps:flipcash:shared:tokens"))
     implementation(project(":services:flipcash"))
diff --git a/apps/flipcash/features/deposit/src/main/kotlin/com/flipcash/app/deposit/internal/DepositViewModel.kt b/apps/flipcash/features/deposit/src/main/kotlin/com/flipcash/app/deposit/internal/DepositViewModel.kt
@@ -2,6 +2,7 @@ package com.flipcash.app.deposit.internal
 
 import android.content.ClipboardManager
 import androidx.lifecycle.viewModelScope
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.extensions.onResult
 import com.flipcash.app.core.extensions.setText
 import com.flipcash.features.deposit.R
@@ -34,6 +35,7 @@ internal class DepositViewModel @Inject constructor(
     resources: ResourceHelper,
     dispatchers: DispatcherProvider,
     featureFlags: FeatureFlagController,
+    analytics: FlipcashAnalyticsService,
 ) : BaseViewModel<DepositViewModel.State, DepositViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent,
@@ -106,6 +108,9 @@ internal class DepositViewModel @Inject constructor(
                     text = stateFlow.value.depositAddress,
                     label = resources.getString(R.string.title_clipboardLabelDepositAddress),
                 )
+                stateFlow.value.selectedTokenAddress?.let { mint ->
+                    analytics.addMoneyAddressCopied(mint)
+                }
             }
             .onEach {
                 dispatchEvent(Event.SetCopied(true))
diff --git a/apps/flipcash/features/menu/src/main/kotlin/com/flipcash/app/menu/internal/MenuScreenViewModel.kt b/apps/flipcash/features/menu/src/main/kotlin/com/flipcash/app/menu/internal/MenuScreenViewModel.kt
@@ -1,6 +1,8 @@
 package com.flipcash.app.menu.internal
 
 import androidx.lifecycle.viewModelScope
+import com.flipcash.app.analytics.Analytics
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.auth.AuthManager
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.android.VersionInfo
@@ -53,6 +55,7 @@ internal class MenuScreenViewModel @Inject constructor(
     dispatchers: DispatcherProvider,
     releaseStageProvider: ReleaseStageProvider,
     purchaseMethodController: PurchaseMethodController,
+    analytics: FlipcashAnalyticsService,
 ) :
     BaseViewModel<MenuScreenViewModel.State, MenuScreenViewModel.Event>(
         initialState = State(),
@@ -165,6 +168,7 @@ internal class MenuScreenViewModel @Inject constructor(
         eventFlow
             .filterIsInstance<Event.PresentDepositOptions>()
             .mapNotNull {
+                analytics.addMoneyOpened(Analytics.AddMoneySource.Menu)
                 val depositFirstUx = featureFlags.get(FeatureFlag.AddMoneyUX)
                 if (!depositFirstUx) {
                     return@mapNotNull AppRoute.Transfers.Deposit()
diff --git a/apps/flipcash/features/messenger/src/main/kotlin/com/flipcash/app/messenger/internal/ChatViewModel.kt b/apps/flipcash/features/messenger/src/main/kotlin/com/flipcash/app/messenger/internal/ChatViewModel.kt
@@ -535,6 +535,7 @@ internal class ChatViewModel @Inject constructor(
         eventFlow
             .filterIsInstance<Event.PresentDepositOptions>()
             .onEach {
+                analytics.addMoneyOpened(Analytics.AddMoneySource.Chat)
                 purchaseMethodController.presentDepositOptions()?.let { route ->
                     dispatchEvent(Event.OpenScreen(route))
                 }
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Analytics.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Analytics.kt
@@ -26,9 +26,7 @@ interface FlipcashAnalyticsService : AnalyticsService {
     fun addMoneyAmountConfirmed(method: Analytics.AddMoneyMethod, amount: Fiat)
     fun addMoneyPaymentInvoked(method: Analytics.AddMoneyMethod, amount: Fiat)
     fun addMoneyAddressCopied(mint: Mint)
-    fun addMoneyCompleted(method: Analytics.AddMoneyMethod, amount: Fiat? = null)
-    fun addMoneyFailed(method: Analytics.AddMoneyMethod, stage: Analytics.AddMoneyStage, error: Throwable? = null)
-    fun addMoneyCancelled(method: Analytics.AddMoneyMethod?, stage: Analytics.AddMoneyStage)
+    fun addMoney(method: Analytics.AddMoneyMethod, amount: Fiat? = null, successful: Boolean = true, error: Throwable? = null)
     fun connectWallet(provider: OnRampProvider.UsesDeeplinks)
     fun amountSelectedForWalletTransfer(provider: OnRampProvider.UsesDeeplinks, amount: Fiat)
     fun transactionSubmittedToWallet(provider: OnRampProvider.UsesDeeplinks)
@@ -68,9 +66,8 @@ object Analytics {
         data object SentCash : Transfer
     }
     enum class OnrampSource { Settings, Balance, Give }
-    enum class AddMoneySource { Menu, GiveShortfall, BuyShortfall }
+    enum class AddMoneySource { Menu, GiveShortfall, BuyShortfall, Chat, Scanner, Balance }
     enum class AddMoneyMethod { Coinbase, Phantom, OtherWallet, Reserves }
-    enum class AddMoneyStage { MethodSelection, AmountEntry, Verification, Payment, Processing }
     enum class OnrampVerificationStep { ShowInfo, EnterPhone, ConfirmPhone, EnterEmail, ConfirmEmail }
     enum class OnrampPurchaseStep { PresetSelected, EnterCustomAmount, InvokePayment, InvokePaymentCustom, Completed }
     enum class TokenInfoSource { Deeplink, Wallet, Give }
@@ -105,9 +102,7 @@ class StubFlipcashAnalytics : FlipcashAnalyticsService {
     override fun addMoneyAmountConfirmed(method: Analytics.AddMoneyMethod, amount: Fiat) = Unit
     override fun addMoneyPaymentInvoked(method: Analytics.AddMoneyMethod, amount: Fiat) = Unit
     override fun addMoneyAddressCopied(mint: Mint) = Unit
-    override fun addMoneyCompleted(method: Analytics.AddMoneyMethod, amount: Fiat?) = Unit
-    override fun addMoneyFailed(method: Analytics.AddMoneyMethod, stage: Analytics.AddMoneyStage, error: Throwable?) = Unit
-    override fun addMoneyCancelled(method: Analytics.AddMoneyMethod?, stage: Analytics.AddMoneyStage) = Unit
+    override fun addMoney(method: Analytics.AddMoneyMethod, amount: Fiat?, successful: Boolean, error: Throwable?) = Unit
 
     override fun connectWallet(provider: OnRampProvider.UsesDeeplinks) = Unit
     override fun amountSelectedForWalletTransfer(provider: OnRampProvider.UsesDeeplinks, amount: Fiat) = Unit
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Events.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Events.kt
@@ -280,39 +280,9 @@ internal sealed interface AnalyticsEvent {
             override fun toProperties() = mapOf("Mint" to mint.base58())
         }
 
-        data class Completed(
-            val method: Analytics.AddMoneyMethod,
-            val amount: Fiat?,
-        ) : AddMoneyEvent {
-            override val name = "Add Money: Completed"
-            override fun toProperties() = buildMap {
-                put("Method", method.propertyValue)
-                amount?.let { putAll(it.asProperties()) }
-            }
-        }
-
-        data class Failed(
-            val method: Analytics.AddMoneyMethod,
-            val stage: Analytics.AddMoneyStage,
-            val error: Throwable?,
-        ) : AddMoneyEvent {
-            override val name = "Add Money: Failed"
-            override fun toProperties() = buildMap {
-                put("Method", method.propertyValue)
-                put("Stage", stage.propertyValue)
-                error?.let { put("Error", it.message.orEmpty()) }
-            }
-        }
-
-        data class Cancelled(
-            val method: Analytics.AddMoneyMethod?,
-            val stage: Analytics.AddMoneyStage,
-        ) : AddMoneyEvent {
-            override val name = "Add Money: Cancelled"
-            override fun toProperties() = buildMap {
-                method?.let { put("Method", it.propertyValue) }
-                put("Stage", stage.propertyValue)
-            }
+        data class Terminal(val method: Analytics.AddMoneyMethod) : AddMoneyEvent {
+            override val name = "Add Money"
+            override fun toProperties() = mapOf("Method" to method.propertyValue)
         }
     }
 
@@ -376,6 +346,9 @@ internal val Analytics.AddMoneySource.propertyValue: String
         Analytics.AddMoneySource.Menu -> "Menu"
         Analytics.AddMoneySource.GiveShortfall -> "Give Shortfall"
         Analytics.AddMoneySource.BuyShortfall -> "Buy Shortfall"
+        Analytics.AddMoneySource.Chat -> "Chat"
+        Analytics.AddMoneySource.Scanner -> "Scanner"
+        Analytics.AddMoneySource.Balance -> "Balance"
     }
 
 internal val Analytics.AddMoneyMethod.propertyValue: String
@@ -386,15 +359,6 @@ internal val Analytics.AddMoneyMethod.propertyValue: String
         Analytics.AddMoneyMethod.Reserves -> "Reserves"
     }
 
-internal val Analytics.AddMoneyStage.propertyValue: String
-    get() = when (this) {
-        Analytics.AddMoneyStage.MethodSelection -> "Method Selection"
-        Analytics.AddMoneyStage.AmountEntry -> "Amount Entry"
-        Analytics.AddMoneyStage.Verification -> "Verification"
-        Analytics.AddMoneyStage.Payment -> "Payment"
-        Analytics.AddMoneyStage.Processing -> "Processing"
-    }
-
 internal fun LocalFiat.asProperties(): Map<String, String> {
     return buildMap {
         putAll(underlyingTokenAmount.asProperties())
diff --git a/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/internal/MixpanelAnalyticsDelegate.kt b/apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/internal/MixpanelAnalyticsDelegate.kt
@@ -160,23 +160,18 @@ internal class MixpanelAnalyticsDelegate @Inject constructor(
         track(AnalyticsEvent.AddMoneyEvent.AddressCopied(mint))
     }
 
-    override fun addMoneyCompleted(method: Analytics.AddMoneyMethod, amount: Fiat?) {
-        track(AnalyticsEvent.AddMoneyEvent.Completed(method, amount))
-    }
-
-    override fun addMoneyFailed(
+    override fun addMoney(
         method: Analytics.AddMoneyMethod,
-        stage: Analytics.AddMoneyStage,
+        amount: Fiat?,
+        successful: Boolean,
         error: Throwable?
     ) {
-        track(AnalyticsEvent.AddMoneyEvent.Failed(method, stage, error))
-    }
-
-    override fun addMoneyCancelled(
-        method: Analytics.AddMoneyMethod?,
-        stage: Analytics.AddMoneyStage
-    ) {
-        track(AnalyticsEvent.AddMoneyEvent.Cancelled(method, stage))
+        track(
+            AnalyticsEvent.AddMoneyEvent.Terminal(method),
+            "State" to if (successful) "Success" else "Failure",
+            *amount?.asProperties()?.toList()?.toTypedArray() ?: emptyArray(),
+            *error.asProperty()
+        )
     }
 
     override fun connectWallet(provider: OnRampProvider.UsesDeeplinks) {
diff --git a/apps/flipcash/shared/payments/build.gradle.kts b/apps/flipcash/shared/payments/build.gradle.kts
@@ -7,6 +7,7 @@ android {
 }
 
 dependencies {
+    implementation(project(":apps:flipcash:shared:analytics"))
     implementation(project(":apps:flipcash:shared:featureflags"))
     implementation(project(":apps:flipcash:shared:tokens:core"))
     implementation(project(":apps:flipcash:shared:userflags"))
diff --git a/apps/flipcash/shared/payments/src/main/kotlin/com/flipcash/app/payments/internal/InternalPurchaseMethodController.kt b/apps/flipcash/shared/payments/src/main/kotlin/com/flipcash/app/payments/internal/InternalPurchaseMethodController.kt
@@ -1,5 +1,7 @@
 package com.flipcash.app.payments.internal
 
+import com.flipcash.app.analytics.Analytics
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.tokens.FundingSource
 import com.flipcash.app.core.tokens.SwapPurpose
@@ -54,6 +56,7 @@ class InternalPurchaseMethodController @Inject constructor(
     exchange: Exchange,
     private val resources: ResourceHelper,
     private val userManager: UserManager,
+    private val analytics: FlipcashAnalyticsService,
 ) : PurchaseMethodController {
 
     private val scope = CoroutineScope(SupervisorJob())
@@ -148,6 +151,18 @@ class InternalPurchaseMethodController @Inject constructor(
             _dismissals.map { null },
         ).first()
 
+        when (result) {
+            PurchaseMethod.CoinbaseOnRamp ->
+                analytics.addMoneyMethodSelected(Analytics.AddMoneyMethod.Coinbase)
+            PurchaseMethod.PhantomWallet ->
+                analytics.addMoneyMethodSelected(Analytics.AddMoneyMethod.Phantom)
+            PurchaseMethod.OtherWallet ->
+                analytics.addMoneyMethodSelected(Analytics.AddMoneyMethod.OtherWallet)
+            is PurchaseMethod.CashReserves ->
+                analytics.addMoneyMethodSelected(Analytics.AddMoneyMethod.Reserves)
+            null -> Unit
+        }
+
         return when (result) {
             PurchaseMethod.CoinbaseOnRamp -> {
                 val profile = userManager.profile
diff --git a/apps/flipcash/shared/session/src/main/kotlin/com/flipcash/app/session/internal/delegates/DepositDelegate.kt b/apps/flipcash/shared/session/src/main/kotlin/com/flipcash/app/session/internal/delegates/DepositDelegate.kt
@@ -1,5 +1,7 @@
 package com.flipcash.app.session.internal.delegates
 
+import com.flipcash.app.analytics.Analytics
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.featureflags.FeatureFlag
 import com.flipcash.app.featureflags.FeatureFlagController
@@ -38,6 +40,7 @@ class DepositDelegate @Inject constructor(
     private val usdcSweep: UsdcDepositSweep,
     private val userManager: UserManager,
     private val resources: ResourceHelper,
+    private val analytics: FlipcashAnalyticsService,
     dispatchers: DispatcherProvider,
     featureFlagController: FeatureFlagController,
 ) : DepositOperations {
@@ -77,6 +80,8 @@ class DepositDelegate @Inject constructor(
                     text = resources.getString(R.string.action_addMoney)
                 ) {
                     scope.launch {
+                        // the scanner's Give action is the only session caller today
+                        analytics.addMoneyOpened(Analytics.AddMoneySource.Scanner)
                         val destination = purchaseMethodController.presentDepositOptions(popToRoot = true)
                         if (destination != null) {
                             onRoute?.invoke(destination)
diff --git a/apps/flipcash/shared/tokens/src/main/kotlin/com/flipcash/app/tokens/ui/SwapViewModel.kt b/apps/flipcash/shared/tokens/src/main/kotlin/com/flipcash/app/tokens/ui/SwapViewModel.kt

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,7 @@`
`1`	`1`	`package com.flipcash.app.cash.internal`
`2`	`2`
`3`	`3`	`import androidx.arch.core.executor.testing.InstantTaskExecutorRule`
	`4`	`+import com.flipcash.app.analytics.StubFlipcashAnalytics`
`4`	`5`	`import com.flipcash.app.core.MainCoroutineRule`
`5`	`6`	`import com.flipcash.app.core.dispatchers.TestDispatchers`
`6`	`7`	`import com.flipcash.app.tokens.TokenCoordinator`
`@@ -78,6 +79,7 @@ class CashScreenViewModelTest {`
`78`	`79`	`verifiedFiatCalculator = verifiedFiatCalculator,`
`79`	`80`	`tokenCoordinator = tokenCoordinator,`
`80`	`81`	`transactionController = transactionController,`
	`82`	`+ analytics = StubFlipcashAnalytics(),`
`81`	`83`	`dispatchers = dispatchers,`
`82`	`84`	`)`
`83`	`85`	`}`
Original file line number	Diff line number	Diff line change
`@@ -535,6 +535,7 @@ internal class ChatViewModel @Inject constructor(`
`535`	`535`	`eventFlow`
`536`	`536`	`.filterIsInstance<Event.PresentDepositOptions>()`
`537`	`537`	`.onEach {`
	`538`	`+ analytics.addMoneyOpened(Analytics.AddMoneySource.Chat)`
`538`	`539`	`purchaseMethodController.presentDepositOptions()?.let { route ->`
`539`	`540`	`dispatchEvent(Event.OpenScreen(route))`
`540`	`541`	`}`