First run message

A first run message is another type of mobile notification. It is displayed during the first visit in an app or right after an update.

This is a great solution to inform customers about:

  • Changes in an app after an update,
  • Important information that users should know during their first visit in the app. It can be, for example, a guide or tips connected with using the app.

Create first run message

In order to activate a First Run message, go to Communication > Mobile.

Screenshot from the Synerise Communication module presenting first run message

  1. Click the Create new button on the upper right side of the screen,
  2. Click First Run message,
  3. Add a name and description to your message.

You can create your first run message in 6 steps:

  • Choose Mobile message type,
  • Choose the device type,
  • Choose the Audience,
  • Create the Content,
  • Set up the Schedule.

Mobile message type

Screenshot from the Synerise Communication module presenting mobile message type

The first section enables you to choose the type of your message. You can change it at any time by clicking the Change button.

Device type

Screenshot from the Synerise Communication module presenting device type for first run message

Decide in which operating systems your message should be displayed. You can choose from:

  1. All types of devices,
  2. iOS only,
  3. Android only.


Screenshot from the Synerise presenting Audience for first run message

In the Audience section, decide who will be the main target of your message. You can do this with the help of three options:

  1. Everyone - Everyone who has your mobile app and gave consent to mobile marketing will receive your message. The estimated reach takes into account the number of customers who have given marketing consent for this type of message,
  2. Segment - Send the message to one or more existing segments in the system,
  3. New Audience - Create new segments and specify conditions which should be meet by your customers.
  4. You can add more options to your shipment by clicking Advanced options. To do this, click the arrow visible in this section,
  5. Batch delivery - Use this option if you want to send your message in batches (provides a message to a large number of recipients in stages, in order to avoid overloading internet and email service providers). If you decide to use this option, you should set the number of batches in a specific time range,
  6. Enable a control group - This option enables you to create a control group (a control group is 30% of your group who will not receive the message) and better understand the mesagge’s effectiveness,
  7. When you set up all the features in this section, click the Apply button to save your changes.
WARNING: You can send the message only to app users who gave you their consent to receive this kind of communication. This is the reason why the estimated reach is lower than the total audience.


Screenshot from the Synerise presenting content for first run message

In the Content section you can create your message.

  1. Use the plus button to add another version of your message which can be used in AB test,
  2. Click the Create message button to add your template. You can create your First Run message using the visual builder, code editor or use an existing template in the system.
Tip: The Code editor enables you to add more advanced features to your template. Just paste your coded content and create a more personalized message.

Screenshot from the Synerise presenting creating first run message

You can also use an existing template from the list if you have prepared one before.

  1. To do this, choose the From templates option and choose one from the list,
  2. Create a new folder using the plus button. The folder can be edited or deleted at any time.
  3. Select a view. Choose between icons and list.
  4. A search engine is available on the right side of this section. You can always sort your results by name or other parameters.
WARNING: If you have not created a folder before, you will only see the default folder.
Tip: If you want to save a modified template as new (instead of overwriting the existing one), rename the template and click “Save as new template”.

Screenshot from the Synerise presenting creating first run message in visual editor

To create a First Run message in Synerise, you can use the visual builder. First, set up a few additional features:

  1. Name your project,
  2. Save the project as a new template in a selected folder,
  3. Go to the next step when your message is ready for use,
  4. You can leave the edition panel using the exit button,
  5. Inserts lets you add a personalized box into your message to include, for example, custom recommendations, coupons or a link.

Screenshot from the Synerise presenting creating first run message in visual editor

After saving your project, you can start creating your personalized message with the menu located in the right menu bar. You can add and edit six features:

  1. Layout. You can choose one layout from among four types: Full screen image, Full screen image + text, Full screen color + text or Mixed content,

  2. Content. The type of content depends on the layout chosen in the previous step. If you have chosen full screen image, you will find a box for the image URL and one in which you can choose the background color. For text, you will find boxes where you can add a header and description. You can monitor how your message will display thanks to a live interactive preview on the left side,

  3. CTA button. Add a CTA button and edit its text, corner radius and color,

  4. Close button. Remember to include a close button to make your message more user friendly and allow customers close the message at any time,

  5. Automatically disappear. This option lets you decide if your message should  disappear and, if so, after what amount of time (described in seconds),

  6. Action type. Decide what kind of action should follow your message. You can choose from:

    • Deep linking - Dedicated to notifications in app. Using the link you can transfer users to a specific place in your app,
    • Open URL - Link to a specific URL,
    • Do nothing.

Screenshot from the Synerise module presenting how to add and edit content for first run message

At this stage you can additionally prepare A/B tests and compare the effectiveness of different versions of your message.

  1. Add another version of your message choosing the plus button on the upper part of the content box.
  2. Add another template in the same way as before. Remember to add some changes to make this version a little bit different than the others.
  3. Use customer allocation and choose what percent of your customers will get version A and to how many of them will get version B,
  4. After adding the content, if the message is displayed correctly, save the changes with the Apply button.
  • By choosing more than one version within the A/B tests, you will be able to set the size of the groups to which a given message version of the message will be sent. The control group (if you checked “enable a control group” in the previous step) is already excluded from the recipient database.
  • The maximum number of versions sent within one message is three with the control group.


Screenshot from the Synerise module presenting how to set up the schedule for first run message

  1. Set the start date for your message by choosing between two options:
    • To send your message after clicking the Send button on the upper right corner, use the Display immediately option.
    • To plan a message to be sent at a future date, use the Scheduled option. Set the start time and the time zone.

      WARNING: Synerise is a system that performs the best while operating on the real time data that is why the users can plan a message 10 days forward from the current date.

      Additionally, the AI algorithm calculates the optimal time to send a message on the basis of the customer activities such as page.visit events. It estimates the best date for the following seven days.
      To set the Start date defined in the Optimal sendig time, click the AI optimizer icon.

  2. To save the changes, click Apply.

Screenshot from the Synerise module presenting how to save first run message

After completing these steps, your message is ready to go. Decide if you want to finish it later or just send it right now. Just choose from the two options visible in the upper right corner of the screen.

  1. You can finish your message later and save it as a draft,
  2. If your message is ready, click the Activate button.
WARNING: The Activate button will not be active until the moment you fill in all the sections described above.


We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.



Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.