feat(flipcash): add onboarding funnel and pool analytics events

bmc08gt · bmc08gt · commit 5b10954229c2 · 2025-07-15T23:06:12.000-04:00
Signed-off-by: Brandon McAnsh &lt;git@bmcreations.dev&gt;
diff --git a/apps/flipcash/app/src/main/kotlin/com/flipcash/app/MainActivity.kt b/apps/flipcash/app/src/main/kotlin/com/flipcash/app/MainActivity.kt
@@ -26,7 +26,9 @@ import com.flipcash.app.router.Router
 import com.flipcash.app.session.LocalSessionController
 import com.flipcash.app.shareable.LocalShareController
 import com.flipcash.app.shareable.ShareSheetController
+import com.flipcash.services.analytics.FlipcashAnalyticsService
 import com.flipcash.services.user.UserManager
+import com.getcode.libs.analytics.LocalAnalytics
 import com.getcode.opencode.compose.LocalExchange
 import com.getcode.opencode.exchange.Exchange
 import com.getcode.util.permissions.LocalPermissionChecker
@@ -99,6 +101,9 @@ class MainActivity : FragmentActivity() {
     @Inject
     lateinit var paymentController: PaymentController
 
+    @Inject
+    lateinit var analytics: FlipcashAnalyticsService
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         handleUncaughtException()
@@ -110,6 +115,7 @@ class MainActivity : FragmentActivity() {
                 LocalSystemSettings provides settingsHelper,
                 LocalNetworkObserver provides networkObserver,
                 LocalExchange provides exchange,
+                LocalAnalytics provides analytics,
                 LocalCurrencyUtils provides currencyUtils,
                 LocalVibrator provides vibrator,
                 LocalRouter provides router,
diff --git a/apps/flipcash/features/login/src/main/kotlin/com/flipcash/app/login/accesskey/LoginAccessKeyViewModel.kt b/apps/flipcash/features/login/src/main/kotlin/com/flipcash/app/login/accesskey/LoginAccessKeyViewModel.kt
@@ -3,6 +3,8 @@ package com.flipcash.app.login.accesskey
 import com.flipcash.app.accesskey.BaseAccessKeyViewModel
 import com.flipcash.app.auth.AuthManager
 import com.flipcash.app.core.storage.MediaScanner
+import com.flipcash.services.analytics.Action
+import com.flipcash.services.analytics.FlipcashAnalyticsService
 import com.flipcash.services.user.UserManager
 import com.getcode.libs.qr.QRCodeGenerator
 import com.getcode.manager.TopBarManager
@@ -20,15 +22,29 @@ class LoginAccessKeyViewModel @Inject constructor(
     qrCodeGenerator: QRCodeGenerator,
     mediaScanner: MediaScanner,
     private val userManager: UserManager,
-    private val authManager: AuthManager
+    private val authManager: AuthManager,
+    private val analytics: FlipcashAnalyticsService,
 ): BaseAccessKeyViewModel(resources, mnemonicManager, mediaScanner, userManager, qrCodeGenerator) {
 
-    suspend fun saveImage(): Result<Boolean> = saveBitmapToFile()
+    suspend fun saveImage(): Result<Boolean> = trackButton(Action.SaveAccessKey)
+        .fold(
+            onSuccess = { saveBitmapToFile() },
+            onFailure = { Result.failure(it) }
+        )
         .onSuccess { authManager.onUserAccessKeySeen() }
         .map { authManager.presentCredentialStorage() }
         .map { userManager.userFlags?.requiresIapForRegistration == true }
 
-    suspend fun onWroteDownInstead(): Result<Boolean> = authManager.onUserAccessKeySeen()
+    suspend fun onWroteDownInstead(): Result<Boolean> = trackButton(Action.SaveAccessKey)
+        .fold(
+            onSuccess = { authManager.onUserAccessKeySeen() },
+            onFailure = { Result.failure(it) }
+        )
         .map { authManager.presentCredentialStorage() }
         .map { userManager.userFlags?.requiresIapForRegistration == true }
+
+    private fun trackButton(action: Action): Result<Unit> {
+        analytics.action(action)
+        return Result.success(Unit)
+    }
 }
diff --git a/apps/flipcash/features/login/src/main/kotlin/com/flipcash/app/login/router/LoginViewModel.kt b/apps/flipcash/features/login/src/main/kotlin/com/flipcash/app/login/router/LoginViewModel.kt
@@ -3,6 +3,8 @@ package com.flipcash.app.login.router
 import androidx.lifecycle.viewModelScope
 import com.flipcash.app.auth.AuthManager
 import com.flipcash.features.login.R
+import com.flipcash.services.analytics.Action
+import com.flipcash.services.analytics.FlipcashAnalyticsService
 import com.flipcash.services.controllers.AccountController
 import com.getcode.manager.BottomBarManager
 import com.getcode.util.resources.ResourceHelper
@@ -25,6 +27,7 @@ class LoginViewModel @Inject constructor(
     private val authManager: AuthManager,
     private val accounts: AccountController,
     private val resources: ResourceHelper,
+    private val analytics: FlipcashAnalyticsService,
 ) : BaseViewModel2<LoginViewModel.State, LoginViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent
@@ -61,6 +64,7 @@ class LoginViewModel @Inject constructor(
 
         eventFlow
             .filterIsInstance<Event.CreateAccount>()
+            .onEach { analytics.action(Action.CreateAccount) }
             .map {
                 authManager.createAccount()
                     .onFailure {
diff --git a/apps/flipcash/features/pools/src/main/kotlin/com/flipcash/app/pools/internal/betting/PoolBettingViewModel.kt b/apps/flipcash/features/pools/src/main/kotlin/com/flipcash/app/pools/internal/betting/PoolBettingViewModel.kt
@@ -21,6 +21,7 @@ import com.flipcash.app.pools.PoolsCoordinator
 import com.flipcash.app.shareable.ShareSheetController
 import com.flipcash.app.shareable.Shareable
 import com.flipcash.features.pools.R
+import com.flipcash.services.analytics.FlipcashAnalyticsService
 import com.flipcash.services.models.ClosePoolError
 import com.flipcash.services.user.UserManager
 import com.getcode.ed25519.Ed25519
@@ -54,6 +55,7 @@ internal class PoolBettingViewModel @Inject constructor(
     shareController: ShareSheetController,
     resources: ResourceHelper,
     payments: PaymentController,
+    analytics: FlipcashAnalyticsService,
 ) : BaseViewModel2<PoolBettingViewModel.State, PoolBettingViewModel.Event>(
     initialState = State(),
     updateStateForEvent = updateStateForEvent
@@ -219,6 +221,7 @@ internal class PoolBettingViewModel @Inject constructor(
             .filterIsInstance<Event.OnPoolRendezvousChanged>()
             .filter { it.fromUser }
             .map { it.rendezvous }
+            .onEach { analytics.poolOpenedFromDeeplink(it.publicKeyBytes.toList()) }
             .map { rendezvous ->
                 dispatchEvent(Event.OnLoadingChanged(true))
                 poolsCoordinator.getPool(rendezvous)
@@ -381,6 +384,7 @@ internal class PoolBettingViewModel @Inject constructor(
                     is PaymentEvent.OnPaymentSuccess -> {
                         event.acknowledge(true) {
                             viewModelScope.launch {
+                                analytics.placedBidInPool(stateFlow.value.metadata.id)
                                 poolsCoordinator.onBetPaidForInPool(
                                     poolId = (event.metadata as PoolBidPaymentMetadata).pool.id
                                 )
@@ -475,6 +479,7 @@ internal class PoolBettingViewModel @Inject constructor(
                     }
                     is PaymentEvent.OnRpcFailure -> Unit
                     is PaymentEvent.OnPaymentSuccess -> {
+                        analytics.declaredOutcomeInPool(stateFlow.value.metadata.id)
                         event.acknowledge(true) {
                             dispatchEvent(Event.OnFundsDistributed(true))
                         }
@@ -537,6 +542,7 @@ internal class PoolBettingViewModel @Inject constructor(
                     }
                     is PaymentEvent.OnPaymentSuccess -> {
                         event.acknowledge(true) {
+                            analytics.declaredOutcomeInPool(stateFlow.value.metadata.id)
                             dispatchEvent(Event.OnFundsDistributed(true))
                         }
                     }
diff --git a/apps/flipcash/features/pools/src/main/kotlin/com/flipcash/app/pools/internal/create/PoolCreateViewModel.kt b/apps/flipcash/features/pools/src/main/kotlin/com/flipcash/app/pools/internal/create/PoolCreateViewModel.kt
@@ -302,6 +302,7 @@ internal class PoolCreateViewModel @Inject constructor(
                 },
                 onSuccess = {
                     dispatchEvent(Event.UpdateCreatingState(loading = false, success = true))
+                    analytics.poolCreated(it)
                     dispatchEvent(Event.OnPoolCreated(it))
                 }
             ).launchIn(viewModelScope)
diff --git a/apps/flipcash/shared/permissions/src/main/kotlin/com/flipcash/app/permissions/internal/PermissionScreenContent.kt b/apps/flipcash/shared/permissions/src/main/kotlin/com/flipcash/app/permissions/internal/PermissionScreenContent.kt
@@ -29,7 +29,9 @@ import androidx.compose.ui.tooling.preview.Preview
 import cafe.adriel.voyager.core.registry.ScreenRegistry
 import com.flipcash.app.core.NavScreenProvider
 import com.flipcash.app.theme.FlipcashDesignSystem
+import com.flipcash.services.analytics.Action
 import com.flipcash.shared.permissions.R
+import com.getcode.libs.analytics.LocalAnalytics
 import com.getcode.navigation.core.LocalCodeNavigator
 import com.getcode.theme.CodeTheme
 import com.getcode.theme.DesignSystem
@@ -41,7 +43,7 @@ import com.getcode.util.permissions.cameraPermissionCheck
 import com.getcode.util.permissions.notificationPermissionCheck
 
 internal enum class Permission {
-    Camera, Notifications
+    Notifications, Camera;
 }
 
 @Composable
@@ -51,12 +53,13 @@ internal fun PermissionScreenContent(
 ) {
     val navigator = LocalCodeNavigator.current
     val permissionChecker = LocalPermissionChecker.current
+    val analytics = LocalAnalytics.current
 
     when (permission) {
         Permission.Camera -> CameraPermissionScreenContent(
             onGranted = {
                 if (fromOnboarding) {
-//                    analytics.action(Action.CompletedOnboarding)
+                    analytics.action(Action.CompletedOnboarding)
                 }
                 navigator.replaceAll(ScreenRegistry.get(NavScreenProvider.HomeScreen.Scanner()))
             },
@@ -65,12 +68,12 @@ internal fun PermissionScreenContent(
             }
         )
         Permission.Notifications -> NotificationScreenContent {
-            if (fromOnboarding) {
-//                analytics.action(Action.CompletedOnboarding)
-            }
             if (permissionChecker.isDenied(Manifest.permission.CAMERA)) {
                 navigator.push(ScreenRegistry.get(NavScreenProvider.Permissions.Camera()))
             } else {
+                if (fromOnboarding) {
+                    analytics.action(Action.CompletedOnboarding)
+                }
                 navigator.replaceAll(ScreenRegistry.get(NavScreenProvider.HomeScreen.Scanner()))
             }
         }
@@ -79,12 +82,14 @@ internal fun PermissionScreenContent(
 
 @Composable
 internal fun CameraPermissionScreenContent(onGranted: () -> Unit, onNotGranted: () -> Unit) {
+    val analytics = LocalAnalytics.current
     var isResultHandled by remember { mutableStateOf(false) }
     val onNotificationResult: (Boolean) -> Unit = { isGranted ->
         if (!isResultHandled) {
             isResultHandled = true
 
             if (isGranted) {
+                analytics.action(Action.AllowCamera)
                 onGranted()
             } else {
                 onNotGranted()
@@ -154,9 +159,13 @@ internal fun CameraPermissionScreenContent(onGranted: () -> Unit, onNotGranted:
 
 @Composable
 internal fun NotificationScreenContent(onGranted: () -> Unit) {
+    val analytics = LocalAnalytics.current
     val onNotificationResult: (Boolean) -> Unit = { isGranted ->
         if (isGranted) {
+            analytics.action(Action.AllowPush)
             onGranted()
+        } else {
+            analytics.action(Action.SkipPush)
         }
     }
     val notificationPermissionCheck = notificationPermissionCheck(onResult = {
diff --git a/services/flipcash/src/main/kotlin/com/flipcash/services/analytics/Analytics.kt b/services/flipcash/src/main/kotlin/com/flipcash/services/analytics/Analytics.kt
@@ -4,11 +4,15 @@ import com.getcode.ed25519.Ed25519.KeyPair
 import com.getcode.libs.analytics.AnalyticsService
 import com.getcode.libs.analytics.AppAction
 import com.getcode.libs.analytics.AppActionSource
+import com.getcode.opencode.model.core.ID
 import com.getcode.opencode.model.financial.CurrencyCode
 import com.getcode.opencode.model.financial.Fiat
 import com.getcode.opencode.model.financial.LocalFiat
 import com.getcode.services.flipcash.BuildConfig
+import com.getcode.solana.keys.PublicKey
+import com.getcode.solana.keys.base58
 import com.getcode.utils.TraceType
+import com.getcode.utils.base58
 import com.getcode.utils.getPublicKeyBase58
 import com.getcode.utils.trace
 import com.google.firebase.ktx.Firebase
@@ -37,6 +41,11 @@ interface FlipcashAnalyticsService : AnalyticsService {
         currency: CurrencyCode,
         owner: KeyPair,
     )
+
+    fun poolOpenedFromDeeplink(id: ID)
+    fun poolCreated(id: ID)
+    fun placedBidInPool(id: ID)
+    fun declaredOutcomeInPool(id: ID)
 }
 
 class FlipcashAnalyticsManager @Inject constructor(
@@ -69,7 +78,9 @@ class FlipcashAnalyticsManager @Inject constructor(
 
     override fun unintentionalLogout() = Unit
 
-    override fun action(action: AppAction, source: AppActionSource?) = Unit
+    override fun action(action: AppAction, source: AppActionSource?) {
+        track(name = action.value)
+    }
 
     override fun transfer(event: AnalyticsEvent.Transfer, amount: LocalFiat?, successful: Boolean, error: Throwable?) {
         val properties = event.properties(localizedAmount = amount, successful = successful, error = error)
@@ -87,6 +98,30 @@ class FlipcashAnalyticsManager @Inject constructor(
         track(event.name, *properties.toList().toTypedArray())
     }
 
+    override fun poolOpenedFromDeeplink(id: ID) {
+        val event = AnalyticsEvent.PoolOpened(id)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun poolCreated(id: ID) {
+        val event = AnalyticsEvent.PoolCreated(id)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun placedBidInPool(id: ID) {
+        val event = AnalyticsEvent.PlacedBid(id)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
+    override fun declaredOutcomeInPool(id: ID) {
+        val event = AnalyticsEvent.DeclaredOutcome(id)
+        val properties = event.properties()
+        track(event.name, *properties.toList().toTypedArray())
+    }
+
     private fun track(name: String, vararg properties: Pair<String, String>) {
         if (BuildConfig.DEBUG) {
             trace(
@@ -104,6 +139,36 @@ class FlipcashAnalyticsManager @Inject constructor(
     }
 }
 
+sealed class Action : AppAction {
+    data object CreateAccount : Action() {
+        override val value: String = "Button: Create Account"
+    }
+
+    data object SaveAccessKey : Action() {
+        override val value: String = "Button: Save Access Key"
+    }
+
+    data object WroteAccessKey : Action() {
+        override val value: String = "Button: Wrote Access Key"
+    }
+
+    data object AllowCamera : Action() {
+        override val value: String = "Button: Allow Camera"
+    }
+
+    data object AllowPush : Action() {
+        override val value: String = "Button: Allow Push"
+    }
+
+    data object SkipPush : Action() {
+        override val value: String = "Button: Skip Push"
+    }
+
+    data object CompletedOnboarding : Action() {
+        override val value: String = "Complete Onboarding"
+    }
+}
+
 sealed interface AnalyticsEvent {
 
     val name: String
@@ -134,6 +199,26 @@ sealed interface AnalyticsEvent {
     data object ClaimedCashLink : Transfer {
         override val name: String = "Receive Cash Link"
     }
+
+    sealed interface PoolEvent : AnalyticsEvent {
+        val id: ID
+    }
+
+    data class PoolOpened(override val id: ID) : PoolEvent {
+        override val name: String = "Pool: Opened From Deeplink"
+    }
+
+    data class PoolCreated(override val id: ID) : PoolEvent {
+        override val name: String = "Pool: Created"
+    }
+
+    data class PlacedBid(override val id: ID) : PoolEvent {
+        override val name: String = "Pool: Place Bet"
+    }
+
+    data class DeclaredOutcome(override val id: ID) : PoolEvent {
+        override val name: String = "Pool: Declared Outcome"
+    }
 }
 
 private fun AnalyticsEvent.properties(
@@ -170,6 +255,10 @@ private fun AnalyticsEvent.properties(
                 put("Currency", event.currency.name)
                 put("Owner Public Key", event.owner.getPublicKeyBase58())
             }
+
+            is AnalyticsEvent.PoolEvent -> {
+                put("ID", event.id.base58)
+            }
         }
 
         if (localizedAmount != null) {

Original file line number	Diff line number	Diff line change
`@@ -302,6 +302,7 @@ internal class PoolCreateViewModel @Inject constructor(`
`302`	`302`	`},`
`303`	`303`	`onSuccess = {`
`304`	`304`	`dispatchEvent(Event.UpdateCreatingState(loading = false, success = true))`
	`305`	`+ analytics.poolCreated(it)`
`305`	`306`	`dispatchEvent(Event.OnPoolCreated(it))`
`306`	`307`	`}`
`307`	`308`	`).launchIn(viewModelScope)`