tencent cloud

With tightening restrictions over the push limit and frequency of vendor channels, the push reach rate and delivery speed are also affected. For specific restrictions, see:

• Vendor Channel Limit Description
• Vendor Channel QPS Limit Description

Tencent Push Notification Service provides two channel assignment policies: smart assignment and custom. These policies can help improve the overall push reach rate and delivery speed against the restrictions of the vendor channels.

Channel Overview

Channel Policy Overview

Smart assignment

Tencent Push Notification Service will, based on the device status, segment active status, and push channel status, intelligently assign the optimal delivery channel for each device to achieve the following effects:

1. Improve the overall push reach rate.
2. Speed up the message arrival overall.
3. Save the resources of the vendor channels.

Custom channel policy

Currently, vendor channels limit the daily number of pushes. You can choose the channels through which this push can be delivered according to business needs and personalize the push channel delivery policy to save vendor channel resources and maximize the value of pushes.
The table below specifies the delivery rules of a custom policy.

Directions

Setting the policy in the console

You can select a channel policy for a push in the following path when creating it in the console:
Tencent Push Notification Service console > Message Management > Task List> Create Push > Advanced settings> Channel Policy

Smart assignment

Select Smart assignment. The system will intelligently assign the delivery channel for each device. For more information, see the rules given in Smart assignment.

Custom policy for Android channels

Select Custom. Click View details to check vendor-specific quota information.

You can choose the channel used for push according to the remaining quota of the current vendor channels and the priority of the push task. For more information, see the rules given in Custom channel policy. We recommend selecting It is preferentially delivered through Tencent Push Notification Service channel when the device is online to save vendor channel resources.

Note：

The Tencent Push Notification Service channel can be disabled.

Custom policy for iOS channels

You can choose the channel used for push based on the priority of the push task. For more information, see the rules given in Custom channel policy. We recommend selecting It is preferentially delivered through Tencent Push Notification Service channel when the device is online to ensure the fastest notification delivery to the device.

Setting the policy with RESTful APIs

Set the optional channel_rules parameter for the RESTful API. For more information, please see channel_rules parameter description in the Push API documentation.
Below is a sample push on Android:

{
    "audience_type": "token",
    "token_list": [
        "05da87c0ae*************8d884aada5bb2"
    ],
    "message_type": "notify",
    "channel_rules": [
        {
            "channel": "mz",
            "disable": true  //Disable the Meizu channel
        },
        {
            "channel": "xm",
            "disable": false  //Enable the Mi channel
        }
    ],
    "tpns_online_push_type":0, //The push will be delivered through the Tencent Push Notification Service channel by default when the device is online
    "message": {
        "title": "The push will be delivered through the Mi channel, and the Meizu channel is not needed",
        "content": "Push content",
        "android": {
             "custom_content":"{\"key\":\"value\"}"
        }
    }
}

Below is a sample push on iOS:

{
        "audience_type": "token",
        "environment": "dev",
        "token_list": ["05da87c0ae********fa9e08d884aada5bb2"],
        "message_type": "notify",
        "channel_rules": [{
            "channel": "apns",
            "disable": true
        }],
        "tpns_online_push_type": 0,
        "message": {
            "title": "The push will be delivered through the Tencent Push Notification Service channel only",
            "content": "Push content",
            "ios": {
                "aps": {
                    "alert": {
                        "subtitle": "Push subtitle"
                    },
                    "badge_type": -2,
                    "sound": "Tassel.wav"
                },
                "custom_content": "{\"key\":\"value\"}"
            }
        }
}