厂商消息分类使用指南
最近更新:2023-03-22
展开全部

厂商消息分类使用指南

消息分类说明

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

消息类型 重要级别消息 普通级别消息
推送内容 即时通讯消息、个人关注动态提醒、个人事项提醒、个人订单状态变化、个人财务提醒、等个人重要通知提醒。 热点新闻、新品推广、平台公告、社区话题、有奖活动等,多为用户普适性的内容。

极光通道消息分类使用

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

channel_id 参数在 notification 的 android 字段下。

关键字 类型 选项 含义 说明
channel_id string 可选 android 通知 channel_id 不超过1000字节,这里根据 Channel ID 来指定通知栏展示效果。

示例如下:

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

        
此代码块在浮窗中显示
  • 若您需要下发厂商通道重要级别消息,请参考下文各个厂商消息分类的使用指南。

小米消息分类使用指南

小米消息分类说明

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

消息类型 公信消息 私信消息
推送内容 热点新闻、新品推广、平台公告、社区话题、有奖活动等,多用户普适性的内容。 聊天消息、个人订单变化、快递通知、交易提醒、IoT 系统通知等与私人通知相关的内容。
提醒方式 响铃、振动
推送数量限制 2-3 倍,具体规则请参见“公信限制规则 不限量
用户接收数量限制 单个应用单个设备单日 5-8 条 不限量
申请方式 需在小米推送平台申请,详情请参见 channel 申请及接入方式
API 调用 - 极光会按照消息分类自动判断是否需要扣除配额,建议使用 API 下发时,设置 options.classification 为 1,详见 REST API 文档

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

小米重要级别消息申请

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

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

小米消息分类使用

服务端使用

channel_id 参数在 options 的 third_party_channel 字段下。

