A Push message can have one of the following Recipient sources:

• Automation - Sends push messages from an Automation Center or Interactions program.
• Using a segment - Sends push messages to a standard Emarsys segment.
• Using a contact list - Sends push messages to a contact list.

A Push message can have one of the following statuses:

• In design – Some content or settings are still missing.
• Tested - Test message has been sent but not launched yet.
• Ready to launch – Not activated yet, but ready to launch.
• Launched - Campaign has been launched
• Canceled - The already launched Web Push campaign has been called off.

Define the General settings of your brand new push message campaign (or rename your existing one).

General settings

• Message name – You can name (or later rename) your push message to identify the campaign on the Push Messages tab.
• Domain name – You can select the domain on which you want to display your message notification. You can send your message only to one domain. Only domains already associated with your account are listed here.
• Recipient source – Define the target audience of your message. For options, see Recipient source.
  • Segment – You can select a pre-built segment, if you are using a segment for your recipient source.

The options for Recipient source are as follows:

• Automation – Sends push messages from an Automation Center or Interactions program.

• Using a segment – Sends push messages to a standard Emarsys segment.
• Using a contact list - Sends push messages to a contact list.

To add text to the push message, type the text directly into the Preview pane available on the right hand side of the screen.

There are 2 types of images that can be added to a campaign, icon image and banner image.

Use the Visual Content Editor (VCE) to add new content (personalized token) to the push message field.

You can add a personalized token to your push message, as follows:

1. Use the dynamic search field to find the required personalized token.
   • Alternatively, you can select a token from the following categories:
     • Capabilities: Contact data (General, Personal, Company, Other)
     • Use Cases: External, First Name, Voucher
2. Drag the selected token over onto the Preview pane and drop it to the field where you want.

Use the Action Buttons tab to add a destination URL for when the contact clicks on the push message.

There are 2 options when setting the destination URL:

• Add Default Action - The destination URL if the user clicks anywhere on the web push campaign message.
• Add Button - It is possible to add up to 2 action buttons to provide the user a choice of action.

When adding a Default Action or Action Button, there are 2 link type options:

• External URL - Choose this if the link is a standard link to the website.
• Deep link - If the link is to deep link into a section of an Android mobile app, choose this option. Please note, the Android app should be preconfigured to know how to handle the link.

Once the action type is selected, enter the URL and click Apply.

Edit the label of the button directly on the campaign preview screen.

You can add and remove languages. Use the dynamic search field to find the requested language or select it from the drop-down list then click Add.

Add any new languages and write the message content in that language. Languages which are not shown here will receive the content in the browser default language.

You can delete languages as well, but a default language is mandatory.

You can use custom data fields to attach metadata to web push messages and act on this data after a message is delivered.

These fields come in handy in the case of triggered web push messages: you can use custom data fields to add data to the API call and customize the push message with it.

To create custom data fields, navigate to Web Push > Domains and click the Custom Data Fields icon, then click Create Custom Data Fields.

Here you can define the interval after which your messages expire in seconds.

Click Test Messages button on the left.

In the appearing Send Test Message window, you can specify an email address or contact list to which a test message will be sent. 

Before clicking Save & Send check if the following requirements are fulfilled:

1. You need to test it with a contact already present in the Emarsys database.

2. Log in to the browser.

3. Enable the notifications for your browser (please note that we tested this procedure in Google Chrome).

4. You need to go to your website and register the contact.

5. Enable the notifications for your website.

6. If you are using Windows, turn off Focus assist.

If sending of the test message fails, a red warning message appears on the screen. The reasons for this could be the following:

• No contact has been found in Emarsys database with the given email address.
• The email address has been found, but there is no device associated to it.

To test your message, click Save & Send.

Click Next step to continue to the Scheduling step.

You can throttle your mobile- and web push campaigns when sending to large portions of your contact base, to ensure that your backend systems are not overwhelmed by spikes in demand.

1. Tick the Set Up Campaign Sending Rate check-box at Push Throttling.
2. Select a preset push message sending rate.
3. Check the following calculated information on push message sending:
1. The calculated push message sending speed.
2. The estimated time it will take this campaign to fully send out with the given speed.
3. The estimation of the earliest time when the last message is going to be sent. It can be later than the estimation, but not earlier.

Optionally, you can click the Cancel button to call off an already launched campaign.

Before canceling a campaign a warning message notifies you that canceling a launched campaign is irreversible and the campaign cannot be re-launched at all, later on.