Overview

The Notification Update feature updates an existing push notification in the users' notification drawer by sending a new notification with the same Update key. This feature helps keep notifications relevant and prevents clutter.

Use Cases

The following are some use cases for this feature:

• Order tracking: Update users with the latest delivery status of their package by overriding the initial shipment confirmation message using the order ID.
• E-commerce: If a user is eligible for multiple offers that can't be combined, you can use a selection key. This ensures the user sees only one relevant offer at a time, preventing confusion and making their shopping experience smooth and clear.
• Media and entertainment: You can update a breaking news alert with the latest confirmed details after the initial notification.
• Travel and hospitality: You can update gate change information for a flight directly within the initial boarding reminder notification. For more information, refer here.
• Gaming: Inform players of an unscheduled server maintenance update, overriding the initial event reminder.

How Notification Update Works

Perform the following steps to update your push notifications:

1. In the second step of push campaign creation, Content, expand the Advanced tab.
2. In the Update key field under the Advanced section, enter a unique string value.
   • This field accepts a single input string.
   • It supports personalization.
   • MoEngage automatically modifies the update key to ensure it does not exceed the 45-character limit. It removes non-Latin scripts, special characters, and spaces to restrict the key composition to ASCII characters exclusively.
   • This update ID will be used to identify and update related push notifications. Ensure you use the same update ID for all push notifications intended to update each other.
3. Complete the remaining steps of the push campaign creation process and send your campaign.

Example

We will create a Push campaign for a new app called MoEngage Travels. This app wants to send push notifications to update the gate information for a flight directly within the initial boarding reminder notification sent to passengers departing from London International Airport.

Scenario (Flight LH456 departure):

• Initial boarding reminder (sent 2 hours before departure):
  • Content: Reminder: Your flight LH456 to London departs at 3:00 PM from Gate D7. Please proceed to the gate.
  • Update key: flightlh456update
• Gate change update (sent 1 hour before departure):
  • Content: Important Update: The departure gate for your flight LH456 to London has changed to Gate C2. Please proceed to the new gate.
  • Update key: flightlh456update

Outcome

The Push campaign for the MoEngage Travels app successfully updated the initial boarding reminder notification with the new gate information for flight LH 456. Using the same update key (flightlh456update), the gate change message updated the initial notification, ensuring passengers receive accurate and timely updates without duplication.

Android	iOS

On Device Behavior

In Android

• Update behavior:
  • If a new notification (B) with the same update key as an existing notification (A) arrives, if B’s sent time is greater than A’s sent time, B replaces A. Otherwise, B is discarded.
  • If two notifications with the same update key arrive simultaneously, only the latest one is shown.
• The Notification Received event: The value of the update key appears as an event attribute named Update Key.
• User experience:
  • A slight flicker may occur when a notification updates.
  • Notification sounds, alerts, and channel settings remain unchanged.
  • Notifications are not replaced in the Push Notification Center or Self-Handled Notification Center, but the update key and sent time are included in the payload.
  • Notification update works independently of Notification Grouping.

In iOS

• Update behavior: iOS updates notifications with the same update key.
• The Notification Received event: The value of the update key appears as an event attribute named Update Key.
• Notifications are not replaced in the Push Notification Center or Self-Handled Notification Center, but the update key is included in the payload.
• Notification update works independently of Notification Grouping.

FAQs

Best Practices

• Use unique update keys to prevent unintended notification updation.
• Test your push campaigns before launching to ensure notifications behave as expected.
• Monitor analytics to track notification performance.
• Combine with notification grouping for a more organized user experience.