适用版本:SA 3.0.4 及以上版本。
使用限制:使用该功能前,需先开通「海外人群包推送 Licence」,并安装 Google Ads 对应平台插件。完成插件配置与账号授权后,即可在分群页面创建推送任务,选择 Google Ads 作为目标渠道,并提交人群包推送。
1. 适用场景与流程
本手册面向需要在神策中配置 Google Ads 人群包推送的客户,旨在帮助您顺利完成从凭证准备到人群包推送的全过程。推送成功后,可在 Google Ads 中查看对应受众。
整体流程分为四步:
-
准备凭证:在 Google Cloud 和 Google Ads 中获取 Service Account、Service Account Key、Developer Token 和 Google Ads Account ID。
-
神策配置连接:在神策后台创建 Google Ads 推送连接,填写凭证并测试。
-
配置推送授权:由管理员为角色分配 Google Ads 推送权限和广告账号范围。
-
创建推送任务:在分群中发起手动推送或配置自动推送,并在 Google Ads 后台验证结果。
2. 接入前准备
2.1. 准备清单
| 准备项 | 用途 | 在神策中填写 |
|---|---|---|
| Service Account | 调用 Google Ads API | 服务账号(Service Account) |
| Service Account Key | 接口调用身份认证 | 服务账号密钥(Service Account Key) |
| Developer Token | 调用 Google Ads API | 开发者令牌(Developer Token) |
| Google Ads Account ID | 指定人群包推送的广告账户 | 广告账户 ID(Google Ads Account ID) |
重要提醒:Service Account 需被添加到 Google Ads 经理账号或目标广告账户中,并授予推送所需访问权限。若权限不足,连接测试或推送任务可能失败。
2.2 获取 Developer Token
Developer Token 是调用 Google Ads API 的必填凭证,需基于 Google Ads 经理账号(Manager Account)申请。
| 步骤 | 步骤说明 | 截图 |
|
步骤一 |
使用Google Ads Manager Account登录 Google Ads后台,左侧导航中选择Admin,然后选择API Center。填写表单后完成Developer Token的申请 |
![]() |
|
步骤2 |
【重要】 Assess Level 必须为 Basic Level。若当前为 Explorer Access,可点击 Apply for Basic Access 申请升级。 |
|
|
步骤3 |
提交后等待 Token Review Team 审核,通常在 1-3 个工作日内完成。 官方文档:https://developers.google.com/google-ads/api/docs/api-policy/developer-token |
|
2.3 获取 Service Account 与 Service Account Key
Service Account 需基于 Google Cloud 项目创建,且目标项目需先启用 Google Ads API。
| 步骤 | 步骤说明 | 截图 |
| 步骤1 |
创建 Google Cloud 项目并启用 Google Ads API
|
|
| 步骤2 |
创建 Service Account
|
|
| 步骤3 |
下载 Service Account Key
|
|
2.4 获取 Google Ads Account ID
Service Account 可访问的账号,取决于其被添加到哪些 Google Ads 广告账号或经理账号中。
| 步骤 | 步骤说明 | 截图 |
| 步骤 1 |
配置 Service Account 的 Google Ads 访问权限 对于人群包推送场景,通常授予 Standard 权限即可满足需求。
|
|
| 步骤 2 |
关联经理账号与广告账号 经理账号用于统一管理一个或多个广告账号;广告账号是实际进行广告投放和人群包触达的目标账号。
|
|
| 步骤 3 |
获取经理账号下的广告账号列表(Customer ID List)
|
—— |
2.5 确认 Customer Match 使用资格
若需将神策人群包推送至 Google Ads 进行广告触达,请先确认目标广告账号具备 Customer Match 使用资格。Google 官方通常不提供单独的资格查询页面,建议结合 Customer Match 政策及账号后台实际可用状态综合判断(例如是否可正常创建、上传并使用 Customer List)。若账号不满足要求,即使推送连接创建成功,仍可能无法正常进行人群包触达。
Customer Match 政策:https://support.google.com/adspolicy/answer/6299717
3. 在神策中配置推送连接
3.1 创建推送连接(广告账号授权)
操作路径:进入「数据管理 → 通用数据集成 → 数据源管理」,在「受众推送」分类下选择 Google Ads。点击 Google Ads 连接管理页面右上角 创建,在弹出的「添加连接」抽屉中填写以下配置项:
| 配置项 | 说明 |
|---|---|
| 连接名称 | 自定义便于识别的名称,例如:华东区-Google主投放账号 |
| 服务账号(Service Account) | 填写或上传 Google Cloud 中准备的服务账号信息 |
| 服务账号密钥(Service Account Key) | 填写或上传服务账号密钥,具体以神策页面展示为准 |
| 开发者令牌(Developer Token) | 填写 Google Ads API 对应的 Developer Token |
| 广告账户 ID(Google Ads Account ID) |
填写目标 Google Ads 广告账户 ID。 Google Ads 后台账号中 Customer ID 格式通常为 123-456-7890。在神策创建连接时填写时需去掉横杠,仅保留数字1234567890。 |
| 推送字段 / 映射字段 |
神策字段名称:选择神策 string 类型用户属性或 string 类型虚拟用户属性。 |
填写完成后,点击「测试连接」。测试通过后点击「提交」,完成连接创建。
3.2 配置角色推送授权
Google Ads 属于广告平台通道,需要管理员在「平台管理 → 成员与角色 → 角色管理」中配置推送通道和广告账户授权。未授权时,成员在创建推送任务时可能看不到对应通道或广告账户。
具体步骤:
-
在「平台管理」→「成员与角色」→「角色管理」的角色列表中定位目标角色,点击「授权对象」进入权限配置页面。
-
在列表中找到「推送插件管理」分类,勾选「Google Ads 推送授权」权限项。
-
点击「配置」,设置该角色可使用的推送连接及广告账号范围:
-
全部广告账号:授权角色使用系统内所有已配置的 Google Ads 推送连接及关联账号。
-
自定义授权:按推送连接或具体广告账号维度,勾选需授权的资源范围。
-
-
完成所有权限配置后,点击「保存」,权限配置即时生效。
3.3 创建推送任务
3.3.1 手动推送
功能说明:
- 在分群历史详情中,可对某个已计算完成的分群版本发起手动推送。
操作路径:
-
进入「分群管理」。
-
打开目标分群详情。
-
进入分群历史详情。
-
点击「立即推送」。
-
选择推送通道、账号或平台所需字段。
-
同步方式:追加(APPEND),系统将仅把当前分群用户新增或更新至目标广告平台的受众中,不会对已有历史用户进行移除或覆盖。
-
用户失效期:用户在 Google Ads 受众列表中的保留时长,超过该时长后用户将自动失效。
-
-
确认后提交推送任务。
3.3.2 自动推送(SA 3.5 及以上版本支持)
创建或编辑分群时开启推送,用于在分群计算完成后自动按已配置规则执行推送。
功能说明:
- 创建或编辑分群时开启推送,用于在分群计算完成后按已配置规则自动执行推送。
开启入口(具体入口以当前产品页面为准):
- 创建分群时:分群管理 → 创建分群 → 推送设置 → 开启推送
- 已有分群时:分群管理 → 分群详情 → 推送设置 → 编辑
推送配置:点击「推送设置」中的「开启推送/编辑」后,进行推送配置,配置项如下:
- 推送通道:选择已配置的推送通道
- 字段映射 / 推送字段:字段配置支持以下方式:
- 预设字段:快捷应用方式。在「数据源管理 > 配置推送通道」时预设的字段映射。配置推送任务时可直接使用。
- 自定义字段:支持按业务需求新增字段映射,用于补充预设字段无法满足的个性化推送场景。
4. 查看推送结果
4.1 在 神策查看推送任务
4.1.1 在分群详情页查看
可在「分群管理 → 分群详情 → 推送记录」中,查看该分群对应的推送任务及执行结果。
适用场景:查看单个分群的推送记录及执行结果。
4.1.2 在推送任务页查看
可在「数据管理 → 通用数据集成 → 推送任务」中,搜索、查看、管理推送任务。
适用场景:统一查看全部分群的推送任务。
4.2 在 Google Ads 平台上查看人群包
推送完成后,可在 Google Ads 后台查看对应的 Customer Match 受众。平台侧通常存在处理延迟,若神策显示推送成功但平台侧暂未展示,请稍后刷新。
操作步骤:
-
登录 Google Ads 后台。
-
进入 Audience manager。
-
在 Your data segments 中查找对应的受众列表。
-
查看列表名称、状态、规模及处理结果。
说明:
-
广告平台侧受众处理通常存在一定延迟,列表状态和规模更新可能不是实时完成。
-
若受众规模异常偏小,可优先检查字段质量、平台资格、账号状态及匹配结果。
-
受众创建成功后,还需在广告系列中正确引用,方可用于后续投放。

