To make the web and mobile push being sent quicker, we have enabled the instant push functionality. This option is not available by default. If you would like to activate it, please contact your Account Manager, who will check the possibility of activating this functionality on your account.
What are instant pushes?
They are a different version of standard web and mobile pushes available in iPresso. Thanks to instant pushes, you are able to make a communication being sent in just a couple of seconds. You only need to fill in the necessary fields or use pre-defined templates. The reporting and segmentation option is not available in this case; if you want to reach your recipients more precisely and check the effects of your communication, use the default iPresso tools.
Before you send your first instant push
- Make sure that you have activated the Instant push option. In the iPresso menu, select Campaigns. If you do not find Instant pushes, contact your Account Manager.
- In case of web pushes, check if the page you want to display the push is monitored (System->Monitoring->Monitored pages) and if the service worker file for the page is added to your server (you can get the file from System->Settings->Web push settings).
- In case of mobile pushes, make sure that you have configured the mobile application that you want to use for the pushes (System->Mobile application settings).
- For both web and mobile pushes, tokens are required. These are permissions granted in the browser or mobile application to receive this type of communication. A token is expressed as a string of characters. iPresso collects tokens (expressed consents) for monitored and anonymous contacts, however in the case of instant pushes it is not possible to segment the precise group of recipients. Make sure tokens are collected from monitored pages/mobile apps.
- Instant pushes are sent to themes, which are groups of topics (e.g. sports or weather) made from tokens. The default topic contains all tokens. If you want to send messages to all tokens, you can proceed to create a push. If you want to target communications to interest groups, configure topics using the instructions in the next step.
Topics of interest
To set up topics, go to System > Campaign settings > Instant push - topics and click Create new topic:
Give the topic a name and an API key that will be used to identify it, sent from your monitored site. Click Save.
If the system indicates that the data is incorrect, it means that the name/API key of the topic was/is currently used. In this case, enter a different name and API key.
The created topic will be visible in the list:
Below is an example of a button you can place on a page:
If a user has agreed to receive notifications, a token is stored in iPresso. If this user clicks on the button above and you have correctly configured the sending of the information about this action to iPresso via API, the token will be assigned to the corresponding topic. At the same time, it will remain in the general topic.
Creating an Instant push
Go to Campaigns > Instant push > Create Instant Push campaign.
Let's start with the web push.
Fill out the Settings section. Required fields are marked with an asterisk:
When you click on the question mark in the circle, field descriptions will appear:
- Name - located in the list of Instant push campaigns, visible only to users in the system.
- Description - a field that gives you the ability to describe detailed information about a particular campaign. The description is available on the list of Instant push campaigns, visible only to the users in the system.
- Type of campaign - possibility to choose between mobile push and web push.
- Monitored site - available in the case of web push. The site where the message will be sent.
- Mobile application - available in case of mobile push. The application within which the message will be sent.
- Topics - allow you to send messages to recipients who are subscribed to a topic.
- Message key - the key by which campaigns are identified. Use gives the ability to replace previous messages that have not yet been delivered to the recipient.
- Expiration date - the date and time after which the message will not be delivered to a recipient who was offline.
Let's stop for a moment at the message key and expiration date. When you send a push, it will immediately be sent to the selected topic (token group). This cannot be undone. If there are tokens in the group of recipients to whom the push has not yet been displayed - we can replace it with a new push. This is what the message key is for - we identify the previous push which we want to replace with a new one.
For example: on Monday you sent 10 web pushes. The user's computer was turned off and on Tuesday he turned it on. He will receive 10 notifications. However, if you set the same key in each web push, the user will receive only the last notification, because each of the 10 sent by you has been replaced by another one.
As for the expiration date, we can set a time limit.
For example: you sent web pushes on Monday, with the time limit set to Wednesday. The user turns on the computer on Thursday. He will not receive the web push.
It's time for the Content section:
- Title - the title of the message without the possibility of personalization. We suggest up to 32 characters.
- Content - the body of the message without the possibility to personalize it. We suggest up to 64 characters.
- Link - address to which user will be redirected after clicking on it. The website address must be secured with HTTPS protocol.
- Icon URL - address from which you want to download the icon for sending.
- Graphic URL - the address from which you want to download the image for shipping.
You can add an action button:
As you can see below, the preview allows you to check the creations for each operating system. By clicking on the moon button, we can enable and disable the night mode. Remember that this is a preview, and the final appearance of the notification depends on the user's system settings. You should definitely keep in mind the short title (up to 32 characters) and short content (up to 64 characters).
Let's move on to mobile push:
Fill in the fields based on the instructions for the web pushes.
Explanation of additional fields:
- Click action - allows you to select one of two options: Application activity, Open the application.
- Additional data - additional data in JSON format which will be sent into the application.
- APNS - additional settings in JSON format for iOS devices. Compatible with available parameters. Incorrect data may result in not delivering the message or displaying it incorrectly.
Once your push is ready, in the top right corner you can: send the message, save it as a template, or schedule the sending:
When saving the template, define its name and API key (it will come in handy for calling up campaigns bypassing the iPresso interface):
Managing instant pushes
You can manage your push messages and templates from the Instant pushes menu:
In the Campaigns tab, you will find completed campaigns. Remember that the token count indicates the tokens to which we sent the communication, not to which we delivered it. We have no way to test the deliverability of instant pushes.
In the Templates tab, you have the option to use a previously saved template, check API keys and delete unnecessary templates.
Remember to use this tool carefully and check the content and subjects you are sending communications to before each send. There is no mechanism to cancel these messages (except for messages scheduled for future execution).
Sending instant pushes via API
In our API documentation, you will find details about sending requests: