Experience: push message

You can configure experience options for push messages and rich push messages, including name, message text, and destination options. You can also configure advanced options, including payload options and custom options for iOS devices.

On the Audience page for a new push message, click Experience.
Type a name for this message.
Type information in the following fields in the Message section:
- Content
  
  Specify the text of your message. You can specify up to a maximum of 140 characters.
- Media URL
  
  Type the URL of the media file that you plan to use in the push notification message. For requirements to use rich push notifications, see Requirements for Rich Push Notifications below.
  IMPORTANT
  To display an image or a video in a push notification, remember the following:
  - The attachment-url data is handled in the push payload.
  - The media URL must be able to handle spikes requests.
- Destination
  
  Select a specific destination, such as a web, deep, or hybrid link, to send users when they click-through the message. For more information, see Destinations.
  
  TIP
  
  When you use the * Web Link or Custom Link destination types, the destination type is not tracked. Only Deep Links are tracked.

Requirements for rich push notifications

Here are the requirements for sending rich push notifications:

Supported Versions

Rich push notifications are supported on the following versions:
- Android 4.1.0 or later
- iOS 10 or later
  IMPORTANT
  Remember the following information:
  - Rich push messages sent to earlier versions will still be sent but only the text is displayed.
  - There is no watch support at this time.
File Formats

Here are the supported file formats:
- Images: JPG and PNG
- Animations (iOS only): GIF
- Videos (iOS only): MP4
URL Formats
- HTTPS only
Sizing
- Images must be in a 2:1 format, or they are cropped.

To configure a push message on the Experience page:

(Optional) Click the Show Advanced Options link to configure additional options:
- Payload: Data
  
  Provide a custom push payload in JSON that is sent to the app through a push or a local notification. The limit for Android and iOS is 4KB.
- Apple Options: Category
  
  Provide a category for push and local notifications. For more information, see Managing Your App’s Notification Support in the iOS Developer Library.
- Apple Options: Sound
  
  Provide the name of the sound file in your app bundle to play. A default alert sound plays if not set. For more information, see Managing Your App’s Notificaton Support in the iOS Developer Library.
- Apple Options: Content Available
  
  Select this option so that when the message arrives, iOS wakes up your app in the background and allows your app to execute code based on the message payload. For more information, see Apple Push Notification Service in the iOS Developer Library.
(Optional) Preview the layout of your message by clicking following icons:
- x Summary
  
  Hides the preview pane. Click to display the preview pane again.
- Change the orientation
  
  To change the orientation of the preview from portrait to landscape mode, click . For watches, the orientation changes from a round watch face to a square watch face.
- Preview on a user’s watch
  
  To preview your message as it will appear on a users’s watches click .
- Preview on a user’s mobile phone
  
  To preview your message as it will appear on a users’s mobile phones click .
- Preview on a user’s tablet
  
  To preview your message in a user’s tablet, click .
At the bottom of the preview pane, you can view a description of the audience that you selected in the previous step.
(Optional) Click Test to push your message to specified devices for testing purposes.
Select the service and type the push tokens for at least one device to which you want to push the message.

Specify the tokens in a comma-separated list to push the message to more than one device.
Configure the scheduling options for the message.

For more information, see Schedule: push message.