Campaign tracking

README.md

@@ -196,7 +196,7 @@ The diagnostics will categorize issues as:
 The result object returned by `postInstallSearchLink()` and `extractLinkFromURL()` contains:
 
 - `url: URL?` - The extracted deep link URL to navigate to
-- `match_type: MatchType` - How the link was detected (`.unique`, `.default`, `.none`, `.unknown`)
+- `matchType: MatchType` - How the link was detected (`.unique`, `.heuristics`, `.ambiguous`, `.intent`, `.none`)
 - `analytics: [TracebackAnalyticsEvent]` - Analytics events you can send to your preferred platform
 
 ### TracebackConfiguration
@@ -283,4 +283,4 @@ do {
 - Test on physical devices for Universal Links validation
 - Use different network conditions
 - Test both fresh installs and existing app scenarios
-- Verify clipboard functionality works as expected
+- Verify clipboard functionality works as expected

Sources/Traceback/Private/APIProvider.swift → Sources/Traceback/Private/API/APIProvider.swift

@@ -33,4 +33,30 @@ struct APIProvider: Sendable {
             throw NetworkError(error: error)
         }
     }
+
+    func getCampaignLink(from url: String, isFirstCampaignOpen: Bool) async throws -> CampaignResponse {
+        var urlComponents = URLComponents(
+            url: config.host.appendingPathComponent("v1_get_campaign", isDirectory: false),
+            resolvingAgainstBaseURL: false
+        )
+
+        // Add query parameters
+        urlComponents?.queryItems = [
+            URLQueryItem(name: "link", value: url),
+            URLQueryItem(name: "isFirstCampaignOpen", value: String(isFirstCampaignOpen))
+        ]
+
+        guard let url = urlComponents?.url else {
+            throw NetworkError.unknown
+        }
+
+        var request = URLRequest(url: url)
+        request.httpMethod = "GET"
+
+        do {
+            return try await network.fetch(CampaignResponse.self, request: request)
+        } catch {
+            throw NetworkError(error: error)
+        }
+    }
 }

Sources/Traceback/Private/API/CampaignResponse.swift

@@ -0,0 +1,13 @@
+//
+//  CampaignResponse.swift
+//  traceback-ios
+//
+//  Created by Nacho Sánchez on 10/24/25.
+//
+
+import Foundation
+
+struct CampaignResponse: Decodable, Equatable, Sendable {
+    let result: URL?
+    let error: String?
+}

Sources/Traceback/Private/PostInstallLinkSearchResponse.swift → Sources/Traceback/Private/API/PostInstallLinkSearchResponse.swift

@@ -11,6 +11,7 @@ struct PostInstallLinkSearchResponse: Decodable, Equatable, Sendable {
     let deep_link_id: URL?
     let match_message: String
     let match_type: String
+    let match_campaign: String?
     let request_ip_version: String
     let utm_medium: String?
     let utm_source: String?
@@ -27,6 +28,8 @@ extension PostInstallLinkSearchResponse {
             return .ambiguous
         case "none":
             return .none
+        case "intent":
+            return .intent
         default:
             return .unknown
         }

Sources/Traceback/Private/CampaignTracker.swift

@@ -0,0 +1,56 @@
+//
+//  CampaignTracker.swift
+//  Traceback
+//
+//  Created by Nacho Sanchez on 24/10/25.
+//
+
+import Foundation
+
+class CampaignTracker {
+    private let userDefaults: UserDefaults
+    private let seenCampaignsKey = "_traceback_seen_campaigns"
+
+    init(userDefaults: UserDefaults = .standard) {
+        self.userDefaults = userDefaults
+    }
+
+    // Get all seen campaigns
+    private func getSeenCampaigns() -> Set<String> {
+        if let campaigns = userDefaults.array(forKey: seenCampaignsKey) as? [String] {
+            return Set(campaigns)
+        }
+        return Set()
+    }
+
+    // Save seen campaigns
+    private func saveSeenCampaigns(_ campaigns: Set<String>) {
+        userDefaults.set(Array(campaigns), forKey: seenCampaignsKey)
+    }
+
+    // Check if campaign has been seen before
+    func hasSeenCampaign(_ campaign: String) -> Bool {
+        return getSeenCampaigns().contains(campaign)
+    }
+
+    // Mark campaign as seen
+    func markCampaignAsSeen(_ campaign: String) {
+        var campaigns = getSeenCampaigns()
+        campaigns.insert(campaign)
+        saveSeenCampaigns(campaigns)
+    }
+
+    // Check and mark in one operation (returns true if first time)
+    func isFirstTimeSeen(_ campaign: String) -> Bool {
+        let isFirstTime = !hasSeenCampaign(campaign)
+        if isFirstTime {
+            markCampaignAsSeen(campaign)
+        }
+        return isFirstTime
+    }
+
+    // Clear all seen campaigns (useful for testing)
+    func clearSeenCampaigns() {
+        userDefaults.removeObject(forKey: seenCampaignsKey)
+    }
+}

Sources/Traceback/Private/DependenciesImpl/LoggerImpl.swift

@@ -18,14 +18,14 @@ extension Logger {
         return Logger(
             info: { message in
                 guard level == .info || level == .debug else { return }
-                logger.info("\(message())")
+                logger.info("\(message(), privacy: .public)")
             },
             debug: { message in
                 guard level == .debug else { return }
-                logger.debug("\(message())")
+                logger.debug("\(message(), privacy: .public)")
             },
             error: { message in
-                logger.error("\(message())")
+                logger.error("\(message(), privacy: .public)")
             }
         )
     }

Sources/Traceback/Private/DependenciesImpl/SystemInfoImpl.swift

@@ -14,7 +14,7 @@ enum TracebackSystemImpl {
         SystemInfo(
             installationTime: installationTime(),
             deviceModelName: deviceModelName(),
-            sdkVersion: sdkVersion(),
+            sdkVersion: TracebackSDK.sdkVersion,
             localeIdentifier: Locale.preferredLanguages.first ?? Locale.current.identifier,
             timezone: TimeZone.current,
             osVersion: UIDevice.current.systemVersion,
@@ -49,14 +49,4 @@ enum TracebackSystemImpl {
         }
 #endif
     }
-
-    private static func sdkVersion() -> String {
-        guard let infoDictSDKVersion = Bundle(for: TracebackSDKImpl.self)
-            .infoDictionary?["CFBundleShortVersionString"] as? String else {
-            // fails in unit test
-            // assertionFailure()
-            return "1.0.0"
-        }
-        return infoDictSDKVersion
-    }
 }

Sources/Traceback/Private/DeviceFingerprint.swift

@@ -15,6 +15,7 @@ struct DeviceFingerprint: Codable, Equatable, Sendable {
     let osVersion: String
     let sdkVersion: String
     let uniqueMatchLinkToCheck: URL?
+    let intentLink: URL?
     let device: DeviceInfo
 
     struct DeviceInfo: Codable, Equatable, Sendable {
@@ -33,6 +34,7 @@ struct DeviceFingerprint: Codable, Equatable, Sendable {
 func createDeviceFingerprint(
     system: SystemInfo,
     linkFromClipboard: URL?,
+    linkFromIntent: URL?,
     webviewInfo: WebViewInfo?
 ) -> DeviceFingerprint {
 
@@ -65,6 +67,7 @@ func createDeviceFingerprint(
         osVersion: system.osVersion,
         sdkVersion: system.sdkVersion,
         uniqueMatchLinkToCheck: linkFromClipboard,
+        intentLink: linkFromIntent,
         device: deviceInfo
     )
 }