Overview

The Push Editor allows you to create and edit relevant and timely messages for your push campaign. This section explains the different Push templates that are pre-built and designed to cater to your various push campaigning needs. You can create your push message by selecting the appropriate push template for your campaign.

From the What section, select the Message Type for your push notification and click Go To Editor. You can see the various push templates to help you create a contextual and timely message.

Push Templates

The Push Editor in CleverTap allows you to design and edit impactful push notifications directly from the dashboard, no developer support or SDK updates are needed. It offers a range of pre-built templates tailored for various campaign goals, making crafting relevant, timely, and engaging messages easier.

You can select from the following template types:

• Standard: Supports simple layout with title, message, image, and optional buttons ideal for quick, informative alerts. For example, an e-commerce business might want to inform customers that their order is on the way. You can add GIFs to your message content using the Standard Template. For more information on GIF sizing and format, refer to GIF Support.

• Advanced: Supports rich media, deep links, and enhanced customization for more engaging messages. It is great for interactive, visually appealing messages. For example, businesses can use it to build excitement for new product drops, early access offers, or feature rollouts that benefit from strong visuals and clear Call to Action (CTAs).

• Auto Carousel: Allows multiple images with titles and links that users can swipe through perfect for showcasing multiple offerings in one message. Businesses can use it to promote new product collections, travel packages, content recommendations, and so on.

• Timer: Adds a countdown timer to your template to enable immediate action from the user ideal for time-sensitive campaigns. For example, businesses can use it for flash sales, limited-time discounts, and so on.

• Text over Image: Places bold text over a background image to deliver visually striking messages. For example, businesses can use it to highlight seasonal campaigns, special announcements, event invitations, and so on.

Manual Carousel Template

Manual Carousel is an interactive push notification format that lets users scroll through a series of cards or slides at their own pace. Each card can display rich content like images, headlines, brief descriptions, and a call-to-action (CTA). Users navigate between cards manually using swipe gestures or navigation arrows.

If only a single image is available for download, this template falls back to the Basic Template.

Push Campaign Setup

Based on the selected template, the editor displays configurable fields grouped by functionality as follows:

• Content
• Android Options
• iOS Options
• Custom Key-Values
• Post Action Webhook
• App Inbox

Once you select the required push template for the Title and Message fields, you can use the following options to create personalized, and engaging campaigns:

• Use text color (icon to be added) to change the color of your text.
• Use emoticons () to create more engaging and visually appealing messages that can more effectively capture the audience's attention than plain text. Emojis, unlike simple emoticons, can be more complex and take up varying amounts of space in text.
• Use @ personalization or {{}} to create more personalized or captivating messages. Enter the required details to create the message.
• Use liquid scripts (icon to be added) < to check the usage>
• Use Clever.AI, the AI-powered writing assistant that can also analyze and adjust the emotional tone of your content. It helps generate attractive and emotionally relevant messages for your campaign.

Content

This section includes the core elements of your push notification, applicable across platforms:

📘

Recommended Character Limits

While there are no enforced character limits for push notifications, following these best practices ensures your message is displayed seamlessly across devices, thus preventing the title from trimming. The recommended character limits are as follows:

Platform	Recommended Title Length	Recommended Message Length
iOS	25-50 characters	150 characters
Android	65 characters	240 character

Android Options

You can use this section to customize Android-specific behavior for your push using the following fields:

iOS Options

You can use this section to customize Apple-specific behavior for your push using the following fields:

Custom Key-Values

Use this section to send additional data in the form of key-value pairs as part of your push notification payload. Your mobile app can use these values to trigger specific in-app behaviors or business logic already configured in your app code.

You can define key-value pairs for:

• All platforms
• iOS only
• Android only

Each pair consists of:

• Key: A unique identifier (for example, discountType)
• Value: The corresponding value the app will read (for example, 20)

Consider an example where you are running a push campaign offering a 20% discount. By adding a custom key-value pair such as offerType: discount20, your app can read this payload and automatically route the user to a discount page upon tapping the notification.

You can add multiple pairs using the Add pair button to support different logic across platforms or campaigns.

Post Action Webhook

Use this section to send a payload to your designated endpoint after a push notification is delivered.

App Inbox

Use this section to also save the notification in the App Inbox so users can revisit it later.

Other Settings

Notification Priority

You can set these priority levels from the CleverTap dashboard as you create your Android push campaigns.

Have your app running our latest SDK (versions v3.1.4 or higher) and follow the steps outlined above to send actionable push notifications and set notification priority on Android devices.

Notification Tray Priority

On Android, you can also set a priority level for each notification to influence how prominently it is displayed. The higher the priority, the more noticeable it will be.

Select any of the following options from the Notification tray priority.

