feat: add analytics metrics around deeplink success rates

Signed-off-by: Brandon McAnsh <git@bmcreations.dev>

Author: bmc08gt

apps/flipcash/app/src/main/kotlin/com/flipcash/app/internal/ui/App.kt

@@ -29,6 +29,7 @@ import cafe.adriel.voyager.navigator.Navigator
 import cafe.adriel.voyager.navigator.currentOrThrow
 import cafe.adriel.voyager.transitions.CrossfadeTransition
 import cafe.adriel.voyager.transitions.SlideTransition
+import com.flipcash.app.analytics.rememberAnalytics
 import com.flipcash.app.android.BuildConfig
 import com.flipcash.app.bill.customization.BillPlaygroundScaffold
 import com.flipcash.app.core.LocalUserManager
@@ -80,7 +81,7 @@ internal fun App(
     solanaRpcConfig: RpcConfig,
 ) {
     val router = LocalRouter.currentOrThrow
-
+    val analytics = rememberAnalytics()
     val viewModel = getActivityScopedViewModel<HomeViewModel>()
     val requireBiometrics by viewModel.requireBiometrics.collectAsStateWithLifecycle()
     val biometricsState = rememberBiometricsState(
@@ -104,7 +105,9 @@ internal fun App(
     var loginRequest by remember { mutableStateOf<String?>(null) }
     val userManager = LocalUserManager.currentOrThrow
     DeepLinkListener {
+        analytics.deeplinkOpened(it.data)
         val type = router.processType(it)
+        analytics.deeplinkParsed(type, it.data)
         if (type is DeeplinkType.Login) {
             loginRequest = type.entropy
         }

apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/Scanner.kt

@@ -74,6 +74,7 @@ internal fun Scanner(deepLink: DeeplinkType?) {
         previewing = previewing,
         session = session,
         navigator = navigator,
+        analytics = analytics,
     ) {
         deepLinkSaved = null
     }
@@ -115,9 +116,10 @@ internal fun Scanner(deepLink: DeeplinkType?) {
                         is CodeScanResult.QrCode -> {
                             val urls = result.results
                             val deeplink = urls.firstNotNullOfOrNull { url ->
-                                router.processType(DeepLink(url))
+                                val type = router.processType(DeepLink(url))
+                                analytics.deeplinkParsed(type, url)
+                                type
                             }
-                            println("deeplink type = $deeplink")
                             if (deeplink != null) {
                                 vibrator.vibrate(duration = 50)
                                 deepLinkSaved = deeplink

apps/flipcash/features/scanner/src/main/kotlin/com/flipcash/app/scanner/internal/ScannerDeepLinkHandler.kt

@@ -20,6 +20,7 @@ internal fun ScannerDeepLinkHandler(
     previewing: Boolean?,
     session: SessionController,
     navigator: CodeNavigator,
+    analytics: FlipcashAnalyticsService,
     onDeeplinkHandled: () -> Unit,
 ) {
 
@@ -32,11 +33,7 @@ internal fun ScannerDeepLinkHandler(
         NavigationStateRestorer(navigator)
     }
 
-    LaunchedEffect(
-        biometricsState,
-        previewing,
-        deepLink
-    ) {
+    LaunchedEffect(biometricsState, previewing) {
         if (previewing == true) {
             focusManager.clearFocus()
         }
@@ -46,16 +43,20 @@ internal fun ScannerDeepLinkHandler(
         if (previewing != null) {
             session.onCameraScanning(previewing)
         }
+    }
+
+    LaunchedEffect(deepLink, biometricsState.passed) {
+        if (!biometricsState.passed) return@LaunchedEffect
 
         val link = deepLink ?: return@LaunchedEffect
 
         when (link) {
             is DeeplinkType.CashLink -> {
                 session.openCashLink(link.entropy)
             }
-
             is DeeplinkType.Login -> Unit
             is DeeplinkType.Navigatable -> {
+                analytics.deeplinkRouted(link)
                 stateRestorer.restoreState(link, animationScale)
             }
         }

apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Analytics.kt

@@ -28,6 +28,9 @@ interface FlipcashAnalyticsService : AnalyticsService {
     fun openTokenInfo(source: Analytics.TokenInfoSource, mint: Mint)
     fun buy(method: Analytics.PurchaseMethod, mint: Mint, amount: Fiat, error: Throwable? = null)
     fun sell(mint: Mint, amount: Fiat, feeAmount: Fiat, error: Throwable? = null)
+    fun deeplinkOpened(url: String)
+    fun deeplinkParsed(type: DeeplinkType?, url: String)
+    fun deeplinkRouted(type: DeeplinkType, error: Throwable? = null)
 
     fun buttonTapped(button: Button) {
         action(button)
@@ -84,6 +87,10 @@ class StubFlipcashAnalytics : FlipcashAnalyticsService {
     override fun openTokenInfo(source: Analytics.TokenInfoSource, mint: Mint) = Unit
     override fun buy(method: Analytics.PurchaseMethod, mint: Mint, amount: Fiat, error: Throwable?) = Unit
     override fun sell(mint: Mint, amount: Fiat, feeAmount: Fiat, error: Throwable?) = Unit
+
+    override fun deeplinkOpened(url: String) = Unit
+    override fun deeplinkParsed(type: DeeplinkType?, url: String) = Unit
+    override fun deeplinkRouted(type: DeeplinkType, error: Throwable?) = Unit
 }
 
 @Composable

apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/Events.kt

@@ -29,6 +29,37 @@ internal sealed interface AnalyticsEvent {
         )
     }
 
+    sealed interface DeeplinkEvent : AnalyticsEvent {
+        data class Open(val url: String) : DeeplinkEvent {
+            override val name = "Deeplink: Open"
+            override fun toProperties() = mapOf("URL" to url)
+        }
+
+        data class Parse(
+            val type: DeeplinkType? = null,
+            val url: String,
+        ) : DeeplinkEvent {
+            override val name = "Deeplink: Parse"
+            override fun toProperties() = buildMap {
+                type?.let { put("Type", it.javaClass.simpleName) }
+                if (type == null) {
+                    put("Error", "Failed to parse deeplink => $url")
+                }
+            }
+        }
+
+        data class Routed(
+            val type: DeeplinkType,
+            val error: Throwable? = null
+        ) : DeeplinkEvent {
+            override val name = "Deeplink: Routed"
+            override fun toProperties() = buildMap {
+                put("Type", type.javaClass.simpleName)
+                error?.let { put("Error", it.message.orEmpty()) }
+            }
+        }
+    }
+
     sealed interface Transfer : AnalyticsEvent
 
     data class GrabBill(val time: Long?) : Transfer {

apps/flipcash/shared/analytics/src/main/kotlin/com/flipcash/app/analytics/internal/MixpanelAnalyticsDelegate.kt

@@ -200,6 +200,18 @@ internal class MixpanelAnalyticsDelegate @Inject constructor(
         track(AnalyticsEvent.TokenTransactionEvent.Sell(mint, amount, feeAmount, error))
     }
 
+    override fun deeplinkOpened(url: String) {
+        track(AnalyticsEvent.DeeplinkEvent.Open(url))
+    }
+
+    override fun deeplinkParsed(type: DeeplinkType?, url: String) {
+        track(AnalyticsEvent.DeeplinkEvent.Parse(type, url))
+    }
+
+    override fun deeplinkRouted(type: DeeplinkType, error: Throwable?) {
+        track(AnalyticsEvent.DeeplinkEvent.Routed(type, error))
+    }
+
     // region Internal
 
     private fun track(event: AnalyticsEvent, vararg extra: Pair<String, String>) {

apps/flipcash/shared/router/src/main/kotlin/com/flipcash/app/router/inject/RouterModule.kt

@@ -1,5 +1,6 @@
 package com.flipcash.app.router.inject
 
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.router.internal.AppRouter
 import com.flipcash.app.router.Router
 import com.flipcash.services.user.UserManager
@@ -17,5 +18,6 @@ object RouterModule {
     @Provides
     fun providesRouter(
         userManager: UserManager,
-    ): Router = AppRouter(userManager)
+        analytics: FlipcashAnalyticsService,
+    ): Router = AppRouter(userManager, analytics)
 }

apps/flipcash/shared/router/src/main/kotlin/com/flipcash/app/router/internal/AppRouter.kt

@@ -3,6 +3,7 @@ package com.flipcash.app.router.internal
 import androidx.core.net.toUri
 import cafe.adriel.voyager.core.registry.ScreenRegistry
 import cafe.adriel.voyager.core.screen.Screen
+import com.flipcash.app.analytics.FlipcashAnalyticsService
 import com.flipcash.app.core.AppRoute
 import com.flipcash.app.core.navigation.DeeplinkType
 import com.flipcash.app.core.navigation.Key
@@ -30,6 +31,7 @@ import org.json.JSONObject
 
 internal class AppRouter(
     private val userManager: UserManager,
+    private val analytics: FlipcashAnalyticsService,
 ) : Router, CoroutineScope by CoroutineScope(Dispatchers.IO) {
     companion object {
         val login = listOf("login")

apps/flipcash/shared/session/src/main/kotlin/com/flipcash/app/session/internal/RealSessionController.kt

@@ -707,6 +707,7 @@ class RealSessionController @Inject constructor(
 
         if (giftCardClaimInProgress.value == null) {
             giftCardClaimInProgress.value = entropy
+            analytics.deeplinkRouted(DeeplinkType.CashLink(entropy))
             claimGiftCard(owner = owner, entropy = entropy, claimIfOwned = false)
         }
     }