Last modified October 10, 2019 by Gordon Glauser

Unity SDK release notes

Swrve has an open source SDK repository. There are two options for downloading the latest public Swrve Unity SDK.

For upgrade instructions, see Unity SDK Upgrade Guide. To view the feature support matrix, see SDK Feature Support Matrix.

Release 6.2 and 5.2

Release date: October 10, 2019


  • iOS: With Apple’s deprecation of the UIWebView API, migrated to the recommended WKWebView to prevent issues with submitting your app to the App Store. If you haven’t upgraded to version 6.0+ of our SDK yet, we’ve also released a hotfix for the 5.0 series of our SDK, v5.2.
  • Android: Upgraded the following tools and services:
    • Gradle to 5.1.1
    • Gradle tools plugin to 3.4.1


  • Fixed an issue with custom fonts preventing some Conversations loading.
  • iOS:
    • Fixed an issue with Conversation videos not loading.
    • Fixed an issue with string parsing in push notifications linked to an in-app message or Conversation campaign.
    • Fixed an issue with the text styling display on multi-page Conversation campaigns.
  • Android:
    • Fixed an issue where custom action buttons on push notification appeared as disabled.
    • Fixed an issue with setting the notification accent color via SwrveNotificationConfig.

Version 5.2

  • iOS: Includes all new features and fixes released in the native iOS SDK from version 5.1.1 to 5.3.3. For more details, see the iOS SDK release notes.

Release 6.1

Release date: April 9, 2019


  • iOS: Added support for iOS 12 Provisional Authorization for push notifications. For more information, see the Unity integration guide.
  • Android: Updated our Firebase library dependency from 17.3.4 to 17.4.0.


  • Fixed an issue where error messages would appear in the Unity Editor when running on an unsupported platform. Now an empty instance starts instead.
  • Fixed an issue where the wrong Unity version was referenced in the networking layer to switch from www to UnityWebRequest.
  • iOS: Fixed an issue with the push notification completion handler being called too early when downloading push media.

Release 6.0

Release date: February 25, 2019


  • Android: In line with Google’s decision to deprecate Google Cloud Messaging and remove support for it in April 2019, we have now completely removed support for the swrve-google flavor of the Unity Android SDK. If you have any questions about migrating from Google Cloud Messaging to Firebase Cloud Messaging, contact your CSM at


  • Added an API for handling User Identity. For more information, see the Unity integration guide. To be part of our Early Access program, contact your CSM at
  • Added ability for the SDK to send a targeted silent notification that confirms a user’s identity before displaying a push notification.
  • Added support for displaying a Swrve in-app message or Conversation campaign directly after a customer engages with a push notification. For more information, see Linking push notifications to in-app campaigns.
  • Added an API for handling deeplinks to show customized campaigns immediately after a user clicks an ad message. Initial support is for Facebook dynamic ad journeys. To be part of our Early Access program, contact your CSM at
  • Removed the ability to set UserId from SwrveConfig or as part of SDK initialization.For more information, see the Unity integration guide.
  • Removed the option to configure HTTP from SwrveConfig. The SDK now only supports HTTPS.
  • Removed the Swrve demo app and added improved samples to the Swrve Unity package.
  • Moved away from WWW method group to UnityWebRequest on supported Unity versions.
  • Moved and refactored our listeners and configurations to the SwrveConfig object to keep parity with our native SDKs. For more information, see the Unity upgrade guide.
  • Android
    • Renamed SwrveFirebase.unityPackage to Swrve.unityPackage as it is now the base push-enabled Android Package.
    • Removed the SwrvePushSDK module from the native layer and migrated push notification handling to SwrveCommon.
    • Removed the ability to locally set the title for rich notifications in SwrveConfig.
    • Updated the GSON library dependency from 2.2.+ to 2.8.5.
    • Updated our Firebase library dependency from 11.6.0 to 17.3.4.
  • iOS
    • Removed support for iOS 8 and 9.


  • Fixed an issue when using custom animations in in-app messages where the InitAnimation method wasn’t functioning properly and not resetting the message correctly.
  • Fixed an issue where push notifications sent to a QA device were triggered twice when the app was completely closed.
  • Android
    • Fixed a couple issues with rich push notification button actions not properly executing when the app was closed or the device was locked.
    • Fixed a push notification issue that could prevent a user from receiving the very first notification sent from Swrve after the app is hard closed.
    • Fixed an issue with QA devices that caused an event to be logged twice when the app was in a closed state.
    • Improved use of Unity preprocessor macros to prevent a crash that could occur when running your app from Unity Editor using Android as the build target.
  • iOS
    • Fixed an issue where Xcode’s new build system was breaking the resulting iOS project when using the latest versions of Xcode.
    • Fixed an issue with rich notification buttons where individual button actions were being overridden if the push engage default action was set to open deeplink.

Release 5.1.3

Release date: August 15, 2018


  • Fixed an issue in Unity 2017 and newer version builds that caused events to be dropped when there was no internet connection.

Release 5.1.2

Release date: August 3, 2018


  • Added an Android sample that shows how to integrate with multiple push providers and still support Android O.


  • Fixed an issue that prevented custom buttons from working properly in Android rich push notifications.
  • Fixed a compiler error in Unity 2018.

Release 5.1.1

Release date: February 12, 2018


  • Fixed an issue where in-app message and Conversation campaigns that were set to display on app launch were not obeying campaign-level display limits.

Release 5.1

