Design a push notification design-push-notification
Once you have created a push notification, you can design its content for iOS and Android platforms. This page guides you through composing your message, configuring on-click behavior, adding media and buttons, and setting advanced options to create engaging push notifications that resonate with your audience.
Title and Body push-title-body
To compose your message, click the Title and Body fields. Use the personalization editor to define content, personalize data and add dynamic content. Learn more about personalization and dynamic content in the personalization editor.
Use the device preview section to visualize how the push notification displays on iOS and Android.
Accelerate your content creation with AI Assistant and generate compelling push notification text with AI Assistant for text generation or create complete push notifications with AI Assistant for full content generation.
On click behavior on-click-behavior
Configure the action that occurs when recipients tap the body of your push notification. Choose from the following options:
- Open app: Launches the application associated with the notification. The app is specified in your channel configuration (i.e. message preset).
- Deeplink: Directs users to specific content within your app, such as a particular view, page section, or tab. Enter the deeplink URL in the provided field.
- Web URL: Directs users to an external webpage. Enter the destination URL in the provided field.
Add media add-media-push
Enhance your push notification by adding visual media. The available media types and implementation methods vary by operating system, as detailed in the tabs below.
For Android, you can only add an image icon, and an image for expanded notifications.
You can add media using either of the following methods:
-
Add media button: Select an asset from Adobe Experience Manager Assets or access the AI Assistant to generate engaging images for push notifications.
-
Add media field: Enter the media URL directly. You can include personalization tokens in the URL.
Once added, the media displays on the right of the notification body.
| note note |
|---|
| NOTE |
When including media attachments in the push notification payload (such as images in custom data fields like adb_media), your mobile application must implement specific client-side handling for the images to render on devices. Your app must implement the automatic display and tracking workflow to handle image attachments from the payload. |
For iOS, you can add an image, video, or GIF to display within your notification.
You can add media using either of the following methods:
-
Add media button: Select an asset from Adobe Experience Manager Assets. Learn more about using Adobe Experience Manager Assets in this page.
-
Add media field: Enter the media URL directly. You can include personalization tokens in the URL.
Once added, the media displays on the right of the notification body.
| note note |
|---|
| NOTE |
When including media attachments in the push notification payload (such as images in custom data fields like adb_media), your mobile application must implement specific client-side handling for the images to render on devices. Your app must implement a Notification Service Extension to download and process media content from the payload. Additionally, the Add mutable-content flag option must be enabled in the Advanced options section. |
Add buttons add-buttons-push
Create an actionable notification by adding buttons to your push content. Browse the tabs below based on your operating system.
If the device screen is locked, these buttons are not displayed: only then the Title and the Message of the notification are visible. If their device is unlocked, recipients will see the buttons.
For Android, you can add up to three buttons.
-
Use the Add button to define settings: the label and associated action. Possible actions are the same as for on-click behavior.
-
Use the Expand view icon under the central preview image to preview your personalized buttons.
For iOS, a notification category identifier is specified. Notification categories need to be preconfigured in the iOS app which will define the buttons to be displayed and actions taken. See the Apple documentation for more details.
Send a silent notification silent-notification
A silent push notification (or background notification) is a hidden instruction that is delivered to the application. It is used for example to notify your application about the availability of new content or initiate a download in the background.
Select the Silent Notification option to silently notify the application: in this case, the notification is transferred directly to the application. No alert is displayed on the device screen.
Use the Custom data section to add key-value pairs.
Custom data custom-data
In the Custom data section, you can add custom variables to the payload, depending on your mobile application configuration. For more on how to set up push notifications in Adobe Experience Platform, refer to this section
Advanced options advanced-options-push
You can configure Advanced options for your push notification. Available parameters are listed below:
The badge value will disappear as soon as the user opens or reads the new content from the application. When a notification is received on a device, it can refresh or add a badge value for the related app.
For example, if you are storing the number of unread articles of your customers, you can leverage personalization to send the unique unread articles badge value for each customer. For more personalization, refer to this section.
Starting with iOS 12, notification groups allow you to consolidate message threads and notification topics into thread IDs. For example, a brand might send marketing notifications under one group ID, while keeping more operational type notifications under one or more different IDs.
To illustrate this, you can have groupID: 123 “check out the new spring collection of sweaters” and groupID: 456 “your package was delivered” notification groups. In this example, all delivery notifications would be bundled under group ID: 456.
Starting in Android 8.0 (API level 26), all notifications must be assigned to a channel in order to display. For more on this, refer to the Android developer documentation.
This works even if the app is running in the background and without needing any user interaction (e.g. tapping on Push notification). However, this does not apply if the app is not running. For more on this, refer to the Apple developer documentation.
You can then leverage your mobile app extensions to further modify the content or presentation of arriving push notifications sent from Journey Optimizer. For example, users can leverage this option to decrypt data, change the body or title text of a notification, add a thread identifier to a notification etc.
Important: This flag must be enabled when including media attachments (images, videos) via payload fields (such as
adb_media) for them to render on iOS devices. Your app must also implement a Notification Service Extension to download and process the media content from the payload.Private will show the notification on all lockscreens, but conceal sensitive or private information on secure lockscreens.
Public will show the notification in its entirety on all lockscreens.
Secret will not reveal any part of the notification on a secure lockscreen.
For more on this, refer the Android developer documentation.