Attribr SDK Docs

https://github.com/mrvltechnologies/attribr-ios

packages:
  Attribr:
    path: /path/to/Attribr-by-MRVL/sdk/swift

targets:
  YourApp:
    dependencies:
      - package: Attribr
        product: Attribr

import SwiftUI
import Attribr

@main
struct YourApp: App {
    init() {
        Attribr.initialize(apiKey: "attr_live_yourkey…")
        Attribr.setConsent(.granted)
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
                .onChange(of: scenePhase) { _, phase in
                    if phase == .active {
                        Attribr.trackLaunch()
                    }
                }
        }
    }

    @Environment(\.scenePhase) private var scenePhase
}

includeBuild("/path/to/Attribr-by-MRVL/sdk/kotlin")

dependencies {
    implementation("com.mrvltechnologies:attribr:1.0.0")
}

import com.mrvltechnologies.attribr.Attribr
import com.mrvltechnologies.attribr.ConsentState

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Attribr.initialize(this, apiKey = "attr_live_yourkey…")
        Attribr.setConsent(ConsentState.GRANTED)
    }
}

// Option A — Base Activity
override fun onResume() {
    super.onResume()
    Attribr.trackLaunch()
}

// Option B — ProcessLifecycleOwner (recommended for multi-activity apps)
ProcessLifecycleOwner.get().lifecycle.addObserver(
    LifecycleEventObserver { _, event ->
        if (event == Lifecycle.Event.ON_START) Attribr.trackLaunch()
    }
)

// 1. Add Associated Domains entitlement in Xcode:
//    applinks:yourapp.attribr.dev

// 2. Handle deep links in your App.swift:
import Attribr

@main
struct YourApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .onOpenURL { url in
                    Attribr.handleDeepLink(url)
                }
        }
    }
}

// 3. Register a deep link handler:
Attribr.onDeepLink { destination, params in
    // destination: the screen path (e.g. "product/123")
    // params: query parameters as [String: String]
    NavigationManager.shared.navigate(to: destination, params: params)
}

// 4. Handle deferred deep links (user installs first, then routes):
Attribr.checkDeferredDeepLink { destination, params in
    guard let destination else { return }
    NavigationManager.shared.navigate(to: destination, params: params)
}

// 1. Add intent filter in AndroidManifest.xml:
// <intent-filter android:autoVerify="true">
//     <action android:name="android.intent.action.VIEW" />
//     <category android:name="android.intent.category.DEFAULT" />
//     <category android:name="android.intent.category.BROWSABLE" />
//     <data android:scheme="https" android:host="yourapp.attribr.dev" />
// </intent-filter>

// 2. Handle deep links in your Activity:
import com.mrvltechnologies.attribr.Attribr

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    Attribr.handleDeepLink(intent)
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    Attribr.handleDeepLink(intent)
}

// 3. Register a deep link handler:
Attribr.onDeepLink { destination, params ->
    // Navigate to the destination screen
    navController.navigate(destination)
}

// 4. Check for deferred deep links on first launch:
Attribr.checkDeferredDeepLink { destination, params ->
    destination?.let { navController.navigate(it) }
}

Dashboard → Ad Networks → Add Network → Select provider
→ Paste API token / App ID → Save

Attribr sends server-to-server postbacks for:
  • install (attributed to a campaign)
  • retention.day1 / day7 / day30
  • custom events (if configured)

// After Attribr.initialize() in App.init():
Attribr.enableAppleSearchAdsAttribution()

// This uses Apple's AdServices framework (no ATT required)
// to attribute installs to Search Ads campaigns.
// Results appear in your Sources and Ad Networks tabs.

import Attribr
import StoreKit

// In your App.init(), after Attribr.initialize():
Attribr.registerSKAN()

// This calls SKAdNetwork.registerAppForAdNetworkAttribution()
// and sets up conversion value management.

// Report a conversion event (e.g. after a purchase):
Attribr.updateConversionValue(.purchase, revenue: 4.99)

// Report engagement milestones:
Attribr.updateConversionValue(.registration)
Attribr.updateConversionValue(.tutorialComplete)

// SKAN 4.0 coarse values (low / medium / high) are mapped
// automatically based on your conversion value schema,
// which you configure in the dashboard under SKAN settings.

Dashboard → Creators → Add Creator → Fill name + platform
→ Link generated: https://attribr.dev/l/cr_a3b7x9

Share this link with the creator. Every install from
this link is attributed to them automatically.

// Share the creator's unique link
let creatorLink = "https://attribr.dev/l/cr_a3b7x9"

// Option A — UIActivityViewController
let vc = UIActivityViewController(
    activityItems: [URL(string: creatorLink)!],
    applicationActivities: nil
)
present(vc, animated: true)

// Option B — In-app sharing (copy to clipboard)
UIPasteboard.general.string = creatorLink

// Share the creator's unique link
val creatorLink = "https://attribr.dev/l/cr_a3b7x9"

val sendIntent = Intent().apply {
    action = Intent.ACTION_SEND
    putExtra(Intent.EXTRA_TEXT, creatorLink)
    type = "text/plain"
}
startActivity(Intent.createChooser(sendIntent, "Share link"))

# Create a creator campaign
curl -X POST https://your-dashboard.vercel.app/api/v1/creators \
  -H "X-Attribr-Key: attr_live_yourkey..." \
  -H "Content-Type: application/json" \
  -d '{"app_id": "com.yourapp", "name": "Sarah Tech Reviews", "platform": "youtube", "handle": "sarahtechreviews"}'

# Response includes the generated link:
# { "creator": { "link_url": "https://attribr.dev/l/cr_a3b7x9", ... } }

# List all creators with stats
curl https://your-dashboard.vercel.app/api/v1/creators?app_id=com.yourapp \
  -H "X-Attribr-Key: attr_live_yourkey..."