人群包推送常见问题
本文汇总人群包推送的公共问题。平台特有的账号、凭证、后台路径问题，请查看对应平台接入准备指引。
1. 入口与权限问题
1.1 为什么创建推送任务时看不到某个平台？
可能原因包括：
- 当前项目未开通对应人群包推送能力。
- 当前项目未安装目标平台插件。
- 目标推送通道/连接未创建或未启用。
- 广告平台通道未给当前角色配置推送通道或广告账户授权。
1.2 为什么广告账户在创建任务时不可选？
广告平台通道需要配置角色授权。请联系管理员检查「平台管理 -> 成员与角色 -> 角色管理 -> 推送插件管理」中是否已授权对应推送通道和广告账户。
1.3 极光、个推、小米需要配置广告账户授权吗？
不需要。极光、个推、小米属于消息触达通道，按平台应用凭证和字段映射配置推送连接即可，不需要额外配置广告平台角色授权。
2. 推送通道/连接配置问题
2.1 神策字段名称可以选择哪些字段？
神策字段名称需选择 string 类型用户属性或 string 类型虚拟用户属性。字段值还需符合目标平台要求，例如邮箱、手机号、移动广告 ID、极光id、个推id 等。
2.2 一个推送通道/连接至少要配置几个字段？
每个推送通道/连接至少配置一组可用字段映射。若目标平台支持多个匹配字段，可按业务数据情况配置多组字段映射。
2.3 测试连接失败怎么办？
请优先检查平台凭证、Token、广告账户 ID、Service Account Key、Developer Token、AppSecret、AppKey、Master Secret 等信息是否填写正确，并确认平台账号或应用仍具备对应接口权限。
3. 字段格式与 SHA256 处理问题
3.1 邮箱和手机号需要客户自己做 SHA256 吗？
不强制客户自行处理。
神策推送前会按平台要求检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送。
3.2 本地已经做过 MD5、Base64、AES 等非 SHA256 处理怎么办？
不建议使用。
广告平台通常无法通过 MD5、Base64、AES 等非 SHA256 值还原或匹配原始用户标识，可能导致匹配失败或匹配率明显降低。建议提供标准化前或标准化后的原始邮箱、手机号，或提供已按目标平台要求处理完成的 SHA256 值。
3.3 手机号是否都需要 E.164 格式？
请按目标平台要求准备手机号字段。为降低多平台维护成本，建议统一使用 E.164 格式，例如 +国家码手机号。
Google Ads 对手机号格式要求更明确，其他平台以目标平台要求和神策页面提示为准。
3.4 MAID 和 MADID 是一回事吗？
在本文中可以按同一类字段理解，均指移动广告 ID。不同平台字段命名不同，例如 Meta Ads 使用 MADID，TikTok Ads 使用 MAID；配置推送通道时，请以页面展示的平台字段名称为准。
4. 创建推送任务问题
4.1 自动推送什么时候触发？
自动推送当前仅支持小米、极光、个推。配置自动推送后，分群例行计算成功时系统自动触发推送；若分群计算失败，则不触发自动推送。
Google Ads、Meta Ads、TikTok Ads 暂不支持自动推送，将在后续版本支持，具体以产品页面展示或版本更新说明为准。未展示自动推送配置项的平台或项目，请使用手动推送。
4.2 手动推送会推送哪个分群版本？
手动推送以用户在分群历史详情中选择的计算成功版本为准。
4.3 可推送结果数为什么小于分群结果数？
分群结果数是当前分群版本的用户数；可推送结果数是满足目标平台字段要求、可被神策推送到平台的用户数。若部分用户缺少字段值或字段格式不符合要求，可推送结果数会小于分群结果数。
5. 推送状态与失败重试问题
5.1 神策显示成功是否代表平台侧已经可投放？
不一定。神策显示成功表示目标平台已接收本次推送；平台侧仍可能需要一定处理时间，最终可投放状态和规模以目标平台后台展示为准。
5.2 推送失败后怎么办？
请先查看失败原因。若失败原因是授权失效、账号权限不足或平台凭证错误，请先修复连接配置后再重试。失败任务支持在有效期内手动重试。
5.3 为什么平台侧规模小于神策可推送结果数？
神策可推送结果数是基于字段完整性和格式规则的预估值，不等同于目标平台最终可识别或可投放的人群规模。目标平台可能因账号权限、字段格式、平台匹配规则或处理延迟，导致最终展示规模与预估值存在差异。
6. 平台侧查看结果问题
6.1 各平台在哪里查看推送结果？
| 平台 | 平台侧查看位置 |
|---|---|
| Google Ads | Google Ads 后台 -> Audience manager -> Your data segments |
| Meta Ads | Meta Ads Manager -> Audiences |
| TikTok Ads | TikTok Ads Manager -> Tools -> Audience Manager |
| 小米 | 直接推送，不支持在小米后台查看人群包 |
| 极光 | 极光后台中查看人群包或标签 |
| 个推 | 个推后台 -> 消息推送 -> 配置管理 -> 应用标签 |
6.2 小米为什么不能在后台查看人群包？
小米当前为直接推送模式，不支持在小米后台查看人群包。请在神策推送记录中查看任务状态。
6.3 极光、个推能在平台后台查看吗？
可以。极光可在极光后台查看人群包或标签；个推可在「消息推送 -> 配置管理 -> 应用标签」查看标签名称、CID 数量，并按需导出 CID 列表。
7. 合规与安全
7.1 排查问题时可以提供真实手机号或邮箱吗？
不建议。人群包推送涉及用户标识数据，请勿在文档、截图或问题排查记录中展示用户手机号、邮箱、设备标识等明文隐私信息。如需排查，请使用脱敏样例或非真实测试值。
7.2 推送前需要确认哪些合规事项？
请确认已具备合法、合规的数据处理依据，并仅推送业务所需字段。涉及广告平台时，还需遵守目标平台关于客户匹配、受众上传和用户隐私保护的规则。