Fixed #

• [iOS] Potential issue with slow SDK initialization.
• [iOS] Potential issues with Simple Authentication requests.

Added #

• We extended a Synerise.changeClientApiKey(apiKey, config) method and added new parameter (config) that allows adding some initialization parameters.
• We added new parameters to the push.click event: clickSource, actionType, url and actionButtonTitle.

Changed #

• requestValidationSalt (Simple Auth) is cleared when Synerise.changeClientApiKey(apiKey, config) is invoked without suitable config.
• Update of native SDK's dependencies.
• Improvements to stability.

Added #

• We added atestDelivery and journeyId parameters to tracked notification events (push.view, push.click, and so on). It describes if the notification was sent as a test notification from a campaign.
• We added a new Synerise.content.generateDocumentWithApiQuery(apiQuery, onSuccess, onError) method. It is analogous to Synerise.content.generateDocument(slug, onSuccess, onError), but can contain more context parameters provided in a query object.
• We added a new Synerise.content.generateScreenViewWithApiQuery(apiQuery, onSuccess, onError) method. It is analogous to Synerise.content.generateScreenView(feedSlug, onSuccess, onError), but can contain more context parameters provided in a query object.
• Anchors from Drag & Drop Builder in the In-App editor are interpreted as URL or as deeplink depending on the value.

Changed #

• We added validation of reserved parameters in events. Now, if a parameter is forbidden, it is removed from the parameters and a log is printed.
• Improvements to stability.

Changed #

• Stability improvements.

Changed #

• Stability improvements.

Fixed #

• [iOS] Some potential issues with retrieving system push consent by the SDK.

Added #

• Synerise.settings.tracker.eventsTriggeringFlush option in settings to let you set the list of event actions which will trigger instant sending of all events in the queue. The default array contains only push event's actions.

Changed #

• All events connected with push campaigns will flush the queue and send events immediately.
• Improvements to push notifications registration.
• Stability improvements.

Fixed #

• [android] NPE on registerForPush while SDK was not initialized yet.

Added #

• Synerise.onReady callback to properly handle Synerise SDK initialization state.

Changed #

• Stability improvements.

Fixed #

• [android] NPE on getClientId after apiKey changes.
• [android] registerForPushCache was not passing request after client context change within 24h.

Changed #

• Stability improvements.

IMPORTANT: We've introduced significant improvements to our method invocation patterns to enhance error handling and simplify success callbacks. This change requires updates to existing method calls in your applications.

• API Call Pattern Changes: Previously, asynchronous API calls were structured to use await along with catchError for error handling. Now, we've shifted to a more structured callback approach using onSuccess and onError parameters, providing clearer control over success and error handling.

• Simplification of Data Retrieval Methods: For methods that retrieve data from native SDKs, such as obtaining a UUID, the pattern has been simplified to use .then for handling successful outcomes. This change promotes cleaner code and more intuitive success handling. Now, the new pattern is more streamlined and focused on the success case.

Added #

• [iOS] Synerise.settings.sdk.localizable option in settings to let you localize some strings displayed by the SDK.
• clientId property in the Token model.

Fixed #

• Improved mechanism for checking capping in in-app messages. The number of views no longer resets when the account's UUID changes.

Changed #

• Stability improvements.

Added #

• Global Control Group support for in-app messages. From now on, you can use this feature in in-app messaging communication. This lets you take your marketing efforts to the next level and provides a solid foundation for accurate measurement of campaign effectiveness. Read more at https://hub.synerise.com/docs/settings/configuration/global-control-group/.

Fixed #

• [iOS] Issue with non-scrolling in-app messages.

Changed #

• Stability improvements.

Fixed #

• [android] Deeplink action when clicking on push notification will directly open in app instead of prompt between app/browser. We set packageName to intent.

Fixed #

• [iOS] In-app message did not hide automatically after invoking SRInapp.openUrl(url) or SRInapp.openDeeplink(deeplink) the action as it should

IMPORTANT: Due to changes in the handling of actions for URLs and deep links in Synerise campaigns, we strongly recommend comparing your configuration with the SDK documentation. Review the changes from the previous SDK version integrated into your application here: https://hub.synerise.com//developers/mobile-sdk/campaigns/action-handling/

Fixed #

• [iOS] Running example by flutter run command.

Added #

• New methods for dealing with encrypted notifications: Synerise.notifications.decryptNotification and Synerise.notifications.isNotificationEncrypted.

