厂商消息分类使用指南

消息分类说明

从 Android 8.0（API 级别 26）开始，所有消息都必须通过相应的渠道 ID（ChannelID）进行下发。目前，为了改善终端用户推送体验、营造良好可持续的通知生态，各厂商会根据消息的内容对推送消息进行分类管理，不同的消息分类主要通过渠道 ID（ChannelID）进行区分。目前消息主要分为以下两类：

极光通道消息分类使用

若您需要根据推送内容对消息进行分类管理，可以自定义 Channel ID。

• ​创建客户端自定义渠道。
• 推送时下发对应的渠道 ID。

channel_id 参数在 notification 的 android 字段下。

示例如下：

          {
    "platform": "all",
    "audience": {
        "registration_id": [
            "1104a8979278ae64e75"
        ]
    },
    "notification": {
        "android": {
            "alert": "message alert",
            "channel_id": "your channel_id"
        }
    }
}

        

• 若您需要下发厂商通道重要级别消息，请参考下文各个厂商消息分类的使用指南。

小米消息分类使用指南

小米消息分类说明

根据《小米推送消息分类新规》，小米推送将消息分为“私信消息”和“公信消息”两个类别，若应用选择不接入私信或公信，则消息推送会失败。

注意：根据 小米推送消息分类新规，已经没有默认消息分类了，开发者必须根据官方新规接入消息分类，迁移至新channel下发。也就是说，推送时必须传递 channel_id 字段，否则厂商会返回推送失败错误，极光会当「参数错误」类型，阶段2的折损处理。

小米重要级别消息申请

申请方式请参见小米官方文档 channel 申请及接入方法。

注意：必须要收到审核通过的邮件才能使用私信功能！且在推送时，您必须传递 channel_id 字段，否则厂商会返回推送失败错误，极光会当「参数错误」类型，阶段2的折损处理。

小米消息分类使用

服务端使用

channel_id 参数在 options 的 third_party_channel 字段下。

示例如下：

          {
    "options": {
        "classification":1,
        "third_party_channel": {
            "xiaomi": {
                "channel_id": "小米推送平台登记的 channel id"
            }
        }
    }
}

        

控制台使用

• 私信消息需要选择“系统消息”。

• 填写小米推送平台登记的 channel id。

华为消息分类使用指南

华为消息分类说明

根据消息内容，华为推送将通知分类为服务与通讯、资讯营销两大类别，并对不同类别消息的提醒方式、消息样式进行差异化管理，具体如下：

华为消息分类方式

华为分类标准
从2023年9月15日开始，华为推送服务将基于《华为消息分类标准》将通知分为「云端通知」和「本地通知」，具体参考 华为消息分类管理方案。

华为消息分类「云端通知」使用方式

「云端通知」服务端使用

消息分类的申请审核通过后，即可指定 importance 进行下发，
该参数在 options 可选参数的 third_party_channel 字段下。

代码示例如下：

          {
    "options": {
        "classification":1,
        "third_party_channel": {
            "huawei": {
                "importance": "NORMAL",
                "category":"IM"
            }
        }
    }
}

        

「云端通知」控制台使用

• 服务与通讯消息需要选择“系统消息”。

华为消息分类「本地通知」使用方式

「本地通知」服务端使用

指定 category 进行下发，
该参数是 notification.android 可选参数。

代码示例如下：

          {
    "notification": {
        "android": {
            "alert": "Hi, JPush!",
            "title": "Send to Android",
            "category": "CATEGORY_NAVIGATION",
            "priority": "0"
        }
    }
}

        

「本地通知」控制台使用

华为消息分类对应表

随着应用的消息发送场景不断变化，华为推送的分类标准会不断演进和补充，请及时留意华为官方文档最新的分类说明，参考 消息分类标准 查询。
云端通知 importance 取值规则可参考上文 “华为消息分类「云端通知」使用方式” 中 importance 字段说明。

荣耀消息分类使用指南

荣耀消息分类说明

根据消息内容，荣耀推送将通知分类为服务与通讯、资讯营销两大类别，并对不同类别消息的提醒方式、消息样式进行差异化管理，具体如下：

荣耀消息分类方式

消息智能分类
智能算法将根据 APP 类型和消息内容等维度，自动将您的消息按照分类标准进行归类。
消息自分类
允许开发者根据消息分类规范，自行对消息进行分类。
目前，所有消息默认通过消息自分类方式进行分类处理，荣耀推送服务将充分信任您提供的分类结果，并且按您提供的分类结果展示对应信息。随着荣耀推送服务能力的不断补充和演进，分类方式也会逐渐更新与升级，请及时留意本文档最新的分类方式说明。

荣耀消息分类使用

服务端使用

指定 importance 进行下发，该参数在 options 可选参数的 third_party_channel 字段下。

示例如下：

          {
    "options": {
        "classification":1,
        "third_party_channel": {
            "honor": {
                "importance": "NORMAL"
            }
        }
    }
}

        

控制台使用

• 服务与通讯消息需要选择“系统消息”。

• 服务与通讯消息需要设置 importance 为 NORMAL。

OPPO 消息分类使用指南

OPPO 消息分类说明

OPPO 私信通道申请

1.私信通道权益申请。
2.私信申请邮件通过后，需要在 OPPO 推送平台上登记该通道，并将通道对应属性设置为“私信”。

注意：必须要收到审核通过的邮件才能使用私信功能！

OPPO 私信通道使用

1.创建客户端自定义渠道，channel_id 须与OPPO 官网登记的通道 ID 一致。
2.API 推送。

channel_id 参数在 options 的 third_party_channel 字段下。

示例如下：

          {
    "options": {
        "classification":1,
        "third_party_channel": {
            "oppo": {
                "channel_id": "OPPO 官网登记的通道 ID"
            }
        }
    }
}

        

控制台使用

• 私信消息需要选择“系统消息”。

• 填写 OPPO 官网登记的通道 ID。

vivo 消息分类使用指南

vivo 消息分类说明

• 通知开启的有效用户：应用集成的 push-sdk 订阅成功，且设备近 14 天内有联网的通知权限开启用户。
• 通知开启有效用户数＜10000，则运营消息量级默认为 10000。
• 通知开启的有效用户数及可发送运营消息量级，可在推送运营后台查询。
• 推送限额数以“到达量”计算，当日到达量超限则计入管控。
• 测试消息不受量级和频控限制。发送测试消息时注意填写 pushMode=1（0：正式推送；1：测试推送；不填默认为 0）。若未填写，则文案相同时，将被当做重复运营消息被去重。

vivo 系统消息使用

1．通过 API 传入相应参数
系统消息只能通过 API 接口创建，控制台暂不支持此功能。API 接口下发 classification 参数，该参数在 options 可选参数的 third_party_channel 字段下。

示例如下：

          {
    "options": {
        "classification":1,
        "third_party_channel": {
            "vivo": {
                "distribution": "secondary_push",
                "category":"IM"
            }
        }
    }
}

        

控制台使用

• 系统消息需要选择“系统消息”。

• 配置符合 vivo 分类标准的 category。

2．智能分类二次修正

• 参数传"0"代表运营消息，不经过智能分类二次修正，直接从运营消息总量扣除额度，并受用户接收条数限制的频控。
• 参数传"1"代表系统消息，经过智能分类二次修正，若智能分类识别出不是系统消息，会自动修正为运营消息，并扣除运营消息额度；若识别为系统消息，则从系统消息总量扣除额度。