5. 常见问题与排查
5.1 连接测试失败,提示无权限访问广告账号,或开发者令牌校验失败
请优先检查:
-
Service Account Email 是否已加入目标 Google Ads 广告账号或其经理账号的 Access and security。
-
当前服务账号是否对目标广告账号具备可用访问权限。
-
若通过经理账号管理多个广告账号,是否已完成经理账号与目标广告账号的关联。
-
当前填写的 Developer Token 是否来自有效的 Google Ads Manager Account。
-
Developer Token 是否已在 Admin → API Center 中完成申请或开通。
说明:服务账号首次添加到 Google Ads 时,通常不支持直接选择 Admin 权限。建议先使用 Standard 权限完成添加;人群包推送场景通常 Standard 权限已可满足。
5.2 广告账户 ID 校验失败
请确认填写的是目标 Google Ads 广告账号的 Customer ID,且填写时已去掉横杠,仅保留数字。
例如,页面显示为 123-456-7890 时,实际填写值应为 1234567890。
5.3 服务账号可推送哪些广告账号?
服务账号可推送的广告账号范围,取决于其在 Google Ads 中被授予的访问范围。
-
若服务账号被直接添加到广告账号,则通常仅可推送该账号。
-
若服务账号被添加到经理账号,则通常可通过该经理账号访问其已关联的广告账号。
实际推送时,还需同时满足目标广告账号具备 Customer Match 使用资格。
5.4 为什么创建连接时仅支持广告账户手动配置,不支持自动同步拉取?
当前版本暂不通过 API 自动同步拉取 Google Ads 广告账户。由于 Google Ads 账号访问链路较复杂,自动拉取结果不一定能准确反映实际可用于推送的目标广告账号范围。为降低误选账号导致的错误触达风险,当前版本采用广告账户手动配置方式。
5.5 Email、Phone 入库时已做加密,还能推送到广告平台吗?
只有标准 SHA256 加密值或明文值可以正常推送;非 SHA256 加密值即使推送也大概率无效。
Google 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:广告投放实际触达的人数,受用户在线状态、广告预算、风控、投放策略、是否开启扩量等因素影响。
说明:神策推送成功仅表示数据已成功提交至广告平台,不代表广告平台全部匹配成功。最终可用于投放的人群规模,以广告平台侧展示的受众规模或匹配结果为准。
附录:文档版本记录
| 版本 | 日期 | 修改说明 |
|---|---|---|
| 1.0 | 2026-09-14 | 适用于 SA 3.0.4 及以上版本 |
本手册将根据产品迭代持续更新,请以神策官方帮助中心最新版本为准。