Channel Policy

Last updated: 2020-12-03 14:25:03

    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, please see

    TPNS provides two channel assignment policies: smart assignment and custom. These policies will improve the overall push reach rate and delivery speed against the restrictions of the vendor channels.

    Channel Policy Overview

    Smart assignment

    TPNS will take into account the device status, segment active status, and push channel status to 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 overall message arrival.
    3. Save the resources of the vendor channels.

    Custom policy

    Currently, the Mi, OPPO, and Vivo 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 the custom policy.

    Channel Enabled Disabled Supported Messages
    Android vendor channels (including Huawei, Mi, Meizu, Vivo, OPPO and FCM) Both vendor channels and TPNS channel are available to the push.
    Note:
  • If the TPNS preference feature is enabled, this push is preferentially delivered through TPNS channel when the device is online.
  • If the TPNS preference feature is disabled, this push is preferentially delivered through an available vendor channel.
  • If the vendor channel push fails, the TPNS channel will be used to retry the push
  • Only the TPNS channel is available to the push Notification bar message
    iOS vendor channels (APNs) Both APNs and TPNS channels are available to the push.
    Note:
  • If the TPNS preference feature is enabled, this push is preferentially delivered through TPNS channel when the device is online.
  • If the TPNS preference feature is disabled, this push is preferentially delivered through APNs channel.
  • If the APNs channel push fails, the TPNS channel will be used to retry the push
  • Only the TPNS channel is available to the push Notification bar message and silent message
    Note: the APNs channel supports delivering up to three silent messages to a device per hour
    TPNS The TPNS channel is available to the push The TPNS channel cannot be disabled Notification bar message, in-app message, and silent message
    Note: the TPNS channel for iOS only takes effect in iOS SDK 1.2.8.0 or later.

    Getting Started

    Using the console

    When creating a push in the console, you can select a channel policy for it in the following path:
    TPNS Console -> Push Management -> 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, please see the rules of smart assignment.

    Custom policy for Android channels

    Select Custom. You can click View Details to see the vendor quota details.

    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, please see the rules of the custom policy. We recommend selecting It is preferentially delivered through TPNS channel when the device is online to save vendor channel resources.

    Note:

    The TPNS channel cannot be disabled.

    Custom policy for iOS channel

    You can choose the channel used for push based on the priority of the push task. For more information, please see the rules of the custom policy. We recommend selecting It is preferentially delivered through TPNS channel when the device is online to ensure the fastest notification delivery to the device.

    Using REST APIs

    Set the optional channel_rules parameter for the REST 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 TPNS channel by default when the device is online
        "message": {
            "title": "The push will be delivered through 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 //Disable the APNs channel
            },
        "tpns_online_push_type":0, //The push will be delivered through the TPNS channel by default when the device is online
        "message":{
         "title": "The push can only be delivered through the TPNS channel",
        "content": "Push content",
        "ios":{
            "aps": {
                "alert": {
                    "subtitle": "Push subtitle"
                },
                "badge_type": -2,
                "sound":"Tassel.wav",
    
            },
           "custom_content":"{\"key\":\"value\"}",
        }
     }
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help