1. 产品概述
人群包推送用于将神策分群中的用户标识同步到外部平台。当前支持广告平台通道和消息触达通道；推送成功后，可在神策查看任务状态，并在目标平台后台查看人群包、受众或标签。
1.1 适用场景
- 广告投放：同步到 Google Ads、Meta Ads用于定向投放、排除人群或相似人群扩展。
- 消息触达：同步到小米、极光、个推，用于后续 App Push、短信或其他触达运营。
- 多平台运营：同一分群按业务需要推送到不同平台，并在神策侧统一查看任务执行结果。
1.2 支持平台范围
1.2.1 广告平台
- Google Ads、Meta Ads、TikTok Ads
1.2.2 消息触达通道
- 小米、极光、个推
2. 使用流程概述
首次使用人群包推送时，可以按以下流程完成配置：
| 步骤 | 操作 | 完成标准 |
|---|---|---|
| 1. 确认功能开通 | 确认目标平台 License、插件和账号权限已配置 | 目标平台入口可见 |
| 2. 准备平台信息 | 按目标平台要求准备 App、Token、广告账号 ID、推送字段等信息 | 平台凭证和字段信息齐全 |
| 3. 创建推送连接 | 在神策中创建目标平台推送连接并测试连接 | 连接测试通过 |
| 4. 配置角色授权 | 海外广告平台 需要为使用的角色配置推送通道和广告账号权限 | 创建任务时可选择对应广告账号 |
| 5. 创建推送任务 | 在分群中选择目标平台的推送连接、推送字段 | 推送任务提交成功 |
| 6. 查看推送结果 | 在神策查看任务状态，必要时到目标平台确认结果 | 任务成功或失败原因可定位 |
3. 接入前准备（详细步骤说明）
3.1 开通 Licence 与安装插件
使用人群包推送前，请确认当前项目已开通目标平台的人群包推送能力 Licence，并已安装对应平台插件。
- 未开通目标平台推送能力时：对应平台入口可能不可见。
- 未安装目标平台插件时：点击平台入口后，系统会提示先完成插件安装。
3.2 准备平台账号与应用凭证
不同平台需要准备的信息不同。平台接入准备步骤通常较多，且涉及大量平台页面截图，建议在各平台接入指引中维护，主文档仅保留入口和差异说明。
| 平台 | 需要准备的信息 | 准备指引 |
|---|---|---|
| Google Ads |
|
|
| Meta Ads |
|
Meta Ads 接入指引 |
| TikTok Ads |
|
TikTok Ads 接入指引 |
| 小米 |
|
小米接入指引 |
| 极光 |
|
极光接入指引 |
| 个推 |
|
个推接入指引 |
4. 创建推送连接/通道
推送通道/连接用于保存目标平台连接信息、账号信息和字段映射。完成配置后，才可在分群中创建推送任务。
操作路径：
- 进入「数据管理 -> 通用数据集成 -> 数据源管理」。
- 在「受众推送」分类下选择目标平台。
- 点击「创建」或进入平台连接管理页。
- 按页面要求填写连接名称、平台凭证、账号信息和字段映射。
- 点击「测试连接」。测试通过后，提交并启用推送通道。
字段映射/推送字段说明：创建推送任务前，需要选择目标平台可识别的用户标识字段。系统会按平台要求对字段进行格式处理和推送，不同平台可用字段以创建推送通道页面展示为准。
| 标识字段 | 常见适用平台 | 客户侧数据准备 | 神策推送前处理 |
|---|---|---|---|
| 邮箱（Email） | Google Ads、Meta Ads、TikTok Ads | 按平台要求准备邮箱字段，建议去除首尾空格并转为小写 | 推送前按平台要求检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送 |
| 手机号（Phone） | Google Ads、Meta Ads、TikTok Ads |
按平台要求准备手机号字段，建议统一使用 E.164 格式（如 +国家码手机号） |
推送前按平台要求检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送 |
| 移动广告 ID（MAID/MADID） | Meta Ads、TikTok Ads | 保持平台要求的广告 ID 格式 | 是否需要哈希处理以目标平台要求为准 |
| 推送平台 ID | 小米、极光、个推 | 保持平台要求的设备或用户 id 格式，如极光id、个推id | 以目标平台要求为准 |
示例：
- 邮箱非真实测试值：
test_user@example.com->af901a8720585d66357781387f4321f6bc8bbf467bbcbb3e595c7ed94acbd3de - 手机号非真实测试值：
+10000000000->ec29282cb39258fd1bb155db71dc219b4c9213ec9b7d13f0a9bc9fe34e1c87d0
说明：SHA256 在部分平台文档中也可能被称为“加密”或“加密上传”，本文统一称为 SHA256 哈希处理。SHA256 格式通常为 64 位十六进制字符串。请勿在文档、截图或问题排查记录中粘贴真实用户的手机号、邮箱或设备标识。
5. 配置角色授权
仅广告平台通道需要配置角色授权。消息触达通道不需要配置该授权。
广告平台授权入口：
- 进入「平台管理 -> 成员与角色 -> 角色管理」。
- 选择需要授权的角色，点击「授权对象」进入权限配置页面。
- 在列表中，找到「推送插件管理」分类，勾选 「Google Ads 推送授权 / Meta Ads 推送授权」权限项，配置对应广告平台的推送通道和广告账号权限。
- 保存后，拥有该角色的成员才可在创建推送任务时选择已授权的推送通道和广告账号。
授权规则：
| 规则 | 说明 |
|---|---|
| 推送通道授权 | 未授权的推送通道，不在创建推送任务时展示 |
| 广告账号授权 | 已授权推送通道下，未授权的广告账号不展示 |
| 授权变更影响范围 | 授权变更仅影响后续创建或执行的推送任务，不回溯修改历史任务记录 |
说明：小米、极光、个推等消息触达通道不需要配置广告平台账号授权。
6. 创建推送任务
推送任务用于将某个分群版本同步到目标平台。系统支持自动推送和手动推送。
6.1 手动推送
在分群历史详情中，可对某个已计算完成的分群版本发起手动推送。
操作路径：
- 进入「分群管理」。
- 打开目标分群详情。
- 进入分群历史详情。
- 点击「立即推送」。
- 选择推送通道、账号或平台所需字段。
- 确认后提交推送任务。
6.2 自动推送
神策分析 3.5 及以上版本支持海外广告平台的自动推送。
创建或编辑分群时开启推送，用于在分群计算完成后自动按已配置规则执行推送。
可在 分群管理 -> 创建分群 中，点击 推送设置中的开启推送 ；也可在 分群管理 -> 分群详情 中，点击 推送设置中的编辑。具体入口以当前产品页面为准
点击 推送设置中的开启推送/编辑后，进行 推送配置 ，配置项如下：
- 推送通道：选择已配置的个推通道
- 字段映射 / 推送字段：字段配置支持以下方式：
- 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
6.3 页面字段说明
创建推送任务时，页面会展示本次分群版本信息，并要求选择目标平台推送配置。
| 页面项 | 是否需配置 | 说明 |
|---|---|---|
| 推送名称 | 系统带出 | 默认使用当前分群名称，用于识别本次推送任务 |
| 分群版本 | 系统带出 | 本次任务对应的分群版本；手动推送时为当前选择的分群历史版本，自动推送时为当次例行计算成功的版本 |
| 分群结果数 | 系统带出 | 当前分群版本的用户数 |
| 推送通道 | 需选择 | 选择已创建并启用的目标平台推送通道 |
| 广告账户/应用 | 需选择 | 广告平台选择广告账户；消息触达通道无该选项 |
| 推送字段 | 需选择 | 选择目标平台支持的用户标识字段，如 Email、Phone、移动广告 ID、极光 ID、个推 ID 等 |
| 可推送结果数预估 | 系统计算 | 预估当前分群中满足 推送字段 要求、可推送到目标平台的用户数 |
说明：可推送结果数为神策侧基于字段完整性和格式规则的预估值，不等同于目标平台最终可识别或可投放的人群规模。目标平台仍可能因账号权限、字段格式、平台匹配规则或处理延迟，导致最终展示规模与预估值存在差异。
7. 查看推送结果
7.1 在神策查看任务状态
推送任务创建后，可在神策侧（分群>推送详情>推送记录 / 数据管理 > 通用数据集成 >推送任务）查看任务执行状态、推送人数、失败原因等信息。任务状态以页面展示为准。
| 状态 | 说明 |
|---|---|
| 等待中 | 任务已创建，等待执行 |
| 推送中 | 系统正在向目标平台推送数据 |
| 成功 | 目标平台已接收本次推送 |
| 失败 | 推送未成功，需查看失败原因 |
| 部分成功 | 部分子任务成功，部分子任务失败，需查看明细 |
失败任务支持在有效期内（3天）手动重试。若失败原因是授权失效、账号权限不足或平台凭证错误，请先修复连接配置后再重试。
7.2. 在广告平台查看结果
推送成功后，可在神策侧查看任务状态。除小米外，其他平台可在目标平台后台查看对应的人群包、受众或标签。平台侧通常存在处理延迟，若神策显示推送成功但平台侧暂未展示，请稍后刷新平台后台。
| 平台 | 平台侧查看位置 |
|---|---|
| Google Ads | Google Ads 后台 -> Audience manager -> Your data segments，详见Google Ads 接入指引 |
| Meta Ads | Meta Ads Manager -> Audiences，详见Meta Ads 接入指引 |
| TikTok Ads | Meta Ads Manager -> Audiences，详见 TikTok Ads 接入指引 |
| 小米 | 直接推送，不支持在小米后台查看人群包 |
| 极光 | 极光后台中查看人群包，详见极光接入指引 |
| 个推 | 个推后台 -> 消息推送 -> 配置管理 -> 应用标签，详见个推接入指引 |
极光、个推推送成功后，可在对应平台后台查看“标签”或“人群包”等对象。个推后台中可在「应用标签」查看标签名称、CID 数量，并按需导出 CID 列表；小米为直接推送，不支持在小米后台查看人群包。
8. 常见问题
8.1 为什么创建推送任务时看不到某个平台或某个广告账号？
可能原因包括：
- 当前项目未开通对应人群包推送能力。
- 当前项目未安装目标平台插件。
- 目标推送通道未启用。
- 广告平台通道未给当前角色配置推送通道或广告账号授权。可联系角色管理员检查「平台管理 -> 成员与角色 -> 角色管理 > 推送插件管理」中是否已授权对应推送通道和广告账号。
8.2 为什么小米、极光、个推不需要配置角色授权？
小米、极光、个推属于消息触达通道，按平台应用凭证和字段映射配置推送通道即可，不需要额外配置广告平台账号授权。
8.3 神策显示推送成功，为什么平台后台暂时看不到？
请先确认目标平台是否支持后台查看人群包。
- 小米为直接推送，不支持在小米后台查看人群包；
- 其他平台通常需要一定时间处理上传的人群包或标签，请稍后刷新平台后台。若长时间不可见，请检查推送任务详情、平台账号权限和平台侧处理结果。
8.4 字段格式不符合要求怎么办？
请检查推送通道中的字段映射和字段值格式。手机号、邮箱、移动广告 ID、推送平台 ID 均需符合目标平台规则；无效值可能导致可推送人数减少或平台匹配失败。
若邮箱、手机号已在本地做过 MD5、Base64、AES 等非 SHA256 处理，广告平台通常无法按原始用户标识完成匹配。建议提供标准化前或标准化后的原始邮箱、手机号，由神策在推送前完成 SHA256 处理；或提供已按目标平台要求处理完成的 SHA256 值。
8.5 MAID 和 MADID 是一回事吗？
在本文中可以按同一类字段理解，均指移动广告 ID。不同平台字段命名不同，例如 Meta Ads 使用 MADID，TikTok Ads 使用 MAID；配置推送通道时，请以页面展示的平台字段名称为准。
9. 合规与安全
人群包推送涉及用户标识数据。使用前请确认已具备合法、合规的数据处理依据，并仅推送业务所需字段。请勿在文档、截图或排查记录中展示用户手机号、邮箱、设备标识等明文隐私信息。