SDK changelog

A list of changes made to the Localytics SDK.

Sign Up for SDK Notifications Here

iOS

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.

6.2.9: October 25, 2022

6.2.8: July 21, 2022

  • 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.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:28.2.0')
          implementation 'com.google.firebase:firebase-messaging'
          implementation 'com.localytics.androidx:library:6.3+'
          

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.

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.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.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.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

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.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

6.0.0: April 4, 2020

5.7.0:

5.6.0:

  • Updates bindings to Android SDK 5.6.1 (Android)

5.5.0:

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