tencent cloud

Feedback

Channel Policies

Last updated: 2022-10-14 18:08:21

    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:

    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 Type Applicable Condition Supported Mobile Brand
    Tencent Push Notification Service channel The application process is online All brands
    Android vendor channels
    (Huawei, Mi, Meizu, vivo, OPPO, and FCM)
    Application process online or offline Huawei, Mi, Meizu, vivo, OPPO, OnePlus, Black Shark, realme, iQOO, Honor, and other mobile phones with Google Services Framework
    iOS vendor channel (APNs) The appplication process is online or offline Apple

    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, 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 a custom policy.

    Channel Enabled Disabled Supported Messages
    Android vendor channels
    (Huawei, Mi, Meizu, vivo, OPPO, and FCM)
    Both the vendor channel and the Tencent Push Notification Service channel are available for this push.
    Note:
  • If the Tencent Push Notification Service preference is enabled, this push is preferentially delivered through the Tencent Push Notification Service channel when the device is online.
  • Otherwise, the vendor channel will be preferred.
  • If the vendor channel push fails, the Tencent Push Notification Service channel will be used to retry the push.
  • If Tencent Push Notification Service channel is disabled, the push can only be delivered with the vendor channel.
  • You can disable the Tencent Push Notification Service channel or the vendor channel. Notification bar messages
    iOS vendor channels (APNs) Both the APNs and Tencent Push Notification Service channels are available for the push.
    Note:
  • If the Tencent Push Notification Service preference feature is enabled, this push is preferentially delivered through the Tencent Push Notification Service channel when the device is online.
  • Otherwise, the APNs channel is preferred.
  • If the APNs channel push fails, the Tencent Push Notification Service channel will be used to retry the push.
  • If Tencent Push Notification Service channel is disabled, the push can only be delivered with the vendor channel.
  • You can disable the Tencent Push Notification Service channel or the vendor channel. Notification bar messages and silent messages.
    Note: The APNs channel supports delivering up to 3 silent messages to a device per hour.
    Tencent Push Notification Service The Tencent Push Notification Service channel is available for the push. The Tencent Push Notification Service channel can be disabled. Notification bar messages, in-app messages, and silent messages.
    Note: The Tencent Push Notification Service channel for iOS only takes effect in iOS SDK 1.2.8.0 or later.

    Getting Started

    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 parameter channel_rules of the RESTful API. For more information, see channel_rules parameter description in the Push API document.
    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\"}"
            }
        }
    }
    
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support