@apex-inc/capacitor-plugin 2.5.1 → 2.6.0

package/ApexIncCapacitorPlugin.podspec

@@ -11,6 +11,7 @@ Pod::Spec.new do |s|
   s.author = package['author']
   s.source = { :git => package['repository']['url'], :tag => s.version.to_s }
   s.source_files = 'ios/Sources/**/*.{swift,h,m,c,cc,mm,cpp}'
+  s.resource_bundles = { 'ApexIncCapacitorPluginPrivacy' => ['ios/Sources/PrivacyInfo.xcprivacy'] }
   s.ios.deployment_target = '13.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.9'

package/README.md

@@ -29,6 +29,8 @@ await Apex.initialize({
   // apiUrl: "https://app.apex.inc",
   // autoTrackScreenViews: true, // default — screen_view auto-fires from SPA navigation
   // autoConversionValues: true, // default — Apex drives SKAdNetwork values from Set up Apex (iOS)
+  // autoTrackInstall: true, // default — app_install once, on the first launch of a fresh install
+  // metaAppId: "1234567890", // Android: credits installs from Meta ads (see "Meta install referrer")
   // sessionTimeoutMinutes: 30,
   // offlineQueueMaxSize: 1000,
   // testMode: false,
@@ -36,7 +38,17 @@ await Apex.initialize({
 });
 ```
 
-`app_open` auto-fires on `initialize()`. `screen_view` auto-fires from
+On iOS and Android the plugin sends `app_install` itself, once, on the
+first launch of a fresh install, carrying what Apex needs to credit the
+ad behind it. Someone who had your app before you added Apex is not sent
+as an install. If your app already tracks `app_install`, keep it or
+remove it: only the first one per install is sent.
+
+Track `app_open` yourself on launch and when the app returns to the
+foreground; on iOS and Android the plugin does not send it for you. (In a
+browser preview, the web version sends one `app_open` per page load.)
+
+`screen_view` auto-fires from
 the webview's History API (pushState / replaceState / back-forward /
 hashchange — covers Ionic, React Router, Vue Router, and plain SPA
 routing, on device and in browser preview). Screen names default to the
@@ -169,6 +181,27 @@ const { status: current } = await Apex.getTrackingStatus();
 
 ## Advertising identifiers
 
+Every event carries the phone's details under `mobile` (app id, app
+version, OS version, model, language, time zone, and on iOS the tracking
+answer). Apex passes them to the ad networks you connect, so they can
+credit installs and purchases to their ads. The advertising id rides
+along only with permission:
+
+- **iOS**: the IDFA, only after the person allowed tracking in the ATT
+  prompt. Read on every event, so a change in Settings applies at once.
+- **Android**: the GAID, only when the person has not limited ad tracking
+  or deleted the id. Looked up at `initialize()` and again when the app
+  opens.
+
+The plugin ships an Apple privacy manifest that declares the advertising
+id, app activity and purchases as used for tracking, since Apex sends
+installs and purchases to the ad networks you connect. Xcode merges it into your app's privacy report;
+your App Store privacy label should say the same.
+
+The IDFV and Android ID fallbacks below are never put on events. If your
+app asks for consent with `requireConsent`, nothing is sent at all until
+`setConsent({ granted: true })`.
+
 ```ts
 // Returns IDFA (iOS, ATT authorized), GAID (Android), or fallback.
 const { id, fallback } = await Apex.getAdvertisingId();
@@ -177,6 +210,24 @@ if (!id && fallback === "idfv") {
 }
 ```
 
+## Meta install referrer (Android)
+
+The Facebook, Instagram and Facebook Lite apps remember the Meta ad a
+person tapped or saw before installing yours. Pass your Meta app id and
+the install carries that ad to Apex:
+
+```ts
+await Apex.initialize({ workspaceKey: "prj_your_key", metaAppId: "1234567890" });
+```
+
+Skip `metaAppId` if your app already has the Facebook SDK's
+`com.facebook.sdk.ApplicationId` manifest entry; the plugin reads it.
+The ad stays encrypted on the phone. Apex opens it with your install
+referrer key: in Meta for Developers, open your app's Basic settings,
+find "Install Referrer Decryption Key" under Android, and paste it in
+Apex under the Meta connection. Needs Facebook 428, Instagram 296 or
+Facebook Lite 411 or newer on the phone.
+
 ## SKAdNetwork conversion values (iOS 4.0+)
 
 You do not have to write this code. In the Apex dashboard, **Set up Apex →

package/android/src/main/AndroidManifest.xml

@@ -36,5 +36,10 @@
         <package android:name="com.google.android.feedback" />
         <package android:name="com.amazon.venezia" />
         <package android:name="com.sec.android.app.samsungapps" />
+        <!-- Meta Install Referrer: Android 11+ hides these apps' content
+             providers unless the app declares it looks for them. -->
+        <package android:name="com.facebook.katana" />
+        <package android:name="com.instagram.android" />
+        <package android:name="com.facebook.lite" />
     </queries>
 </manifest>

package/android/src/main/java/inc/apex/capacitor/ApexCapacitorPlugin.kt

@@ -67,9 +67,19 @@ class ApexCapacitorPlugin : Plugin() {
     // rather than returning null because the Play service hasn't
     // connected yet. Calls that arrive before the fetch completes are
     // parked and flushed by the listener.
-    private var installReferrerResolved: Boolean = false
+    @Volatile private var installReferrerResolved: Boolean = false
     private var installReferrerClickSeconds: Long = 0
     private val pendingReferrerCalls = mutableListOf<PluginCall>()
+    private val referrerLatch = java.util.concurrent.CountDownLatch(1)
+
+    // The install is sent once per install, by the plugin or the app, never both.
+    private var autoTrackInstall: Boolean = true
+    private val installLock = Any()
+
+    // Meta Install Referrer. Read once per launch, on the install event.
+    private var metaAppId: String? = null
+    @Volatile private var metaReferrerRead: Boolean = false
+    @Volatile private var metaReferrer: MetaInstallReferrer.Found? = null
     // Phase 2-SDK — workspace-bound SDK key forwarded as
     // `x-apex-api-key` on every event POST + on `identify()`.
     private var apiKey: String? = null
@@ -85,6 +95,27 @@ class ApexCapacitorPlugin : Plugin() {
     // Phase 4a — consent gate. Defaults granted; set false by
     // initialize({ requireConsent: true }) until setConsent({ granted:true }).
     private var consentGranted: Boolean = true
+
+    // The GAID, looked up off the main thread (Play services blocks) and
+    // refreshed on `app_open`, since the person can limit ad tracking or
+    // delete the id in Settings at any time.
+    @Volatile private var gaid: String? = null
+    @Volatile private var gaidResolved: Boolean = false
+    private val device by lazy {
+        val locale = Locale.getDefault()
+        MobileContext.Device(
+            bundleId = context.packageName,
+            appVersion = try {
+                context.packageManager.getPackageInfo(context.packageName, 0).versionName ?: "0.0.0"
+            } catch (_: Exception) {
+                "0.0.0"
+            },
+            osVersion = Build.VERSION.RELEASE,
+            deviceModel = "${Build.MANUFACTURER} ${Build.MODEL}".trim(),
+            timezone = TimeZone.getDefault().id,
+            locale = "${locale.language}-${locale.country}",
+        )
+    }
     // Phase 3 — per-launch dedup so each (experiment, variant) exposure fires
     // once. Concurrent set: getVariant resolves on background threads.
     private val firedExposures = java.util.concurrent.ConcurrentHashMap.newKeySet<String>()
@@ -156,6 +187,8 @@ class ApexCapacitorPlugin : Plugin() {
         apiKey = if (rawKey.isNullOrEmpty()) null else rawKey
         // Phase 4a — consent gate.
         consentGranted = !(call.getBoolean("requireConsent", false) ?: false)
+        metaAppId = MetaInstallReferrer.normalizeAppId(call.getString("metaAppId")) ?: manifestMetaAppId()
+        autoTrackInstall = call.getBoolean("autoTrackInstall", true) ?: true
         val maxSize = call.getInt("offlineQueueMaxSize") ?: 1000
 
         val queueFile = File(context.filesDir, "apex-capacitor/events.json")
@@ -210,10 +243,80 @@ class ApexCapacitorPlugin : Plugin() {
 
         // Fire-and-forget install referrer retrieval on init.
         fetchInstallReferrer()
+        Thread { resolveGaid() }.start()
+        // Off this thread: the install waits up to REFERRER_WAIT_MS for Play.
+        Thread { sendInstallIfFirstLaunch() }.start()
 
         call.resolve()
     }
 
+    /** First install time and this version's install time, from the package manager. */
+    private fun installTimes(): Pair<Long?, Long?> = try {
+        val info = context.packageManager.getPackageInfo(context.packageName, 0)
+        Pair(info.firstInstallTime, info.lastUpdateTime)
+    } catch (_: Exception) {
+        Pair(null, null)
+    }
+
+    /**
+     * Send `app_install` on the first launch of a fresh install. Marks the
+     * install as handled for someone who had the app before Apex, so the
+     * update that adds Apex reports no one as new.
+     */
+    private fun sendInstallIfFirstLaunch() {
+        if (!autoTrackInstall || !consentGranted || offlineQueue == null) return
+        val (installed, versionInstalled) = installTimes()
+        val decision = synchronized(installLock) {
+            val sent = prefs?.getBoolean(FirstLaunchInstall.PREF_KEY, false) == true
+            val d = FirstLaunchInstall.decide(sent, installed, versionInstalled, System.currentTimeMillis())
+            if (d != FirstLaunchInstall.Decision.ALREADY_SENT) {
+                prefs?.edit()?.putBoolean(FirstLaunchInstall.PREF_KEY, true)?.apply()
+            }
+            d
+        }
+        if (debug) println("[apex-capacitor] first-launch install: $decision")
+        if (decision != FirstLaunchInstall.Decision.SEND) return
+        try {
+            enqueuePayload(
+                UUID.randomUUID().toString().lowercase(),
+                mutableMapOf<String, Any?>("type" to "app_install", "data" to JSONObject().put("source", "apex_first_launch")),
+            )
+        } catch (e: Exception) {
+            if (debug) println("[apex-capacitor] first-launch install not queued: ${e.message}")
+        }
+    }
+
+    /** True the first time an install is claimed; the app's own `app_install` after that is dropped. */
+    private fun claimInstall(): Boolean = synchronized(installLock) {
+        if (prefs?.getBoolean(FirstLaunchInstall.PREF_KEY, false) == true) {
+            false
+        } else {
+            prefs?.edit()?.putBoolean(FirstLaunchInstall.PREF_KEY, true)?.apply()
+            true
+        }
+    }
+
+    private fun resolveGaid() {
+        if (Looper.myLooper() == Looper.getMainLooper()) return
+        gaid = try {
+            val info = AdvertisingIdClient.getAdvertisingIdInfo(context)
+            MobileContext.advertisingId(info.id, info.isLimitAdTrackingEnabled)
+        } catch (_: Exception) {
+            null
+        }
+        gaidResolved = true
+    }
+
+    /** The first event of a launch (often the install) waits for the lookup rather than going without. */
+    private fun currentGaid(): String? {
+        if (!gaidResolved) resolveGaid()
+        return gaid
+    }
+
+    private fun stampDevice(slot: MutableMap<String, Any?>) {
+        MobileContext.fill(slot, device, currentGaid())
+    }
+
     // ── Push notifications (FCM) ──────────────────────────────────────
     @PluginMethod
     fun registerForPushNotifications(call: PluginCall) {
@@ -812,7 +915,7 @@ class ApexCapacitorPlugin : Plugin() {
         payload["mobile"] = mutableMapOf<String, Any?>(
             "releaseChannel" to releaseChannel,
             "releaseChannelSource" to releaseChannelSource,
-        )
+        ).also { stampDevice(it) }
         val event = NativeQueuedEvent(
             id = UUID.randomUUID().toString().lowercase(),
             payload = payload,
@@ -902,8 +1005,7 @@ class ApexCapacitorPlugin : Plugin() {
     // ── Events / Queue ────────────────────────────────────────────────
     @PluginMethod
     fun track(call: PluginCall) {
-        val queue = offlineQueue
-        if (queue == null) {
+        if (offlineQueue == null) {
             call.reject("Plugin not initialized — call initialize() first")
             return
         }
@@ -916,6 +1018,22 @@ class ApexCapacitorPlugin : Plugin() {
         val id = call.getString("id") ?: UUID.randomUUID().toString().lowercase()
         val payload = mutableMapOf<String, Any?>()
         call.data.keys().forEach { key -> payload[key] = call.data.opt(key) }
+        if (payload["type"] == "app_install" && !claimInstall()) {
+            if (debug) println("[apex-capacitor] app_install already sent for this install; dropping")
+            call.resolve()
+            return
+        }
+        try {
+            enqueuePayload(id, payload)
+            call.resolve()
+        } catch (e: Exception) {
+            call.reject("Failed to enqueue event: ${e.message}")
+        }
+    }
+
+    /** Stamp and queue an event. Shared by `track()` and the plugin's own install. */
+    private fun enqueuePayload(id: String, payload: MutableMap<String, Any?>) {
+        val queue = offlineQueue ?: throw IllegalStateException("Plugin not initialized")
         TrackStamps.apply(payload, visitorId, testMode, java.time.Instant.now().toString())
 
         // MMP-061 — stamp release channel under event.mobile so the
@@ -934,7 +1052,10 @@ class ApexCapacitorPlugin : Plugin() {
         }
         mobileSlot["releaseChannel"] = releaseChannel
         mobileSlot["releaseChannelSource"] = releaseChannelSource
+        stampDevice(mobileSlot)
+        if (payload["type"] == "app_install") stampInstallReferrers(mobileSlot)
         payload["mobile"] = mobileSlot
+        if (payload["type"] == "app_open") Thread { resolveGaid() }.start()
 
         // MMP-081 — runtime context. Native Android plugin always
         // stamps `native-android`; we don't overwrite a value the
@@ -951,13 +1072,8 @@ class ApexCapacitorPlugin : Plugin() {
             attempts = 0,
             enqueuedAtMs = System.currentTimeMillis(),
         )
-        try {
-            queue.enqueue(event)
-            kickFlush("track")
-            call.resolve()
-        } catch (e: Exception) {
-            call.reject("Failed to enqueue event: ${e.message}")
-        }
+        queue.enqueue(event)
+        kickFlush("track")
     }
 
     @PluginMethod
@@ -1010,6 +1126,7 @@ class ApexCapacitorPlugin : Plugin() {
         if (granted) {
             // Resume: flush anything captured before this point.
             kickFlush("consent")
+            Thread { sendInstallIfFirstLaunch() }.start()
         } else {
             // Revoke: drop anything queued but not yet sent.
             try {
@@ -1108,8 +1225,71 @@ class ApexCapacitorPlugin : Plugin() {
         })
     }
 
+    /**
+     * The install event carries Play's referrer and Meta's, so Apex can
+     * credit the ad. Waits briefly for Play when it hasn't answered yet,
+     * off the main thread only.
+     */
+    private fun stampInstallReferrers(slot: MutableMap<String, Any?>) {
+        if (!installReferrerResolved && Looper.myLooper() != Looper.getMainLooper()) {
+            try {
+                referrerLatch.await(REFERRER_WAIT_MS, java.util.concurrent.TimeUnit.MILLISECONDS)
+            } catch (_: InterruptedException) { }
+        }
+        MetaInstallReferrer.stampInstall(slot, lastInstallReferrer, installReferrerClickSeconds, readMetaReferrer())
+    }
+
+    /** The Meta app id from the Facebook SDK's manifest entry, when the app has one. */
+    @Suppress("DEPRECATION")
+    private fun manifestMetaAppId(): String? = try {
+        val info = context.packageManager.getApplicationInfo(
+            context.packageName,
+            android.content.pm.PackageManager.GET_META_DATA,
+        )
+        MetaInstallReferrer.normalizeAppId(info.metaData?.get("com.facebook.sdk.ApplicationId")?.toString())
+    } catch (_: Exception) {
+        null
+    }
+
+    /** Ask the Facebook, Instagram and Facebook Lite apps for the Meta ad behind this install. */
+    private fun readMetaReferrer(): MetaInstallReferrer.Found? {
+        if (metaReferrerRead) return metaReferrer
+        val appId = metaAppId
+        if (appId == null) {
+            metaReferrerRead = true
+            return null
+        }
+        val found = mutableListOf<MetaInstallReferrer.Found>()
+        for ((authority, app) in MetaInstallReferrer.PROVIDERS) {
+            try {
+                if (context.packageManager.resolveContentProvider(authority, 0) == null) continue
+                val uri = Uri.parse("content://$authority/$appId")
+                context.contentResolver.query(uri, MetaInstallReferrer.COLUMNS, null, null, null)?.use { c ->
+                    if (!c.moveToFirst()) return@use
+                    val refIdx = c.getColumnIndex("install_referrer")
+                    if (refIdx < 0 || c.isNull(refIdx)) return@use
+                    val ctIdx = c.getColumnIndex("is_ct")
+                    val tsIdx = c.getColumnIndex("actual_timestamp")
+                    found += MetaInstallReferrer.Found(
+                        referrer = c.getString(refIdx),
+                        isClickThrough = if (ctIdx >= 0 && !c.isNull(ctIdx)) c.getInt(ctIdx) == 1 else null,
+                        timestampSeconds = if (tsIdx >= 0 && !c.isNull(tsIdx)) c.getLong(tsIdx) else null,
+                        app = app,
+                    )
+                }
+            } catch (e: Exception) {
+                if (debug) println("[apex-capacitor] Meta referrer from $app failed: ${e.message}")
+            }
+        }
+        metaReferrer = MetaInstallReferrer.latest(found)
+        metaReferrerRead = true
+        if (debug) println("[apex-capacitor] Meta install referrer ${if (metaReferrer != null) "found (${metaReferrer?.app})" else "not found"}")
+        return metaReferrer
+    }
+
     private fun flushPendingReferrerCalls() {
         installReferrerResolved = true
+        referrerLatch.countDown()
         val waiting = synchronized(pendingReferrerCalls) {
             val copy = pendingReferrerCalls.toList()
             pendingReferrerCalls.clear()

package/android/src/main/java/inc/apex/capacitor/FirstLaunchInstall.kt

@@ -0,0 +1,28 @@
+package inc.apex.capacitor
+
+/**
+ * Whether this launch should send `app_install`. The plugin sends it once
+ * per install so every app counts installs the same way; the app's own
+ * `app_install` is dropped once one has gone.
+ *
+ * Someone who had the app before Apex was added is not a new install: the
+ * update that brings Apex must not report every existing user to the ad
+ * networks as one. A fresh install is one made in the last 7 days, or one
+ * never updated since (the version installed is the one running).
+ */
+internal object FirstLaunchInstall {
+    const val PREF_KEY = "installSent"
+    const val FRESH_WINDOW_MS: Long = 7L * 24 * 3600 * 1000
+    private const val SAME_VERSION_TOLERANCE_MS: Long = 5L * 60 * 1000
+
+    enum class Decision { SEND, ALREADY_SENT, EXISTING_USER }
+
+    fun decide(alreadySent: Boolean, installedMs: Long?, versionInstalledMs: Long?, nowMs: Long): Decision {
+        if (alreadySent) return Decision.ALREADY_SENT
+        if (installedMs == null || installedMs <= 0) return Decision.SEND
+        if (versionInstalledMs != null && kotlin.math.abs(versionInstalledMs - installedMs) <= SAME_VERSION_TOLERANCE_MS) {
+            return Decision.SEND
+        }
+        return if (nowMs - installedMs <= FRESH_WINDOW_MS) Decision.SEND else Decision.EXISTING_USER
+    }
+}

package/android/src/main/java/inc/apex/capacitor/MetaInstallReferrer.kt

@@ -0,0 +1,75 @@
+package inc.apex.capacitor
+
+/**
+ * Meta Install Referrer: the Facebook, Instagram and Facebook Lite apps
+ * keep the Meta ad a person tapped or saw before installing, and hand it to
+ * the app that was installed. Play's referrer only carries a tap that led
+ * straight to the install; this also carries views and earlier taps.
+ *
+ * The campaign inside is encrypted with the app owner's key. The plugin
+ * never decrypts it; it goes to Apex on the `app_install` event and Apex
+ * opens it with the key the shop saved in the Meta connection.
+ *
+ * Pure logic here (no Android imports) so it runs under plain JUnit. The
+ * ContentResolver query lives in the plugin.
+ */
+internal object MetaInstallReferrer {
+
+    /** Content provider authority → the app name Apex records. */
+    val PROVIDERS: List<Pair<String, String>> = listOf(
+        "com.facebook.katana.provider.InstallReferrerProvider" to "facebook",
+        "com.instagram.contentprovider.InstallReferrerProvider" to "instagram",
+        "com.facebook.lite.provider.InstallReferrerProvider" to "facebook_lite",
+    )
+
+    val COLUMNS: Array<String> = arrayOf("install_referrer", "is_ct", "actual_timestamp")
+
+    data class Found(
+        val referrer: String,
+        /** Null when the Meta app didn't say tap or view. */
+        val isClickThrough: Boolean?,
+        /** When the tap or view happened, in seconds. */
+        val timestampSeconds: Long?,
+        val app: String,
+    )
+
+    /**
+     * The Meta app id as the provider path wants it: digits only. Accepts
+     * the Facebook SDK's `fb1234…` form as well as the plain id.
+     */
+    fun normalizeAppId(raw: String?): String? {
+        val trimmed = raw?.trim()?.removePrefix("fb") ?: return null
+        return if (trimmed.isNotEmpty() && trimmed.all { it.isDigit() }) trimmed else null
+    }
+
+    /** The most recent touch wins when more than one Meta app answered. */
+    fun latest(found: List<Found>): Found? =
+        found.filter { it.referrer.isNotBlank() }.maxByOrNull { it.timestampSeconds ?: 0L }
+
+    /** What goes under `event.mobile.metaInstallReferrer`. */
+    fun toSlot(found: Found): Map<String, Any?> {
+        val slot = mutableMapOf<String, Any?>("referrer" to found.referrer, "app" to found.app)
+        found.isClickThrough?.let { slot["isClickThrough"] = it }
+        found.timestampSeconds?.let { if (it > 0) slot["timestamp"] = it }
+        return slot
+    }
+
+    /**
+     * Stamp the install's referrers on an `app_install` event, keeping
+     * anything the app already set.
+     */
+    fun stampInstall(
+        slot: MutableMap<String, Any?>,
+        playReferrer: String?,
+        playClickSeconds: Long,
+        meta: Found?,
+    ) {
+        if (slot["installReferrer"] == null && !playReferrer.isNullOrBlank()) {
+            slot["installReferrer"] = playReferrer
+            if (playClickSeconds > 0) slot["installReferrerClickTimestamp"] = playClickSeconds
+        }
+        if (slot["metaInstallReferrer"] == null && meta != null) {
+            slot["metaInstallReferrer"] = toSlot(meta)
+        }
+    }
+}

package/android/src/main/java/inc/apex/capacitor/MobileContext.kt

@@ -0,0 +1,43 @@
+package inc.apex.capacitor
+
+/**
+ * The device details stamped under `event.mobile` on every event, matching
+ * iOS. Apex builds the ad networks' app-event device block from them
+ * (Meta's `app_data` + `extinfo`), so an event without them reaches Meta
+ * with a blank device.
+ *
+ * The advertising id is the GAID, and only when the person has not limited
+ * ad tracking. The Android ID fallback is never sent: it is not an
+ * advertising id and Meta must not match on it.
+ */
+internal object MobileContext {
+    private const val ZERO_ID = "00000000-0000-0000-0000-000000000000"
+
+    data class Device(
+        val bundleId: String,
+        val appVersion: String,
+        val osVersion: String,
+        val deviceModel: String,
+        val timezone: String,
+        val locale: String,
+    )
+
+    /** The GAID to send, or null when tracking is limited or the person deleted the id. */
+    fun advertisingId(id: String?, limitAdTracking: Boolean): String? =
+        if (limitAdTracking || id.isNullOrBlank() || id == ZERO_ID) null else id.lowercase()
+
+    /** Fill the fields the caller didn't set on the event. */
+    fun fill(slot: MutableMap<String, Any?>, device: Device, gaid: String?) {
+        putIfMissing(slot, "bundleId", device.bundleId)
+        putIfMissing(slot, "appVersion", device.appVersion)
+        putIfMissing(slot, "osVersion", device.osVersion)
+        putIfMissing(slot, "deviceModel", device.deviceModel)
+        putIfMissing(slot, "timezone", device.timezone)
+        putIfMissing(slot, "locale", device.locale)
+        if (gaid != null) putIfMissing(slot, "gaid", gaid)
+    }
+
+    private fun putIfMissing(slot: MutableMap<String, Any?>, key: String, value: String) {
+        if (slot[key] == null) slot[key] = value
+    }
+}

package/dist/definitions.d.ts

@@ -205,10 +205,11 @@ export interface InitializeOptions {
      * until you call `setConsent({ granted: true })` (e.g. from your privacy
      * prompt's accept handler). Default `false` (collect immediately).
      *
-     * Apex uses a first-party visitor id, not an ad identifier (IDFA), so iOS
-     * App Tracking Transparency is out of scope; this gate covers the consent
-     * obligation that does apply. (See `requestTrackingAuthorization` for ATT,
-     * which remains a separate, optional native prompt.)
+     * Apex counts people by a first-party visitor id. The advertising id is a
+     * separate permission: events carry the IDFA only after the person allows
+     * tracking in the ATT prompt (`requestTrackingAuthorization`), and the
+     * GAID only when they haven't limited ad tracking. The IDFV and Android
+     * ID are never put on events.
      */
     requireConsent?: boolean;
     /**
@@ -247,6 +248,26 @@ export interface InitializeOptions {
      * workspace has more than one. Defaults to the workspace's first app.
      */
     mobileAppId?: string;
+    /**
+     * Your Meta (Facebook) app id, from Meta for Developers. On Android the
+     * plugin uses it to ask the Facebook, Instagram and Facebook Lite apps
+     * which Meta ad the person tapped or saw before installing, and sends
+     * that with the `app_install` event. Apex opens it with the install
+     * referrer key saved in your Meta connection and credits the ad.
+     *
+     * Optional when your app already has the Facebook SDK's
+     * `com.facebook.sdk.ApplicationId` manifest entry. No-op on iOS and web.
+     */
+    metaAppId?: string;
+    /**
+     * Send `app_install` once, on the first launch of a fresh install
+     * (default true on iOS and Android; no-op on web). It carries what Apex
+     * needs to credit the ad behind the install and to report it to the ad
+     * networks you connect. Someone who had the app before Apex was added is
+     * not sent as an install. Whether the plugin or your app sends it, only
+     * the first `app_install` per install goes.
+     */
+    autoTrackInstall?: boolean;
 }
 /**
  * Options for {@link ApexCapacitorPlugin.identify}.
@@ -400,7 +421,8 @@ export interface ApexCapacitorPlugin {
     /**
      * Returns IDFA (iOS) or GAID (Android). When unavailable (ATT denied or LAT
      * enabled), returns a fallback with `fallback` indicating which identifier
-     * was substituted.
+     * was substituted. Events never carry the fallback: they get `idfa` /
+     * `gaid` under `mobile` only when the real advertising id is allowed.
      */
     getAdvertisingId(): Promise<AdvertisingIdResult>;
     /**

package/dist/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/definitions.d.ts

@@ -205,10 +205,11 @@ export interface InitializeOptions {
      * until you call `setConsent({ granted: true })` (e.g. from your privacy
      * prompt's accept handler). Default `false` (collect immediately).
      *
-     * Apex uses a first-party visitor id, not an ad identifier (IDFA), so iOS
-     * App Tracking Transparency is out of scope; this gate covers the consent
-     * obligation that does apply. (See `requestTrackingAuthorization` for ATT,
-     * which remains a separate, optional native prompt.)
+     * Apex counts people by a first-party visitor id. The advertising id is a
+     * separate permission: events carry the IDFA only after the person allows
+     * tracking in the ATT prompt (`requestTrackingAuthorization`), and the
+     * GAID only when they haven't limited ad tracking. The IDFV and Android
+     * ID are never put on events.
      */
     requireConsent?: boolean;
     /**
@@ -247,6 +248,26 @@ export interface InitializeOptions {
      * workspace has more than one. Defaults to the workspace's first app.
      */
     mobileAppId?: string;
+    /**
+     * Your Meta (Facebook) app id, from Meta for Developers. On Android the
+     * plugin uses it to ask the Facebook, Instagram and Facebook Lite apps
+     * which Meta ad the person tapped or saw before installing, and sends
+     * that with the `app_install` event. Apex opens it with the install
+     * referrer key saved in your Meta connection and credits the ad.
+     *
+     * Optional when your app already has the Facebook SDK's
+     * `com.facebook.sdk.ApplicationId` manifest entry. No-op on iOS and web.
+     */
+    metaAppId?: string;
+    /**
+     * Send `app_install` once, on the first launch of a fresh install
+     * (default true on iOS and Android; no-op on web). It carries what Apex
+     * needs to credit the ad behind the install and to report it to the ad
+     * networks you connect. Someone who had the app before Apex was added is
+     * not sent as an install. Whether the plugin or your app sends it, only
+     * the first `app_install` per install goes.
+     */
+    autoTrackInstall?: boolean;
 }
 /**
  * Options for {@link ApexCapacitorPlugin.identify}.
@@ -400,7 +421,8 @@ export interface ApexCapacitorPlugin {
     /**
      * Returns IDFA (iOS) or GAID (Android). When unavailable (ATT denied or LAT
      * enabled), returns a fallback with `fallback` indicating which identifier
-     * was substituted.
+     * was substituted. Events never carry the fallback: they get `idfa` /
+     * `gaid` under `mobile` only when the real advertising id is allowed.
      */
     getAdvertisingId(): Promise<AdvertisingIdResult>;
     /**

package/dist/esm/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}

package/ios/Sources/ApexCapacitorPlugin/FirstLaunchInstall.swift

@@ -0,0 +1,50 @@
+//
+//  FirstLaunchInstall.swift
+//  Apex Capacitor Plugin
+//
+//  Whether this launch should send `app_install`. The plugin sends it once
+//  per install so every app counts installs the same way; the app's own
+//  `app_install` is dropped once one has gone.
+//
+//  Someone who had the app before Apex was added is not a new install: the
+//  update that brings Apex must not report every existing user to the ad
+//  networks as one. A fresh install is one made in the last 7 days, or one
+//  never updated since (the version installed is the one running).
+//
+
+import Foundation
+
+public enum FirstLaunchInstall {
+    public static let defaultsKey = "apex.installSent"
+    public static let freshWindow: TimeInterval = 7 * 24 * 3600
+    private static let sameVersionTolerance: TimeInterval = 5 * 60
+
+    public enum Decision: Equatable { case send, alreadySent, existingUser }
+
+    public static func decide(
+        alreadySent: Bool,
+        installedAt: Date?,
+        versionInstalledAt: Date?,
+        now: Date
+    ) -> Decision {
+        if alreadySent { return .alreadySent }
+        guard let installedAt = installedAt else { return .send }
+        if let versionInstalledAt = versionInstalledAt,
+           abs(versionInstalledAt.timeIntervalSince(installedAt)) <= sameVersionTolerance {
+            return .send
+        }
+        return now.timeIntervalSince(installedAt) <= freshWindow ? .send : .existingUser
+    }
+
+    /// When the app was first installed: the Documents folder is made then
+    /// and survives updates.
+    public static func installedAt() -> Date? {
+        guard let docs = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else { return nil }
+        return (try? FileManager.default.attributesOfItem(atPath: docs.path))?[.creationDate] as? Date
+    }
+
+    /// When the running version was installed: the app bundle is replaced on every update.
+    public static func versionInstalledAt() -> Date? {
+        (try? FileManager.default.attributesOfItem(atPath: Bundle.main.bundlePath))?[.creationDate] as? Date
+    }
+}

package/ios/Sources/ApexCapacitorPlugin/MobileContext.swift

@@ -0,0 +1,49 @@
+//
+//  MobileContext.swift
+//  Apex Capacitor Plugin
+//
+//  The device details stamped under `event.mobile` on every event. Apex
+//  builds the ad networks' app-event device block from them (Meta's
+//  `app_data` + `extinfo`), so an event without them reaches Meta with a
+//  blank device and tracking marked off.
+//
+//  The advertising id is the IDFA, and only when the person allowed
+//  tracking. The IDFV fallback is never sent: it is not an advertising id
+//  and Meta must not match on it.
+//
+
+import Foundation
+
+public enum MobileContext {
+    public static func fields(
+        device: DeviceMetadata,
+        att: AttStatus,
+        adId: AdvertisingIdResult
+    ) -> [String: Any] {
+        var fields: [String: Any] = [
+            "bundleId": device.bundleId,
+            "appVersion": device.appVersion,
+            "osVersion": device.osVersion,
+            "deviceModel": device.model,
+            "timezone": device.timezone,
+            "locale": device.locale,
+            "attStatus": att.rawValue,
+        ]
+        if att == .authorized, adId.fallback == nil, let idfa = adId.id {
+            fields["idfa"] = idfa
+        }
+        return fields
+    }
+
+    /// Fill the fields the caller didn't set on the event.
+    public static func fill(
+        _ slot: inout [String: Any],
+        device: DeviceMetadata,
+        att: AttStatus,
+        adId: AdvertisingIdResult
+    ) {
+        for (key, value) in fields(device: device, att: att, adId: adId) where slot[key] == nil {
+            slot[key] = value
+        }
+    }
+}

package/ios/Sources/ApexCapacitorPluginBridge/ApexCapacitorPlugin.swift

@@ -55,6 +55,7 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
     private var attManager = AttManager()
     private var skanManager = SkanManager()
     private var deviceInfo = DeviceInfo()
+    private lazy var deviceMeta: DeviceMetadata = deviceInfo.collect()
     private var deepLinks = DeepLinkManager()
     private var adIds = AdvertisingIdProvider()
     private lazy var pushManager = PushNotificationManager()
@@ -101,6 +102,9 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
     // Phase 4a — consent gate. Defaults granted; set false by
     // initialize({ requireConsent: true }) until setConsent({ granted:true }).
     private var consentGranted = true
+    // The install is sent once per install, by the plugin or the app, never both.
+    private var autoTrackInstall = true
+    private let installLock = NSLock()
     // Phase 3 — per-launch dedup so each (experiment, variant) exposure
     // fires once, matching the JS/web fallback.
     private var firedExposures = Set<String>()
@@ -216,6 +220,7 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
         apiKey = rawKey.isEmpty ? nil : rawKey
         // Phase 4a — consent gate.
         consentGranted = !(call.getBool("requireConsent") ?? false)
+        autoTrackInstall = call.getBool("autoTrackInstall") ?? true
 
         // MMP-061 — release channel detection. iOS uses the receipt URL
         // + StoreKit 2 AppTransaction. Any JS-supplied override on iOS
@@ -271,10 +276,62 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
             self?.handleTokenArrived(token)
         }
         pushManager.silentRegisterIfAuthorized()
+        sendInstallIfFirstLaunch()
 
         call.resolve()
     }
 
+    /// Send `app_install` on the first launch of a fresh install. Marks the
+    /// install as handled for someone who had the app before Apex, so the
+    /// update that adds Apex reports no one as new.
+    private func sendInstallIfFirstLaunch() {
+        guard autoTrackInstall, consentGranted, let queue = offlineQueue else { return }
+        let defaults = UserDefaults.standard
+        installLock.lock()
+        let decision = FirstLaunchInstall.decide(
+            alreadySent: defaults.bool(forKey: FirstLaunchInstall.defaultsKey),
+            installedAt: FirstLaunchInstall.installedAt(),
+            versionInstalledAt: FirstLaunchInstall.versionInstalledAt(),
+            now: Date()
+        )
+        if decision != .alreadySent { defaults.set(true, forKey: FirstLaunchInstall.defaultsKey) }
+        installLock.unlock()
+        if debug { print("[apex-capacitor] first-launch install: \(decision)") }
+        guard decision == .send else { return }
+
+        var payload: [String: AnyCodable] = [:]
+        payload["type"] = AnyCodable("app_install")
+        payload["data"] = AnyCodable(["source": "apex_first_launch"])
+        if testMode { payload["testMode"] = AnyCodable(true) }
+        payload["platform"] = AnyCodable("ios")
+        payload["timestamp"] = AnyCodable(ISO8601DateFormatter().string(from: Date()))
+        payload["visitorId"] = AnyCodable(visitorId)
+        var mobileSlot: [String: Any] = [
+            "releaseChannel": releaseChannel,
+            "releaseChannelSource": releaseChannelSource,
+        ]
+        stampDevice(&mobileSlot)
+        payload["mobile"] = AnyCodable(mobileSlot)
+        let event = NativeQueuedEvent(
+            id: UUID().uuidString.lowercased(),
+            payload: payload,
+            attempts: 0,
+            enqueuedAt: Date()
+        )
+        try? queue.enqueue(event)
+        kickFlush(reason: "track")
+    }
+
+    /// True the first time an install is claimed; the app's own `app_install` after that is dropped.
+    private func claimInstall() -> Bool {
+        installLock.lock()
+        defer { installLock.unlock() }
+        let defaults = UserDefaults.standard
+        if defaults.bool(forKey: FirstLaunchInstall.defaultsKey) { return false }
+        defaults.set(true, forKey: FirstLaunchInstall.defaultsKey)
+        return true
+    }
+
     /// Forward a freshly-arrived APNs device token to JS listeners and
     /// register it with the Apex backend. Shared by the explicit
     /// `registerForPushNotifications()` path and the silent re-register
@@ -930,10 +987,11 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
         payload["platform"] = AnyCodable("ios")
         payload["timestamp"] = AnyCodable(ISO8601DateFormatter().string(from: Date()))
         payload["visitorId"] = AnyCodable(visitorId)
-        let mobileSlot: [String: Any] = [
+        var mobileSlot: [String: Any] = [
             "releaseChannel": releaseChannel,
             "releaseChannelSource": releaseChannelSource,
         ]
+        stampDevice(&mobileSlot)
         payload["mobile"] = AnyCodable(mobileSlot)
         let event = NativeQueuedEvent(
             id: UUID().uuidString.lowercased(),
@@ -947,6 +1005,17 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
 
     // MARK: - Events & Queue
 
+    /// The device, the tracking answer, and the IDFA when the person allowed
+    /// it. Read per event: the answer can change in Settings mid-session.
+    private func stampDevice(_ slot: inout [String: Any]) {
+        MobileContext.fill(
+            &slot,
+            device: deviceMeta,
+            att: attManager.currentStatus(),
+            adId: adIds.current()
+        )
+    }
+
     @objc public func track(_ call: CAPPluginCall) {
         guard let queue = offlineQueue else {
             call.reject("Plugin not initialized — call initialize() first")
@@ -958,6 +1027,11 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
             call.resolve()
             return
         }
+        if call.getString("type") == "app_install" && !claimInstall() {
+            if debug { print("[apex-capacitor] app_install already sent for this install; dropping") }
+            call.resolve()
+            return
+        }
 
         let id = call.getString("id") ?? UUID().uuidString.lowercased()
         let payloadDict = call.options.compactMapValues { $0 }
@@ -1004,6 +1078,7 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
         }
         mobileSlot["releaseChannel"] = releaseChannel
         mobileSlot["releaseChannelSource"] = releaseChannelSource
+        stampDevice(&mobileSlot)
         codablePayload["mobile"] = AnyCodable(mobileSlot)
         let event = NativeQueuedEvent(
             id: id,
@@ -1066,6 +1141,7 @@ public class ApexCapacitorPlugin: CAPPlugin, CAPBridgedPlugin, UNUserNotificatio
         if granted {
             // Resume: flush anything captured before this point.
             kickFlush(reason: "consent")
+            sendInstallIfFirstLaunch()
         } else {
             // Revoke: drop anything queued but not yet sent.
             try? offlineQueue?.clear()

package/ios/Sources/PrivacyInfo.xcprivacy

@@ -0,0 +1,72 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<!--
+  What @apex-inc/capacitor-plugin collects, merged by Xcode into the app's
+  privacy report. Installs and purchases count as tracking because Apex
+  sends them to the ad networks the app connects to measure ads. The IDFA
+  is read only after the person allows tracking in the ATT prompt. No
+  tracking domains are listed: iOS blocks listed domains
+  outright when tracking is denied, and Apex's own endpoint also serves
+  measurement that needs no permission.
+-->
+<plist version="1.0">
+<dict>
+	<key>NSPrivacyTracking</key>
+	<true/>
+	<key>NSPrivacyTrackingDomains</key>
+	<array/>
+	<key>NSPrivacyCollectedDataTypes</key>
+	<array>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypeDeviceID</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeThirdPartyAdvertising</string>
+				<string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypeProductInteraction</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+				<string>NSPrivacyCollectedDataTypePurposeThirdPartyAdvertising</string>
+			</array>
+		</dict>
+		<dict>
+			<key>NSPrivacyCollectedDataType</key>
+			<string>NSPrivacyCollectedDataTypePurchaseHistory</string>
+			<key>NSPrivacyCollectedDataTypeLinked</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypeTracking</key>
+			<true/>
+			<key>NSPrivacyCollectedDataTypePurposes</key>
+			<array>
+				<string>NSPrivacyCollectedDataTypePurposeAnalytics</string>
+				<string>NSPrivacyCollectedDataTypePurposeThirdPartyAdvertising</string>
+			</array>
+		</dict>
+	</array>
+	<key>NSPrivacyAccessedAPITypes</key>
+	<array>
+		<dict>
+			<key>NSPrivacyAccessedAPIType</key>
+			<string>NSPrivacyAccessedAPICategoryUserDefaults</string>
+			<key>NSPrivacyAccessedAPITypeReasons</key>
+			<array>
+				<string>CA92.1</string>
+			</array>
+		</dict>
+	</array>
+</dict>
+</plist>

package/ios/Tests/ApexCapacitorPluginTests/FirstLaunchInstallTests.swift

@@ -0,0 +1,66 @@
+//
+//  FirstLaunchInstallTests.swift
+//
+
+import XCTest
+@testable import ApexCapacitorPlugin
+
+final class FirstLaunchInstallTests: XCTestCase {
+
+    private let now = Date(timeIntervalSince1970: 1_790_000_000)
+    private let day: TimeInterval = 24 * 3600
+
+    func testSendsOnTheFirstLaunchOfAFreshInstall() {
+        let installed = now.addingTimeInterval(-60)
+        XCTAssertEqual(
+            FirstLaunchInstall.decide(alreadySent: false, installedAt: installed, versionInstalledAt: installed, now: now),
+            .send
+        )
+    }
+
+    func testSendsOnceOnly() {
+        XCTAssertEqual(
+            FirstLaunchInstall.decide(alreadySent: true, installedAt: now, versionInstalledAt: now, now: now),
+            .alreadySent
+        )
+    }
+
+    func testAnUpdateThatAddsApexIsNotAnInstall() {
+        XCTAssertEqual(
+            FirstLaunchInstall.decide(
+                alreadySent: false,
+                installedAt: now.addingTimeInterval(-90 * day),
+                versionInstalledAt: now.addingTimeInterval(-day),
+                now: now
+            ),
+            .existingUser
+        )
+    }
+
+    func testARecentInstallStillCountsAfterAQuickUpdate() {
+        XCTAssertEqual(
+            FirstLaunchInstall.decide(
+                alreadySent: false,
+                installedAt: now.addingTimeInterval(-3 * day),
+                versionInstalledAt: now.addingTimeInterval(-day),
+                now: now
+            ),
+            .send
+        )
+    }
+
+    func testALateFirstOpenOfANeverUpdatedInstallCounts() {
+        let installed = now.addingTimeInterval(-20 * day)
+        XCTAssertEqual(
+            FirstLaunchInstall.decide(alreadySent: false, installedAt: installed, versionInstalledAt: installed, now: now),
+            .send
+        )
+    }
+
+    func testSendsWhenTheInstallTimeIsUnknown() {
+        XCTAssertEqual(
+            FirstLaunchInstall.decide(alreadySent: false, installedAt: nil, versionInstalledAt: nil, now: now),
+            .send
+        )
+    }
+}

package/ios/Tests/ApexCapacitorPluginTests/MobileContextTests.swift

@@ -0,0 +1,56 @@
+//
+//  MobileContextTests.swift
+//
+
+import XCTest
+@testable import ApexCapacitorPlugin
+
+final class MobileContextTests: XCTestCase {
+
+    private let device = DeviceMetadata(
+        platform: "ios",
+        osVersion: "18.1",
+        model: "iPhone16,1",
+        appVersion: "3.1.0",
+        bundleId: "com.skillshot.app",
+        timezone: "America/Chicago",
+        locale: "en-US"
+    )
+
+    func testStampsTheDeviceAndTheIdfaWhenTrackingIsAllowed() {
+        let fields = MobileContext.fields(
+            device: device,
+            att: .authorized,
+            adId: AdvertisingIdResult(id: "6d92078a-8246-4ba4-ae5b-76104861e7dc", fallback: nil)
+        )
+        XCTAssertEqual(fields["bundleId"] as? String, "com.skillshot.app")
+        XCTAssertEqual(fields["deviceModel"] as? String, "iPhone16,1")
+        XCTAssertEqual(fields["attStatus"] as? String, "authorized")
+        XCTAssertEqual(fields["idfa"] as? String, "6d92078a-8246-4ba4-ae5b-76104861e7dc")
+    }
+
+    func testNeverSendsTheIdfvAsTheAdvertisingId() {
+        let fields = MobileContext.fields(
+            device: device,
+            att: .denied,
+            adId: AdvertisingIdResult(id: "idfv-value", fallback: "idfv")
+        )
+        XCTAssertNil(fields["idfa"])
+        XCTAssertNil(fields["idfv"])
+        XCTAssertEqual(fields["attStatus"] as? String, "denied")
+    }
+
+    func testKeepsWhatTheAppSet() {
+        var slot: [String: Any] = ["releaseChannel": "app-store", "locale": "fr-FR"]
+        MobileContext.fill(
+            &slot,
+            device: device,
+            att: .notDetermined,
+            adId: AdvertisingIdResult(id: nil, fallback: nil)
+        )
+        XCTAssertEqual(slot["locale"] as? String, "fr-FR")
+        XCTAssertEqual(slot["releaseChannel"] as? String, "app-store")
+        XCTAssertEqual(slot["appVersion"] as? String, "3.1.0")
+        XCTAssertEqual(slot["attStatus"] as? String, "not-determined")
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apex-inc/capacitor-plugin",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "description": "Apex Capacitor plugin — iOS/Android attribution, events, deep linking, SKAN, and offline-tolerant tracking for Capacitor apps.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",