✨ Feat: Mixpanel 분석 프로바이더 추가

TapTap/Projects/AnalyticsKit/Project.swift

@@ -18,7 +18,8 @@ let project = Project.project(
       dependencies: [
         .TCA(),
         .FirebaseAnalytics(),
-        .Amplitude()
+        .Amplitude(),
+        .Mixpanel()
       ]
     ),
     Target.target(

TapTap/Projects/AnalyticsKit/Sources/AnalyticsConfiguration.swift

@@ -9,16 +9,19 @@ import Foundation
 
 public struct AnalyticsConfiguration: Sendable {
   public let amplitudeAPIKey: String?
+  public let mixpanelToken: String?
   public let hasFirebaseConfigFile: Bool
 
   public let isDebugLoggingEnabled: Bool
 
   public init(
     amplitudeAPIKey: String?,
+    mixpanelToken: String?,
     hasFirebaseConfigFile: Bool,
     isDebugLoggingEnabled: Bool
   ) {
     self.amplitudeAPIKey = amplitudeAPIKey
+    self.mixpanelToken = mixpanelToken
     self.hasFirebaseConfigFile = hasFirebaseConfigFile
     self.isDebugLoggingEnabled = isDebugLoggingEnabled
   }
@@ -32,12 +35,14 @@ public struct AnalyticsConfiguration: Sendable {
 
     return AnalyticsConfiguration(
       amplitudeAPIKey: bundle.nonEmptyString(forInfoDictionaryKey: Self.amplitudeKeyName),
+      mixpanelToken: bundle.nonEmptyString(forInfoDictionaryKey: Self.mixpanelKeyName),
       hasFirebaseConfigFile: bundle.path(forResource: "GoogleService-Info", ofType: "plist") != nil,
       isDebugLoggingEnabled: isDebug
     )
   }
 
   static let amplitudeKeyName = "AMPLITUDE_API_KEY"
+  static let mixpanelKeyName = "MIXPANEL_TOKEN"
 }
 
 private extension Bundle {

TapTap/Projects/AnalyticsKit/Sources/AnalyticsService.swift

@@ -33,6 +33,14 @@ public final class AnalyticsService: Sendable {
         )
       )
     }
+    if configuration.mixpanelToken != nil {
+      providers.append(
+        MixpanelAnalyticsProvider(
+          token: configuration.mixpanelToken,
+          isVerboseLoggingEnabled: configuration.isDebugLoggingEnabled
+        )
+      )
+    }
 
     self.providers = providers
   }

TapTap/Projects/AnalyticsKit/Sources/Provider/MixpanelAnalyticsProvider.swift

@@ -0,0 +1,86 @@
+//
+//  MixpanelAnalyticsProvider.swift
+//  AnalyticsKit
+//
+//  Created by 홍 on 9/10/26.
+//
+
+import Foundation
+import os
+
+import Mixpanel
+
+public final class MixpanelAnalyticsProvider: AnalyticsProviding {
+  public let identifier = "Mixpanel"
+
+  private let logger = Logger(subsystem: "TapTap", category: "AnalyticsKit.Mixpanel")
+
+  private let client: MixpanelInstance?
+
+  public init(token: String?, isVerboseLoggingEnabled: Bool = false) {
+    guard let token else {
+      client = nil
+      return
+    }
+
+    // trackAutomaticEvents: Amplitude의 [.sessions, .appLifecycles]와 같은 자리다.
+    // 세션·앱 생명주기만 자동으로 수집하고 화면 뷰는 포함하지 않는다 — screen_view는
+    // 리듀서에서 직접 심는다(뷰 자동수집은 SwiftUI에서 화면 구분이 뭉개진다).
+    let instance = Mixpanel.initialize(token: token, trackAutomaticEvents: true)
+    instance.loggingEnabled = isVerboseLoggingEnabled
+    client = instance
+  }
+
+  @discardableResult
+  public func start() -> Bool {
+    guard client != nil else {
+      logger.notice("MIXPANEL_TOKEN이 비어 있어 Mixpanel을 건너뛴다.")
+      return false
+    }
+    return true
+  }
+
+  public func track(_ event: AnalyticsEvent) {
+    guard let client else { return }
+    client.track(event: event.name, properties: event.parameters.mapValues(\.mixpanelValue))
+  }
+
+  public func setUserProperty(_ property: AnalyticsUserProperty) {
+    guard let client else { return }
+    client.people.set(properties: [property.name: property.value.mixpanelValue])
+  }
+
+  public func setUserID(_ userID: String?) {
+    guard let client else { return }
+    // Mixpanel의 identify는 nil을 받지 않는다. 사용자를 지우는 것은 reset이고,
+    // 그래야 다음 이벤트가 새 distinct_id로 나간다.
+    if let userID {
+      client.identify(distinctId: userID)
+    } else {
+      client.reset()
+    }
+  }
+
+  public func setCollectionEnabled(_ isEnabled: Bool) {
+    guard let client else { return }
+    if isEnabled {
+      client.optInTracking()
+    } else {
+      client.optOutTracking()
+    }
+  }
+}
+
+/// `AnalyticsValue`가 SDK를 모르게 두려고 여기에 둔다 —
+/// `firebaseValue`·`amplitudeValue`는 `Any`라 SDK 타입이 필요 없지만
+/// Mixpanel은 `MixpanelType` 프로토콜을 요구해서 import가 따라붙는다.
+private extension AnalyticsValue {
+  var mixpanelValue: MixpanelType {
+    switch self {
+    case .string(let value): return value
+    case .int(let value): return value
+    case .double(let value): return value
+    case .bool(let value): return value  // Amplitude와 같이 native boolean. GA4만 문자열이다
+    }
+  }
+}