• Default Priority: Use for most of your messages that are not time-sensitive, such as general notifications and promotional offers.
• High Priority: Use for important communications that require extra attention, such as chat messages. These will also display as heads-up notifications and be given a higher priority in the user’s tray. Heads up notifications are notifications that pop up on your screen from the top even when you are using other apps. For example, receive a message on your chat app when you’re using the food delivery app. This feature is available for Android N (API 25) and below. For Android Oreo and above, define the priority in the Notification Channel.
• Maximum Priority: Use for urgent, time-sensitive notifications. These notifications will get higher placement inside the user’s tray and display as heads-up notifications.

Notification Delivery Priority

You can assign delivery priority on Android for Push notifications as follows:

• Normal: The data messages with normal priority are delivered immediately when the device is active. However, if the device is inactive to conserve battery, the delivery may be delayed until the device becomes active again. You must set the priority as Normal for less time-sensitive messages (such as notifications of new emails, keeping your UI in sync, or syncing app data in the background).
• High: The messages with high priority are delivered immediately, even if the device is asleep. It wakes the device and allows limited processing (including minimal network use) to ensure the message is received. These messages are meant to provoke user action or response to your app or its notifications. You must set the priority as High for time-sensitive or user-visible content. CleverTap recommends setting the notification priority as High to ensure the time-sensitive content is rendered immediately on end-user devices. If FCM detects a pattern in which messages do not result in user-facing notifications, the messages are deprioritized to normal priority.

The value for this field is set to High by default.

📘

Notification Priority for Cloned Campaigns

Cloned campaigns retain the priority setting from the original campaign.

Collapse Key

To replace an existing notification with the same collapse key, you can use the collapse notification option. For example, if push X and push Y have a collapse key A. Push X notification is present on the mobile device when push Y notification is received. The push X notification will no longer be visible (it is collapsed), and push Y is displayed. The collapse key must be added under the collapse notification field. For more information, see Collapse Key.

Interruption Level

In iOS versions earlier than 15, users could choose to silence all calls and notifications by enabling Do Not Disturb mode. Starting in iOS 15, users can hone their notification preferences to fit different contexts by setting Work, Sleep, and Personal notification modes. With iOS 15, Apple introduced four interruption levels, including time-sensitive and critical notifications, to ensure urgent alerts, like weather emergencies, reach users effectively.

These interruption levels determine the priority and delivery timing of notifications, allowing users to be in control of their device notifications. The interruption levels are designed to cater to different scenarios while respecting user preferences and focus modes. Here are the three interruption levels:

Active (Default)

• Behavior: Active notifications replicate the existing notification behavior. Upon delivery, they trigger audible sounds and vibrations and illuminate the screen.
• Focus Mode Compatibility: Active notifications do not break through Focus modes, ensuring that the user's selected focus settings remain undisturbed.
• Purpose: Use this interruption level for notifications that require immediate attention and engagement.

Time Sensitive

• Behavior: Time-sensitive notifications share similarities with active notifications. However, they are accompanied by a distinctive yellow banner, making them visually recognizable as urgent.
• Focus Mode Compatibility: These notifications can break through both scheduled delivery times and active Focus modes.
• Purpose: Reserve the Time Sensitive interruption level for notifications demanding immediate user action. Their unique appearance aids users in identifying critical messages quickly.

Passive

• Behavior: Passive notifications are designed for non-urgent matters. They arrive discreetly without generating sounds or vibrations.
• Focus Mode Compatibility: Passive notifications are considerate of users' Focus modes and do not disrupt them.
• Purpose: Employ the Passive interruption level for notifications that do not require instant attention, minimizing distractions while keeping users informed.

📘

Critical Interruption Level

Currently, this Interruption level is not availabe in CleverTap dashboard. We recommend contacting your Customer Success Manager and sharing your use case if you want to send the campaign from the dashboard with Interruption level set as Critical.

Template Variations

Users can preview and render different variations of outputs for each Push template type based on the following factors:

• Version-based Rendition- Notifications render differently for Android version 12 and above and version 11 and below. Key considerations include the following:
  • Android 13 and above: Use images no larger than 450x450 px for optimal rendering.
  • Android 12 and above: Center-align any text within images is centered for to ensure better visibility.
  • Android 11 and 12: Use image file size below 100 KB to prevent rendering issues.
  • Android 11 and below: Use images of under 3 MB or lower is recommended for better to maintain optimal performance.
• CTA-based Rendition - Notification renders based on whether CTA buttons are included in the payload.

Dark Mode

Push templates automatically adapt to the device's theme settings, rendering notifications in dark or light mode.

📘

Custom Color Support

Templates support custom color definitions that adapt to both themes for visual consistency.

Image Scaling

Android supports various image scaling options to control how images appear in push notifications. CleverTap optimizes image rendering to maintain visual consistency across devices while leveraging Android native scaling behavior. To handle scaling in a Push template, you must add the key pt_scale_type key and the value is set as fit_center or center_crop based on the requirement.

The following table lists the different scaling settings in Push templates: