Web Push Notifications
  • Integration
    • My website already has a service worker
    • My website does not have a service worker
    • Salesforce Commerce Cloud
  • Defining Notifications
    • Image sizing
  • Dashboard
  • Settings
  • Troubleshooting
Powered by GitBook
On this page
  • Welcome Notification
  • Delivery Settings
  • Default Icon
  • Expiry Time
  • Email Updates
  • Failed Delivery Threshold

Settings

PreviousDashboardNextTroubleshooting

Last updated 2 months ago

Navigate to the "Settings" section of the portal to customize certain behavior of your web push notifications.

Welcome Notification

If enabled, the system will send a welcome notification to the user immediately upon subscribing to receive notifications. This can often lead the user to be more receptive to future notifications.

Delivery Settings

These setting can help avoid bombarding notifications to users, especially during particularly sensitive times of the day / week. Notifications will only ever be sent to your users on the day of the week defined here and between the defined start and end times, even if specified otherwise in a particular scheduled notification. These times and days are interpreted in the end user's time zone.

Additionally, the "Time between notifications" setting controls the frequency in which a single user receives a notification. Using the image above for example, a particular user can only be sent one notification every two hours. Any other web push notifications scheduled for that specific user will be sent following the "one every two hours" schedule until all are sent (but only during the delivery window).

Default Icon

Optionally, you can choose a default icon here in the settings. This will act as the default icon for newly created notifications, but this can be overridden.

Expiry Time

This setting controls how long the notification should stay alive in the user's browser or device without being seen before expiring. Essentially, using the image as example, your user will have 5 days to access their device and see the notification before it is hidden automatically. If the notification is delivered and viewed within this period, it will still be available to the user after this expiry time.

Email Updates

This group of settings can be set to alert particular email addresses when each scheduled notification is sent. The email includes information regarding exactly how many notifications are sent and how long the process took.

Failed Delivery Threshold

For various reasons including subscription revoking or browser issues, certain users will be unable to receive a particular notification. This setting defines how many times the system should try to send subsequent notifications to the user. After the specified number of retries, the user will be marked as "lost", and the system will stop attempting to send future notifications to the user.

It does not control how many times a single notification is attempted. It only applies to the next notifications sent to the same user.

Figure 1: Welcome notification setting
Figure 2: Delivery settings
Figure 3: Default icon setting
Figure 4: Time to expire setting
Figure 4: Notify emails
Figure 5: Failed delivery threshold