适用版本：SA 3.0.4 及以上版本。
前置说明：使用该功能前，需先开通「国内人群包推送」，并安装对应平台插件。完成插件配置后，即可在分群页面创建推送任务，选择 小米V2 作为目标渠道，提交人群包推送。
本文用于说明将神策人群包推送到小米前，需要提前准备的信息。
1. 适用场景
适用于将神策分群同步到小米消息触达通道，供后续触达运营使用。小米为直接推送，不支持在小米后台查看人群包。
2. 接入前准备
在神策中创建 小米v2 推送连接前，请先由小米应用管理员准备以下信息。
| 准备项 | 由谁准备 | 权限要求 | 用途 | 在神策中填写 |
|---|---|---|---|---|
| AppSecret | 小米应用管理员 | 需具备目标小米应用的管理权限，并可查看应用服务端鉴权密钥 | 用于小米接口调用鉴权 | app_secret_key |
说明：AppSecret 需来自目标应用。若 AppSecret 与实际要推送的应用不一致，连接测试或推送任务可能失败。
3. 平台侧准备
获取 AppSecret 步骤
- 使用 开发者账号 （需要完成企业开发者认证）登录小米开放平台。
- 进入「管理控制台」。
- 在「应用服务」中选择「PUSH服务 / 消息推送」，进入小米推送运营平台。
- 在应用列表中选择需要配置推送的 App。
- 若该 App 尚未启用推送服务，先点击「启用推送」完成开通。
- 进入该 App 的「应用信息」页面。
- 在应用信息中查看并复制 AppSecret，该值即为神策配置中需要填写的 app_secret_key。
补充说明
- AppID、AppKey 用于客户端识别应用。一个小米应用通常对应一个 AppSecret。如客户存在多个 App、测试/正式 App 或多端应用，请选择本次人群包推送目标 App 对应的 AppSecret。
- AppSecret 用于服务端鉴权和消息下发，在神策中通常对应 app_secret_key。
- 若无法查看 AppSecret，请确认当前账号是否具备目标应用管理权限。
- 请勿将 AppSecret/app_secret_key 暴露给无关人员或写入公开文档。
4. 神策侧操作步骤
4.1 创建推送通道/连接
操作路径：进入「数据管理 -> 通用数据集成 -> 数据源管理」，在「受众推送」分类下选择小米v2。
点击 小米v2 连接管理 页面右上角 创建，在弹出的 添加连接 抽屉中填写配置项如下：
- 连接名称：自定义填写便于识别的名称，例如：品牌海外推广
- app_secret_key ：对应小米推送平台中的 AppSecret，需要从小米平台侧获取
- 字段映射/推送字段：定义神策侧用户标识字段与目标平台用户识别字段之间的对应关系。推送时，系统会从分群结果中提取所选神策字段的值，并按照配置的映射关系写入目标平台字段，用于目标平台识别和匹配用户。
- 神策字段名称：可选string类型的用户属性、支持string类型的虚拟用户属性
- 小米名称：仅支持 小米id
完成填写后，点击 测试连接。测试通过后，点击 提交，完成 小米渠道 推送连接创建。
4.2 创建推送任务
4.2.1 立即推送
立即推送用于将已经计算好的分群结果推送至目标平台。
在 分群管理 -> 分群详情 -> 分群历史详情中，选择一条计算成功的分群版本，点击操作列中的 立即推送。
点击 立即推送 后，打开 创建推送 抽屉，配置项如下：
- 推送名称：默认使用当前分群名称，用于识别本次推送。不可修改。
- 分群版本：当前选择的分群历史版本时间。不可修改。
- 分群结果数：当前分群版本的用户数。不可修改。
- 推送通道：选择已配置的小米通道
- 字段映射 / 推送字段：字段配置支持以下方式：
- 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
- 可推送结果数预估：完成必填配置后，点击
预估查看可推送结果数，用于判断当前分群历史版本中实际满足目标平台推送要求的用户数量。建议提交前执行
4.2.2 推送设置（开启推送 / 编辑）
创建或编辑分群时开启推送，用于在分群计算完成后自动按已配置规则执行推送。
可在 分群管理 -> 创建分群 中，点击 推送设置中的开启推送 ；也可在 分群管理 -> 分群详情 中，点击 推送设置中的编辑。具体入口以当前产品页面为准
点击 推送设置中的开启推送/编辑后，进行 推送配置 ，配置项如下：
- 推送通道：选择已配置的小米通道
- 字段映射 / 推送字段：字段配置支持以下方式：
- 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
4.3 查看推送任务
4.3.1 在分群详情页查看
可在 分群管理 -> 分群详情 -> 推送记录 中，查看该分群对应的推送任务及执行结果。
适用场景：适用于查看单个分群的推送记录及执行结果。
4.3.2 在推送任务页查看
可在 数据管理 -> 通用数据集成 -> 推送任务 中，搜索、查看、管理推送任务
适用场景：适用于统一查看全部分群的推送任务。
5 常见问题
5.1 老版本小米和新版本小米 v2 插件有什么区别？
老版与 v2 插件的推送目标一致，都是将神策分群人群同步至小米、极光、个推等平台。核心差异在于推送通道的配置与管理方式。
- 老版插件：需要通过命令行安装插件，并在服务端配置推送通道。配置和调整通常依赖技术人员操作，业务人员无法直接在页面中维护。
- v2 插件：安装插件后，可在神策后台页面中创建、测试和管理推送通道。业务人员可在界面中完成通道配置，后续维护更方便。
后续老版插件不在维护，请及时联系神策工作人员开通安装 v2 版本插件