feat: implement Google Analytics integration for launcher usage and settings tracking

Okladnoj · Okladnoj · commit 64fe14c50193 · 2026-06-30T17:21:50.000+03:00
diff --git a/Platform/MacOS/Launcher/.env.example b/Platform/MacOS/Launcher/.env.example
@@ -0,0 +1,2 @@
+GO_GA_MEASUREMENT_ID=G-XXXXXXXXXXXX
+GO_GA_API_SECRET=XXXXXXXXXXXXXXXXXX
diff --git a/Platform/MacOS/Launcher/.gitignore b/Platform/MacOS/Launcher/.gitignore
@@ -2,3 +2,5 @@ build/
 outputs/
 .DS_Store
 launcher.log
+.env
+!.env.example
diff --git a/Platform/MacOS/Launcher/Sources/Analytics.swift b/Platform/MacOS/Launcher/Sources/Analytics.swift
@@ -0,0 +1,94 @@
+import Foundation
+
+enum Analytics {
+    private static let measurementId =
+        (Bundle.main.object(forInfoDictionaryKey: "GAMeasurementId") as? String) ?? ""
+    private static let apiSecret =
+        (Bundle.main.object(forInfoDictionaryKey: "GAApiSecret") as? String) ?? ""
+    private static let collectEndpoint = "https://www.google-analytics.com/mp/collect"
+
+    private static let optOutKey = "GA_ANALYTICS_OPT_OUT"
+    private static let clientIdKey = "GA_CLIENT_ID"
+
+    static var isOptedOut: Bool {
+        get { UserDefaults.standard.bool(forKey: optOutKey) }
+        set { UserDefaults.standard.set(newValue, forKey: optOutKey) }
+    }
+
+    private static let clientId: String = {
+        if let existing = UserDefaults.standard.string(forKey: clientIdKey) {
+            return existing
+        }
+        let generated = UUID().uuidString
+        UserDefaults.standard.set(generated, forKey: clientIdKey)
+        return generated
+    }()
+
+    private static let launcherVersion: String =
+        (Bundle.main.object(forInfoDictionaryKey: "GOLauncherVersion") as? String) ?? "unknown"
+
+    static func log(_ name: String, _ params: [String: Any] = [:]) {
+        guard !isOptedOut, measurementId.hasPrefix("G-"), !apiSecret.isEmpty else { return }
+
+        var enriched = params
+        enriched["engagement_time_msec"] = 1
+        enriched["launcher_version"] = launcherVersion
+
+        let payload: [String: Any] = [
+            "client_id": clientId,
+            "events": [["name": name, "params": enriched]]
+        ]
+
+        guard
+            let body = try? JSONSerialization.data(withJSONObject: payload),
+            let url = URL(string: "\(collectEndpoint)?measurement_id=\(measurementId)&api_secret=\(apiSecret)")
+        else { return }
+
+        var request = URLRequest(url: url)
+        request.httpMethod = "POST"
+        request.httpBody = body
+        URLSession.shared.dataTask(with: request).resume()
+    }
+
+    static func logOpen(uiLanguage: String) {
+        log("launcher_open", [
+            "ui_language": uiLanguage,
+            "os_version": ProcessInfo.processInfo.operatingSystemVersionString
+        ])
+    }
+
+    static func logSettingsSnapshot(_ vm: LauncherViewModel) {
+        log("settings_snapshot", [
+            "windowed_edge_scroll": vm.isWindowedEdgeScrollEnabled.gaFlag,
+            "hotkey_labels": vm.showHotkeyLabels.gaFlag,
+            "game_language": vm.gameLanguage,
+            "ui_language": vm.selectedLanguage,
+            "limit_framerate": vm.limitFramerate.gaFlag,
+            "fps_limit": Int(vm.fpsLimit),
+            "stats_overlay": vm.statsOverlay.gaFlag,
+            "alternative_endpoint": vm.useAlternativeEndpoint.gaFlag,
+            "verbose_logging": vm.verboseLogging.gaFlag,
+            "camera_move_speed": vm.cameraMoveSpeed
+        ])
+    }
+
+    static func logSettingChanged(_ key: String, value: Any) {
+        log("setting_changed_\(key)", ["setting_value": "\(value)"])
+    }
+
+    static func logTabSelected(_ tab: String) {
+        log("tab_selected", ["tab": tab])
+    }
+
+    static func logGameLaunched() {
+        log("game_launched")
+    }
+
+    static func logPatchStarted(source: String) {
+        log("patch_started", ["source": source])
+    }
+}
+
+private extension Bool {
+    var gaFlag: Int { self ? 1 : 0 }
+}
diff --git a/Platform/MacOS/Launcher/Sources/LauncherViewModel.swift b/Platform/MacOS/Launcher/Sources/LauncherViewModel.swift
@@ -24,17 +24,20 @@ class LauncherViewModel: ObservableObject {
                 "ScreenEdgeScrollEnabledInWindowedApp": valStr,
                 "CursorCaptureEnabledInWindowedGame": isWindowedEdgeScrollEnabled ? "yes" : "no"
             ])
+            reportSettingChange("windowed_edge_scroll", isWindowedEdgeScrollEnabled)
         }
     }
     @Published var showHotkeyLabels: Bool = SettingsDefaults.showHotkeyLabels {
         didSet {
             OptionsIniHelper.writeValue(value: showHotkeyLabels ? "yes" : "no", forKey: "ShowHotKeyLabels")
+            reportSettingChange("hotkey_labels", showHotkeyLabels)
         }
     }
     @Published var gameLanguage: String = SettingsDefaults.gameLanguage {
         didSet {
             guard !isInitializing else { return }
             OptionsIniHelper.writeValue(value: gameLanguage, forKey: "Language")
+            reportSettingChange("game_language", gameLanguage)
         }
     }
     
@@ -51,23 +54,35 @@ class LauncherViewModel: ObservableObject {
     
     // settings.json render settings
     @Published var limitFramerate: Bool = SettingsDefaults.limitFramerate {
-        didSet { saveSettings() }
+        didSet {
+            saveSettings()
+            reportSettingChange("limit_framerate", limitFramerate)
+        }
     }
     @Published var fpsLimit: Double = SettingsDefaults.fpsLimit {
         didSet { saveSettings() }
     }
     @Published var statsOverlay: Bool = SettingsDefaults.statsOverlay {
-        didSet { saveSettings() }
+        didSet {
+            saveSettings()
+            reportSettingChange("stats_overlay", statsOverlay)
+        }
     }
     
     // settings.json network settings
     @Published var useAlternativeEndpoint: Bool = SettingsDefaults.useAlternativeEndpoint {
-        didSet { saveSettings() }
+        didSet {
+            saveSettings()
+            reportSettingChange("alternative_endpoint", useAlternativeEndpoint)
+        }
     }
     
     // settings.json debug settings
     @Published var verboseLogging: Bool = SettingsDefaults.verboseLogging {
-        didSet { saveSettings() }
+        didSet {
+            saveSettings()
+            reportSettingChange("verbose_logging", verboseLogging)
+        }
     }
 
     var steamCMD = SteamCMDManager()
@@ -135,13 +150,21 @@ class LauncherViewModel: ObservableObject {
         
         self.isInitializing = false
         updateChecker.startPeriodicChecks()
+
+        Analytics.logOpen(uiLanguage: selectedLanguage)
+        Analytics.logSettingsSnapshot(self)
     }
 
     func saveCredentials() {
         guard !steamUsername.isEmpty, !steamPassword.isEmpty else { return }
         KeychainHelper.save(account: steamUsername, password: steamPassword)
     }
 
+    private func reportSettingChange(_ key: String, _ value: Any) {
+        guard !isInitializing else { return }
+        Analytics.logSettingChanged(key, value: value)
+    }
+
     private func saveSettings() {
         guard !isInitializing else { return }
         SettingsJsonHelper.writeSettings(
@@ -244,6 +267,7 @@ class LauncherViewModel: ObservableObject {
     }
 
     func confirmPatching() {
+        Analytics.logPatchStarted(source: activeTab.rawValue)
         switch activeTab {
         case .steam:
             assetPatcher.startPatching(rootDir: steamCMD.installDir, zhDir: steamCMD.assetsDir)
@@ -280,6 +304,8 @@ class LauncherViewModel: ObservableObject {
         do {
             try task.run()
 
+            Analytics.logGameLaunched()
+
             DispatchQueue.global().async {
                 Thread.sleep(forTimeInterval: 0.5)
                 DispatchQueue.main.async {
diff --git a/Platform/MacOS/Launcher/Sources/MainView.swift b/Platform/MacOS/Launcher/Sources/MainView.swift
@@ -148,6 +148,9 @@ struct MainView: View {
         }
 
         return Button(action: {
+            if viewModel.activeTab != tab {
+                Analytics.logTabSelected(tab.rawValue)
+            }
             withAnimation(.easeInOut(duration: 0.2)) {
                 viewModel.activeTab = tab
             }
diff --git a/Platform/MacOS/Launcher/assemble_distribution.sh b/Platform/MacOS/Launcher/assemble_distribution.sh
@@ -17,6 +17,12 @@
 VERSION="1.4.1"
 BUILD="10"
 
+if [ -f ".env" ]; then
+    set -a
+    . ./.env
+    set +a
+fi
+
 LAUNCHER_NAME="GeneralsLauncher"
 FINAL_APP_NAME="Generals Online"
 CMAKE_APP_DIR="../../../build/macos/GeneralsMD/GeneralsOnlineZH.app"
@@ -119,6 +125,16 @@ PLIST_FILE="$CONTENTS_DIR/Info.plist"
 /usr/libexec/PlistBuddy -c "Add :GOLauncherBuild string $BUILD" "$PLIST_FILE"
 echo "   Launcher version: v$VERSION (build $BUILD)"
 
+if [ -n "$GO_GA_MEASUREMENT_ID" ] && [ -n "$GO_GA_API_SECRET" ]; then
+    /usr/libexec/PlistBuddy -c "Delete :GAMeasurementId" "$PLIST_FILE" 2>/dev/null || true
+    /usr/libexec/PlistBuddy -c "Add :GAMeasurementId string $GO_GA_MEASUREMENT_ID" "$PLIST_FILE"
+    /usr/libexec/PlistBuddy -c "Delete :GAApiSecret" "$PLIST_FILE" 2>/dev/null || true
+    /usr/libexec/PlistBuddy -c "Add :GAApiSecret string $GO_GA_API_SECRET" "$PLIST_FILE"
+    echo "   Analytics: enabled ($GO_GA_MEASUREMENT_ID)"
+else
+    echo "   Analytics: disabled (no .env keys)"
+fi
+
 echo "📝 [5/7] Copying HTML instructions..."
 if [ -f "www/instructions.html" ]; then
     cp "www/instructions.html" "$OUTPUTS_DIR/$INSTRUCTIONS_NAME"

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+GO_GA_MEASUREMENT_ID=G-XXXXXXXXXXXX`
	`2`	`+GO_GA_API_SECRET=XXXXXXXXXXXXXXXXXX`
Original file line number	Diff line number	Diff line change
`@@ -148,6 +148,9 @@ struct MainView: View {`
`148`	`148`	`}`
`149`	`149`
`150`	`150`	`return Button(action: {`
	`151`	`+ if viewModel.activeTab != tab {`
	`152`	`+ Analytics.logTabSelected(tab.rawValue)`
	`153`	`+ }`
`151`	`154`	`withAnimation(.easeInOut(duration: 0.2)) {`
`152`	`155`	`viewModel.activeTab = tab`
`153`	`156`	`}`