Mandatory mobile app upgrade message

In-app notifications on mandatory application upgrade ensure that your customers are promptly notified and guided through the essential process of updating their mobile application. Enhance user experience, maintain the application’s optimal performance, and provide your customers access to the latest features and security improvements. Streamline the upgrade process and keep your customers seamlessly connected with the most up-to-date version of your application through strategic in-app messages.

This use case describes the process of creating an in-app message with information about mandatory application upgrade for customers who have an old version of the application.

This use case provides you with an instruction how to use a ready-made in-app template that can be used 1:1 in a business scenario.

Prerequisites

Implement Synerise SDK in your mobile app.

Create an in-ap message

Create an in-app campaign triggered by the client.applicationStarted event of the old version of the application. We will use a predefined template for the message with mandatory application upgrade information, so there is no need to create a template from scratch.

1. Go to Communication > In-app messages> Create in-app.
2. Enter a meaningful name for the in-app campaign.

Define the audience

As the first step, define the target group of customers for the in-app message.

3. In the Audience section:
   1. Click Define.
   2. Select the Everyone tab.
   3. Click Apply.

Define content

1. In the Content section, click Define.:
   1. Click Create message.
   2. Go to the Default folder and choose Fullscreen template.

Edit form in the Config tab

The form in the Config tab is already filled in with default values. You can keep them or change them to fit your business needs.

1. In the Background section, use the color picker to select the color of the background or enable background image and enter the link to this image (add the image to Data Management > Files and then you can find there the URL to this image).
2. In the Image section, enable the image in your banner campaign and add the link to this image (add the image to Data Management > Files and then you can find there the URL to this image).
3. In the Header section, enable header and add the text, font size and color of the header you want to display in the in-app message.
4. In the Description section, enable description and add the text, font size and color of the description you want to display in the in-app message.
5. In the CTA button section, enable the CTA and add the text on the button, corner radius of the button, text color, button background color, and URL to which you want to redirect a mobile app user.
6. In the Close button section, disable this option. Thanks to this, the in app message cannot be closed, and the user must click the CTA button.
7. After you make changes to the template, you can check the preview.
   1. Click the Preview button on the upper left side.
   2. Enter the ID of a mobile app user.
   3. Click Apply.
8. To continue the process of configuring the in-app campaign, click Next.
9. To save your content changes, click Apply.

Select events that trigger the in-app message display

In this part of the process, you will define the event triggering the display of the in-app message.

1. In the Trigger events section, click Define.
2. Select Add event and from the dropdown list, choose client.applicationStarted event.
   Note: Event client.applicationStarted is retained (can be seen on the activity list in the customer profile), and it only generates when the application was closed, and then opened again.
3. Click the + where button and select version.
4. As the logical operator, select Not equal.
5. In the text field, type the latest app version.
6. Click Apply.

Schedule the message and configure display settings

As the final part of the process, you will set the display settings of the in-app message such as schedule, capping, priority of the message among other in-app messages.

1. In the Schedule section, click Define and set the time when the message will be active.
2. In the Display Settings section, click Change.
3. Define the Delay display, Priority index according to your business needs.
4. Enable the Capping limit toggle to limit the amount of times the in-app message can be displayed to a user in general, set it to 1.
5. Click Apply.
6. Optionally, you can define the UTM parameters and Additional parameters for your in-app campaign.
7. Click Activate.

Check the use case set up on the Synerise Demo workspace

You can check the In-app message configuration directly in Synerise Demo workspace.

If you don’t have access to the Synerise Demo workspace, please leave your contact details in this form, and our representative will contact you shortly.

Read more

• In-app messages
• Using in-app template builder