Simple push

A simple push is a notification that is displayed in the main screen of a mobile device or directly in a mobile app. Simple push messages appear in the notification center on mobile devices when the screen is locked or they are visible in the top bar when the screen is unlocked. They consist of a header, icon or graphics and text.

This is a great solution to:

  • Inform about current promotions.
  • Share important information connected with the app usage.
  • Send personalized content based on the recipient’s behavioral profile.


Image requirements

  • Allowed format: .jpg, .jpeg, or .png
  • Allowed width: minimum 645px
  • Allowed size: maximum 1 MB
  • Recommended aspect ratio is 2:1

Create a simple push

  1. Go to Campaign icon Communication > Mobile Push > Create new.
  2. Enter the name of the push notification (it is only visible on the list of notifications).
  3. As the mobile notification type, select Simple push.

Select device type

In this part of the process, you will declare the operating system of devices which will receive the notifications.

  1. On the Device type section, click Show.
  2. Select one of the following tabs:
    • Android - The push notification is dedicated to the devices with Android only
    • iOS - The push notification is dedicated to the devices with iOS only
    • All - The push notification is dedicated to the device with any kind of operating system
      The device type section
      The device type section
  3. Confirm your choice by clicking Apply.

Select recipients

In this part of the process, define the recipients of the push notification.

  1. In the Audience section:
    1. Choose the recipients:

      • Everyone - Everyone who gave marketing consent will receive your message. The estimated reach takes into account the number of customers who have given marketing consent to this type of communication (this means that in the case of communication such as mobile push, the estimated reach may be higher than the number of customers who have your mobile application).
      • Segment - You can send the message to one or more existing segments in the system.
      • New Audience - Create new segments and specify the conditions which the target must meet.
        • Regardless of the way of selecting the audience, the system limits the audience to those who have the marketing agreement on, unless you override this behavior in the advanced options.
        • If the audience is larger than 500000 profiles, consider using Batch delivery in the advanced options to avoid timeouts.
    2. Optional: Open Advanced options and configure additional settings.

      Advanced options - explanation

      • Batch delivery - It prevents sending notifications to all recipients at once.

        Important: If you plan to send messages to a large audience, this option is recommended.

        For example, if the expected performance of your messaging provider is 1 million messages per hour and the expected audience is 5 million profiles, you can split the communication into 60 batches sent 5 minutes apart: every batch will include ~83000 profiles sending all messages will take 5 hours.
        If you send a large number of messages all at once, there is a chance that your application may experience a sudden increase in traffic. To prevent any issues, make sure your application is fully prepared to handle this potentially significant surge in traffic. If a batch takes more than 8 hours to complete for any reason, it is cancelled in Synerise.

      • Enable control group - It creates a subgroup of the recipients who won’t receive any push notification variant. When to use it? When you send one or several variants of a notification (A/B testing). When a customer is assigned to their control group, the information is available in their Profiles card as an event.

      • Send without marketing agreement check - To comply with GDPR resolutions, Synerise by default filters out the recipients with marketing agreement off. This option, however, allows to send push notifications to those whose marketing agreement is off (after ticking this option, the number in the estimated reach don’t refresh). When to use it? While sending messages that don’t contain marketing content, for example, information about delays in shipping.

      • Include audience changes - Available only for scheduled notifications. It recalculates the number of recipients right before sending the message. By default, the size of the customer segmentation chosen for the push notification is the same as in the moment of sending, even if the number of customers in the chosen segment changed between scheduling the notification and sending. When to use it? When the size of the segments of customers selected as the audience of the notification can change dynamically.

      • Ignore limits - If you want to make sure that this message is sent to a customer, even it exceeds the global limit of this type of messages for a single customer per day (more information is available here), enable the Ignore limits toggle. You may apply it to system messages such as a transaction confirmation, notifications about order delays, and so on.

      The Audience section
      The Audience section
    3. Confirm the selection by clicking Apply.

Create a push template

In this part of the process, you will create a push template. If you have created a template before, in step 3 in the procedure below, select From Template option on the user interface.

  1. In the Content section, click Define.

  2. To create a template, click Create message.
    Result: You will be redirected to wizard choice.

  3. Select one of the following wizard options:

    • Drag&Drop builder - This wizard will allow you create a push template by filling out a form.
    • Code editor - By using this creator, you can use code to create a push template. This code editor allows using inserts which allow you to use pieces of information stored in Synerise to personalize the content of your message.
      Note: Further part of the instruction describes creating a push template in Drag&Drop builder.
  4. In the Title field, enter the text that will display in the header of the notification. You can use up to 160 characters.

  5. In the Message field, enter the text that will display in the body of the notification. You can use up to 160 characters.

  6. Select the OS for which your notification is dedicated. If you create a template for both OS, fill out the settings in both tabs: iOS and Android.

    Simple push wizard for the iOS
    Simple push wizard for the Android
    1. To add the image to your notification:

      1. Enable the Rich media option.
      2. Select one of the options:
        • Single media - It is a single image.
        • Image carousel - Several images presented as a carousel.
      3. In the Media dropdown list, click the plus icon.
      4. On the pop-up, select Images.
      5. On the list, hover the mouse cursor on the image you want to add and click Copy URL.
      6. Enter the copied link in the Media field.
    2. If your push notification doesn’t contain image, enable the Category option.

    3. In the Category field, enter the category of the notification.

    4. To add a button to your notification:

      1. Enable the Action buttons option.
      2. Click Add button.
      3. In the Button 1 field, enter the text that will display on the button.
      4. Select the linking option:
        • URL - Choose this option if you want to refer a user to a specific URL.
        • Deep link - Choose this option if you want to refer a user to the specific place in the application.
      5. In the URL/Deep link field, enter the location of redirecting a user.
    5. If you want to add more buttons, repeat step d.

    6. To set a priority of the notification:

      1. Enable the Priority option.
      2. Select one of the options:
        • Normal - When a push notification’s priority is set to normal, the notification is delivered immediately when the application is active. When backgrounded, the delivery can be delayed.
        • High - When a push notification’s priority is set to high, the system tries to deliver it immediately even if the device is in the Doze mode.
    7. To customize the sound of the notification:

      1. Enable the Sound option.
      2. Select one of the options:
        • Default OS sound - When the notification is delivered to the device, the device makes a sound selected as the default in the device settings.
        • Custom sound - If you want to device make a custom sound on the delivery of the notification, paste the sound file path.
          To be able to use custom sound, you must first upload it to the File explorer in the Data Management module.
    8. If you want the customers to receive push notification when the application is in background or resume state, enable the Content-Available option.

      Tip: More information about the Content-Available option is available here.
    9. To pass the notification to your notification service extension before delivery, enable the Mutable-Content option. When this option is disabled:

      • the push.view event won’t be generated
      • the push notification will lack the thumbnail image (a smaller version of a full digital image) before expanding the notification.
      • native action buttons won’t be added, if the message contains any
      Tip: More information about the Mutable-Content option is available here.
    10. To define what happens when the user clicks the notification, in the Action type section, select one of them:

    • Open app - After clicking the notification, the user is redirected to the main screen of your app.
    • Deep linking - After clicking the notification, the user is redirected to a specific place in your app (for the notifications displayed in the application).
    • Open URL - After clicking the notification, the user is redirected to the link which opens in a browser.
  7. If your template is ready, click Next.

A/B/x testing

You can create up to 3 push notification templates and send them within one campaign. If you use more than 1 template in a campaign, you can define the allocation of recipients to the template variants. If you enabled a control group while defining the recipients of your push notification campaign, you can additionally define the percentage of recipients who will belong to the control group (these customers won’t receive a push notification and a push.controlGroup event will be generated on their activity list on a profile card).

  1. In the Content section, next to Variant A, click Add variant icon.
  2. Repeat the steps from the Create a push template section.

Schedule the notification

In this part of the process, you will define when the push notification will be sent.

  1. In the Schedule section, click Define.

  2. You can choose between two options:

    • To send your notification 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.

      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.

      To select the best time of sending the message, take a look at the suggestion from the AI engine that calculates the best time (for all recipients). If time optimization is disabled, click here to learn more how to enable it and use it.

  3. Additionally, you can set up time restrictions for sending notifications.

  4. To save the configuration, click Apply.

Set up time restrictions for sending notifications

To disable sending out notifications at a specific time during the day, in the Silence Hours in the Schedule section, select one of the following options:

  • Without silence hours - Notification can be processed and sent out to the recipients at any time during the day.
  • Include silence hours - In the selected time, the notifications won’t be sent out to the recipients. The duration of silence hours can’t exceed 12 hours. If the sending process overlaps with silence hours, the unsent part of the notifications will be rejected. In such case, the push.skipped event will be generated.
    WARNING: If a notification is scheduled for sending just before silence hours (for example, silence hours start at 22:00 and sending is scheduled at 21:59:59), the notification may be processed, sent, and logged in the events a short time after the silence hours start.
The Schedule section
The schedule section

Define additional parameters

You can add up to 10 parameters which will be added to every event generated by this communication. Their values are the same for every event in the communication. You can use this, for example, to create a common parameter for events from different types of communication that belong to one marketing campaign.

The list below contains the events to which additional parameters are added:

  • push.send,
  • push.notSent,
  • push.capping
  • push.controlGroup
  1. To define the custom event parameters, in the Additional parameters section, click Define.

  2. Click Add parameter.

  3. In the Parameter field, enter the name of the parameter.
    The following parameters cannot be sent:

    • modifiedBy
    • apiKey
    • eventUUID
    • ip
    • time
    • businessProfileId
    • correlationId
    • clientId
    • uuid
  4. In the Value field, enter the parameter value.
    The value is always sent as a string when the event’s JSON payload is generated. The maximum length of the string is 230 characters.

    WARNING: Dynamic values are not supported in the Parameter and Value fields.

  5. If you want to add more parameters, click Add parameter, and repeat steps 3-4.
    Result: the parameters will be added to all events listed above with the values you entered. This is an example event saved in the database. The custom parameter season is located in the params object:

      "action": ...
      "params": {
        "clientId": 1111111111,
        "season": "autumn",
        "campaignName": "Back to school",
        "time": 1662392318050,
        "title": "Have you prepared for coming back to school?",
        "businessProfileId": "xxx"

  6. Confirm the settings by clicking Apply.

Save and send

When you completed your work on the push notification campaign:

  • to save your progress only, in the upper right corner, click Save as a draft.
  • to schedule your notification for sending or to send it immediately (depending on the schedule option you selected before), in the upper right corner, click Send.

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.

Close modal icon Placeholder alt for modal to satisfy link checker