Mobile push notifications

To send mobile push notifications, you need to link your mobile app to the service, then create and customise the message.

Setting up a mobile application requires experience with mobile applications. If you do not have such experience, contact the developers of your mobile application.

Configure the mobile application according to the instructions:

To connect an application, you need experience with mobile applications. If you do not have such experience, please contact the developers of your mobile application. If you have already sent Mobile Push before - you already have Firebase service account key and Huawei keys, if you want to start sending Mobile Push - you need to register and get all the necessary data.

To set up your mobile app go to Settings ➔ Mailings

Set the settings:

• App name - displayed only in the service in the Mobile Push preview and in the base volume table

Android and iOS

At this time, setup is only available through Firebase Cloud Messaging.

• Upload the Firebase service account key (.json), which can be obtained from the account Firebase (Project Settings → Cloud Messaging → Service Account → Google Cloud Console in the Service Account section, select Keys) and save the changes

HarmonyOS

Setting up a mobile application for Huawei devices.

• Enter the Huawei App Id and Huawei App Secret, which can be obtained from the Huawei App Gallery Connect (My projects → Project settings → General information → App information→ OAuth 2.0 client ID) and save the changes

Once you have completed the configuration, inform your personal manager to activate the module.

In order to create a Mobile Push notification go to Mailings ➔ Messages ➔ New message and select the Mobile Push channel

Currently you can only create an instant message - it will be sent immediately after creation

In the creation wizard you can set the sending settings:

• Message subject (on devices, the subject displays approximately 50 characters)
• Message text (about 200 characters)
• Jump URL - this is the action when you tap on the push notification (you can choose from three available options: URL, Deeplink, Open app)
• Image URL - a link to the image that will be displayed on the right side of the push notification.

Once all the send settings are filled in, you can set additional settings. They are not mandatory, but will allow you to personalise the push notification and make it more visible to the recipient.

• Buttons - you can add up to 3 buttons to your notification, for each button you need to set the text and action when you tap on it (the three options are similar to setting up a click URL).
• UTM tags and URL parameters - work only for URL links

You can change the display for iOS and Android

At the same step you can send a test Mobile Push to check if the message is displayed correctly and, if necessary, correct it before sending it to users.

Additionally, in the same window you will be able to track the status of sending the test Mobile Push and find out the reason if the message was not delivered (e.g. if an invalid token was entered).

Test sending is available when you create or edit a Mobile Push message. Go to Mailings → Messages → Message editor (Mobile Push). In the Message editor step, fill in the required fields:

• Message subject;
• URL.

The “Sending test message” button will become active. As soon as you press on it in the opened window:

• enter the device token manually or select from the list of previously used tokens;
• select the operating system (Android or iOS) - it is important to select the OS corresponding to the token, as it will be recorded in the database;
• click “Send” (the button will become active only after entering the token).

The window will display the real-time sending status of the test Mobile Push:

• Sending - with a download indicator;
• Delivered - the message was successfully delivered to the recipient's device;
• Not sent - with an error text, for example, “Requested entity was not found.”

Limitations and Features

• You can only enter one token at a time.
• You can send tests even for tokens that:
  • unsubscribed;
  • not added to the enKod contact database - after a test send they will be added;
  • deleted - after a test send the contact will be restored from the deleted ones.
• Test send statistics are saved until you exit the Message editor (Mobile Push).

After creating the mobile push, you need to specify the recipients of the message. To do this, in the corresponding drop-down lists, include or exclude the segments you need from the mailing list.

In Mobile Push segments, recipients are counted based on the number of unique contacts, however, one contact can have more than one device assigned to it. As a result, the number of messages sent (displayed in Message Details ➔ Device Statistics) may be higher than expected. In the Message Details ➔ Information ➔ Recipients section, you can track the number of recipients, sent and unsent messages separately by unique contacts and separately by number of devices.

If there is an inactive mobile token in the recipients (Firebase Cloud Messaging returns the error requested entity was not found), the message will not be delivered to it, and the token itself will be automatically unsubscribed.