SDK changelog

A list of changes made to the Localytics SDK.

iOS

6.3.2: October 3rd, 2024

Restore the Live monitor feature with QR code
Removed the Gesture pairing option of Live monitor feature

6.3.1: July 1st, 2024

Fixes an issue with background tasks not always being terminated
Fixes InApp/Inbox completion handler not being called in some failure cases

6.3.0: April 4th, 2024

Adds xcprivacy manifest with default required permissions
Updates and resolves deprecated API methods and warnings

6.2.9: October 25, 2022

Disables bitcode to support Xcode 14.

6.2.8: July 21, 2022

Discouraged versions

Versions starting from 6.2.7 and lower either have known bugs or will have compatibility issues and are not recommended to be used.

Fixes an issue with frequency cap in-app limits not being properly enforced.

6.2.7: June 14, 2022
Note: Due to known issues, this version should not be used.

Fixes an issue with in-app message clicks not being reported properly.
Known Bug: some in-app frequency capping rules are ignored.

6.2.6: May 27, 2022
Note: Due to known issues, this version should not be used.

Fixes an issue with internal database encryption introduced in 6.2.4.
Known Bug: in-app message clicks are not reported properly.
Known Bug: some in-app frequency capping rules are ignored.

6.2.5: March 29, 2022
Note: Due to known issues, this version should not be used.

Fixes bug that caused frequency capping rules to be ignored.
Known Bug: has an issue reporting data for some returning customers.

6.2.4: February 18, 2022
Note: Due to known issues, this version should not be used.

Automatic encryption of the on-device database was added.
Known Bug: some in-app frequency capping rules are ignored.
Known Bug: has an issue reporting data for some returning customers.

6.2.2: October 10, 2021
Note: Due to known issues, this version should not be used.

The Localytics SDK is now built as an xcframework with support for Mac Catalyst.
Introduces a new API to allow for the display of local HTML files as a full screen In-App.

6.2.1: December 28, 2020
Note: Due to known issues, this version should not be used.

Fixes rare bug that caused in-apps to ignore frequency capping rules.

6.2.0: November 17, 2020
Note: Due to known issues, this version should not be used.

The Localytics SDK is now built as an xcframework.
Introduces a new API to allow for the display of local HTML files as a full screen In-App.

6.1.0: August 20, 2020
Note: Due to known issues, this version should not be used.

Adds support Mobile Wallet in In-App, Inbox, Push and Places campaigns.
Ensure compatibility with iOS 14.
Introduce new API's to support iOS 14's IDFA tracking.
Include Identifier for Vendor in Analytics payloads.

6.0.1: April 27, 2020
Note: Due to known issues, this version should not be used.

Fix a bug that prevented user who re-entered a workflow from seeing In-Apps a second time.

6.0.0: March 31, 2020
Note: Due to known issues, this version should not be used.

Adds the capability to trigger In-Apps based on a workflow
AutoIntegration now supports Apps with UIScene based configurations
Fix an issue with RPV that prevented progressing due to old UIAlertController.
Drop support for iOS 8

5.8.0: October 31, 2019
Note: Due to known issues, this version should not be used.

In-Apps now support a triggering condition of active geofences.
Make Inbox delete button text configurable.

5.7.0: October 1, 2019
Note: Due to known issues, this version should not be used.

This version of the Localytics SDK was built with the Xcode 11 build tools. Apps on Xcode 10.3 will not be able to use this version, and should instead upgrade directly to SDK 5.8.0.
Adds support for iOS 13. This includes fixes for In-App rendering and dark mode rendering in particular.
Adds support for video in In-App and Inbox campaigns
Adds support for proper redirection of deeplinks generated in the Movable Ink platform.
In-App banners now support configurable aspect ratios.
Fixed a bug where customer ids may not have been uploaded immediately if no other data was tagged.
Fixed a bug with the accessibility label on In-App close buttons.

5.5.0: April 1, 2019
Note: Due to known issues, this version should not be used.

Introduces support for live device logging
Fixes a bug that in rare circumstances could lead to Localytics Push Received events being tagged as Localytics Push Opened events. This bug requires migration.

5.4.0: November 8, 2018
Note: Due to known issues, this version should not be used.

This release requires Xcode 10.1. The Localytics SDK has transitioned from using Xcode9 to Xcode10.1. Unfortunately, versions earlier than Xcode10.1 does not support generation of appropriate BitCode compliant binaries.
Places now supports a foreground only mode, for apps that only ever request location "when in use" permissions.
Add the ability to change the native rendering of In App based on values in the html creative. To learn more, read the In App documentation
Fix a bug where the viewport-fit portion of the meta name=viewport element was being destroyed.
In Apps now specify an option to auto hide the Home Screen Indicator.

5.3.0: September 27, 2018
Note: Due to known issues, this version should not be used.

This release drops support for In App messages and Inbox Detail views on iOS 8. The Localytics SDK has transitioned from using UIWebView to WKWebView. Unfortunately, WKWebView does not support rendering of local files on iOS 8.
This release has major breaking changes to Places behavior. The setLocationMonitoringEnabled API will no longer request location permissions. Please consult the migration guide to ensure your integrations.
Push Event Labels passed through the Push API will now be reported on Push Received and Push Opened events.
Adds new API's to the Javascript available in In-Apps and Inbox campaigns that allow for deeplinking to the settings screen.
Security improvement: In App's will sandbox their filesystem and ignore any files with parent directory access.
Location monitoring can be persisted. Location monitoring that has been persisted will restart monitoring automatically on new session.

5.2.0: July 9, 2018
Note: Due to known issues, this version should not be used.

Adds new API's to the Javascript available in In-Apps and Inbox campaigns including methods for setting opted out state, prompting for location and notification permissions, and querying the current location authorization status.
Introduces a new delegate (CallToActionDelegate) that will update the user of Localytics related events that occur from inside campaigns.
Add Inbox delete API's and functionality including swipe to dismiss from the Inbox list view, as well as a delete button from the detail view controller.
Fix a potential deadlock when any Profiles API was called from inside the AnalyticsDelegate.
Fix a bug where In Apps with a trigger condition for Language would fail to ever qualify.
Fix a bug where the Inbox List view would show a date well before the user could have actually seen the campaign.
Some reliability improvements to the download and display of In Apps.
Deprecate MessgingDelegate:localyticsShouldDeeplink: in favor of CallToActionListener:localyticsShouldDeeplink:campaign:. This method will be removed in the next major release, and if both are implemented only the CallToActionDelegate variant will be called.

5.1: April 4, 2018
Note: Due to known issues, this version should not be used.

Improves integration pathways for GDPR compliance.
Adds new method for recording device timezone, ensuring messages get delivered at the correct time immediately following the beginning or end of Daylight Savings Time.
Fixes an issue where standard dimensions were getting truncated during In-App campaign trigger qualification
Updates setOptOut to cease collection and uploading of Profiles data.

5.0: January 17, 2018
Note: Due to known issues, this version should not be used.

Adds support for data flushing. Analytics data can now be flushed at periodic intervals that will improve time sensitive messaging capabilities.
Adds support for an In-app live creative previewer for device testing.
Adds support for the iPhone X and includes updates for iOS 11.
Removes support for versions below iOS 8.
Includes better support for a high number of geofences.
Adds more granular location permissions support.
Adds support for deep link suppression handling.
Adds support for Carthage integrations.
Fixes a bug where In-Apps with a common event trigger were not ordered correctly.
Fixes an issue with stale campaigns when a customer ID changes.
Fixes an issue with geofence downloading that causes freezing on the main thread.
Adds an API for opting into attaching an ADID parameter to Inbox URLs.

4.4.1: July 17, 2017
Note: Due to known issues, this version should not be used.

Fixed an issue that caused crashes because of how application state calls were being handled.

4.4.0: July 10, 2017
Note: Due to known issues, this version should not be used.

Categories and actions are now supported in Push and Places Notifications.
Added rich media support for Places notifications.
Full-screen videos can now be shown within Inbox creatives.
Silent Inbox campaigns are now supported to help A/B testing creatives without visible UI.
A new API has been added for tagging when an Inbox list item has been tapped.
Added Inbox messaging callbacks for displaying and dismissing the detail view controller.

4.3.2: April 13th, 2017
Note: Due to known issues, this version should not be used.

Fixed a bug that removed bitcode support in the framework.

4.3.1: April 5th, 2017
Note: Due to known issues, this version should not be used.

Fixed a bug that caused In-App creatives in test mode to not be approprately responsive.

4.3.0: March 23, 2017
Note: Due to known issues, this version should not be used.

In-App Messaging improvements including:
- Per campaign UI modification. Using a callback, a number of properties on the In-app campaign can be modified such as centered In-App aspect ratio, Banner In-App offset from the edges of the screen, full-screen In-App transparency, and dismiss button image, location and visibility.
- A new campaign test mode UI including the ability to preview all creatives in an A/B test.
- The ability to delay In-App campaigns triggered by "Session Start" and refire them at a later time to avoid conflicts with splash screens or other interstitials.
- Additional Javascript callbacks for setting Profiles and identifying users within custom HTML In-App Messaging creatives.
- A new In-App Dimiss button.
- In-App Messages can now be triggered or suppressed based on dimensions.
Performance events to manually track impressions and conversions for customers rendering fully custom Push, In-App, Inbox, and Places campaigns.
Added creative location access for custom Inbox and In-App campaigns.
Places notification trigger methods.

4.2.0: November 11, 2016
Note: Due to known issues, this version should not be used.

Added support for frequency capping in Places.
Added support for downloading scheduled campaigns in advance so they are available immediately at campaign launch time.
Fixed a bug that caused places identifiers with quotes to not be handled appropriately.
Fixed a bug where standard events would log transactions with a customer value of 0.
Improved logging.

4.1.0: August 30, 2016
Note: Due to known issues, this version should not be used.

Added support for iOS10 and the new UserNotification framework.
Fixed an issue that was caused when file protection is enabled globally for an app.

4.0.1: August 9, 2016
Note: Due to known issues, this version should not be used.

Fixed an issue that could cause a crash when Places is enabled in the Dashboard but Places integration has not been completed.

4.0.0: May 31, 2016
Note: Due to known issues, this version should not be used.

Added support for Places, our geofencing and background location analytics and messaging product.
Added standard events.
Replaced add/remove SDK callback API with a single set callback API.
Replace static lib release with two frameworks, one static and one dynamic. This provides full support for swift with Cocoapods.
Dropped iOS 6 support.

3.8.0: March 10, 2016
Note: Due to known issues, this version should not be used.

