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.
Application Scope
Currently, Tencent Push Notification Service rich media push supports the following types of rich media contents:
Android: image and audio
iOS: image, audio, and video
Note:
The Tencent Push Notification Service channel for iOS supports rich media push by default. For the APNs channel, applications need to integrate with the notification service extension plugin.
The supported types of rich media and use requirements for each push channel are as follows:
Push Channel
Supported Type
Use Requirements
Huawei
Thumbnail
Only HTTPS URLs are supported.
Format requirements:
PNG, JPG, and JPEG
120 x 120 px. The image will be automatically resized if its width or height exceeds 120 px.
Less than 200 KB.
Mi
Large image
Only HTTPS URLs are supported.
Format requirements:
PNG, JPG, and JPEG
Fixed at 876 x 324 px.
Less than 1 MB.
Note: to use the large image notification feature in the Mi channel, you need to first call the image upload API of Mi to upload the image file, get the image address pic_urlspecified by Mi, and enter it in the corresponding Tencent Push Notification Service push parameter xg_media_resources. For more information, see the large image upload API description in here.
Tencent Push Notification Service
Large image, thumbnail, and audio
Android platform:
Only HTTPS URLs are supported.
Image format requirements:
JPEG, JPG, and PNG .
The height of a large image cannot exceed 324 px and the width is adaptive.
The size of a thumbnail should be 120 x 120 px. If its height or width exceeds 120 px, it will be cropped into a square.
Audio file format requirements: an audio file cannot exceed 5 MB.
iOS platform: the requirements are the same as that of the APNs channel.
APNs
Thumbnail and audio/video
Only HTTPS URLs are supported.
Image format requirements:
JPEG, PNG, and GIF formats.
Less than 10 MB.
Audio/Video file format requirements:
Video encoding formats: MPEG, MPEG-2 Video, MPEG-4, and AVI
Audio file extensions: AIFF, WAV, and CAF
Audio encoding formats: Linear PCM, MA4 (IMA/ADPCM), alaw, and μLaw
An audio/video file should be less than 5 MB.
An audio file should be less than 30s long.
Note: image and audio/video cannot be enabled at the same time.
3. Enable Notification Image or Notification Audio/Video, and enter the rich media message URL. The detailed configuration instructions are as follows:
When you enable Notification Image:
Android:
Note:
Thumbnail:
The URL must be in HTTPS format.
The thumbnail can be displayed in pushes delivered through the Tencent Push Notification Service and Huawei channels.
Format requirements: PNG, JPG, or JPEG; 120 × 120 px; less than 200 KB
Large image:
The URL must be in HTTPS format.
The large image can be displayed in pushes delivered through the Tencent Push Notification Service and Mi channels.
Format requirements: PNG, JPG, or JPEG; 876 x 324 px; less than 1 MB.
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.
When you enable Notification Audio or Notification Audio/Video:
Android:
Note:
After the audio URL is entered, notifications delivered through the Tencent Push Notification Service 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
To send a rich media message via an API call, you can set the following parameters in the Android or iOS message body in the Push API:
Platform
Parameter
Notes
Android
Thumbnail: icon_res, icon_type
Large image: xg_media_resources
Audio: xg_media_audio_resources
Thumbnails are supported only for the Tencent Push Notification Service and Huawei channels.
Large images are supported only for the Tencent Push Notification Service and Mi channels.
Audios are supported only for the Tencent Push Notification Service channel.
iOS
Image and audio/video: xg_media_resources
Notification Image and Notification Audio/Video cannot be enabled at the same time.
For more information, see the Required Parameters section in Push API.
Below is a 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 URL of the rich media element, such as `https://www.xx.com/img/bd_logo1.png?qua=high`.
"xg_media_audio_resources":"xxx", // Enter the URL of the audio, such as `https://sc1.111ttt.cn/2018/1/03/13/396131227447.mp3`.
"android":{
"icon_type":1,
"icon_res":"xxx", // Enter the URL of the thumbnail.
"custom_content":"{\\"key\\":\\"value\\"}"
}
}
}
FAQs
The Meizu, OPPO, and vivo channels do not support rich media. How do I deliver notifications to all devices?
Notifications delivered through the Tencent Push Notification Service, Huawei, Mi, and FCM channels contain images, while those delivered through the Meizu, OPPO, and vivo channels are in plain text format without images by default.
How can I include an image in a push message?
Whether you call an API or use the console to deliver a message, you need to generate a URL for the image to include it in the message.
What is the policy for delivering audios on Android?
Audio pushes delivered through the Tencent Push Notification Service channel can display the audios normally, while those delivered through other channels will be in plain text format without audios by default.
Can I enable both Notification Image and Notification Audio/Video for iOS?