Release date: January 23, 2018


  • Includes refactors and code improvements for easier integration and to safely persist data per User ID. For more information, see the Unity SDK 5.0 Upgrade Guide.
  • Includes updates required for Locations SDK 2.0. For more information, see the Locations SDK Release Notes.
  • Removed auto-initialization. You must now initialize the the SDK from a C# script. For more information, see the Unity Integration Guide.
  • Removed Universal Windows Platform (UWP) as a target platform of the SDK.
  • Added support for nested push notification payload JSON.
  • Added Object.DontDestroyOnLoad to the SDK by default to avoid an object being automatically destroyed when a new scene is loaded.


  • It is no longer possible to use internal Swrve.* events to trigger in-app messages or conversations.
  • Moved some parts of the SDK from the WWW class to UnityWebRequest to avoid runtime issues in Unity 2017+.
  • Removed allowBackup tag from library that could collide with app’s value.
  • Android:
    • Removed BuildConfig.class to avoid Gradle build problems.
    • The SDK now uses JobScheduler to support Android O.
  • iOS:
    • The SDK will not automatically generate an app group if you have not included one in the configuration postprocess.json file.

Previous releases summary

  • October 13, 2017 – v4.11 – Several push notification enhancements, including support for creating rich notifications directly in Swrve and iOS influenced metrics reporting. Added support for Firebase Cloud Messaging and Android O.
  • June 7, 2017 – v4.10.1 – Bug fixes.
  • May 24, 2017 – v4.10 – Added support for using silent push notifications to send background app content updates.
  • May 8, 2017 – v4.9.2 – Bug fixes.
  • April 18, 2017 – v4.9.1 – Bug fixes.
  • March 21, 2017 – v4.9 – Disabled calls to native code (iOS / Android) when running the SDK in the Unity3D Editor to prevent error warnings in the logs and bug fixes.
  • February 2, 2017 – v4.8 – Various Conversation enhancements and fixes, including custom fonts and styling. To prevent App Store rejection by Apple, the SDK no longer collects Advertising Identifier (IDFA) by default.
  • November 24, 2016 – v4.7 – Added support for using date-type user properties to target your campaign audiences and for sending your own push engagement event.
  • November 22, 2016 – v4.6 – Changed the main Swrve Unity C# namespace from Swrve to SwrveUnity.
  • October 12, 2016 – v4.5.3 – Bug fixes.
  • September 2, 2016 – v4.5.2 – Bug fixes.
  • August 23, 2016 – v4.5.1 – Improved post-processing for iOS XCode projects in C#.
  • August 4, 2016 – v4.5 – Added support for Conversations, Message Center API and Location-Based Campaigns.
  • June 14, 2016 – v3.8 – Added support for using event payload conditions to trigger in-app messages campaigns.
  • April 12, 2016 – v3.7 – Changed the swrve.device_region user property from a 3-letter country code to a 2-letter country code.
  • February 11, 2016 – v3.6 – Added ability to disable SDK device logging.
  • November 30, 2015 – v3.5 – Restricted use of Swrve. namespace for custom events.
  • October 23, 2015 – v3.4.3 – Updated Android push notifications plugin to latest GCM library.
  • August 18, 2015 – v3.4.2 – Added support to log device region and default to HTTPS to support iOS 9.
  • June 4, 2015 – v3.4.1 – Bug fixes.
  • April 8, 2015 – v3.4 – Changed default background of in-app messages from solid black to transparent.
  • March 13, 2015 – v3.3.2 – Added support for Unity 5.
  • January 21, 2015 – v3.3.1 – Bug fixes.
  • November 11, 2014 – v3.3 – Added support to log carrier information by default.
  • October 21, 2014 – v3.2 – Added support to generate a random UUID if no custom user ID is provided at initialization.
  • September 12, 2014 – v3.1.3 – Production support for iOS 8.
  • August 29, 2014 – v3.1.2 Beta – Beta support for testing devices running iOS 8 Beta 5.
  • August 8, 2014 – v3.1.1 Beta – Beta support for iOS 8 push registration method.
  • July 30, 2014 – v3.1 – Simplified Unity Android push notification integration and added support for triggering in-app messages at session start.
  • May 27, 2014 – v3.0.1 – Bug fixes.
  • May 15, 2014 – v3.0 – Enhancements to real-time targeting and added support for Google IAP functionality.
  • April 1, 2014 – v2.10 – Simplified in-app message actions and QA device registration.
  • March 4, 2014 – v2.9 – Added support for push notifications for both Unity Android and Unity iOS devices.
  • v2.8.2 – Bug fixes.
  • v2.8.1 – Bug fixes.
  • v2.8 – Added support for Swrve’s redesigned in-app messaging functionality and push notifications Beta.
  • v2.7 – Added push notification changes, support for auto-generation of user IDs, and unified the in-app messaging and analytics SDKs.
  • November 12, 2013 – v2.6 – Added support for extended IAP event and bug fixes.
  • October 22, 2013 – v2.5.2 – Bug fixes.
  • October 18, 2013 – v2.5.1 – Bug fixes.
  • October 16, 2013 – v2.5 – Added support for in-app messaging per campaign dismissal rules and bug fixes.
  • October 2, 2013 – v2.4.1- Bug fixes.
  • September 17, 2013 – v2.4 – Added support for in-app messaging QA logging.
  • August 20, 2013 – v2.3 – Added support for in-app messaging QA user functionality.
  • July 26, 2013 – v2.2 – Support for new iTunes connect receipt validation.
  • July 2, 2013 – v2.0.1 – Added support for in-app messaging and other features.
  • February 21, 2013 – v1.0 – First public release.
  • August 24, 2012 – First beta release.
  • June 5, 2012 – Fixed install, dismiss and custom button processing.