@apex-inc/capacitor-plugin 2.5.1 → 2.6.1

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) {
@@ -448,12 +551,6 @@ class ApexCapacitorPlugin : Plugin() {
     // kotlinx.coroutines here would bloat every consumer's APK by ~1MB.
     @PluginMethod
     fun identify(call: PluginCall) {
-        // Phase 4a — identify sends PII; collect nothing until consent given.
-        if (!consentGranted) {
-            if (debug) println("[apex-capacitor] consent not granted; skipping identify")
-            call.resolve()
-            return
-        }
         val email = call.getString("email")?.trim()
         if (email.isNullOrEmpty()) {
             call.reject("email is required")
@@ -463,10 +560,18 @@ class ApexCapacitorPlugin : Plugin() {
         val traits = call.getObject("traits")
 
         val payload = JSObject()
-            .put("visitorId", visitorId)
             .put("email", email)
             .put("workspaceKey", workspaceKey)
             .put("timestamp", java.time.Instant.now().toString())
+        // Signing up is its own reason to know the person. Without consent
+        // only the identify goes: no device id, and Apex records advertising
+        // as denied so no ad platform is sent them.
+        if (consentGranted) {
+            payload.put("visitorId", visitorId)
+        } else {
+            if (debug) println("[apex-capacitor] consent not granted; identifying without a device id")
+            payload.put("noBrowserConsent", true)
+        }
         if (!userId.isNullOrEmpty()) {
             payload.put("userId", userId)
         }
@@ -812,7 +917,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 +1007,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 +1020,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 +1054,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 +1074,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 +1128,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 +1227,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,15 @@ 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.)
+     * One exception: `identify` still tells Apex who signed up, because
+     * signing up is their own reason for you to know them. It sends no event
+     * and no device id, and Apex records advertising consent as denied.
+     *
+     * 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 +252,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 +425,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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"}