Web Changelog
The latest updates to the Airship Web SDK
v2.5.0 October 3, 2024
This minor release improves gesture/swipe detection in Scenes, and ensures that in-app experiences that are loaded from a previous session respect their priority ordering. This change is fully backward compatible and does not require any update to existing integrations.
Changes
- Sort schedules in priority order when rehydrating in-app experiences
- Use latest in-app experience renderer for updated gesture detection
v2.4.0 September 25, 2024
This minor release adds SDK support for personalizing In-App Experiences using custom event data. This feature will be enabled in the platform in the near future. This change is fully backward compatible and does not require any update to existing integrations.
Changes
- Send triggering event data when performing server-side resolution of an In-App Automation payload
v2.3.3 September 18, 2024
This patch release fixes conversion events for permission changes (such as push opt-in) when using Scenes, and improves subscription list loading for channels and contacts. This change is fully backward compatible and does not require any update to existing integrations.
Note that v2.3.2
was an internal-only release, and was never released publicly.
Changes
- Emit conversion events for permission changes (notifications, location) as a result of scene opt-ins
- Cache subscription list listings for channels and contacts
v2.3.1 September 6, 2024
This patch release fixes issues with non-push channel registration in mobile Safari. This change is fully backward compatible and does not require any update to existing integrations.
Changes
- Check for presence of
pushManager
before access on channel registration, as it is not present in some mobile Safari versions unless added to the home screen
v2.3.0 September 4, 2024
This minor release adds support for inline text formatting in In-App Experiences, and improves message priority handling in some cases. This change does not require any update to existing integrations.
Changes
- Update to the latest In-App Experience renderer for inline text formatting support
- Ensure correct message priority is used when displaying ongoing messages
v2.2.21 August 27, 2024
This patch release improves In-App Experiences display handling and delegation to ensure frequency limits are accurately applied in all situations. This change is fully backward compatible and does not require any update to existing integrations.
Changes
- Perform rate limit incrementing later in the display process to ensure only actual views are counted against frequency limits
- Only ask display delegates for display permission prior to actual display
- Update to latest In-App Experience renderer
v2.2.20 August 12, 2024
This patch release fixes some issues present in channel registration and In-App Experiences. This change is fully backward compatible and does not require any update to existing integrations.
Note that v2.2.19
was an internal-only release, and was never released publicly.
Changes
- Improves caching of feature flag checks for server-side audiences
- Fixes a rare issue where a user manually clearing their local browser storage could lead to multiple channels being created for a single browser
- Fixes an issue in In-App Experiences where certain types of media would fail to preload, causing the display to be suspended
v2.2.18 August 1, 2024
Version 2 of the Airship Web SDK, which adds new features including In App Experiences for web!
For a full explanation of changes as well explanations of each feature, see Implementing Web SDK v2 as well as our migration guide.
v2.2.18 is the first public release of the Airship Web SDK version 2, all previous released under major version 2 were not public.
New Features
- In-App Experience features, including Scenes and Surveys
- Register browsers as Channels without requiring notification opt-in, allowing In-App Experiences, Named User association, event tracking, and all the features you’re accustomed to in our mobile SDKs
Removed Support
Some features were removed from the SDK; if you still rely on these features, then you will wish to stay on the v1
SDK:
- Support for HTTP setups; this is also referred to as “secure bridge”. The
v2
SDK requires HTTPS on all pages.- The registration page plugin has been removed, as it was only needed for these setups
- Multi-domain setups are not supported; this is where a single registration was shared across multiple domains or subdomains.
- APNs Safari is no longer supported, as Apple started supporting VAPID push in Safari 16 on macOS 13 and above, which was released October 2022.
Known Issues
- APNs Safari registrations are not automatically migrated to VAPID, and must be re-registered using the
sdk.register()
method. - AMP support is untested and not supported for new integrations
v1.23.1 July 8, 2024
v1.23.0 June 28, 2024
- Removes early access feature flag support; this feature will return in a later release
v1.22.2 May 24, 2024
This release fixes some minor defects. It is fully backward compatible with existing installations.
- fix some issues with autogenerated docs for custom events
- introduces a workaround for chrome incorrectly reporting web push permission status in some cases
- transpile external modules for ES5, matching the rest of the SDK’s compilation target
v1.22.1 November 7, 2023
- fixes mobile Safari “standalone” detection inadvertently including desktop Safari 17
v1.22.0 October 31, 2023
- Fix an issue when re-evaluating a feature flag audience condition
- Support emitting feature flag interaction events
v1.21.7 September 5, 2023
v1.21.6 August 31, 2023
v1.21.1 August 22, 2023
- Fixes an issue in feature flag audience evaluation where some comparisons were always done case insensitively
- Updates remote data (feature flags, preference centers) caching to align with other Airship SDKs
v1.21.0 August 16, 2023
- Add support for Feature Flags
- Support specifying the version string of your app when configuring the web SDK, by passing
appVersion
when initializing
This release has no backward-incompatible changes; when new features are not used, behavior is identical to the previous release.
v1.20.1 May 4, 2023
- Fixes a rare issue where named user identifiers could be cached indefinitely, causing some workflows to fail if the user id was disassociated by another process.
v1.18.0 March 6, 2023
This minor release adds support for mobile Safari web push in iOS 16.4.
In mobile Safari:
sdk.canRegister
will only be true if in “standalone” mode; that is, if the app is added to the home screen. Mobile Safari only supports web push when in this mode.- Attempts to call
sdk.register()
when in an unsupported context will reject with a relevant error - SDK registration plugins, such as the HTML Prompt will not prompt for opt-in unless in a supported context.
This release is backwards compatible, and mobile Safari will automatically be supported, in supported contexts, on any VAPID-enabled integration. However your website may need updates to support these contexts; see iOS Safari docs for further details.
v1.17.1 April 4, 2022
This minor release adds new types describing cross channel preference centers as well as scoped subscription list management for contacts.
- Add scoped subscription list management to the contact Contact.subscriptions
- Update preference center
item
types to represent cross-channel preference centers
This release has no backward-incompatible changes; if these features are not used, behavior is identical to the previous release.
1.16.0 September 30, 2021
This minor release adds new options for triggering an email double opt-in either via registration call, or opt-in form.
- Add new double opt-in options to the Contact.registerEmail interface
- Add new double opt-in options to the Opt-in Forms Plugin
This release has no backward-incompatible changes; when these options are not specified, behavior is identical to the previous release.
1.15.0 September 14, 2021
This release adds a number of new features, and deprecates some existing ones. No code changes will be necessary in your existing integrations, but for new or updated integrations it’s recommended that you use the new APIs.
Contact
The new Contact interface replaces the existing UaSDK.Channel.NamedUser
API, providing the following benefits:
- Tags and attributes may be set at any time, before the user is given a name; the data you set will be carried over to a new named user once identified
- A more consistent experience for users of our iOS/Android SDKs
- Register and associate email/sms/open channels with the current contact
Note: you should not use the deprecated NamedUser
SDK APIs and the new Contact
simultaneously, or you may have unexpected behaviors.
Preference Centers
New SDK APIs allow you to implement preference centers on your website, see the topic guide for further information.
- UaSDK.preferenceCenters for retrieving preference center definitions for your application.
- PreferenceCenter for data formats
- UaSDK.Channel.subscriptions for managing and retrieving a channel’s subscription list membership
Note: Preference Centers are only available if your plan has access to this feature.
Opt-In Forms
A new plugin has been added which provides a pre-made form for registering email and SMS channels on your website. For additional information, see the plugin documentation.
Note: Opt-In Forms are only available if your plan has access to this feature.
1.14.0 August 10, 2021
- Add support for AMP websites
1.13.0 March 15, 2021
- Improvement: Allow passing query parameters in the service-worker URL
1.12.0 February 22, 2021
1.11.0 January 13, 2021
Minor release:
- add locale override support
1.10.0 September 3, 2020
Minor release:
- Add support for Yandex browser
- Fix a regression on Safari
1.9.0 August 27, 2020
Minor release including:
- Add data collection handling to match mobile SDK
- Internal changes to prevent flooding the backend (channel events capping, named user debouncing)
1.8.2 August 14, 2020
Patch release:
- make the unsupported-browser error catchable using UA.catch()
- fix default positioning of HTML prompt alert template to top when incorrect or not defined
1.8.1 August 12, 2020
1.8.0 August 4, 2020
Minor release for web notification button support and a bug fix for named users.
- Added support for displaying buttons in web notification
- Fixed bug where clicking a web notification could remove named user from the channel
1.7.0 June 15, 2020
1.6.0 May 5, 2020
1.4.0 March 23, 2020
Minor release introducing a new plugin framework, and two plugins to make user acquisition easier.
Changes
- Introduced a new plugin framework
- Added customizable HTML prompt plugin
- Added registration page plugin
Categories