Added "push registered" event, which allows Localytics to upload a user's push token immediately. This improves reliability for developers when testing push integration. It also ensures all users who have only had one session can still receive push notifications.
Bug fixes.

3.7.0: February 5, 2016
Note: Due to known issues, this version should not be used.

Added App Inbox for delivering personalized content to users through a dedicated inbox.
Fixed an issue that could prevent in-app control group impressions from being tagged.

3.6.1: January 5, 2016
Note: Due to known issues, this version should not be used.

Fixed underreporting of Localytics Push Opened events at cold start which could cause incorrect push campaign performance metrics.

3.6.0: December 11, 2015
Note: Due to known issues, this version should not be used.

Increased hard limit on number of custom dimensions to enable future Dashboard improvements.
Fixed a deadlock that could occur when dispatching to the main thread from an analytics delegate callback.

3.5.1: October 7, 2015
Note: Due to known issues, this version should not be used.

Added Bitcode support
Fixed empty array/profile bug
Fixed offline/online bug
Updated Profile method signatures to better bridge between Swift & Objective C

3.5.0: August 28, 2015
Note: Due to known issues, this version should not be used.

Fix to in-app messaging for iOS 9 compatibility
Improved support for full-screen in-app messages for apps that support multiple orientations

3.4.0: July 1, 2015
Note: Due to known issues, this version should not be used.

Support for scheduling automation for in-app messaging
Support for control groups for in-app messaging
Added ability to suppress attachment of adid to in-app URLs upon click-through
tagScreenM now reports consecutive tags of the same screen as one tag

3.3.0: June 4, 2015
Note: Due to known issues, this version should not be used.

Added setters for customer first name, last name, full name, and email that will act as Profile attributes and be available in raw data exports
Fixed bug that impacted identically-named in-app campaigns
Improved handling of special characters in Customer IDs
Changed Profile upload batch size from 500 to 50

3.2.0: May 7, 2015
Note: Due to known issues, this version should not be used.

Added support for watchOS 1.0

3.1.1: April 7, 2015
Note: Due to known issues, this version should not be used.

Numerous performance-enhancing updates and bug fixes

3.1.0: February 20, 2015
Note: Due to known issues, this version should not be used.

Enables new Localytics Push Received event for more comprehensive campaign performance tracking

3.0.0: December 31, 2014
Note: Due to known issues, this version should not be used.

Profiles APIs enable you to increment, decrement, add to set, and remove set
Support for events that occur outside a session
New callbacks to expose more SDK state (helpful for event tagging and managing in-app message display)
Consistent tagging across iOS and Android SDKs for seamless integration experience
Performance enhancements across analytics and marketing

2.7.1: October 1, 2014
Note: Due to known issues, this version should not be used.

Fix for in-app message rotation issues on iOS 8

2.7.0: September 30, 2014
Note: Due to known issues, this version should not be used.

Support for Profiles
More efficient uploading of customer data
Fix deprecation warnings on iOS 8

2.6.1: September 19th, 2014
Note: Due to known issues, this version should not be used.

Remove direct calls to registerForRemoteNotificationTypes so apps that are not using push don't get warning emails after submission to the App Store
Suppress in-app messages while the app is in the background

2.6.0: August 1st, 2014
Note: Due to known issues, this version should not be used.

Support for additional customer data

Android

Discouraged versions

Versions starting from 6.1.0 and lower, which use legacy android support, as this will cause issues with targeting latest AndroidSDK versions.
Version 6.3.5 has a known bug caused by a missing AdvertisingID dependency, which was resolved in version 6.3.6

6.4.2: August 31, 2024

Included the proguard rules by default in the SDK consumer rules (no need to re-write again in your proguard rules).
Fixed a file I/O operation during SDK initialization that was resulting in a StrictMode violation.
Fixed an exception that was happenning at In-app/Inbox dismiss button clicking.

6.4.0: March 21, 2024

Fixed an issue related to LocationManager being initialised even if the Places functionality is not used.

6.3.9: January 5, 2024

Removed the collection of the Android ID identifier from our SDK.
Advertising ID identifier has been made optional and can be configured based on the app developer configurations and requirements.
Telephony ID (for example, IMEI/MEID) and Device WiFi Mac Hash identifiers have been removed from our SDK and will not be collected.
Fixed an In-App & Inbox Creatives issue where the Localytics attributes were not being pulled correctly.
Bug fixes for the Places functionality.

6.3.8: October 11, 2023

Targeted SDK 34 (Android 14).
Upgrading Gradle to 8+.
Upgrading to Java 17.
Fixing an issue that was causing app crashes when calling Localytics.setLocation().

6.3.7: September 30, 2022

Targeted SDK 33 (Android 13).
Upgrading Gradle to 7+.
Handling the IN-APP JavaScript API call for promptForNotificationPermissions Natively just like the iOS SDK, as Android 13+ now demands permissions for Notifications Pushing.

6.3.6: March 29, 2022

Fixed Mobile Ad ID for Advertising


        implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'

6.3.5: February 15, 2022
Note: Due to known issues, this version should not be used.

Added support for firebase BoM 29.0.4 and Android 12 (targetSdkVersion 31)


      implementation platform('com.google.firebase:firebase-bom:29.0.4')
      implementation 'com.google.firebase:firebase-messaging'
      implementation 'androidx.work:work-runtime:2.8.1'
      implementation 'com.localytics.androidx:library:6.3.5'

