Overview

Web push notifications are browser-based messages you can send to your website users even when they are outside of your website.

Introduction

Web push notifications provide the ability to communicate brief, yet important alerts to your users while CleverTap’s rich segmentation and powerful infrastructure can help send time-sensitive, relevant, and personalized push messages at scale.

🚧

Prerequisite

The prerequisite to set up web push campaigns requires a specific code configuration. For more information, refer to Web in the developer documentation.

The Web Push feature makes it easy to set up web push campaigns for all your users or specific user segments. These segments can be created on the basis of past or live user behavior, user properties, or a combination of user behavior and properties.

Once a campaign has been sent, you can view detailed reports on how many messages were sent, how many users clicked on them, how many users converted as a result, and more.

Create a Web Push Campaign

This guide shows how to create a web push campaign from start to finish.

Create a New Campaign

To start creating a web push campaign, perform the following steps:

  1. Navigate to Campaigns.
  2. Click on the + Campaign button.
  3. Select Web Push under the Desktop / Mobile web channels section.

Select the Campaign Type

To select the campaign type, use the following to make your selection:

Past behavior campaigns can be scheduled to run:

  • One time: On a specific date and time.
  • Multiple dates: On multiple specified dates and times.
  • Recurring: On a recurring basis.

Live campaigns can be set up as follows:

  • Single action: In response to a user event.
  • Inaction within time: User event or inaction combination, such as an abandoned cart scenario.
  • On a date/time: Based on a date event property value of an event, such as a reminder for upcoming travel booking.

For instance, you can choose to create a live, Inaction within time campaign that will target users as soon as they add a product to their cart but do not finish transacting within 10 minutes, the golden window within which most users transact on our website.

Define the When

Set up the When to schedule the campaign start and end.

Global campaign limits are limits you can apply to determine how many web push notifications each app user receives per day. If you would like to override these settings for an important campaign, you can click on the Don’t apply global campaign limits to this campaign checkbox.

You can also click on the Advanced checkbox to specify Do Not Disturb (DND) hours during which notifications from this web push campaign are prevented from going out, either by discarding them or delaying delivery to after DND hours complete, such as 9 PM to 9 AM.

Since past behavior campaigns can have scheduled times, you have the option to stop campaign delivery after a certain cut-off time, or even deliver at the specified time in the user’s timezone. For more information, refer to Notification Delivery Options.

📘

Recurring Day

If you specify a recurring day for a campaign, such as the 7th of each month, then the campaign will start for the specified day and ignore the creation date. This is a precaution to avoid sending a campaign unintentionally on a prior date.

Define the Who

Next, indicate the target audience for your web push campaign.

You can target your web push campaign to a new user segment by clicking on Create an ad-hoc segment or use a previously saved user segment from the list of pre-saved segments shown in the table as shown below.

If you choose to create an ad-hoc segment, you can now select a type of segment on which to base your web push campaign. The target can be created either on the basis of past user behavior and/or user properties, or live (ongoing) user behavior (the latter is useful to send out real-time, triggered web push campaigns).

For live campaigns, you can check the Filter on past user past behavior and common properties checkbox to filter by any past user behavior and common properties.

For past behavior campaigns, you will also have an option to estimate reach to view how many users qualify for the campaign criteria and are reachable via web push notifications.

Define the What

The web push notification text fields shown below can be personalized for every user based on specific user property or event property values. For more information, refer to User Profiles.

  1. To invoke the personalization menu, type the @ symbol in the title or the message field.

Emojis can be included in your web push notifications, such as in a regular text. You can use the CleverTap emoji picker or copy-paste emojis from an Emoji keyboard online.

  1. Enter any optional items as shown below:

🚧

Browser Considerations

Some of the optional items only apply to a certain browser, such as Firefox, Chrome, or KaiOS.

  • Deep Link: Specify a deep link, so that upon a web push click, the user is taken back to one of your specific webpages, such as the checkout page. With dynamic replacements, you can take the user right back to the webpage of the product they just added to their cart and present them with an incentive to encourage the transaction.
  • Image Link: Specify an image link. You can specify a publicly hosted image URL, such as a product they just added to their cart. You can add from a list of default web push notification icons.
  • Icon: Specify an icon or select the checkbox Don't use icon if you do not need to use one.
  • Time To Live: Select a time for the web push notification to remain viewable to users, prevent notification dismissal unless interacted with by the user, and even include a call to action link within the notification.
  • Custom key-value pairs: Add any key-value pairs.

Once you are done setting up the content of your campaign, you have the option to send a test web push notification to any CleverTap user profile you have marked as a test profile.

  1. Click the Send a test notification link.

  2. Click Continue.

Setup

To define your campaign setup at this stage, perform the following steps:

  1. Create the control groups.
  2. Add labels.
  3. Set up conversion tracking.
  4. After testing, when you are satisfied with the appearance of your campaign, click Continue to view your campaign summary.

Overview and Schedule Campaign

As a final step, save and schedule your campaign to ensure that your message reaches your intended audience.

Click Schedule notification.

Viewing Web Push Campaign Stats

Once the campaign has been sent, you can view its stats from the dashboard by clicking on Campaigns, then selecting the campaign of interest to view its total sends, clicks, conversions, and revenue from conversions (if applicable).

Campaign Considerations

Below are some things to consider in regards to Safari.

Safari Considerations

Safari, being a proprietary browser, has some built-in restrictions. Following are the considerations with Safari web push as compared to Chrome or Firefox:

  • Deep link URL is mandatory or else the notifications will not be rendered.
  • Custom icons are not rendered in the notifications as Safari uses the icons available in the Safari push package.
  • Image and call to action buttons are not available for Safari notifications.
  • Sent and viewed events are not supported as there is no handler unlike Service Worker in Chrome and Firefox to capture the click and view events.

Safari Errors

You may encounter the following errors while sending web push notification on Safari:

  • Invalid Authentication
  • BadRequest(400)
  • DeviceTokenInactiveForTopic(410)
  • ServerUnavailable(503)

Video Tutorial

For further information, you can watch the following video on web push notification campaigns:

Updated 5 months ago


Web Push


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.