TapTap/Projects/AnalyticsKit/Tests/AnalyticsServiceTests.swift

@@ -32,6 +32,7 @@ final class AnalyticsServiceTests: XCTestCase {
   func test_키가_없으면_프로바이더가_붙지_않는다() {
     let configuration = AnalyticsConfiguration(
       amplitudeAPIKey: nil,
+      mixpanelToken: nil,
       hasFirebaseConfigFile: false,
       isDebugLoggingEnabled: false
     )
@@ -45,6 +46,10 @@ final class AnalyticsServiceTests: XCTestCase {
     XCTAssertFalse(AmplitudeAnalyticsProvider(apiKey: nil).start())
   }
 
+  func test_Mixpanel은_토큰이_없으면_시작하지_않는다() {
+    XCTAssertFalse(MixpanelAnalyticsProvider(token: nil).start())
+  }
+
   func test_유저프로퍼티_이름과_구간() {
     let provider = RecordingProvider(identifier: "p")
     let service = AnalyticsService(providers: [provider])

TapTap/Projects/App/Project.swift

@@ -23,6 +23,7 @@ let appTarget = Target.target(
       "ITSAppUsesNonExemptEncryption": false,
 
       "AMPLITUDE_API_KEY": "$(AMPLITUDE_API_KEY)",
+      "MIXPANEL_TOKEN": "$(MIXPANEL_TOKEN)",
 
       "FirebaseAutomaticScreenReportingEnabled": false,
 

TapTap/Tuist/Package.swift

@@ -8,7 +8,8 @@ let packageSettings = PackageSettings(
   productTypes: [
     "ComposableArchitecture": .framework,
     "Lottie": .staticFramework,
-    "AmplitudeSwift": .staticFramework
+    "AmplitudeSwift": .staticFramework,
+    "Mixpanel": .staticFramework
   ]
 )
 #endif
@@ -31,6 +32,10 @@ let package = Package(
     .package(
       url: "https://github.com/amplitude/Amplitude-Swift.git",
       from: "1.18.8"
+    ),
+    .package(
+      url: "https://github.com/mixpanel/mixpanel-swift.git",
+      from: "5.0.0"
     )
   ]
 )

TapTap/Tuist/ProjectDescriptionHelpers/PackageName.swift

@@ -15,4 +15,5 @@ public extension Package {
 public extension Package {
   static let firebaseAnalytics = "FirebaseAnalytics"
   static let amplitude = "AmplitudeSwift"
+  static let mixpanel = "Mixpanel"
 }

TapTap/Tuist/ProjectDescriptionHelpers/TargetDependency+Library.swift

@@ -25,4 +25,8 @@ extension TargetDependency {
   public static func Amplitude() -> TargetDependency {
     .external(name: Package.amplitude)
   }
+
+  public static func Mixpanel() -> TargetDependency {
+    .external(name: Package.mixpanel)
+  }
 }