6.3.0: October 10, 2021

Added support for firebase BoM 28.2.0


      implementation platform('com.google.firebase:firebase-bom')
      implementation 'com.google.firebase:firebase-messaging'
      implementation 'com.localytics.androidx:library:6.4+'

6.2.0: November 17, 2020

Introduces a new API to allow for the display of local HTML files as a full screen In-App.
Fix a bug with the Install Referrer library on devices with no Google Play Services.
Improve upload intervals with respect to 5G networks.

6.1.0: Augist 24, 2020
Note: Due to known issues, this version should not be used.

Adds support Mobile Wallet in In-App, Inbox, Push and Places campaigns.
Minor changes to support Android 11.

6.0.1: April 27, 2020
Note: Due to known issues, this version should not be used.

Fix a bug that prevented user who re-entered a workflow from seeing In-Apps a second time.

6.0.0: March 31, 2020
Note: Due to known issues, this version should not be used.

Adds the capability to trigger In-Apps based on a workflow
This SDK is built against Android P and uses compileSDKVersion 29. All apps using it must be at least targeting Android P.
This SDK has updated the minimum requirements for some of its dependencies. Specifically, you must be on a minimum of firebase-messaging version 17.1.0, and Play Services libraries version 16.0.0.
Drop support for Android 4.x
Fix a bug that resulted in OutOfMemoryExceptions in the Live Monitoring code.

Localytics SDK Dependencies:

compileSdkVersion	29+
minSdkVersion	21+
Firebase Messaging	17.1.0+
Play Services Libraries	16.0.0+
Install Referrer	1.1+

5.9.0: January 8, 2020
Note: Due to known issues, this version should not be used.

Support new Attribution library
Always verify Facebook app is installed before requesting attribution information.

Localytics SDK Dependencies:

compileSdkVersion	28+
minSdkVersion	17+
Firebase Messaging	9.8+
Play Services Libraries	9.8+
Install Referrer	1.1+

5.8.0: October 31, 2019
Note: Due to known issues, this version should not be used.

Improve Geofence download code. Geofences are now downloaded more efficiently.
In-Apps now support a triggering condition of active geofences.
Make Inbox delete button text configurable.

5.7.0: October 1, 2019
Note: Due to known issues, this version should not be used.

Adds support for video in In-App and Inbox campaigns
Adds support for proper redirection of deeplinks generated in the Movable Ink platform.
Fixed a bug where the key values from a push campaign wouldn't be passed to the destination intent of a push message.

5.6.1: July 12, 2019
Note: Due to known issues, this version should not be used.

Fix an issue with TLS 1.2 support on Android Kit Kat devices.
Adds a local token to help validate the source of custom intent deeplinks.

5.6.0: June 17, 2019
Note: Due to known issues, this version should not be used.

In-App's now support rotation in app's that handle configuration changes
Fullscreen In-Apps can now be configured to render in the notch via HTML meta tag keys.
In-App banners now support configurable aspect ratios.
The default Localytics notification channel is now configurable, and set to IMPORTANCE_HIGH.
Fixed a bug where customer ids may not have been uploaded immediately if no other data was tagged.

5.5.0: April 1, 2019
Note: Due to known issues, this version should not be used.

Introduces support for live device logging
Fixes a bug where In-App and Inbox links with ampExternalOpen=false wouldn't open inside the In-App or Inbox's window.
Fixes a bug in PushTrackingActivity.

5.4.0: November 8, 2018
Note: Due to known issues, this version should not be used.

Add the ability to change the native rendering of In App based on values in the html creative. To learn more, read the In App documentation
Ensure that In App's render properly on devices with notches such as the Pixel 3 XL.

5.3.0: September 27, 2018
Note: Due to known issues, this version should not be used.

Fixes a bug where Inbox campaigns migrated from SDK 5.1 would have an expiration date in the past, and therefore be excluded from Inbox lists.
Push Event Labels passed through the Push API will now be reported on Push Received and Push Opened events.
Adds new API's to the Javascript available in In-Apps and Inbox campaigns that allow for deeplinking to the settings screen.
Added a fix for use of the Places BackgroundService with Google Play Services 12+.
Security improvement: In App's will sandbox their filesystem and ignore any files with parent directory access.
Location monitoring can be persisted. Location monitoring that has been persisted will restart monitoring automatically on new session.

5.2.1: July 18, 2018
Note: Due to known issues, this version should not be used.

Fixed a bug that could cause In App messages to fail to render in wrapper SDKs.

5.2.0: July 9, 2018
Note: Due to known issues, this version should not be used.

This SDK version has a major Inbox bug. Please upgrade directly to SDK 5.3 if you use Inbox
Drop supported Android versions back to Android OS 4.2 (API 17). All functionality is restored for older OS versions, with the exception of full screen In App messages.
Adds new API's to the Javascript available in In-Apps and Inbox campaigns including methods for setting opted out state and prompting for location permissions.
Introduces a new listener (CallToActionListener) that will update the user of Localytics related events that occur from inside campaigns.
Add Inbox delete API's and functionality including opt in swipe to dismiss from the Inbox list view.
The device back button will no longer dismiss In-App messages that have chosen to hide the dismiss button.
Fix a bug where the Inbox List view would show a date well before the user could have actually seen the campaign.
Add a tagPushReceivedEvent API for ease of integration on Firebase.
Some reliability improvements to the download and display of In Apps.
Deprecate MessgingListener#localyticsShouldDeeplink in favor of CallToActionListener#localyticsShouldDeeplink. This method will be removed in the next major release, and if both are implemented only the CallToActionListener variant will be called.

