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