Deep Links & Attribution

The Datafly mobile SDKs extract UTM parameters and vendor click IDs from deep links, enabling campaign attribution for mobile app traffic.

Handling deep links

Call handleDeepLink() when your app receives a deep link URL:

iOS (Swift)

// SwiftUI
.onOpenURL { url in
    Datafly.shared.handleDeepLink(url: url)
}
 
// UIKit SceneDelegate
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    if let url = URLContexts.first?.url {
        Datafly.shared.handleDeepLink(url: url)
    }
}
 
// UIKit AppDelegate (legacy)
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
    Datafly.shared.handleDeepLink(url: url)
    return true
}

Android (Kotlin)

// In your Activity
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    intent.data?.let { Datafly.handleDeepLink(it) }
}
 
override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let { Datafly.handleDeepLink(it) }
}

React Native

import { Linking } from 'react-native';
 
Linking.addEventListener('url', ({ url }) => {
  DataflySignal.handleDeepLink(url);
});

What gets extracted

UTM parameters

UTM parameters are attached to all subsequent events in the context.campaign object until overwritten by a new deep link.

Vendor click IDs

The SDK extracts 13 vendor-specific click IDs from URL query parameters:

Click IDs are included in the vendor IDs payload and delivered to the corresponding vendor’s API for conversion attribution.

Example deep link URL

https://example.com/product/123?utm_source=google&utm_medium=cpc&utm_campaign=summer_sale&gclid=abc123&fbclid=def456

This would:

1. Set campaign context: { source: "google", medium: "cpc", campaign: "summer_sale" }
2. Capture click IDs: { gclid: "abc123", fbclid: "def456" }
3. Attach both to all subsequent events

Universal Links / App Links

The handleDeepLink() method works with any URL format:

• Custom scheme: myapp://product/123?gclid=abc
• Universal Links (iOS): https://example.com/product/123?gclid=abc
• App Links (Android): https://example.com/product/123?gclid=abc

The SDK only reads query parameters — it does not interpret the URL path or scheme.