5.1.2: May 14, 2018
Note: Due to known issues, this version should not be used.

Fix an issue that could cause full screen In-App messages to render with an incorrect height.

5.1.1: May 1, 2018
Note: Due to known issues, this version should not be used.

Fix an issue that could cause full screen In-App messages to render as fully transparent on older devices and in wrapper SDKs.
Fix an issue where the default notificaton channel id set in the localytics.xml was not properly respected.

5.1.0: April 4, 2018
Note: Due to known issues, this version should not be used.

Improves integration pathways for GDPR compliance.
Adds new method for recording device timezone, ensuring messages get delivered at the correct time immediately following the beginning or end of Daylight Savings Time.
Adds ability to configure location update intervals.
Updates setOptOut to cease collection and uploading of Profiles data.

5.0.1: February 8, 2018
Note: Due to known issues, this version should not be used.

Fixes an issue which could prevent apps from being shipped to the Google Play store.

5.0.0: February 5, 2018
Note: Due to known issues, this version should not be used.

Adds support for data flushing. Analytics data can now be flushed at periodic intervals that will improve time sensitive messaging capabilities.
Adds support for an In-app live creative previewer for device testing.
Takes advantage of manifest merging and adds a config file, localytics.xml, to simplify integrations.
Removes support for versions of Android below 4.4 (KitKat).
Adds deeper Notification Channel support.
Removes the dependency on Google play services for both Google Cloud Messaging and Firebase Cloud Messaging integrations.
Fixes display of In-Apps on Android 8 devices with a soft navigation bar or action bar.
Adds support for push notifications with titles and no body.
Adds support for deep link suppression handling.
Fixes an issue with stale campaigns when a customer ID changes.
Adds an API for opting into attaching an ADID parameter to Inbox URLs.

4.5.2: July 12, 2019
Note: Due to known issues, this version should not be used.

Adds a local token to help validate the source of custom intent deeplinks.

4.5.1: October 18, 2017
Note: Due to known issues, this version should not be used.

Fixed a bug introduced in SDK v4.5.0 which led to crashes when certain 3rd party SDKs use Android services that dynamically activate/deactivate based on optional transitive dependencies.

4.5.0: September 12, 2017
Note: Due to known issues, this version should not be used.

Added support for Android O. The Localytics SDK will now use notification channels as needed, and handle background execution properly in Android O.
Updated Notifications enabled reporting to more accurately represent the user's state.
Fixed a bug where in app creatives stored as .html files would fail to download in test mode.

4.4.1: August 14, 2017
Note: Due to known issues, this version should not be used.

Fixed an issue where some deep links sent through Firebase Cloud Messaging caused apps to freeze.

4.4.0: July 10, 2017
Note: Due to known issues, this version should not be used.

Actions are now supported in Push and Places Notifications.
Added rich media support for Places notifications.
Full-screen videos can now be shown within Inbox creatives.
Silent Inbox campaigns are now supported to help A/B testing creatives without visible UI.
A new API has been added for tagging when an Inbox list item has been tapped.
Added extra Firebase validation for Rapid Push Verification.
Improved Firebase integration to make it quicker to set up.

4.3.1: April 5th, 2017
Note: Due to known issues, this version should not be used.

Fixed a bug introduced in SDK 4.3 preventing new Places from loading for apps with more than 1000 Places.

4.3.0: March 23, 2017
Note: Due to known issues, this version should not be used.

In-App Messaging improvements including:
- Per campaign UI modification. Using a callback, a number of properties on the In-app campaign can be modified such as centered In-App aspect ratio, Banner In-App offset from the edges of the screen, full-screen In-App transparency, and dismiss button image, location and visibility.
- A new campaign test mode UI including the ability to preview all creatives in an A/B test.
- The ability to delay In-App campaigns triggered by "Session Start" and refire them at a later time to avoid conflicts with splash screens or other interstitials.
- Additional Javascript callbacks for setting Profiles and identifying users within custom HTML In-App Messaging creatives.
- A new In-App Dimiss button.
- In-App Messages can now be triggered or suppressed based on dimensions.
Performance events to manually track impressions and conversions for customers rendering fully custom Push, In-App, Inbox, and Places campaigns.
Added creative location access for custom Inbox and In-App campaigns.
Places notification trigger methods.
First class support for Push messages with rich media attachments.

4.2.1: December 6, 2016
Note: Due to known issues, this version should not be used.

Fixed a crash that could occur when using Rapid Push Verification with a Firebase Cloud Messaging integration.

4.2.0: November 11, 2016
Note: Due to known issues, this version should not be used.

Added support for frequency capping in Places.
Added support for downloading scheduled campaigns in advance so they are available immediately at campaign launch time.
Fixed a bug that caused places identifiers with quotes to not be handled appropriately.
Improved logging.

4.1.0: September 6, 2016
Note: Due to known issues, this version should not be used.

Enable TLS 1.1/1.2 on API 16+ devices.
Fix in-app message aspect ratio on certain devices.

3.8.2: August 29, 2016
Note: Due to known issues, this version should not be used.

Fixed an issue with push registration due to an update in Google Play Services.

