Unity

Usage Requirements

Supported Development Environment

Third-Party Dependencies

The Noctua SDK already includes the following third-party libraries:

  • Firebase Analytics
  • Firebase Crashlytics
  • Adjust SDK
  • Facebook SDK

You do not need to install these plugins manually.
However, if your game also uses these SDKs for internal features, you can still include them — but you must match the same versions used by Noctua to avoid conflicts.

This version alignment is required only for iOS.
On Android, there are no conflicts even if you use different versions.


SDK Versions Used by Noctua (iOS)

SDKVersion
Adjust iOS Native SDK4.38.4
Firebase iOS Native SDK11.6.0
Facebook iOS Native SDK17.0.2

Please ensure you use the same versions above when integrating your own iOS dependencies to prevent symbol or linking conflicts.

Application.version

It is mandatory to set the Application.version property with your game version to ensure proper functionality of the SDK. This property allows the SDK to identify the current version of your application, which is essential for features like version-specific configurations, analytics tracking, and compatibility checks.

To set the version number in Unity, go to Edit > Project Settings > Player. Please use Semantic Versioning as your game version format.

Reference: https://semver.org/

PlayerPrefs

You must not remove any PlayerPrefs keys that begin with the Noctua prefix and NativeGalleryPermission. These keys are critical for the SDK's internal operations, such as storing configuration data, maintaining user state, and ensuring consistent functionality across game sessions. Deleting or altering these keys can result in unexpected behavior, data loss, or failures in essential SDK features.

If your game logic requires clearing persistent data within PlayerPrefs, please exclude all keys in this list below:

  • NoctuaFirstOpen
  • NoctuaWebContent.Announcement.LastShown
  • NoctuaAccountContainer.UseFallback
  • NoctuaAccountContainer
  • NoctuaPendingPurchases
  • NoctuaLocaleCountry
  • NoctuaLocaleCurrency
  • NoctuaLocaleUserPrefsLanguage
  • NativeGalleryPermission
  • NoctuaUnpairedOrders
  • NoctuaPurchaseHistory
  • NoctuaEvents
Previous
Getting Started for Casual Games