人群包推送流程总览

确认项	负责角色	说明
功能开通与插件安装	神策工作人员	确认当前项目已开通目标平台推送能力，并已安装对应插件
平台凭证与账号权限	广告平台管理员或应用管理员	准备 Token、广告账户 ID、AppSecret、AppKey、Master Secret 等信息
神策字段准备	数据管理员或运营人员	确认用于推送的标识字段（用户属性或虚拟用户属性为 string 类型），且字段值符合目标平台要求
推送连接创建	有数据源管理权限的成员	在数据源管理中创建目标平台推送连接并测试连接
广告账户授权	有角色管理权限的成员	仅广告平台通道需要配置角色授权，未授权时创建任务不可选对应广告账户
推送任务创建与结果确认	运营人员	在分群历史详情页创建推送任务，并在神策和目标平台后台查看结果

广告平台通道适用于广告投放和再营销场景。此类平台通常需要先完成平台账号授权，并在神策中配置广告账户授权关系。

平台	支持匹配的标识字段	平台侧查看位置
Google Ads	EMAIL、PHONE	Google Ads 后台 -> Audience manager -> Your data segments
Meta Ads	EMAIL、PHONE、MADID	Meta Ads Manager -> Audiences

说明：MAID 和 MADID 均指移动广告 ID，不同平台字段名称不同。本文统一称为“移动广告 ID（MAID/MADID）”，配置时以平台字段名称为准。

3. 使用前准备

3.1 开通功能与安装插件

使用人群包推送前，请确认当前项目已开通目标平台的人群包推送能力，并已安装对应平台插件。

• 未开通目标平台推送能力时：对应平台入口可能不可见。
• 未安装目标平台插件时：点击平台入口后，系统会提示先完成插件安装。

 

3.2 准备平台账号与应用凭证

不同平台需要准备的信息不同。平台接入准备步骤通常较多，且涉及大量平台页面截图，建议在各平台接入指引中维护，主文档仅保留入口和差异说明。

平台	需要准备的信息	准备指引
Google Ads	服务账号（Service Account） 服务账号密钥（Service Account Key） 开发者令牌（Developer Token） 广告账户 ID（Google Ads Account ID）	Google Ads 接入指引
Meta Ads	Access Token 广告账户 ID（Account ID）	Meta Ads 接入指引
小米	AppSecret	小米接入指引
极光	AppKey Master Secret	极光接入指引
个推	App ID APP key Master Secret	个推接入指引

 

3.3 准备用户标识字段

创建推送任务前，请确认分群用户中存在目标平台可识别的用户标识字段。系统会按平台要求对字段进行格式处理和推送，不同平台可用字段以创建推送通道页面展示为准。

标识字段	常见适用平台	客户侧数据准备	神策推送前处理
邮箱（Email）	Google Ads、Meta Ads	按平台要求准备邮箱字段，建议去除首尾空格并转为小写	推送前按平台要求检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送
手机号（Phone）	Google Ads、Meta Ads	按平台要求准备手机号字段，建议统一使用 E.164 格式（如 +国家码手机号）	推送前按平台要求检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送
移动广告 ID（MAID/MADID）	Meta Ads	保持平台要求的广告 ID 格式	是否需要哈希处理以目标平台要求为准
推送平台 ID	小米、极光、个推	保持平台要求的设备或用户 id 格式，如极光id、个推id	以目标平台要求为准

示例：

• 邮箱非真实测试值：test_user@example.com -> af901a8720585d66357781387f4321f6bc8bbf467bbcbb3e595c7ed94acbd3de
• 手机号非真实测试值：+10000000000 -> ec29282cb39258fd1bb155db71dc219b4c9213ec9b7d13f0a9bc9fe34e1c87d0

说明：SHA256 在部分平台文档中也可能被称为“加密”或“加密上传”，本文统一称为 SHA256 哈希处理。SHA256 格式通常为 64 位十六进制字符串。请勿在文档、截图或问题排查记录中粘贴真实用户的手机号、邮箱或设备标识。

 

