Releases: sailthru/sailthru-mobile-ios-sdk
7.3.1-beta
Bug fixes surrounding push notification handling.
7.3.0
Features
Sailthru Link Handling
You can now use Carnival's handleSailthruLink: method to take Sailthru links from emails (a la http://link.client.com/click/...),
and unroll them into their destination links, while tracking that the link in question has been clicked.
The proposed use case for this is that you want to open a view from your app by clicking on an email sent from Sailthru.
To do this using Apple's Universal Links, you can follow this guide, ensuring that you've also followed Sailthru's docs on setting up Universal Links to work with Sailthru Emails.
From within the AppDelegate:application:continueUserActivity:restorationHandler: method, you can do as follows:
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([Any]?) -> Void) -> Bool {
let url = Carnival.handleSailthruLink(userActivity.webpageURL!)
// Then route to some view using the url returned...
return true;
}Mobile Track and Personalize
Carnival SDK 7.3.0 brings new features to let you better personalize your content on mobile and on the web. You can use the Carnival:recommendationsWithSection:withResponse: method to get an array of personalized content from Sailthru's SPM service, provided you have Sailthru integrated.
To recommend your users the right content, you can track the content they interact with by calling the Carnival:trackPageviewWithUrl:andTags:andResponse:, Carnival:trackImpressionWithSection:andUrls:andResponse: and Carnival:trackClickWithSection:andUrl:andResponse: methods. More information on integrating SPM can be found in our docs, and more in-depth mobile integration advice can be found in the Carnival Developer Documentation
As always, if you need more help or support integrating new features, please feel free to talk to your CSM, or to get in touch with [email protected].
7.2.0-beta
Introduces experimental features that allow integrating Track and Personalize features from Sailthru SPM (Site Personalisation Manager).
These methods are being validated and they are likely to change. Please, reach out to your CSM or [email protected] for more details.
Carnival iOS SDK 7.1.1 Release Notes
Improvements
This release contains some under the hood changes for our Unity, Cordova and React Native wrapper SDKs.
Carnival iOS SDK 7.1.0 Release Notes
Features
You can now use userNotificationCenter:willPresentNotification: with full compatability with the SDK. Your implementation will be used as the source of truth. The default is the iOS 1-10 behaviour of showing while the app is open. Read more docs on this here.
Bug Fixes
- Fixes an issue where an In App Notification wouldn't show on iOS 11.0.x. (Fixed by Apple in 11.1.x)
- Fixes an issue where "Push Enabled" in device logs would not populate properly on first install. This should now appear when the user first accepts permissions for push notifications.
Integration changes
- For manual and Carthage installations, you'll need to include UserNotifications.framework.
Carnival iOS SDK 7.0.0 Release Notes
Features
Support for iPhone X, respecting the iPhone X Human Interface Guidelines:
- Full Screen Messages shows the status bar on iPhone X
- In App Notification appears lower, as not to be obsured by the notch on iPhone X
Bug Fixes
- Fixes an issue with the In App Notificaiton would scale oddly if displayed during a device rotation
- Fixes an issue with Full Screen Messages displaying oddly on rotation.
- Fix scrollbars and landscape centering of Full Screen Messages on iPhone X
Method Removals
Removed the +startEngine:andNotificationTypes: initializer method, as this was deprecated in iOS 10. To use this manually, do
// Set up your types
if (@available(iOS 10.0, *)) {
[[UNUserNotificationCenter currentNotificationCenter] requestAuthorizationWithOptions:types completionHandler:^(BOOL granted, NSError * _Nullable error) { // Import and link UNUserNotification framework
NSLog(@"Granted? %d", granted);
NSLog(@"Error? - %@", error.localizedDescription);
}];
[[UNUserNotificationCenter currentNotificationCenter] setDelegate:self];
} else {
// Fallback on iOS 8-9 versions
UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:types categories:nil];
[[UIApplication sharedApplication] registerUserNotificationSettings:settings];
}
[[UIApplication sharedApplication] registerForRemoteNotifications];
[Carnival startEngine:@"testkey12345" registerForPushNotifications: NO]; // Start Carnival lastor, use [Carnival startEngine:@"testkey12345"]; to let us handle basic (alert, badge, sound) registration for you.
If you have any issues with the SDK, especially as iPhone X comes out, please let us know. We're happy to help.
Carnival iOS SDK 6.1.4 Release Notes
Bug Fixes
- Fixes bitcode, which regressed last version. Thank you for your reports! 🙏
- Under the hood changes for Xcode 9 beta 5.
- With Xcode 9 in beta, this release should be considered a beta, too.
We're also downloading new betas of Xcode 9 as Apple releases them and doing tests - but if you find something odd with Carnival in your code Xcode 9 beta testing, we'd love to know! Send us an email - [email protected]. Thanks!
Carnival iOS SDK 6.1.3 Release Notes
Xcode 9 Support Release
- Added Xcode 9 support
- Fixes a crash that occurs when the Main Thread Checker is enabled
- With Xcode 9 in beta, this release should be considered a beta, too.
We're also downloading new betas of Xcode 9 as Apple releases them and doing tests - but if you find something odd with Carnival in your code Xcode 9 beta testing, we'd love to know! Send us an email - [email protected]. Thanks!
Carnival iOS SDK 6.1.2 Release Notes
Bug Fixes
- Fixed a bug where potentially stale custom attributes would be sent when updating other device or user data.
Carnival iOS SDK 6.1.1 Release Notes
Bug Fixes
- Framework now includes a ModuleMap for Swift importing (
import Carnival) - Message impressions are now counted in the detail view for link type messages