人群包推送到小米

1.  产品概述

适用版本：SA 3.0.4 及以上版本。

前置说明：使用该功能前，需先开通「国内人群包推送」，并安装对应平台插件。完成插件配置后，即可在分群页面创建推送任务，选择 小米V2 作为目标渠道，提交人群包推送。

 

2. 推送至小米前准备工作

在神策后台创建 小米v2 推送连接前，需先完成小米平台侧准备，并获取推送人群包目标应用的以下字段：

• AppSecret

注：小米页面菜单名称可能因账号类型、页面版本或语言设置不同而略有差异，请以实际页面展示为准

 

2.1 获取 AppSecret

获取步骤

1. 使用 开发者账号 （需要完成企业开发者认证）登录小米开放平台。
2. 进入「管理控制台」。
3. 在「应用服务」中选择「PUSH服务 / 消息推送」，进入小米推送运营平台。
4. 在应用列表中选择需要配置推送的 App。
5. 若该 App 尚未启用推送服务，先点击「启用推送」完成开通。
6. 进入该 App 的「应用信息」页面。
7. 在应用信息中查看并复制 AppSecret，该值即为神策配置中需要填写的 app_secret_key。

补充说明

• AppID、AppKey 用于客户端识别应用。一个小米应用通常对应一个 AppSecret。如客户存在多个 App、测试/正式 App 或多端应用，请选择本次人群包推送目标 App 对应的 AppSecret。
• AppSecret 用于服务端鉴权和消息下发，在神策中通常对应 app_secret_key。
• 若无法查看 AppSecret，请确认当前账号是否具备目标应用管理权限。
• 请勿将 AppSecret/app_secret_key 暴露给无关人员或写入公开文档。

 

3. 操作步骤

3.1 创建推送通道/连接

完成小米平台侧授权准备后，可在神策后台创建 小米v2渠道 推送连接

在「数据管理」→「通用数据集成」→「数据源管理」，找到「受众推送」分类。在受众推送平台列表中选择「小米v2」，点击进入 小米v2连接管理 页面。

点击 小米v2 连接管理 页面右上角 创建，在弹出的 添加连接 抽屉中填写配置项如下：

1. 连接名称：自定义填写便于识别的名称，例如：品牌海外推广
2. app_secret_key ：对应小米推送平台中的 AppSecret，需要从小米平台侧获取
3. 字段映射/推送字段：定义神策侧用户标识字段与目标平台用户识别字段之间的对应关系。推送时，系统会从分群结果中提取所选神策字段的值，并按照配置的映射关系写入目标平台字段，用于目标平台识别和匹配用户。
   1. 神策字段名称：可选string类型的用户属性、支持string类型的虚拟用户属性
   2. 小米名称：仅支持 小米id

完成填写后，点击 测试连接。测试通过后，点击 提交，完成 小米渠道 推送连接创建。

 

3.2 创建推送任务

3.2.1 立即推送

立即推送用于将已经计算好的分群结果推送至目标平台。

在 分群管理 -> 分群详情 -> 分群历史详情中，选择一条计算成功的分群版本，点击操作列中的 立即推送。

点击 立即推送 后，打开 创建推送 抽屉，配置项如下：

1. 推送名称：默认使用当前分群名称，用于识别本次推送。不可修改。
2. 分群版本：当前选择的分群历史版本时间。不可修改。
3. 分群结果数：当前分群版本的用户数。不可修改。
4. 推送通道：选择已配置的小米通道
5. 字段映射 / 推送字段：字段配置支持以下方式：
   1. 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
   2. 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
6. 可推送结果数预估：完成必填配置后，点击 预估 查看可推送结果数，用于判断当前分群历史版本中实际满足目标平台推送要求的用户数量。建议提交前执行

 

3.2.2 推送设置（开启推送 / 编辑）

创建或编辑分群时开启推送，用于在分群计算完成后自动按已配置规则执行推送。

可在 分群管理 -> 创建分群 中，点击 推送设置中的开启推送 ；也可在 分群管理 -> 分群详情 中，点击 推送设置中的编辑。具体入口以当前产品页面为准

点击 推送设置中的开启推送/编辑后，进行 推送配置 ，配置项如下：

1. 推送通道：选择已配置的小米通道
2. 字段映射 / 推送字段：字段配置支持以下方式：
   1. 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
   2. 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。

 

3.3 查看推送任务

3.3.1 在分群详情页查看

可在 分群管理 -> 分群详情 -> 推送记录 中，查看该分群对应的推送任务及执行结果。

适用场景：适用于查看单个分群的推送记录及执行结果。

 

3.3.2 在推送任务页查看

可在 数据管理 -> 通用数据集成 -> 推送任务 中，搜索、查看、管理推送任务

 

 

4 常见问题

4.1 老版本小米和新版本小米 v2 插件有什么区别？

老版与 v2 插件的推送目标一致，都是将神策分群人群同步至小米、极光、个推等平台。核心差异在于推送通道的配置与管理方式。

• 老版插件：需要通过命令行安装插件，并在服务端配置推送通道。配置和调整通常依赖技术人员操作，业务人员无法直接在页面中维护。
• v2 插件：安装插件后，可在神策后台页面中创建、测试和管理推送通道。业务人员可在界面中完成通道配置，后续维护更方便。

后续老版插件不在维护，请及时联系神策工作人员开通安装 v2 版本插件