Feature awareness and new app version
This reference article addresses how to use the Braze platform to keep your customers up to date on new features and versions of your app.
You work hard to continually update and improve your app, and you want your users to experience these exciting new features and new app versions. Learn how to teach your users about the new features they have yet to use, and encourage them to explore the app to get the most you have to offer.
Feature awareness campaigns are a great way to encourage users to stay engaged with your app as you continue to improve your app’s functionality. Keeping users up to date is a great way to keep them active, boost ratings, and ensure user engagement.
Filtering by most recent app versions
Braze SDKs automatically track a user’s most recent app version. These versions can be used in filters and segments to determine which users should receive a message or campaign.
App version number
Use the App Version Number filter to segment users by the app’s version and build number.
This filter supports numerical comparisons to target a range of app versions. For example, you can target users whose app is “below”, “above”, and “equal to” app version “1.2.3”, which might be beneficial to promote a new feature which requires an app upgrade.
This new filter can replace the legacy “App Version Name” filter which would require explicitly listing each older version or using a regular expression.
How it works
- Each part of the
major.minor.patchversion sent in your app’s app version are compared as integers
- If the major numbers are equal, the minor numbers are compared, etc.
- Android apps have both a human readable
versionNameand an internal
versionCode. The App Version Number filter uses
versionCodebecause it is guaranteed to be incremented with each app store release.
- This can cause confusion when your app’s
versionCodeget out of sync, especially since both fields can be viewed from the Braze dashboard. As a best practice, check that your app’s
versionCodeare incremented together.
- If you need to filter by the human readable
versionNamefield instead (uncommon), use the App Version Name filter.
Values for this filter are collected starting with Braze Android SDK v3.6.0+ and iOS SDK v3.21.0+. Even though this filter has SDK requirements, you will still be able to target users who are on lower (older) versions of your app using this feature!
For Android, this version number is based on the Package Long Version Code for the app.
For iOS, this version number is based on the Short Version String for the app.
This filter will populate values after users upgrade their apps to the supported Braze SDK Versions. Until then, the filter won’t show any versions when selected.
In the following scenario, let’s assume that you first upgraded to the Braze SDKs which supports this filter in version
2.0.0 of your app.
Once Braze receives data from version 2.0.0 of your app, you can target users with earlier or later versions.
|Filter||User’s App Version||Result|
|Less than 2.0.0||1.0.0||The user is in the segment, even though their Braze SDK did not support the “App Version Number” filter.|
|Greater than 2.0.0||2.5.1||The user and all future installs will be in the segment.|
|Greater than 2.0.0||1.9.9||The user is not in the segment.|
|Less than or equal to 2.0.0||3.0.1||The user is not in the segment.|
App version name
Use the “App Version Name” filter to segment users by the app’s user-facing “build name”.
This filter supports matching with “is”, “is not”, and regular expressions. For example, you can target users who have an app that is not version “1.2.3-test-build”.
Have not used feature
When you release a new app version and introduce new features, users may not notice new content. Running a feature awareness campaign is a great way to teach users about new features or features they have never used. To do so, you must create a custom attribute that is assigned to users who have never completed a certain action within your app or use a custom event to track a particular action. You can use this attribute (or event) to segment the users you want to send the campaign to.
Looking to retarget a specific portion of your audience? Check out Retargeting Campaigns to learn how to retarget campaigns by leveraging your user’s previous actions.