Changed #

• Changes in handling actions from campaigns (read important note above).
• Update of native SDK's dependencies.

Fixed #

• Resolved the issue of SDK initializing multiple times in a specific scenario and implemented a prevention mechanism.

Changed #

• Example app project files refinements.

Fixed #

• [iOS] Potential issues with Simple Authentication requests.
• [iOS] Issue with location of some SDK files in the Documents directory. The old location caused the SDK files to be visible in the shared documents directory if the host application file sharing was enabled.
• [iOS] Potential issue with native notification buttons when Simple Push campaign contained Rich Media (Single Media) or had a custom notification category identifier.

Changed #

• Update of native SDK's dependencies.

Added #

• setRequestValidationSalt is now optional. Salt is not required for simpleAuthentication, but we recommend using it for improved security (it needs to be enabled in the Synerise portal first).
• Synerise.settings.inAppMessaging.shouldSendInAppCappingEvent option in settings to enable or disable sending inApp.capping event by the SDK.

Fixed #

• iOS example app project files refinements.

Changed #

• Stability improvements.

Added #

• Notifications Methods: Introduced new methods for notification payload verification, including isSyneriseNotification, isSyneriseSimplePush, isSyneriseBanner, isSilentCommand, and isSilentSDKCommand.

Fixed #

• Addressed issues with inApp listeners handling in the Android platform.
• Improved the handling of the activateAccount method in the Android portion.
• Enhanced the architecture of the events classes in the Dart part.
• Corrected the field name in the IdentityProvider class.

Changed #

• Stability improvements.

Added #

• New authentication mechanism - Simple Authentication. It allows identification of customers without implementing more complicated processes such as RaaS, OAuth, or authenticating by third party services, for example Facebook or Apple. Simple Authentication needs only two methods - client.simpleAuthentication to recognize a customer and client.isSignedInViaSimpleAuthentication to check if the customer is signed in and uses the Simple Authentication feature. The client.signOut method and similar methods are a common way to sign out and clear the user context.
• Client Methods: Added several client methods, including pinCodeMethods (request and confirm), conditional authentication and sign-in, changeApiKey, phone/EmailChange, regenerateWithUUID, and signOutWithMode.
• Added the Apple value to the identityProvider enum.

Fixed #

• Implemented minor fixes to improve the handling of channel method results.

Changed #

• Stability improvements.

Added #

• Included iOS native push extensions to the example app.

Fixed #

• Resolved issues with iOS tracker params mapping.
• Enhanced the handling of channel methods result.

Fixed #

• Removed redundant code from the example app.
• Fixed parameter mapping for custom events in the iOS native part.

Fixed #

• Addressed a bug related to Android push notifications banners.

Changed #

• Stability improvements.

Added #

• We added a new content.generateDocument method. It's analogous to `Content.getDocument``. The old method is deprecated. The new method generates the document that is defined for the provided slug.
• We added a new content.getRecommendationsV2 method. It's analogous to content.getRecommendations. The old method is deprecated. The new method gets recommendations that are defined for the options provided.
• We added a new content.generateScreenView method. It's analogous to content.getScreenView. The old method is deprecated. The new method generates a customer's highest-priority screen view campaign that is defined for the provided slug.
• We added models correlating with new methods: ScreenView, Document.
• Introduced predefined Events. Full list is available in the documentation.

Fixed #

• Clarified the terminology related to the API key.

Removed #

• Deprecated old methods in the Content module.

Added #

• Introduced the Promotions module.

Fixed #

• Made minor fixes to improve mapping.

Changed #

• Stability improvements.

Added #

• Updated SSL pins for all domains.

Removed #

• Removed the QUERY_ALL_PACKAGES permission in Android.

Added #

• Extended and polished the example app.

Fixed #

• Enhanced object mappings for Content methods.
• Adjusted project structure to align with the preferred pattern on pub.dev.

Added #

• Implemented Inapp and Push notifications handling.
• Enhanced native listeners handling.
• Introduced several methods in the Client module for client account management.

Fixed #

• Improved the project structure.

Changed #

• Stability improvements.

Added #

• Added the Settings module.
• Introduced the Tracker module with custom events.
• Implemented the Content module with several methods.

Fixed #

• Enhanced the project structure.

Added #

• Initiated the SDK with basic configuration options.
• Introduced the Client module with several methods for user authorization and session management.