关键字 类型 选项 含义 父项目 说明
classification int 可选 消息类型分类 options 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。
  • 0:代表运营消息。
  • 1:代表系统消息。
  • channel_id string 可选 android 通知 channel_id options.third_party_channel.xiaomi
  • 不超过 1000 字节,Android 8.0 开始可以进行 NotificationChannel 配置,这里根据 channel ID 来指定通知栏展示效果。
  • android 下也有 channel_id 字段,对极光通道及支持的厂商通道均生效。
  • 若本字段没有填充,则使用 android 里面定义的 channel id 字段。若本字段有填充,则优先使用本字段。
  • 示例如下:

    { "options": { "classification":1, "third_party_channel": { "xiaomi": { "channel_id": "小米推送平台登记的 channel id" } } } }
              {
        "options": {
            "classification":1,
            "third_party_channel": {
                "xiaomi": {
                    "channel_id": "小米推送平台登记的 channel id"
                }
            }
        }
    }
    
            
    此代码块在浮窗中显示

    控制台使用

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

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

    华为消息分类使用指南

    华为消息分类说明

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

    消息类型 服务与通讯 资讯营销
    推送内容 包括社交通讯类消息和服务提醒类消息。 包括资讯类消息和营销类消息,指的是运营人员向用户发送的活动信息、内容推荐、资讯等。
    提醒方式(EMUI 10.0及以上) 锁屏、铃声、振动 静默通知,仅在下拉通知栏展示消息
    消息样式 文本+小图 仅有文本
    推送数量 不限量 2023 年 01 月 05 日 起,资讯营销类消息根据应用类型对每日推送数量进行上限管理,具体要求参见 不同应用类别的推送数量上限要求
    配置方式 需要向华为申请自分类权益,审核通过后将信任开发者提供的分类信息,消息不经过智能分类。 默认

    华为消息分类方式

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

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

    「云端通知」服务端使用

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

    关键字 类型 选项 含义 父项目 说明
    classification int 可选 消息类型分类 options 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。
  • 0:代表运营消息。
  • 1:代表系统消息。
  • importance string 可选 华为通知栏消息智能分类 options.third_party_channel.huawei
  • 取值为"LOW"时,表示消息为资讯营销。
  • 取值为"NORMAL"时,表示消息为服务与通讯。
  • 说明1:华为从 2023.09.15 开始基于《华为消息分类标准》对其云端通知和本地通知进行共同管控推送,开发者通过极光服务发起推送时,请注意此字段传值要符合华为官方「云端通知 importance」取值要求,要和「华为云端通知 category」取值要求对应。
  • category string 可选 华为厂商消息场景标识 options.third_party_channel.huawei 为了适配华为手机厂商消息,完成自分类权益申请 后,用于标识消息类型,确定消息提醒方式,对特定类型消息加快发送。对应值及其说明参考 category 值说明
  • 若应用没有自分类权益,或应用有自分类权益但推送消息不携带 category 字段,则应用的推送消息将通过智能分类进行自动归类。
  • 若应用有自分类权益且推送消息携带category字段,将信任开发者提供的分类信息,消息不经过智能分类。
  • 说明:华为从 2023.09.15 开始基于《华为消息分类标准》对其云端通知和本地通知进行共同管控推送,开发者通过极光服务发起推送时,请注意此字段传值要符合华为官方「华为云端通知 category」取值要求。
  • 代码示例如下:

    { "options": { "classification":1, "third_party_channel": { "huawei": { "importance": "NORMAL", "category":"IM" } } } }
              {
        "options": {
            "classification":1,
            "third_party_channel": {
                "huawei": {
                    "importance": "NORMAL",
                    "category":"IM"
                }
            }
        }
    }
    
            
    此代码块在浮窗中显示

    「云端通知」控制台使用

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

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

    「本地通知」服务端使用

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

    关键字 类型 选项 含义 父项目 说明
    category string 可选 通知栏消息分类条目 notification.android
  • 说明1:华为从 2023.09.15 开始基于《华为消息分类标准》 对其本地通知进行管控推送,参考:《华为本地通知频次及分类管控通知》 ,此字段值对应「本地通知」category取值,开发者通过极光服务发起推送时如果传递了此字段值,请务必按照华为官方要求传递,极光会自动适配华为本地通知importance取值,无需开发者额外处理。
  • 说明2:考虑到一次推送包含多个厂商用户的情况,建议此处传递的字段值要和您APP开发代码中创建的channel效果对应(category值一致),最好创建新的channelId,避免曾经已经创建了无法修改。
  • priority string 可选 通知栏展示优先级 notification.android
  • 默认为 0,范围为 -2~2。
  • 说明1:华为从 2023.09.15 开始基于《华为消息分类标准》 对其本地通知进行管控推送,参考:《华为本地通知频次及分类管控通知》 ,开发者通过极光服务发起推送时,如果有传递此字段值,请注意此字段要和 category 同时使用;反之,如果传了category,没传递此值时极光会自动帮您适配处理优先级。
  • priority = -2 时,对应华为本地通知 importance 级别为 IMPORTANCE_MIN;priority = 0 时,对应华为本地通知 importance 级别为 IMPORTANCE_DEFAULT。
  • 代码示例如下:

    { "notification": { "android": { "alert": "Hi, JPush!", "title": "Send to Android", "category": "CATEGORY_NAVIGATION", "priority": "0" } } }
              {
        "notification": {
            "android": {
                "alert": "Hi, JPush!",
                "title": "Send to Android",
                "category": "CATEGORY_NAVIGATION",
                "priority": "0"
            }
        }
    }
    
            
    此代码块在浮窗中显示

    「本地通知」控制台使用

    华为消息分类对应表

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

    消息类型/一级分类 消息类型/二级分类 消息类型/三级分类 云端通知category取值 本地通知category取值 本地通知importance取值
    服务与通讯类 社交通讯 即时聊天 IM CATEGORY_MESSAGE IMPORTANCE_DEFAULT
    服务与通讯类 社交通讯 音频、视频通话 VOIP CATEGORY_CALL IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 订阅 SUBSCRIPTION - -
    服务与通讯类 服务提醒 出行 TRAVEL CATEGORY_NAVIGATION IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 健康 HEALTH - -
    服务与通讯类 服务提醒 工作事项提醒 WORK CATEGORY_REMINDER IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 帐号动态 ACCOUNT - -
    服务与通讯类 服务提醒 订单&物流 EXPRESS - -
    服务与通讯类 服务提醒 财务 FINANCE CATEGORY_SERVICE IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 设备提醒 DEVICE_REMINDER - -
    服务与通讯类 服务提醒 邮件 MAIL CATEGORY_EMAIL IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 闹钟/计时器 - CATEGORY_ALARM IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 秒表 - CATEGORY_STOPWATCH IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 进度 - CATEGORY_PROGRESS IMPORTANCE_DEFAULT
    服务与通讯类 服务提醒 位置共享 - CATEGORY_LOCATION_SHARING IMPORTANCE_DEFAULT
    资讯营销类 内容资讯 内容推荐 MARKETING CATEGORY_RECOMMENDATION IMPORTANCE_MIN
    资讯营销类 内容资讯 新闻 MARKETING CATEGORY_RECOMMENDATION IMPORTANCE_MIN
    资讯营销类 内容资讯 财经动态 MARKETING CATEGORY_RECOMMENDATION IMPORTANCE_MIN
    资讯营销类 内容资讯 生活资讯 MARKETING CATEGORY_RECOMMENDATION IMPORTANCE_MIN
    资讯营销类 内容资讯 社交动态 MARKETING CATEGORY_SOCIAL IMPORTANCE_MIN
    资讯营销类 内容资讯 调研 MARKETING CATEGORY_PROMO IMPORTANCE_MIN
    资讯营销类 内容资讯 其他 MARKETING CATEGORY_PROMO IMPORTANCE_MIN
    资讯营销类 营销活动 产品促销 MARKETING CATEGORY_PROMO IMPORTANCE_MIN
    资讯营销类 营销活动 功能推荐 MARKETING CATEGORY_PROMO IMPORTANCE_MIN
    资讯营销类 营销活动 运营活动 MARKETING CATEGORY_PROMO IMPORTANCE_MIN

    荣耀消息分类使用指南

    荣耀消息分类说明

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

    消息类型 服务与通讯 资讯营销
    推送内容 包括社交通讯类消息和服务提醒类消息。 包括资讯类消息和营销类消息,指的是运营人员向用户发送的活动信息、内容推荐、资讯等。
    提醒方式 锁屏展示+下拉通知栏展示,支持铃声、震动 静默通知,仅在下拉通知栏展示消息
    消息样式 文本+小图 仅有文本
    推送数量 不限量 资讯营销类消息根据应用类型对每日推送数量进行上限管理,
  • 新闻类(三级分类为新闻类):5 条
  • 其他应用类型:2 条。
    具体要求参见 不同应用类别的推送数量上限要求
  • REST API 配置
  • 设置 options.classification 为 1
  • 指定 importance 为 normal
  • 指定 importance 为 low

    荣耀消息分类方式

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

    荣耀消息分类使用

    服务端使用

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

    关键字 类型 选项 含义 父项目 说明
    classification int 可选 消息类型分类 options 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。
  • 0:代表运营消息。
  • 1:代表系统消息。
  • importance string 可选 荣耀通知栏消息智能分类 options.third_party_channel.honor
  • 取值为"LOW"时,表示消息为资讯营销。
  • 取值为"NORMAL"时,表示消息为服务与通讯。
  • 示例如下:

    { "options": { "classification":1, "third_party_channel": { "honor": { "importance": "NORMAL" } } } }
              {
        "options": {
            "classification":1,
            "third_party_channel": {
                "honor": {
                    "importance": "NORMAL"
                }
            }
        }
    }
    
            
    此代码块在浮窗中显示

    控制台使用

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

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

    OPPO 消息分类使用指南

    OPPO 消息分类说明

    • OPPO 厂商 2024.11.20 实施OPPO消息分类新规,消息分成「通讯与服务」、「内容与营销」两大类别,分别对应极光平台「系统消息」、「运营消息」,根据对不同类别消息的关注度,OPPO官方提供对应的权限如下:
    消息类型 定义范围 推送内容方向 提醒方式 推送量级
    通讯与服务 1、用户间的聊天消息、通话等信息;
    2、与用户自身息息相关的重要通知提醒,用户对接收此类消息有预期;
    1、用户间点对点聊天消息(或私信)、群聊天消息、视频语音提醒;
    2、个人账号与资产变化;个人设备提醒;个人订单/物流状态变化等;
    默认为<通知栏、锁屏>;可升级为<通知栏、锁屏、横幅、铃声、震动>强提醒方式(需找OPPO官方申请); 发送量级和接收量级均不限
    内容与营销 开发者主动向用户发送的对内容或产品推广的通知 内容推荐、平台活动、社交动态等; 仅下拉通知栏展示 限制每日推送量级与单用户接收条数,具体参考:《推送服务受限说明》

    OPPO 推送数量限制

    推送权限 消息分类 应用类别 推送总量 单设备推送条数限制
    正式权限 通讯与服务(原私信消息) / 不限量 不限量
    内容与营销(原公信消息) 新闻类(三级分类为新闻类) 累计用户数 < 10000,总量按20000/日计算;累计用户数≥10000,总量=累计用户数*2/日; 5条
    其他应用类型 2条
    测试权限 通讯与服务(原私信消息) / 不支持
    内容与营销(原公信消息) / 1000 2条

    OPPO 消息分类使用

    • Step1:服务端关注(classification、channel_id、category、notify_level)4个字段,详细字段说明如下,或查看极光 Push API 文档
    • Step2:配置推送消息时携带以上字段,消息以对应提醒方式下发。
    关键字 类型 选项 含义 父项目 说明
    classification int 可选 消息类型分类 options 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。
  • 0:代表运营消息。
  • 1:代表系统消息。
  • channel_id string 可选 android 通知 channel_id options.third_party_channel.oppo
  • 为了适配小米、华为、oppo 手机厂商通知栏消息分类,由开发者自行向手机厂商申请,具体申请规则参考: 厂商消息分类使用指南
  • 注意华为数据处理位置为中国区的应用不支持该字段,详情参见 华为自定义通知渠道
  • android 下也有 channel_id 字段,若本字段有填充,则优先使用,若无填充则以 android.channel_id 的定义为准。
  • 特别注意:由于 OPPO 厂商 2024.11.20 实施OPPO消息分类新规,建议您同时填写此字段和下面的category、notify_level字段。
  • category string 可选 华为、vivo、OPPO 厂商消息场景标识 options.third_party_channel.oppo 为了适配华为、vivo、OPPO 手机厂商消息,用于标识「云端通知」消息类型,确定消息提醒方式,对特定类型消息加快发送。
  • 对应值及其说明参考:华为 category 值说明 vivo 分类标准
  • oppo category 值说明
  • 说明1:华为需完成 自分类权益申请
  • 说明2:华为从 2023.09.15 开始基于《华为消息分类标准》对其云端通知和本地通知进行共同管控推送,开发者通过极光服务发起推送时,请注意此字段传值要符合华为官方「华为云端通知 category」取值要求。
  • 说明3:vivo 具体规则参考 vivo 官方说明
  • 说明4:OPPO于2024.11.20实施消息分类新规,具体规则参考 OPPO 官方说明
  • notify_level int 可选 OPPO通知栏消息提醒等级 options.third_party_channel.oppo
  • 说明1:官方取值定义:1-通知栏、2-通知栏+锁屏、16-通知栏+锁屏+横幅+震动+铃声;请开发者按照官网定义传递,极光仅做透传处理。
  • 说明2:根据官方说明 notify_level 字段,仅对「服务与通讯类」消息生效
  • 说明3:使用notify_level参数时,category参数必传
  • 示例如下:

    { "options": { "classification":1, "third_party_channel": { "oppo": { "channel_id": "OPPO 官网登记的通道 ID" "category": "IM" "notify_level": 16 } } } }
              {
        "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)。若未填写,则文案相同时,将被当做重复运营消息被去重。
    消息类型 系统消息 运营消息
    推送内容 用户需要及时知道的消息,如:即时消息、邮件、用户设置的提醒、物流等通知。 用户关注程度较低的消息,如:内容推荐、活动推荐、社交动态等通知。
    通知栏权限
  • ​默认响铃、震动、消息外显
  • ​默认锁屏、悬浮

  • 默认无响铃、无震动、应用不存活时消息收纳进盒子
  • ​默认无悬浮、无锁屏
  • 推送数量限制 3 倍通知开启有效用户数(可邮件申请消息不限量权限,详见 推送消息限制说明)。
  • 新闻类(三级分类为新闻类):3 倍通知开启有效用户数
  • 其他类:2 倍通知开启有效用户数。
  • 用户接收数量限制 无限制
  • 新闻类(三级分类为新闻类):5 条
  • 其他类:2 条
  • 配置方式 设置 options.classification 为 1 默认

    vivo 系统消息使用

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

    关键字 类型 选项 含义 父项目 说明
    classification int 可选 消息类型分类 options 极光不对指定的消息类型进行判断或校准,会以开发者自行指定的消息类型适配 Android 厂商通道。不填默认为 0。
  • 0:代表运营消息。
  • 1:代表系统消息。
  • 请开发者特别注意正确设置此字段值,需要和 category 字段值匹配对应。
  • category string 可选 厂商消息场景标识 options.third_party_channel.vivo 为了适配 vivo 手机厂商消息,用于标识消息类型,确定消息提醒方式,对特定类型消息加快发送。对应值及其说明参考:vivo 分类标准
  • 若推送消息不携带 category 字段,vivo 厂商会默认按照运营消息类别下发,受到用户接收条数频控限制。
  • 若推送消息携带 category 字段,将信任开发者提供的分类信息,消息不经过智能分类。
  • vivo 具体生效时间和规则参考 vivo 官方说明
  • 示例如下:

    { "options": { "classification":1, "third_party_channel": { "vivo": { "distribution": "secondary_push", "category":"IM" } } } }
              {
        "options": {
            "classification":1,
            "third_party_channel": {
                "vivo": {
                    "distribution": "secondary_push",
                    "category":"IM"
                }
            }
        }
    }
    
            
    此代码块在浮窗中显示

    控制台使用

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

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

    2.智能分类二次修正

    • 参数传"0"代表运营消息,不经过智能分类二次修正,直接从运营消息总量扣除额度,并受用户接收条数限制的频控。
    • 参数传"1"代表系统消息,经过智能分类二次修正,若智能分类识别出不是系统消息,会自动修正为运营消息,并扣除运营消息额度;若识别为系统消息,则从系统消息总量扣除额度。
    文档内容是否对您有帮助?

    Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

    在文档中心打开