Operation Scenarios

Rich media push allows you to push rich media contents such as image, audio, and video in addition to text, which can effectively increase the notification click rate. You can use this feature to push a wider variety of contents such as news, coupons, and event information, satisfying your personalized push needs.

Scope of Application

Currently, the rich media push feature of TPNS supports the following types of rich media contents:

• Android: image and audio.
• iOS: image, audio and video

  Note：

  The TPNS channel for iOS supports the rich media push feature by default. In the APNs channel, the application needs to integrate with the notification service extension plugin.

The supported types of rich media and use requirements for each push channel are as detailed below:

Directions

Console

1. Log in to the TPNS Console and select Push Management > Push Task on the left sidebar to enter the push task page.

2. Click Create Push > Advanced Settings.
   

3. Enable Notification Image or Notification Audio/Video and enter the rich media message URL. The specific configuration is as detailed below:

   • If **Notification Image is enabled:**
     Android:

     Note：

     • Thumbnail:
       The URL must be in HTTPS format.
       The thumbnail can be displayed for pushes delivered through the TPNS and Huawei channels.
       Format requirements: image in PNG, JPG, or JPEG format at dimensions of 120×120 px and below 200 KB in size.
     • Big image:
       The URL must be in HTTPS format.
       The big image can be displayed for pushes delivered through the TPNS and Mi channels.
       Format requirements: image in PNG, JPG, or JPEG format at fixed dimensions of 876x324 px and below 1 MB in size.

   
   iOS:

   Note：

   After the image URL is entered, the image will be displayed in the notification. Format requirements:

   • The file size cannot exceed 10 MB.
   • The file must be in PNG, JPG, JPEG, or GIF format.
   • The URL must be in HTTPS format.

   

   • If **Notification Audio or Notification Audio/Video is enabled:**
     Android:

     Note：

     After the audio URL is entered, notifications delivered through the TPNS channel can contain audio.

     • The audio file size cannot exceed 5 MB.
     • The URL must be in HTTPS format.

   
   iOS:

Note：

After the audio/video URL is entered, notifications can contain audio or video and be played back through Apple's native component.

• The audio/video file size cannot exceed 5 MB.
• The file must be in MPEG, MPEG-2 Video, MPEG-4, or AVI format.
• The URL must be in HTTPS format.

RESTful API

If you want to deliver rich media messages when calling the API for push, you can set the following parameters in the Android or iOS message body in the Push API:

For more information, please see the description of required parameters for the Push API.

Sample push on Android

{
    "audience_type": "token",
    "token_list": [
        "05da87c0ae******2dfa9e08d884aada5bb2"
    ],
    "message_type": "notify",
    "multi_pkg":true,
    "message": {
        "title": "Push title",
        "content": "Push content",
        "xg_media_resources": "xxx1" , // Enter the rich media element address, such as `https://www.xx.com/img/bd_logo1.png?qua=high`
        "xg_media_audio_resources":"xxx", // Enter the audio rich media element address, such as `https://sc1.111ttt.cn/2018/1/03/13/396131227447.mp3` 
        "android": {
       "icon_type": 1,
        "icon_res": "xxx", // Enter the image thumbnail element address
             "custom_content":"{\"key\":\"value\"}"
        }                        
    }
}

FAQs

The Meizu, OPPO, and Vivo channels do not support rich media. How do I deliver a notification when pushing to all devices?

Notifications delivered through the TPNS, Huawei, Mi, and FCM channels can contain images, while those delivered through the Meizu, OPPO, and Vivo channels are in text format without images by default.

How can I include an image in a push message?

No matter whether you call an API or use the console to deliver a message, you should generate a URL for the image to include it in the message.

What is the delivery policy for audio rich media on Android?

Audio rich media pushes delivered through the TPNS channel can display the audio normally, while those delivered through other channels will be in text format without audio by default.

Can notification image and notification audio/video be enabled for rich media notification on iOS at the same time?

No. Only one of them can be enabled at a time.