厂商消息分类使用指南

消息分类说明

从 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 字段说明。

荣耀消息分类使用指南

荣耀消息分类说明

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

荣耀消息分类方式

根据荣耀官方说明：2024年12月31日前，开发者需要登录荣耀开发者服务平台申请自分类权益 ，对推送服务消息进行分类管理。若应用没有自分类权益，或应用有自分类权益但推送消息未携带 importance 字段，应用的推送消息将自动归类为资讯营销消息，详情请见荣耀消息分类方式。

荣耀消息分类使用

服务端使用

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

示例如下：

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

        

控制台使用

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

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

OPPO 消息分类使用指南

OPPO 消息分类说明

• OPPO 厂商 2024.11.20 实施OPPO消息分类新规，消息分成「通讯与服务」、「内容与营销」两大类别，分别对应极光平台「系统消息」、「运营消息」，根据对不同类别消息的关注度，OPPO官方提供对应的权限如下：

OPPO 推送数量限制

OPPO 消息分类使用

• Step1：服务端关注（classification、channel_id、category、notify_level）4个字段，详细字段说明如下，或查看极光 Push API 文档。
  
• Step2：配置推送消息时携带以上字段，消息以对应提醒方式下发。
  

示例如下：

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

        

控制台使用

• 私信消息需要选择“系统消息”，具体请您根据实际情况正确选择。

• 填写 OPPO 消息分类参数，确保数据填写正确。

vivo 消息分类使用指南

vivo 消息分类说明

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

vivo 系统消息使用

1．通过 API 传入相应参数
特别注意：通过 API 接口支持消息分类，下发 classification 参数，该参数在 options 可选参数字段下。完整分类字段有2个，如下说明：

示例如下：

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

        

控制台使用

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

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

2．智能分类二次修正

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