Events Changelog

Welcome to the Events changelog document for CleverTap. This changelog provides insights into system event updates in CleverTap, helping you use CleverTap effectively and monitor your metrics with greater accuracy.

We are dedicated to empowering businesses with advanced mobile marketing and analytics capabilities and delivering continuous improvements to meet our users' evolving needs. Stay tuned as we update this changelog regularly to inform our customers of any changes to existing system events or the introduction of new ones.

October 2026

Change Release DateEvent NameProperty NameUpdate TypeDescription
October 23, 2026Notification RepliedCTWA ReferralEvent Property AddedCaptures the Click-to-WhatsApp (CTWA) ad click ID when a user starts a WhatsApp conversation by clicking a Facebook or Instagram ad.

The value is the ctwa_clid string received from Meta. You can use it to segment, filter, and report on ad-originated replies.

For more information, refer to Notification Replied under System Events​.

September 2026

Change Release DateEvent NameProperty NameUpdate TypeDescription
September 22, 2026Notification ClickedDelivery ChannelEvent Property AddedIndicates the messaging channel through which the notification was sent to the user.

It will be populated only for SMS/RCS campaigns

June 2026

Change Release DateEvent NameProperty NameUpdate TypeDescription
June 10, 2026Notification Clicked, Notification ViewedUser AgentEvent Property AddedIndicates the user agent associated with the interaction.

Note: For more information, refer to Bot Activity Filter. The feature is currently in Private Beta. To enable this feature for your account, contact your Customer Success Manager.
Notification Clickedmachine clickEvent Property AddedWhen true, the click is flagged as suspected bot activity and excluded from campaign click metrics and journey evaluations. When false, the click is attributed to a human user.

Note: For more information, refer to Bot Activity Filter. The feature is currently in Private Beta. To enable this feature for your account, contact your Customer Success Manager.
Notificated Viewedmachine openEvent Property AddedWhen true, the open is flagged as suspected bot activity and excluded from Notification Viewed metrics. When false, the open is attributed to a human user.

Note: For more information, refer to Bot Activity Filter. The feature is currently in Private Beta. To enable this feature for your account, contact your Customer Success Manager.

February 2026

Change Release DateEvent NameProperty NameUpdate TypeDescription
February 26, 2026Push Impression, Notification Clickedwzrk_sifEvent Property AddedBoolean property that indicates whether the push notification was delivered silently (no popup shown when the app is open). For more information, refer to Push Editor.
wzrk_dismissEvent Property AddedThis property enables automatic dismissal of a push notification from the notification tray after a specified duration.On Android 8.0 or later, you can configure the dismissal time (in seconds). Once the set duration elapses, the notification is removed from the tray even if the user has not interacted with it.For example, setting wzrk_dismiss = 10 removes the notification after 10 seconds.This is useful for time-sensitive notifications, such as flash sale alerts, which may become irrelevant after a short period.
wzrk_stickyEvent Property AddedThis property controls whether a push notification remains pinned in the notification tray and cannot be easily dismissed.You can configure a notification as sticky using wzrk_sticky with a value of true or false.Behavior by Android Version
  • Android 14 and above
    When set to true, the notification can still be swiped away individually. However, it is not cleared when the user taps Dismiss all and remains in the notification tray.
  • Android 13 and below
    When set to true, the notification cannot be dismissed by swiping or by using Dismiss all. It remains in the tray until explicitly dismissed based on a user interaction (for example, tapping the notification) or through app logic.
This is useful for critical or ongoing updates, such as OTPs, ride status updates, or delivery tracking notifications.

October 2025

Change Release DateEvent NameProperty NameUpdate TypeDescription
October 8, 2026CT Custom Reward IssuedEvent AddedThis event is raised when a custom reward is issued to a user through a Promo campaign or API. For more information about the properties of this event, refer to CT Custom Reward Issued under System Events .

June 2025

Change Release DateEvent NameProperty NameUpdate TypeDescription
July 1, 2025Notification FailedEvent AddedThis event captures the errors that occurred in the WhatsApp campaign.
June 30, 2025CT Coupon RewardedEvent AddedThis event is raised when the coupon is issued to a user through a Promo campaign. For more information about the properties of this event, refer to CT Coupon Rewarded under System Events.
June 30, 2025CT Coupon RedeemedEvent AddedThis event is raised when the user redeems the coupon through the coupon redemption API. For more information about the properties of this event, refer to CT Coupon Redeemed under System Events.
June 30, 2025CT Coupon RevertedEvent AddedThis event is raised when a redeemed coupon is reversed. For more information about the properties of this event, refer to CT Coupon Reverted under System Events.
June 30, 2025CT Points CreditedEvent AddedThis event is raised when points are credited to the loyalty wallet. For more information about the properties of this event, refer to CT Points Credited under System Events.
June 30, 2025CT Points DebitedEvent AddedThis event is raised when points are debited from the loyalty wallet. For more information about the properties of this event, refer to CT Points Debited under System Events.
June 30, 2025CT Partner Voucher RewardedEvent AddedThis event is raised when a user receives a third-party partner voucher. For more information about the properties of this event, refer to CT Partner Voucher Rewarded under System Events.

February 2025

Change Release DateEvent NameProperty NameUpdate TypeDescription
February 5, 2025Notification DeliveredOthersNow, this event is raised for Email campaigns, indicating the successful delivery to the end user. For more information, refer to Email Campaign Stats.
  • Note*: Delivered is currently released in Private Beta. Contact your Customer Success Manager to enable this for email campaigns.

October 2024

Change Release DateEvent NameProperty NameUpdate TypeDescription
October 11, 2024Notification FailedOthersNow, this event also captures the errors that occur in email campaigns.
  • Note*: This event is currently in Private Beta. Contact your account manager to enable this event.

June 2024

Change Release DateEvent NameProperty NameUpdate TypeDescription
June 19, 2024Notification FailedEvent Added

This event captures the errors that occurred in the campaign.

This event is currently in private beta and can be enabled upon request. Contact your account manager if you need access to this event.

Campaign IDThe property helps identify the specific campaign associated with the error.
Campaign TypeThe property indicates the type of campaign (e.g., WhatsApp, SMS, Email).
ErrorThe property describes the title of the error observed in the campaign.
LabelThe property denotes the specific label associated with the error.
VariantThe property helps identify the errors for a specific campaign variant in the case of A/B, split delivery, or multi-variant campaigns.

May 2024

Change Release DateEvent NameProperty NameUpdate TypeDescription
May 15, 2024Push UnregisteredProperties Added
Source
  • CT_Push: Indicating that the event is raised via silent Push. In this case, FCM returns a 404 Unregistered error for stale tokens from devices that have not connected to FCM for 270 days or for users who have uninstalled the app.
  • CT_SDK: Indicating that the event is raised via OnUserLogin() method.
  • CT_Target: Indicating that the event is raised via campaigns or journeys.
Token ValueThe property contains the actual value of the token.
Token Type
  • FCM
  • Baidu
  • Huawei
targetIdThe property denotes the ID of the campaign or journey.

April 2024

Change Release DateProperty NameEvent NameUpdate TypeDescription
April 2, 2024Notification ClickedProperty Added
button_id

The property is visible for the event if the Notification Clicked event is tracked for button clicks associated with the new Image Interstitial template. Therefore, the customers adopting this template will see this new property.

For more information, refer to In-App Image Interstitial Template.


Did this page help you?
Suggest Edit
CleverTap Ask AI Widget (CSP-Safe)