4. 创建推送连接/通道

推送通道/连接用于保存目标平台连接信息、账号信息和字段映射。完成配置后，才可在分群中创建推送任务。

操作路径：

1. 进入「数据管理 -> 通用数据集成 -> 数据源管理」。
2. 在「受众推送」分类下选择目标平台。
3. 点击「创建」或进入平台连接管理页。
4. 按页面要求填写连接名称、平台凭证、账号信息和字段映射。
5. 点击「测试连接」。测试通过后，提交并启用推送通道。

字段映射/推送字段说明：

配置项	说明
神策字段名称	选择神策 string 类型用户属性或 string 类型虚拟用户属性，字段值需符合平台要求
平台字段名称	选择目标平台可识别的匹配字段，例如 Email、Phone、移动广告 ID（MAID/MADID）、极光id、个推id
至少一组映射	每个推送通道至少配置一组可用字段映射

 

5. 配置角色授权

仅广告平台通道需要配置角色授权。消息触达通道不需要配置该授权。

广告平台授权入口：

1. 进入「平台管理 -> 成员与角色 -> 角色管理」。
2. 选择需要授权的角色，点击「授权对象」进入权限配置页面。
3. 在列表中，找到「推送插件管理」分类，勾选 「Google Ads 推送授权 / Meta Ads 推送授权」权限项，配置对应广告平台的推送通道和广告账号权限。
4. 保存后，拥有该角色的成员才可在创建推送任务时选择已授权的推送通道和广告账号。

授权规则：

规则	说明
推送通道授权	未授权的推送通道，不在创建推送任务时展示
广告账号授权	已授权推送通道下，未授权的广告账号不展示
授权变更影响范围	授权变更仅影响后续创建或执行的推送任务，不回溯修改历史任务记录

 说明：小米、极光、个推等消息触达通道不需要配置广告平台账号授权。

 

6. 创建推送任务

推送任务用于将某个分群版本同步到目标平台。系统支持自动推送和手动推送。

6.1 创建推送任务页面说明

创建推送任务时，页面会展示本次分群版本信息，并要求选择目标平台推送配置。

页面项	是否需配置	说明
推送名称	系统带出	默认使用当前分群名称，用于识别本次推送任务
分群版本	系统带出	本次任务对应的分群版本；手动推送时为当前选择的分群历史版本，自动推送时为当次例行计算成功的版本
分群结果数	系统带出	当前分群版本的用户数
推送通道	需选择	选择已创建并启用的目标平台推送通道
广告账户/应用	需选择	广告平台选择广告账户；消息触达通道无该选项
推送字段	需选择	选择目标平台支持的用户标识字段，如 Email、Phone、移动广告 ID、极光 ID、个推 ID 等
可推送结果数预估	系统计算	预估当前分群中满足 推送字段 要求、可推送到目标平台的用户数

说明：可推送结果数为神策侧基于字段完整性和格式规则的预估值，不等同于目标平台最终可识别或可投放的人群规模。目标平台仍可能因账号权限、字段格式、平台匹配规则或处理延迟，导致最终展示规模与预估值存在差异。

 

6.2 手动推送

在分群历史详情中，可对某个已计算完成的分群版本发起手动推送。

操作路径：

1. 进入「分群管理」。
2. 打开目标分群详情。
3. 进入分群历史详情。
4. 点击「立即推送」。
5. 选择推送通道、账号或平台所需字段。
6. 确认后提交推送任务。

 

6.3 自动推送 

自动推送当前支持范围如下：

配置自动推送后，分群例行计算成功时系统自动触发推送。若分群计算失败，则不触发自动推送。若目标平台授权失效、接口权限不足或平台返回错误，推送任务会失败并记录失败原因。

说明：

• 具体可用范围以产品页面展示或版本更新说明为准。
• 未展示自动推送配置项的平台或项目，请使用手动推送。
• 自动推送仅对配置生效后的分群例行计算结果生效，不回溯触发历史分群版本。
• 自动推送任务的执行状态可在推送记录中查看。

 

7. 查看推送任务

推送任务创建后，可在神策侧（分群>推送详情>推送记录 / 数据管理 > 通用数据集成 >推送任务）查看任务执行状态、推送人数、失败原因等信息。任务状态以页面展示为准。

状态	说明
等待中	任务已创建，等待执行
推送中	系统正在向目标平台推送数据
成功	目标平台已接收本次推送
失败	推送未成功，需查看失败原因
部分成功	部分子任务成功，部分子任务失败，需查看明细

失败任务支持在有效期内（3天）手动重试。若失败原因是授权失效、账号权限不足或平台凭证错误，请先修复连接配置后再重试。

 

8. 查看平台侧结果

推送成功后，可在神策侧查看任务状态。除小米外，其他平台可在目标平台后台查看对应的人群包、受众或标签。平台侧通常存在处理延迟，若神策显示推送成功但平台侧暂未展示，请稍后刷新平台后台。

平台	平台侧查看位置
Google Ads	Google Ads 后台 -> Audience manager -> Your data segments，详见Google Ads 接入指引
Meta Ads	Meta Ads Manager -> Audiences，详见Meta Ads 接入指引
小米	直接推送，不支持在小米后台查看人群包
极光	极光后台中查看人群包，详见极光接入指引
个推	个推后台 -> 消息推送 -> 配置管理 -> 应用标签，详见个推接入指引

极光、个推推送成功后，可在对应平台后台查看“标签”或“人群包”等对象。个推后台中可在「应用标签」查看标签名称、CID 数量，并按需导出 CID 列表；小米为直接推送，不支持在小米后台查看人群包。

 

9. 常见问题

9.1 为什么创建推送任务时看不到某个平台或某个广告账号？

可能原因包括：

1. 当前项目未开通对应人群包推送能力。
2. 当前项目未安装目标平台插件。
3. 目标推送通道未启用。
4. 广告平台通道未给当前角色配置推送通道或广告账号授权。可联系角色管理员检查「平台管理 -> 成员与角色 -> 角色管理 > 推送插件管理」中是否已授权对应推送通道和广告账号。

9.2 为什么小米、极光、个推不需要配置角色授权？

小米、极光、个推属于消息触达通道，按平台应用凭证和字段映射配置推送通道即可，不需要额外配置广告平台账号授权。

9.3 神策显示推送成功，为什么平台后台暂时看不到？

请先确认目标平台是否支持后台查看人群包。

• 小米为直接推送，不支持在小米后台查看人群包；
• 其他平台通常需要一定时间处理上传的人群包或标签，请稍后刷新平台后台。若长时间不可见，请检查推送任务详情、平台账号权限和平台侧处理结果。

9.4 字段格式不符合要求怎么办？

请检查推送通道中的字段映射和字段值格式。手机号、邮箱、移动广告 ID、推送平台 ID 均需符合目标平台规则；无效值可能导致可推送人数减少或平台匹配失败。

若邮箱、手机号已在本地做过 MD5、Base64、AES 等非 SHA256 处理，广告平台通常无法按原始用户标识完成匹配。建议提供标准化前或标准化后的原始邮箱、手机号，由神策在推送前完成 SHA256 处理；或提供已按目标平台要求处理完成的 SHA256 值。

9.5 MAID 和 MADID 是一回事吗？

在本文中可以按同一类字段理解，均指移动广告 ID。不同平台字段命名不同，例如 Meta Ads 使用 MADID，TikTok Ads 使用 MAID；配置推送通道时，请以页面展示的平台字段名称为准。

 

10. 合规与安全

人群包推送涉及用户标识数据。使用前请确认已具备合法、合规的数据处理依据，并仅推送业务所需字段。请勿在文档、截图或排查记录中展示用户手机号、邮箱、设备标识等明文隐私信息。