4.0.1: June 2, 2016
Note: Due to known issues, this version should not be used.

Fixed the availability of some standard events.

4.0.0: May 31, 2016
Note: Due to known issues, this version should not be used.

Added support for Places, our geofencing and background location analytics and messaging product.
Added standard events.
Removed in-app messaging dependency on FragmentActivity and dropped support for Android 2.3 (Gingerbread);
Fixed bug that could prevent a user from receiving push notifications after restoring from an Android 6.0 (Marshmallow) app backup.
Added listener callbacks to allow easy modification or suppression of push messages.

3.8.1: May 6, 2016
Note: Due to known issues, this version should not be used.

Fixed an issue that could cause session start in-app campaigns to not trigger on their first qualified session.

3.8.0: March 10, 2016
Note: Due to known issues, this version should not be used.

Added "push registered" event, which allows Localytics to upload a user's push token immediately. This improves reliability for developers when testing push integration. It also ensures all users who have only had one session can still receive push notifications.
Bug fixes.

3.7.0: February 5, 2016
Note: Due to known issues, this version should not be used.

Added App Inbox for delivering personalized content to users through a dedicated inbox.
Fixed an issue that could prevent in-app control group impressions from being tagged.

3.6.0: December 9, 2015
Note: Due to known issues, this version should not be used.

Increased hard limit on number of custom dimensions to enable future Dashboard improvements.
Fixed issue caused by calling flush() on devices with API level 18 and below.
Fixed issue in which some screen flows could be dropped due to not being persisted between app launches when the app left memory.

3.5.0: October 15, 2015
Note: Due to known issues, this version should not be used.

Added "handlePushNotificationReceived()" public method to allow push received tracking when not using Localytics broadcast receiver
Added "setLaunchIntent()" method to the "PushNotificationOptions.Builder" class, allowing customization of the launch intent used by Localytics notifications
Added "setTitle()" method to the "PushNotificationOptions.Builder" class, allowing customization of the title displayed in Localytics notifications
Bug fixes

3.4.2: September 14, 2015
Note: Due to known issues, this version should not be used.

