个推接入指引

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

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

本文用于说明将神策人群包推送到个推前，需要提前准备的信息。

1. 适用场景

适用于将神策分群同步到个推，供后续消息触达运营使用。推送成功后，可在个推后台查看对应应用标签。

 

2. 接入前准备

在神策中创建 个推v2 推送连接前，请先由个推应用管理员准备以下信息。

说明：App ID、APP key、Master Secret 必须来自同一个个推应用。若三者不匹配，连接测试或推送任务可能失败。

 

3. 平台侧准备

1. 登录个推开发者中心  ，进入目标应用。
2. 获取并记录 app_id、app_key、Master Secret。
3. 确认应用凭证具备标签同步所需权限。

 

4. 神策侧操作步骤

4.1 创建推送通道/连接

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

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

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

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

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

 

4.2 创建推送任务

4.2.1 立即推送

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

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

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

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

 

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

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

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

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

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

 

4.3 查看推送任务

3.3.1 在分群详情页查看

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

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

 

4.3.2 在推送任务页查看

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

 

4.4 在个推后台中查看人群包