适用版本：SA 3.0.4 及以上版本。
使用限制：使用该功能前，需先开通「海外人群包推送 Licence」，并安装 Meta Ads 对应平台插件。完成插件配置与账号授权后，即可在分群页面创建推送任务，选择 Meta Ads 作为目标渠道，并提交人群包推送。
1. 适用场景
适用于将神策分群同步到 Meta Ads，用于广告定向投放、排除人群或相似人群扩展。推送成功后，可在 Meta Ads Manager 中查看对应受众。
2. 接入前准备
在神策中创建 Meta Ads 推送连接前，请按以下页面依次准备 Access Token 和 Account ID。Meta Ads 平台页面可能随版本调整，具体入口以 Meta Ads 页面实际展示为准。
2.1 Access Token 获取
以下 Meta 官方页面在部分场景下可能需要登录 Facebook 账号后查看。详情可参考官方文档：Meta Ads API官方文档
| 步骤 | 内容 | 说明 |
| 第一步 | 创建应用 |
登录 Meta for Developers后台，创建应用
|
| 第二步 | 将应用添加为业务资产 |
登录 Meta Business Suite后台，先导航到广告管理工具平台，然后点击所有工具，找到业务设置
|
| 第三步 | 创建系统用户 |
|
| 第四步 | 创建口令 |
生成系统用户的口令
|
| 第五步 | 使用口令 |
|
2.2 广告账户 ID 查看页面
如需获取 Meta Ads 广告账号列表，可在 Meta Business Settings 中进入 Accounts → Ad accounts 查看当前业务资产下的广告账号及 Ad Account ID
2.3 权限确认页面
确认 Custom Audience 相关条款与平台能力：若后续需将神策人群包推送至 Meta Ads 进行广告触达，请先确认相关条款、平台政策及广告账户能力均满足要求。
|
 |
3. 神策侧操作步骤
3.1 创建推送通道
操作路径：进入「数据管理 -> 通用数据集成 -> 数据源管理」，在「受众推送」分类下选择 Meta Ads。点击 Meta Ads 连接管理 页面右上角 创建，在弹出的 添加连接 抽屉中填写配置项如下：
| 配置项 | 说明 |
|---|---|
| 连接名称 | 自定义填写便于识别的名称，用于在神策中识别该 Meta Ads 推送连接，例如：华东区-Meta主投放账号 |
| Access Token | 填写 Meta 平台侧准备的 Access Token |
| 广告账户 ID（Account ID） | 填写目标广告账户 ID |
| 推送字段/映射字段 | 神策字段名称：选择神策 string 类型用户属性或 string 类型虚拟用户属性 |
| 推送字段/映射字段 | 平台字段名称：选择 Meta Ads 支持的匹配字段，如 EMAIL、PHONE、MADID |
3.2 角色授权
Meta Ads 属于广告平台通道，需要管理员在「平台管理 -> 成员与角色 -> 角色管理」中配置推送通道和广告账户授权。未授权时，成员在创建推送任务时可能看不到对应通道或广告账户。
具体步骤如下：
- 在「平台管理」→「成员与角色」→「角色管理」的在角色列表中定位目标角色，点击「授权对象」进入权限配置页面。
- 在列表中，找到「推送插件管理」分类，勾选 「Meta Ads 推送授权」权限项。
- 点击「配置」，设置该角色可使用的推送连接及广告账号范围：
- 全部广告账号：授权角色使用系统内所有已配置的 Meta Ads 推送连接及关联账号。
- 自定义授权：按推送连接或具体广告账号维度，勾选需授权的资源范围
- 完成所有权限配置后，点击「保存」按钮，权限配置即时生效
3.3 创建推送任务
3.3.1 手动推送
在分群历史详情中，可对某个已计算完成的分群版本发起手动推送。
操作路径：
- 进入「分群管理」。
- 打开目标分群详情。
- 进入分群历史详情。
- 点击「立即推送」。
- 选择推送通道、账号或平台所需字段。
- 确认后提交推送任务。
3.3.2 自动推送
神策分析 3.0.5 及以上版本支持自动推送。
创建或编辑分群时开启推送，用于在分群计算完成后自动按已配置规则执行推送。
可在 分群管理 -> 创建分群 中，点击 推送设置中的开启推送 ；也可在 分群管理 -> 分群详情 中，点击 推送设置中的编辑。具体入口以当前产品页面为准
点击 推送设置中的开启推送/编辑后，进行 推送配置 ，配置项如下：
- 推送通道：选择已配置的个推通道
- 字段映射 / 推送字段：字段配置支持以下方式：
- 预设字段：快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段：支持按业务需求新增字段映射，用于补充预设字段无法满足的个性化推送场景。
3.4 推送字段映射与与格式建议
在神策创建 Meta Ads 推送连接时或在创建推送任务时，需要配置「神策字段名称」与「平台字段名称」的映射关系。平台字段名称指 Meta Ads 可识别的用户匹配字段；神策字段名称指神策项目中用于存放对应用户标识的 string 类型用户属性或 string 类型虚拟用户属性。
| Meta Ads 平台字段名称 | 神策字段要求 | 客户侧数据准备 | 神策推送前处理 |
|---|---|---|---|
| 选择存放邮箱的 string 类型用户属性或 string 类型虚拟用户属性 |
建议格式
|
检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送 | |
| Phone | 选择存放手机号的 string 类型用户属性或 string 类型虚拟用户属性 |
建议格式
|
检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送 |
| MADID | 选择存放移动广告 ID 的 string 类型用户属性或 string 类型虚拟用户属性 |
保持平台要求的移动广告 ID 格式 |
是否需要哈希处理以目标平台要求为准 |
说明：
- 可用平台字段以神策创建推送连接页面实际展示为准。
- MADID 属于移动广告 ID。若神策字段中存在空值或格式不符合平台要求，该用户可能无法被推送或无法被 Meta Ads 成功匹配。
- 请勿在文档、截图或问题排查记录中粘贴真实用户手机号、邮箱或设备标识。
4. 推送后查看结果
4.1 在 神策数据上查看人群包
推送任务创建后，可在神策侧（分群>推送详情>推送记录 / 数据管理 > 通用数据集成 >推送任务）查看任务执行状态、推送人数、失败原因等信息。任务状态以页面展示为准。
| 状态 | 说明 |
|---|---|
| 等待中 | 任务已创建，等待执行 |
| 推送中 | 系统正在向目标平台推送数据 |
| 成功 | 目标平台已接收本次推送 |
| 失败 | 推送未成功，需查看失败原因 |
| 部分成功 | 部分子任务成功，部分子任务失败，需查看明细 |
失败任务支持在有效期内（3天）手动重试。若失败原因是授权失效、账号权限不足或平台凭证错误，请先修复连接配置后再重试。
4.2 在 Meta Ads 查看受众
推送完成后，可在 Meta Ads 后台查看对应的 Custom Audience。
操作步骤：
- 登录 Meta Ads Manager。
- 进入 Audiences 页面。
- 查找对应的 Custom Audience。
- 查看受众名称、状态、规模及可用情况。
说明：
- Meta 页面入口名称可能因账号类型、语言设置或页面版本不同而略有差异，请以实际页面展示为准。
- 若受众状态异常、规模过小或不可用于投放，建议优先检查条款接受情况、字段质量、账户权限及平台处理结果。
- 实际受众可用性以 Meta 平台侧展示和审核结果为准。
5. 常见问题
5.1 为什么创建推送连接时仅支持广告账户手动配置，不支持自动同步拉取？
当前版本暂不通过 API 自动同步拉取广告账户。由于 Meta Ads 可访问的广告账户范围受 Access Token、商务平台资产授权、系统用户权限及广告账户状态等因素共同影响，自动拉取结果不一定稳定。为降低误选广告账户导致的错误触达风险，当前版本采用手动配置方式。
5.2 当前凭证可推送哪些广告账户？如何确认是否可用于人群包触达？
当前凭证可推送的广告账户范围，取决于该 Access Token 在 Meta 平台中被授予的访问范围。若当前 Token 对多个广告账户具有访问权限，则可用于这些广告账户；若仅被授权访问单个广告账户，则通常仅可推送该广告账户。
是否可正常进行人群包触达，还需同时满足以下条件：
- 当前 Access Token 对目标广告账户具备有效访问权限
- 相关业务主体已接受 Custom Audience 相关条款
- 目标广告账户可正常使用 Customer List Custom Audience 相关能力
- 当前数据来源、授权方式及使用方式符合 Meta 平台政策要求
若上述条件未满足，即使推送连接创建成功，后续仍可能无法正常完成人群包触达。
5.3 企业资格认证（Business Verification）是否必需？
不一定。
企业资格认证并非所有 Meta Ads 推送连接场景下的统一必选前置条件，但在部分商务平台、应用权限或广告能力使用场景下，Meta 可能要求企业先完成认证。若平台页面提示需完成认证，请先按 Meta 官方要求完成后再继续配置。
5.4 Meta Ads 拉数和推送是否可以共用同一个 Access Token？
通常可以。
若该 Token 来自同一 Business 下的同一 App 和 System User，且同时具备 ads_read、ads_management、business_management 等所需权限，则可同时用于广告数据读取和人群包推送。
5.5 Email、Phone 入库时已做加密，还能推送到广告平台吗？
只有标准 SHA256 加密值或明文值可以正常推送；非 SHA256 加密值即使推送也大概率无效。
Meta Ads、Meta Ads 等广告平台要求 Email、Phone 使用标准 SHA256 哈希值进行匹配。神策推送时会判断字段值是否已是 SHA256 格式：
- 若已是 SHA256 格式：直接上传到目标平台。
- 若不是 SHA256 格式：神策会先进行 SHA256 加密后再上传至目标平台。
如果客户入库时使用了 MD5、加盐 SHA256 或其他非标准加密方式，神策可能会将其识别为非 SHA256 并再次加密，最终都会导致广告平台无法正确匹配用户。
建议：Email、Phone 保持明文入库，或使用广告平台认可的标准 SHA256 哈希值入库。
5.6 为什么分群结果数、可推送结果数、广告平台匹配人数不一致？
这是正常现象。用户从神策分群到广告平台触达，会经过字段过滤、数据加密、平台匹配、广告投放等环节，每一步人数都可能减少。
- 整体关系通常为：
分群结果数 M ≥ 可推送结果数 N ≥ 广告平台匹配人数 P - 若广告仅基于该受众定向投放，通常：
广告平台匹配人数 P ≥ 实际触达人数 Q
指标口径说明如下：
- 分群结果数 M：神策分群计算出的目标用户总数。
- 可推送结果数 N：根据本次字段映射筛选后，具备有效 Email / Phone 等推送字段，并完成平台要求加密处理的用户数，按用户去重统计。
- 广告平台匹配人数 P：广告平台收到数据后，与自身用户库匹配成功并进入受众池的人数。
- 实际触达人数 Q：广告投放实际触达的人数，受用户在线状态、广告预算、风控、投放策略、是否开启扩量等因素影响。
说明：神策推送成功仅表示数据已成功提交至广告平台，不代表广告平台全部匹配成功。最终可用于投放的人群规模，以广告平台侧展示的受众规模或匹配结果为准。