Added push notification customization options for Lollipop+, such as setting vibration pattern, LED color, category, priority, small and large icons, etc. ( https://developer.android.com/design/patterns/notifications.html )
Fixed upgrade bug when updating from SDK v2.19-to v3.1+
Other bug fixes

3.4.1: July 15, 2015
Note: Due to known issues, this version should not be used.

Added some extra security measures around in-app creatives

3.4.0: July 1, 2015
Note: Due to known issues, this version should not be used.

Support for scheduling automation for in-app messaging
Support for control groups for in-app messaging

3.3.0: June 2, 2015
Note: Due to known issues, this version should not be used.

Added setters for customer first name, last name, full name, and email that will act as Profile attributes and be available in raw data exports
Fixed bug that impacted identically-named in-app campaigns
Improved handling of special characters in Customer IDs
Changed Profile upload batch size from 500 to 50
Fix for attribution due to late broadcast of INSTALL_REFERRER Intent
Added Android attribution test mode
Added extra check to see if icon resource is valid before posting notification
Enabled remote JavaScript in in-app creatives

3.1.1: April 7, 2015
Note: Due to known issues, this version should not be used.

Numerous performance-enhancing updates and bug fixes

3.1.0: February 20, 2015
Note: Due to known issues, this version should not be used.

Enables new Localytics Push Received event for more comprehensive campaign performance tracking
Application class integration is now available and required
Support for runtime app key setter
Support for multi-line push notifications
Simplified push integration with PushTracking Activity
New APIs for manual push registration: getRegistration and setRegistration
Upgraded to GCM and removed any references to C2DM
Fix in performance measurement when A/B testing multiple creatives in an in-app messaging campaign

3.0.1: February 2, 2015
Note: Due to known issues, this version should not be used.

Added getRegistrationId and setRegistrationId APIs to facilitate push registration for Titanium
Only available as part of Titanium 3.0.1

3.0.0: December 31, 2014
Note: Due to known issues, this version should not be used.

Profiles APIs enable you to increment, decrement, add to set, and remove set
Support for events that occur outside a session
New callbacks to expose more SDK state (helpful for event tagging and managing in-app message display)
Consistent tagging across iOS and Android SDKs for seamless integration experience
Performance enhancements across analytics and marketing

2.73: December 17th, 2014
Note: Due to known issues, this version should not be used.

In-app test mode fixes
Better handling of failed WakeLock acquisition
JavaScript API bug fixes for in-app creatives

2.72: November 7th, 2014
Note: Due to known issues, this version should not be used.

Fix for push registration on API Level 21

2.71: October 31st, 2014
Note: Due to known issues, this version should not be used.

Support for Profiles
Android Lollipop compatibility
Can specify an icon for Localytics push notifications

2.70: October 1st, 2014
Note: Due to known issues, this version should not be used.

More efficient uploading of customer data
WakeLock permission is now optional

2.66: September 19th, 2014
Note: Due to known issues, this version should not be used.

Referral receiver bug fixes

2.65: August 13th, 2014
Note: Due to known issues, this version should not be used.

Automatic integration using ActivityLifecycleCallbacks
Push receiver bug fixes

2.60: August 1st, 2014
Note: Due to known issues, this version should not be used.

Added in-app messaging support
Support for additional customer data
Google Advertising ID

Web

4.2.0: March 16, 2020

Ensure that all Localytics stored cookies are tagged with SameSite=None and Secure.

4.1.0: October 16, 2019

Adds the ability to opt out of future data collection using the setOptedOut apis.

4.0.0: July 31, 2019

Add support for web push in Chrome, Firefox, Opera, and Edge.
Add ability to opt out specific users from analytics data tracking.

3.4.0: April 23, 2018

Improves integration pathways for GDPR compliance.

3.3.3: June 7, 2017

Increased the number of supported custom dimensions to 20.

3.3.2: January 10, 2017

Fixed a bug where customer identifiers weren't being encoded in profile uploads.

3.3.1: December 5, 2016

Add methods for setting first name, last name and full name identifiers.
Fixed a bug where setting identifiers wouldn't update corresponding profile attributes.

3.3.0: June 25, 2016

Add the ability to set profile attributes in the web.
Retry failed requests up to 3 times.

3.1.2: July 8, 2015

Improved AMD compatibility and error handling.

3.1.1: June 18, 2015

Improved handling of special characters.

3.1.0: January 6th, 2015

Added RequireJS and CommonJS support.

3.0.2: January 6th, 2015

Fix for missing screen flow data.

3.0.0: October 23rd, 2014

All new integration with async loading.
Local storage / cookies option.
Cross-domain support.
Auto page view tracking.

Cordova

6.4.1: October 3rd, 2024

Updates iOS native binding to iOS SDK 6.3.2 and Android SDK 6.4.2

6.4.0: August 31, 2024

Updates iOS native binding to iOS SDK 6.3.1 and Android SDK 6.4.2

6.3.8: April 17, 2024

Updates iOS native binding to iOS SDK 6.3.0 (which adds xcprivacy manifest with default required permissions)

6.3.7: April 4, 2024

Updates Android native binding to Android SDK 6.4.0 (which contains important fixes related to places feature)

6.3.6: March 1, 2024

Updates Android native binding to Android SDK 6.3.9 (which contains important updates related to complying with Google Play data collection policies)

6.3.5: October 25, 2023

Wraps Android SDK 6.3.8 & iOS SDK 6.2.9

6.3.4: November 1, 2022

Wraps Android SDK 6.3.7 & iOS SDK 6.2.9
This version wraps an iOS SDK with Bitcode disabled, so please stay on 6.3.3 if you do not prefer this.

6.3.3: November 1, 2022

Wraps Android SDK 6.3.7 & iOS SDK 6.2.8
Adding the ask-for-notification-permission logic to the android plugin code through the InApp messaging feature.
Migrating to AndroidX
Removing optimistic operator from the iOS platform to target exact pod version.
Added some enhancements & code refactors to the android plugin that have been tested thoroughly.

6.3.1: September 9, 2022

This is the last Cordova version wrapping the legacy (android-support) Android SDK 6.1.0
It is also the last Cordova version wrapping the iOS SDK with an optimistic operator to get the latest pod version.

Maui

1.1.4: October 3rd, 2024

Updates iOS native binding to iOS SDK 6.3.1 and Android SDK 6.4.2

1.1.2: August 31, 2024

Updates iOS native binding to iOS SDK 6.3.1 and Android SDK 6.4.2

1.1.1: May 3, 2024

Updates iOS native binding to iOS SDK 6.3.0 (which adds xcprivacy manifest with default required permissions)

1.1.0: April 4, 2024

Updates Android native binding to Android SDK 6.4.0 (which contains important fixes related to places feature)

1.0.9: March 8, 2024

Updates Android native binding to Android SDK 6.3.9 (which contains important updates related to complying with Google Play data collection policies)

1.0.8: October 25, 2023

Updates Android native binding to Android SDK 6.3.8 (which will require upgrading VS OpenJDK to Java-17)

1.0.7: Sep 15, 2023

Fixing an issue related to using AutoIntegrate on iOS platform code. However, it's not recommended to use it as it's not fully supported since .net6. The manual integrate function should be used instead.

1.0.6: Aug 16, 2023

Fixing an issue related to deploying to physical iOS devices

1.0.3: May 30, 2023 Note: Due to known issues, this version should not be used.

Initial release of the Maui SDK

React Native

3.3.5: October 3rd, 2024

Updates iOS native binding to iOS SDK 6.3.2 and Android SDK 6.4.2

3.3.4: August 31, 2024

Updates iOS native binding to iOS SDK 6.3.1 and Android SDK 6.4.2

3.3.3: April 19, 2024

Updates iOS native binding to iOS SDK 6.3.0 (which adds xcprivacy manifest with default required permissions)

3.3.2: April 4, 2024

Updates Android native binding to Android SDK 6.4.0 (which contains important fixes related to places feature)

3.3.1: March 1, 2024

Updates Android native binding to Android SDK 6.3.9 (which contains important updates related to complying with Google Play data collection policies)

3.2.9: October 25, 2023

Updates Android native binding to Android SDK 6.3.8

3.2.8: April 28, 2023

Fixes an issue related to Inbox Campaign Creatives viewing.

3.2.7: November 22, 2022

Updates bindings to SDK 6.3.7 (Android) and 6.2.8 (iOS)
Fixes issues related to using the latest versions of the Localytics Android SDK
Targets Android SDK-33 (Android 13), and adds support to the in-app messaging notification permission requesting through the (promptForNotificationPermissions) function
Refactors and reduces the npm package size dramatically.

3.1.0: August 24, 2020

Updates bindings to SDK 6.1.1 (Android, iOS)

3.0.0: April 27, 2020

Updates bindings to SDK 6.0.1 (Android, iOS)
Introduce support for androidX in RN 0.60+. For customers on RN 0.59 and below who cannot use androidX, please change your depdency to localytics-react-native-legacy as stated in the setup guide

2.8.2: February 6, 2020

Introduce support for autolinking introduced in React Native version 0.60.x

2.8.0: January 10, 2020

Updates bindings to Android SDK 5.9.0

2.7.0: November 1, 2019

Updates bindings to SDK 5.8.0 (Android, iOS)
Fixes a weak reference in the Inbox implementation that could lead to crashes.

2.6.0: October 2, 2019

Updates bindings to SDK 5.7.0 (Android, iOS)
Fixes a weak reference in the Inbox implementation that could lead to crashes.

2.5.0: July 13, 2019

Updates bindings to Android SDK 5.6.1 (Android)

2.4.0: April 4, 2019

Update bindings to SDK 5.5.0 (Android, iOS)
Fixes a bug in PushTrackingActivity on Android

2.3.1: January 4, 2019

Add support for Inbox

2.3.0: November 16, 2018

IOS builds require Xcode 10.1. Earlier versions of Xcode do not generate BitCode compatible binaries.
Updates bindings to SDK 5.4.0 (Android, iOS)
Improve performance by moving all Localytics calls off the main thread and onto a background thread.

2.2.0: July 19, 2018

Updates bindings to SDK 5.2.0
Fix an issue with the LLLocationEmitter.

2.1.2: May 14, 2018

Updates bindings to Android SDK 5.1.2
Fix an issue that could cause full screen In-App messages to render with an incorrect height.

2.1.1: May 1, 2018

Updates bindings to Android SDK 5.1.1
Fix an issue that could cause Android full screen In-App messages to render as fully transparent.

2.1.0: April 9, 2018

Improves integration pathways for GDPR compliance.
Updates bindings to iOS/Android SDK 5.1.0.

2.0.0: March 6, 2018

Updates bindings to iOS/Android SDK 5.0.0.

Xamarin

6.3.2: May 27, 2024

Updates Android native binding to Android SDK 6.4.0 (which contains important fixes related to places feature)
Updates iOS native binding to iOS SDK 6.3.0 (which adds xcprivacy manifest with default required permissions). Note: This version is built only for x86_64 CPU architecture, but still can run on both simulators and physical devices, to achieve this update you app csproj file to only support the mentioned architecture.
```
<PropertyGroup>
  <MtouchArch>x86_64</MtouchArch>
</PropertyGroup>
```

6.3.1: February 17, 2023

Updates bindings to iOS SDK 6.2.9 (without bitcode) (iOS)

6.3.0: February 17, 2023

Updates bindings to Android SDK 6.3.7 (Android) & iOS SDK 6.2.8 (with bitcode) (iOS)
Updating all of the SDK outdated packages
Targeting Andorid 13 Framework
Migrating from packages.config to packagereference

6.0.1: April 27, 2020

Updates bindings to SDK 6.0.1 (Android, iOS)

6.0.0: April 4, 2020

Updates bindings to SDK 6.0.0 (Android, iOS)

5.7.0:

Updates bindings to SDK 5.7.0 (Android, iOS)

5.6.0:

Updates bindings to Android SDK 5.6.1 (Android)

5.5.0:

Updates bindings to SDK 5.5.0 (Android, iOS)

5.4.0: November 30, 2018

IOS builds require Xcode 10.1. Earlier versions of Xcode do not generate BitCode compatible binaries.
Updates bindings to SDK 5.4.0 (Android, iOS)
Support for Location services in Foreground. SDK nolonger requests location permission. Application should now request permissions for Location.
Supports WKWebView for iOS. Requires Xamarin.iOS 12.2.1.11 or later.

5.1.2:

Updates bindings to Android SDK 5.1.2

tvOS

1.0.2: December 14, 2016

Fixed a bug where apps would crash when trying to deeplink while auto-integrated.

1.0.1: December 6, 2016

Fixed a bug where apps would crash when receiving a silent push notification while auto-integrated.

1.0.0: October 28, 2016

Introduced an Apple TV SDK with support for Analytics and Profiles.

Windows RT

3.1.0: November 11, 2015

Added support for profiles

3.0.1: July 10, 2015

Fixed bug that impacted exception handling

3.0.0: April 7, 2015

Initial release of analytics-only WinRT SDK, developed natively in C# for Windows Runtime
Works with Windows Phone 8.1 and later, Windows Store (i.e. Desktop) 8.1 and later
Analytics parity with iOS and Android

Roku

4.0.2: April 6, 2017

Fixes a bug introduced in 4.0.1 where sessions are not initialized properly on fresh installs.

4.0.1: March 29, 2017

Fixes an issue where registry writes could overlap from different threads.

4.0.0: March 3, 2017

Adds support for Scene Graph

3.0.0: May 26, 2015

Initial release of Roku SDK

Titanium

3.0.1: February 02, 2015

Major revision to the Titanium module to support Push and In-App Messaging for iOS
All iOS 3.0.0 improvements, including numerous performance enhancements
All Android 3.0.1 improvements

Get a Demo Tailored to You

Thanks!