Attribr SDK Docs

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

dependencies: [
    .package(url: "https://github.com/mrvltechnologies/attribr-ios", from: "1.4.1")
]

@MainActor
enum MyAttribrWrapper {
    static func start(apiKey: String) {
        Attribr.initialize(apiKey: apiKey)
        Attribr.setConsent(.granted)
        Attribr.trackLaunch()
    }
}

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()
    }
)

npm install @mrvltechnologies/attribr-react-native

npx expo install expo-application expo-crypto

import * as Attribr from '@mrvltechnologies/attribr-react-native';

Attribr.initialize({
  apiKey: 'attr_live_yourkey…',   // Client key (sdk_ingest scope) - see "API Key Format" below
  appId: 'com.yourcompany.yourapp',
});
Attribr.setConsent('granted');

await Attribr.trackLaunch();

<script
  src="https://attribr.dev/attribr-web.js"
  data-api-key="YOUR_ATTRIBR_KEY"   <!-- must be a Client key (sdk_ingest scope) -->
  data-app-id="com.yourcompany.yourapp"
  async
></script>

Attribr.trackEvent(
    name: "level_complete",
    value: 5,
    currency: nil,
    metadata: ["level": "5"]
)

Attribr.trackRevenue(
    amount: 9.99,
    currency: "GBP",
    productId: "com.yourapp.pro_monthly",
    transactionId: transaction.originalID.description,  // StoreKit 2
    store: "apple",
    eventType: "initial_purchase"
)

// AppDelegate.application(_:didRegisterForRemoteNotificationsWithDeviceToken:)
Attribr.registerPushToken(deviceToken)

Attribr.deleteAllData { success in
    // handle result
}

// 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
                    Task {
                        switch await Attribr.handleDeepLink(url) {
                        case .resolved(let destination, let metadata):
                            NavigationManager.shared.navigate(to: destination, metadata: metadata)
                        case .attributed(let destination):
                            NavigationManager.shared.navigate(to: destination)
                        case .notAttribrLink:
                            break // pass to your own URL handling
                        case .error(let message):
                            print("Attribr deep link error: \(message)")
                        }
                    }
                }
        }
    }
}

// 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)
    intent?.data?.let { uri ->
        val result = Attribr.handleDeepLink(uri)
        // handle result the same way as onNewIntent below
    }
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let { uri -> Attribr.handleDeepLink(uri) }
}

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)

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(eventName: "purchase", value: 4.99)

// Report engagement milestones (value is optional):
Attribr.updateConversionValue(eventName: "registration")
Attribr.updateConversionValue(eventName: "tutorial_complete")

// 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..."