> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appstack.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Unity SDK changelog

> Every release of the Appstack Unity SDK, newest first.

Releases of the `com.appstack.unity-sdk` UPM package, newest first. Always integrate against the latest
stable release — [`appstack-cli review`](/tooling/cli) will tell you what you
are on.

<Card title="Unity integration guide" icon="book-open" href="/SDKs/unity">
  Install, configure, and send your first events.
</Card>

<Update label="1.3.0" description="2026-09-03" tags={["Changed","Fixed"]}>
  **Changed**

  * Pinned native SDKs are now Appstack iOS SDK `4.6.0` and Appstack Android SDK
    `1.8.0`. Platform floors are unchanged: iOS 15.0+ and Android API level 21+.
  * Custom event parameters are encrypted on the device before being sent.
    Parameter names that must stay readable, such as `currency` and `revenue`,
    are excluded through a server-controlled list, so revenue reporting is
    unchanged. On-device encryption requires iOS 17 or newer; iOS 15 and 16
    encrypt server-side as before.
  * The pinned iOS SDK ships an Apple privacy manifest declaring its
    required-reason API usage.

  **Fixed**

  * On iOS, an event whose parameters hold `null` is no longer dropped, and a
    parameter value JSON cannot represent no longer crashes the app. Those keys
    are dropped individually and the event still sends.

  [Release notes on GitHub](https://github.com/appstack-tech/appstack-unity-sdk/releases/tag/1.3.0)
</Update>

<Update label="1.2.1" description="2026-08-19" tags={["Changed"]}>
  **Changed**

  * OpenUPM releases now use a Unity-signed `.tgz` created with a pinned,
    checksum-verified Unity UPM CLI. Unity 6.3 and newer can verify the package's
    publisher and integrity instead of showing the missing-signature warning.

  [Release notes on GitHub](https://github.com/appstack-tech/appstack-unity-sdk/releases/tag/1.2.1)
</Update>

<Update label="1.2.0" description="2026-08-13" tags={["Added"]}>
  **Added**

  * Optional scene-independent auto-initialization configured through **Edit →
    Project Settings → Appstack**, with separate development and production keys
    for iOS and Android, per-platform enablement, automatic or pinned environment
    selection, explicit production-key fallback for development builds, and
    target-specific pre-build validation.
  * Idempotent Unity-side configuration: the first successful automatic or
    manual configuration wins, identical repeats are silent, conflicting repeats
    warn without exposing credentials, and failed attempts remain retryable.

  [Release notes on GitHub](https://github.com/appstack-tech/appstack-unity-sdk/releases/tag/1.2.0)
</Update>

<Update label="1.1.0" description="2026-08-12" tags={["Added","Changed"]}>
  **Added**

  * `SetCustomerUserId(customerUserId)` and `ClearCustomerUserId()` for setting or
    clearing the customer user ID after `Configure()`, bridging the native
    iOS/Android setter of the same name. Use them when a login reveals the ID: a
    repeat `Configure()` is a no-op and ignores its `customerUserId`. `null`, an
    empty string, and whitespace all clear the stored ID, so
    `ClearCustomerUserId()` is the explicit spelling of `SetCustomerUserId(null)`
    rather than separate behavior. This differs from `Configure()`, where an empty
    `customerUserId` means "not provided" because it never clears.

  **Changed**

  * Pinned native SDKs are now Appstack iOS SDK `4.5.0` (from `4.4.0`) and
    Appstack Android SDK `1.7.0` (from `1.5.0`). Platform floors are unchanged:
    iOS 15.0+ and Android API level 21+.
  * `SendEvent(EventType.INSTALL)` is a no-op. `EventType.INSTALL` is emitted
    automatically by the native SDKs on first launch, and both new pinned versions
    discard a manually sent `INSTALL`; the previous pins accepted it.

  [Release notes on GitHub](https://github.com/appstack-tech/appstack-unity-sdk/releases/tag/1.1.0)
</Update>

<Update label="1.0.0" description="2026-07-17" tags={["Added"]}>
  **Added**

  * Initial Unity Package Manager distribution as `com.appstack.unity-sdk` for
    Unity 6 (`6000.0`) or newer.
  * Support for iOS 15.0+ through Appstack iOS SDK `4.4.0` and Android API level
    21+ through Appstack Android SDK `1.5.0`.
  * SDK configuration with an API key, log level, and optional customer user ID.
  * Standard and custom event tracking with optional event parameters.
  * Apple Ads attribution on iOS.
  * Appstack ID, SDK status, and asynchronous attribution-parameter retrieval.
  * Concurrent attribution requests with callbacks returned to the captured
    synchronization context when available.
  * Automatic iOS Swift Package Manager integration through the Unity Xcode
    postprocessor, including dynamic-framework embedding in the application.
  * Automatic Android native dependency resolution through EDM4U.
  * Automatic Android R8/ProGuard configuration with no custom keep-rules step.
  * Basic Integration sample for manual SDK configuration and event tracking.

  [Release notes on GitHub](https://github.com/appstack-tech/appstack-unity-sdk/releases/tag/1.0.0)
</Update>