Mobile Push: create form

The ~~Personalization/~~Channels/ Mobile Push tab allows sending personalized push notification messages to a segmented audience originating from Firebase-enabled mobile applications.

Prerequisites for Mobile Pushes

To work with Mobile Pushes, first, they need to be set by the Meiro team:

For Mobile Push, it is required to configure the "Firebase account" in the ~~Setup/Channels~~Administration/Configurations/Channel ~~tab.~~tab and set the "Registration token attribute".
Meiro Events must be implemented.
The Firebase registration tokens ~~must~~need to be made available to Meiro either via Meiro Events or via the Meiro Integration workflow.

~~It is required to set the “Registration token attribute ID” in the channel settings of Mobile Push.~~
The administrator must enable the Mobile Push tab for your user role.

Mobile Push form

Clicking on the 'create Mobile Push' button on the top will bring you to push notification settings. It is possible to insert content for Mobile Push, select a segment created beforehand, send a notification immediately to the customers, or set a schedule.

How it works

1. Content tab

1.1 Content section

Name

(required)

Name of mobile push notification that will be visible in the list on the Personalization/ Mobile Push tab.

Remember: If performance reporting is set up for Mobile Push, frequently changing the campaign name may render the report difficult to understand. After the Mobile Push campaign is live and activated we suggest changing the name as little as possible.

Title template

(required)

Title of Mobile Push that will be sent to the user's device. It is delivered in bold type to grab customers’ attention.

Body template

(required)

A message that the user wants to render as a notification to the customers’ mobile phones.

Warning: the notification might be truncated on iOS devices if the title and body combined exceed 178 characters in length. The notification might be truncated on Android devices if the title exceeds 65 characters in length and the body 240 characters.

1.2 Attributes

To personalize a Mobile Push, you can use attributes in the title and body of the Mobile Push template. You may use the attribute picker to refer to a needed attribute. It is allowed to use single-value attributes only, both scalar and compound.

The syntax for referencing attributes is as follows:

Scalar: {{customer_db_name}}, {{mx_geo_city}}, etc.
Compound: {{bank_cs_cases.date}}, {{bank_web_exit_page.product_viewed}}, etc.

If an attribute value is undefined, it is rendered as an empty string.

Learn more: about use cases of Mobile Push, where examples of attributes are presented.

1.3 Preview section

Users can see dynamic text appearing on the preview on the right. It is possible to switch previews between iOS and Android. If a user does not have the right to see the PII attribute set in “Attribute visibility protection”, then the PII attribute used in the Mobile Push will be displayed to the user on the preview as *protected information*.

Click on the Save button to apply your setting to Mobile Push and enable the activation tab.

2. Activation tab

2.1 Segment section

Segment selection

(required)

A dropdown list that allows selecting a segment or multiple segments of customers you want to send Mobile Push to. Remember, a segment should be created in advance in the Segments tab and should contain customers with known Registration token attribute ID.

Remember: if you send a Mobile Push to multiple segments, it may occur that one customer who is appearing in more than one segment, will receive this push notification multiple times. It is recommended to wisely use sending one Mobile Push campaigns to multiple segments.

Schedule selection

(optional)

It is possible to schedule a specific time for sending Mobile Pushes. Time is scheduled in the UTC timezone.

Currently, you can set a schedule:

at a particular time of the day,
repeat every minute /hour (from hour to hour).

It is possible to set multiple schedules for one segment.

Use the "Send now" button to send the push notification to the audience with immediate effect. If the schedule was set to the segment, then users from the segment will receive notifications on their mobile phones on selected days and time.

2.2 Activation history

Activation history

Activation history lists all Mobile Pushes sent for the last 30 days.

It contains information on the segment's name, date when the Mobile Push was sent, user, and status (waiting, running, error, finished) of the push notification.

Logs

The ‘Log’ button redirects the user to the logs box that tracks updates made to a Mobile Push and notes about the level of each modification (“info” or “error”), the time it was made, and a comment. The statistics of how many entities successfully received Mobile Push is also visible in the Log box.

The ‘Attributes’ section shows the condition of attributes used in the Mobile Push.

Warning: if an attribute is defined in Mobile Push and later is hidden, attempting to activate the associated campaign results in error.

The statistics of how many entities successfully received Mobile Push is stored in the Grafana logs of the User menu.