Show Menu
TOPICS×

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.
  1. On the Audience page for a new push message, click Experience .
  2. Type a name for this message.
  3. 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.
      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 .
      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
      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 will be cropped.
For more information about configuring rich push notifications, see the following content:
To configure a push message on the Experience page:
  1. ( Optional ) Click the Show Advanced Options link to configure additional options:
    • Payload: Data
      Provide a custom push payload in JSON that will be 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 .
  2. (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.
  3. ( Optional ) Click Test to push your message to specified devices for testing purposes.
  4. 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.
  5. Configure the scheduling options for the message.
    For more information, see Schedule: push message .