iOS SDKAndroid SDKPulsate APISDK API
API Reference

iOS SDK Release Notes

❗️

CocoaPods could not find compatible versions for pod "PULPulsate"

If you are having problems with installing a specific version of PULPulsate please try using the following commands in the order specified below:

  1. pod repo update
  2. pod deintegrate
  3. pod install --repo-update
  4. pod update --repo-update

Release 4.6.0

New:

  1. Added new method getFeedUnreadCount() to allow direct access to unread count and help keep inside App badges / unread count up to date.
  2. Added Feed completion callback. Callback will happen when deinit is triggered. This informs you when the user has exited the Pulsate Feed. This is a good time to for example call getFeedUnreadCount() and update your UI.

Behavior Changes:

  1. Start Session will no longer trigger permissions. We leave asking for permissions and proper priming to Developers. Just starting the Pulsate SDK should not ask for push / location permissions.

Bug Fixes:

  1. Fixed loading external bundle. Now uses direct reference of bundle loaded into app into SDK.

Release 4.5.5

New:

  1. New method "UserHasLoggedIn"
    • Enables in apps
    • Shows last bounced in app
    • Sets user as authorized
    • Shows last unauthorized message
  2. New method "UserHasLoggedOut"
    • Disables in apps
    • Sets user as unauthorized
  3. New listener pulsateLinkListener - URLs and Deeplinks will be sent first to this new listener if set. On return false Pulsate will handle the URL / Deeplink. On true we return.
  4. Added privacy manifest

Improvments:

  1. Database manager refactored to make it thread safe
  2. Stats will now sync more often
  3. Small in apps stats improvement

Bug Fixes:

  1. In Apps refactored to cover edge cases on statistics
  2. SDK will now properly remember authorization state between sessions.
  3. Fixed edge cases where Pushes would not open destinations for unauthorized users

02.04.20244.5.0New Features:

- PulsateSDK crashes and anrs will now be collected and sent to New Relic.
07.03.20244.4.0Location Rework:

- Location and Geofencing have been reworked. The amount of active location updates caused by the SDK has been reduced by more than 90% in some cases. Most location updates still happening are caused by the Geofencing API itself.

- Restrict location updates if no geofence is aroundImprovements:

- In Apps will now auto close if app goes into background. Fixed collecting dismiss stats for auto closing.

- Added cache for enable/disable push notifications, privacy, and location.

- Improved database auto migration.

- Added reset/delete locations cache.

- Removed depreciation warnings.

- Removed and updated push notification settings/options.

- Improved push notification delivery and bounce events.
01.02.20244.3.0Improvements:

- iOS Deployment target changed from iOS 12 to iOS 13.

- Improvements to stat collection. SDKs will now trigger the whole flow of stats that must have happened to get to this place.

- Update User / Privacy / Location / Push settings will all be debounced to merge multiple calls into one. This will reduce the amount of requests done and prevent a possibile race condition where we would have two active request updating the same setting to different values.

- Added core data automatic migration.Bug Fixes:

- We will no longer send empty user data to the BE. If firstName / lastName / email / phone are null or empty we will not send it to the BE.

- Update user will no longer send duplicate attributes and actions.

- Fixed time spent calculation for screen records.

- Fixed setting Feature Suggestion as a category for talks.

- current_location will not be sent if location is null.
14.09.20234.2.3Bug Fixes:

- fixed crash caused by starting session for alias with empty alias - will now throw a custom error
- moved In App show to main thread, this should fix a rare crash when rendering In Apps
14.07.20234.2.2Bug Fixes:

- fixed color configuration json
27.06.20234.2.1Bug Fixes:

- fixed button colors on In Apps
- fixes button colors on Back of the Card
14.06.20234.2.0New Features:

- Dual Buttons - new design, Big In App / Card / Back of Card can now have up to two buttons.

- New Colors in PulsateConfiguration.json
pulsate_card_one_btn_color
pulsate_card_one_txt_color
pulsate_card_two_btn_color
pulsate_card_two_txt_color
pulsate_card_two_btn_outline_color
pulsate_card_back_one_btn_color
pulsate_card_back_one_txt_color
pulsate_card_back_two_btn_color
pulsate_card_back_two_txt_color
pulsate_card_back_two_btn_outline_color
pulsate_big_in_app_one_button_color
pulsate_big_in_app_one_button_text_color
pulsate_big_in_app_two_button_color
pulsate_big_in_app_two_button_text_color
pulsate_big_in_app_two_button_outline_colorStats:

- PULUserAction.recordUserStatAction - is now responsible for collecting all stats.

- Added update user request to beacon events.

- Added update user request to geofence events.

- Added update user request to location updates. Only happens when geofence list is refreshed. We try to wait at least 1km between each refresh.

- Added threshold for update user request. If user actions and user updates size does not pass the threshold the request will not happen. This is to prevent empty requests and prevent background updates to happen for every single update.
Thresholds:
Alias Change - 0
Logout - 0
Daily sync - 0
Geofence - 1
Beacon - 1
Location Update - 1Improvements:

- Pulsate config for strings and colors can now be moved into App files. First copy configuration and strings from pulsatebasic bundle and add into main app then specify main app bundle id to manager.resourcebundleIdentifier. Example for app with identifier "pulsate.universal.app" - pulsateManager.resourceBundleIdentifier = "pulsate.universal.app", this will cause the SDK to search for resources in the Main folder of the App.

- badgeDelegate will now not update badges on it's own if a badgeDelegate is set, instead it will send a callback to the Developer to handle the badge update.Bug Fixes:

- handlePushNotification will now retry properly when App state is not active.

- Fixed possible crash when PULFeedEmptyView is null.

- createSessionAndGetData will now retry properly when App state is not active.

- logout will now first end the session and after that logout the user.
16.06.20234.0.8.3Released 4.0.8.1 using xCode 14.1
14.06.20234.0.8.1Bug Fixes:

- Fixed possible crash when PULFeedEmptyView is null.
12.05.20234.0.8Bug Fixes:

- Back of Card will now properly render button with Botttom Navigation.
- Turned off debug logs for builds.
04.04.20234.0.7Improvements:

- Added retry mechanic to start session.

- Added retry mechanic to opening push destinationBug Fixes:

- In Apps not scaling properly when there is no personal message

- Fix an issues where updateuser / endsession would crash due to nulls.
17.11.20224.0.5Improvements:

- showLastInAppNotification() changed to showLastInAppNotification( _ forceShow: Bool = false) - when force is true the SDK will be forced to show the last received In App Notification even if isInAppNotificationEnabled() returns false. By default force is set to false.
27.10.20224.0.4Bug Fixes:

- PULTextBlock is now public.
- PULTextStyle is now public.
26.10.20224.0.3Bug Fixes:

- BUILD_LIBRARY_FOR_DISTRIBUTION is now YES. This should fix build errors caused by Swift version mismatch.
- PULPulsateUnauthorizedManagerDelegate and PULPulsateBadgeDelegate are now public.
- Unread color fix - card buttons should now properly change when cards are read.
16.09.20224.0.0iOS 15 Release - Built using Xcode 13.4.1 (13F100)

Improvements:

1. SDK has written into Swift.
2. Improved rendering ui layout in in-apps.
3. Improved rendering ui layout in Feed.
4. Improved location checking.
5. Improved geofencing.
6. Improved push notification responses.
05.12.20223.8.1Improvements:

- Backported In App Improvements from 4.0.5.
- showLastInAppNotification() changed to showLastInAppNotification( _ forceShow: Bool = false) - when force is true the SDK will be forced to show the last received In App Notification even if isInAppNotificationEnabled() returns false. By default force is set to false.
14.10.20213.8.0iOS 15 Release - Built using Xcode 13.0 (13A233)

Improvements:

1. Improved Accessibility - navigation, voice over support, element sizes, ui grouping.

2. Improved geofencing accuracy on iOS 15.

3. Small In Apps can now be dismissed by swiping them left or right.

4. Small In Apps will now try to always show below the toolbar and above bottom navigation elements.

5. Simplified and reduced the amount of background tasks running.

6. Code cleanup - removed many warnings, divided large chunks of code into smaller methods, removed whitespaces in many places, fixed code formatting in many places.Bug Fixes:

7. Push notifications will now properly open talks when the app is force closed.

8. Push notifications with expired cards will no longer take the user to a feed that loads forever.

9. Fixed edge cases that could cause "destination feed" from sometimes not taking the user to the feed.

10. New Thread Button will now animate properly (hide / show) when the user scrolls the Feed.
18.06.20213.7.0New Features:

1. Added collecting background_permission state in update_user and end_session.

2. The SDK will now collect stats about pushes, in apps, cards.Bug Fixes:

3. Fixed crash that happened when the user was in the inbox and received a card message.

4. Fixed a bug that could cause the inbox to be stuck in forever loading state when returning to the inbox from a single card view.

5. User Actions will be deleted after they have been successfully sent to the server.