1. 产品概述
本功能支持将神策系统内的用户分群同步至 极光
适用版本：SA 3.0.4 及以上版本。
前置说明：使用该功能前，需先开通「国内人群包推送」，并安装对应平台插件。完成插件配置后，即可在分群页面创建推送任务，选择 极光V2 作为目标渠道，提交人群包推送。
2. 推送至极光前准备工作
在神策后台创建 极光v2 的推送连接前，需先完成极光平台侧准备，并获取推送人群包目标应用的以下字段：
- AppKey
-
MasterSecret
以上字段用于创建极光推送连接和完成接口鉴权。
注：极光页面菜单名称可能因账号类型、页面版本或语言设置不同而略有差异，请以实际页面展示为准
2.1 获取 AppKey、Master Secret
-
登录 极光工作台：
-
已有应用
- 方式一：点击右上角 应用管理，进入应用列表。在应用列表中找到需要配置人群包推送的 目标应用。点击操作列的 设置&秘钥 后进入 应用设置 页面，在应用信息中查看并复制 APP key 、Master Secret
- 方式二：在 我的应用 中选择目标应用，点击进入 应用设置 页面，在应用信息中查看并复制 APP key 、Master Secret
- 新应用：点击右上角 +创建应用 ，进入创建流程，创建后复制 APP key 、Master Secret 即可
注：请勿将 AppKey、Master Secret 暴露给无关人员或写入公开文档。
3. 操作步骤
3.1 创建推送通道/连接
完成极光平台侧授权准备后，可在神策后台创建 极光v2渠道 推送连接
在「数据管理」→「通用数据集成」→「数据源管理」，找到「受众推送」分类。在受众推送平台列表中选择「极光v2」，点击进入 极光v2连接管理 页面。
点击 极光v2 连接管理 页面右上角 创建，在弹出的 添加连接 抽屉中填写配置项如下：
- 连接名称：自定义填写便于识别的名称，例如：品牌海外推广
- app_key：对应极光 AppKey，从极光平台侧获取
- app_secret_key ：对应极光 Master Secret，从极光平台侧获取
- 字段映射/推送字段：定义神策侧用户标识字段与目标平台用户识别字段之间的对应关系。推送时，系统会从分群结果中提取所选神策字段的值，并按照配置的映射关系写入目标平台字段，用于目标平台识别和匹配用户。
- 神策字段名称：可选string类型的用户属性、支持string类型的虚拟用户属性
- 极光字段名称：仅支持 极光id
完成填写后，点击 测试连接。测试通过后，点击 提交，完成 极光渠道 推送连接创建。
3.2 创建推送任务
3.2.1 立即推送
立即推送用于将已经计算好的分群结果推送至目标平台。
在 分群管理 -> 分群详情 -> 分群历史详情中，选择一条计算成功的分群版本，点击操作列中的 立即推送。
点击 立即推送 后，打开 创建推送 抽屉，配置项如下：
- 推送名称：默认使用当前分群名称，用于识别本次推送。不可修改。
- 分群版本：当前选择的分群历史版本时间。不可修改。
- 分群结果数：当前分群版本的用户数。不可修改。
- 推送通道：选择已配置的 极光v2 通道
- 字段映射 / 推送字段：字段配置支持以下方式：
- 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
- 可推送结果数预估：完成必填配置后，点击
预估查看可推送结果数，用于判断当前分群历史版本中实际满足目标平台推送要求的用户数量。建议提交前执行
3.2.2 推送设置（开启推送 / 编辑）
创建或编辑分群时开启推送，用于在分群计算完成后自动按已配置规则执行推送。
可在 分群管理 -> 创建分群 中，点击 推送设置中的开启推送 ；也可在 分群管理 -> 分群详情 中，点击 推送设置中的编辑。具体入口以当前产品页面为准
点击 推送设置中的开启推送/编辑后，进行 推送配置 ，配置项如下：
- 推送通道：选择已配置的极光通道
- 字段映射 / 推送字段：字段配置支持以下方式：
- 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
3.3 查看推送任务
3.3.1 在分群详情页查看
可在 分群管理 -> 分群详情 -> 推送记录 中，查看该分群对应的推送任务及执行结果。
适用场景：适用于查看单个分群的推送记录及执行结果。
3.3.2 在推送任务页查看
可在 数据管理 -> 通用数据集成 -> 推送任务 中，搜索、查看、管理推送任务
适用场景：适用于统一查看全部分群的推送任务。
3.4 在极光后台中查看人群包
