适用版本：SA 3.0.4 及以上版本。
使用限制：使用该功能前，需先开通「海外人群包推送」，并安装 Google Ads 对应平台插件。完成插件配置与账号授权后，即可在分群页面创建推送任务，选择 Google Ads 作为目标渠道，并提交人群包推送。
本文用于说明将神策人群包推送到 Google Ads 前，需要在 Google Ads、Google Cloud 和神策中提前准备的信息。
1. 适用场景
适用于将神策分群同步到 Google Ads，用于广告定向投放、排除人群或相似人群扩展。推送成功后，可在 Google Ads 后台查看对应人群数据。
2. 接入前准备
在神策中创建 Google Ads 推送连接前，请先由 Google Ads 管理员和 Google Cloud 管理员准备以下信息。
| 准备项 | 由谁准备 | 权限要求 | 用途 | 在神策中填写 |
|---|---|---|---|---|
| Service Account | Google Cloud 管理员 | 需具备目标 Google Cloud 项目中创建或查看服务账号的权限 | 用于调用 Google Ads API | 服务账号（Service Account） |
| Service Account Key | Google Cloud 管理员 | 需具备为 Service Account 创建或下载密钥的权限 | 用于接口调用身份认证 |
服务账号密钥（Service Account Key） |
| Developer Token | Google Ads 管理员 | 需具备 Google Ads API 开发者令牌申请或查看权限 | 用于调用 Google Ads API |
开发者令牌（Developer Token） |
| Google Ads Account ID | Google Ads 管理员或广告投放管理员 | 需具备目标 Google Ads 广告账户访问权限 | 指定人群包推送到哪个广告账户 |
广告账户 ID（Google Ads Account ID） |
重要说明：
- Service Account 需被添加到 Google Ads 经理账号或目标广告账户中，并授予推送所需访问权限。若权限不足，连接测试或推送任务可能失败。
Customer Match 使用资格说明：
- 若后续需将神策人群包推送至 Google Ads 进行广告触达，请先确认目标广告账号具备 Customer Match 使用资格。Google 官方通常不提供单独的资格查询页面，建议结合 Customer Match 政策及账号后台实际可用状态综合判断，例如是否可正常创建、上传并使用 Customer List。若账号不满足相关要求，即使推送连接创建成功，仍可能无法正常进行人群包触达。
- Customer Match 政策：https://support.google.com/adspolicy/answer/6299717
3. 平台侧准备
请按以下页面依次准备 Service Account、 Service Account Key、Developer Token 和 Google Ads Account ID。Google Ads 平台页面可能随版本调整，具体入口以 Google Ads 页面实际展示为准。
3.1 申请开发者令牌（Developer Token） 申请或查看页面
3.1.1 创建或确认 Google Ads 经理账号
Google Ads 的 Developer Token 通常需基于 Google Ads 经理账号（Manager Account）申请。
因此，在进行后续 API 对接前，请先确认当前已拥有可用的 Google Ads 经理账号；若尚未创建，请先参考官方文档完成创建
3.1.2 申请 Developer Token
Developer Token 是调用 Google Ads API 的必填凭证
| 步骤说明 | 截图 |
|
使用Google Ads Manager Account登录 Google Ads后台，左侧导航中选择Admin，然后选择API Center。填写表单后完成Developer Token的申请 【重要】Assess Level 必须提供访问权限为 Basic Level 的 Developer Token |
 |
|
若不是该权限可点击 Explorer Access下的Apply for Basic Access 进行申请 填完申请表格之后，需等待 Token Review Team 批准你的 Developer Token。审核大多数会在 1 -3个工作日内完成。 官方文档：https://developers.google.com/google-ads/api/docs/api-policy/developer-token |
|
3.2 服务账号和服务账号秘钥（Service Account、Service Account Key）获取页面
3.2.1 创建 Google Cloud 项目并启用 Google Ads API
Service Account 需基于 Google Cloud 项目创建，且目标项目需先启用 Google Ads API
| 步骤说明 | 截图 |
| 登录 Google Cloud 控制台（需登录 Google 账号后查看） | |
|
|
|
|
3.2.2 创建 Service Account
启用 Google Ads API 后，需在 Google Cloud 项目中创建 Service Account
| 步骤说明 |
截图 |
|
|
|
|
3.2.3 下载 Service Account Key
创建 Service Account 后，需下载对应的 JSON 格式密钥文件
| 步骤说明 |
截图 |
|
|
3.3 广告账户（Google Ads Account ID ）查看页面
Service Account 可访问的账号，取决于其被添加到哪些 Google Ads 广告账号或经理账号中。添加至经理账号后，该经理账号下已关联的广告账号原则上均可访问，并可用于人群包推送。
3.3.1 配置 Service Account 的 Google Ads 访问权限
对于人群包推送场景，通常授予 Standard 权限即可满足使用需求。
| 步骤说明 |
截图 |
|
。
|
注：若页面未提供 Admin 访问级别，可先按实际可选权限完成添加；对于人群包推送场景，通常 Standard 权限即可满足使用 |
|
权限级别升级（Standard 升级为 Admin）：对于人群包推送场景，通常授予 Standard 权限即可满足使用需求；如有更高权限要求，请以实际业务和管理员策略为准
|
添加成功后，可返回 Access and security 的用户列表，在该服务账号对应的 Access level 下拉菜单中将权限升级为 Admin（如当前业务或 API 调用确有需要） |
|
3.3.2 关联经理账号与广告账号
经理账号用于统一管理一个或多个广告账号；广告账号是实际进行广告投放和人群包触达的目标账号。
若服务账号邮箱已添加至经理账号，则通常可通过该经理账号访问其已关联的广告账号，并用于人群包推送。
| 步骤说明 |
截图 |
|
|
|
|
3.3.3 获取经理账号下的广告账号列表（Customer ID List）
- 使用经理账号登录 Google Ads。
- 进入左侧导航栏 Accounts。
- 切换到账号列表页，可查看该经理账号下的广告账号。
- 确认列表中已展示 Customer ID 列。
- 点击页面右上方的下载图标。
- 选择导出格式，例如 CSV 或 Excel CSV。
- 下载后，从文件中提取 Customer ID 列，即为广告账号 ID 列表。
4. 神策侧操作步骤
4.1 创建推送通道
操作路径：进入「数据管理 -> 通用数据集成 -> 数据源管理」，在「受众推送」分类下选择 Google Ads。点击 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 类型虚拟用户属性 |
| 推送字段/映射字段 | 平台字段名称：选择 Google Ads 支持的匹配字段，如 Email、Phone |
推送字段映射与与格式要求：在神策创建 Google Ads 推送连接时，需要配置「神策字段名称」与「平台字段名称」的映射关系。平台字段名称指 Google Ads 可识别的用户匹配字段；神策字段名称指神策项目中用于存放对应用户标识的 string 类型用户属性或 string 类型虚拟用户属性。
| Google Ads 平台字段名称 | 神策字段要求 | 客户侧数据准备 | 神策推送前处理 |
|---|---|---|---|
| 选择存放邮箱的 string 类型用户属性或 string 类型虚拟用户属性 |
建议格式
|
检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送 | |
| Phone | 选择存放手机号的 string 类型用户属性或 string 类型虚拟用户属性 |
建议格式
|
检测 SHA256 格式；已是 SHA256 直接推送，非 SHA256 则先哈希处理后推送 |
说明：
- 可用平台字段以神策创建推送连接页面实际展示为准。
- 若神策字段中存在空值或格式不符合平台要求，该用户可能无法被推送或无法被 Google Ads 成功匹配。
- 请勿在文档、截图或问题排查记录中粘贴真实用户手机号、邮箱等隐私信息。
4.2 角色授权
Google Ads 属于广告平台通道，需要管理员在「平台管理 -> 成员与角色 -> 角色管理」中配置推送通道和广告账户授权。未授权时，成员在创建推送任务时可能看不到对应通道或广告账户。
具体步骤如下：
- 在「平台管理」→「成员与角色」→「角色管理」的在角色列表中定位目标角色，点击「授权对象」进入权限配置页面。
- 在列表中，找到「推送插件管理」分类，勾选 「Google Ads 推送授权」权限项。
- 点击「配置」，设置该角色可使用的推送连接及广告账号范围：
- 全部广告账号：授权角色使用系统内所有已配置的 Meta Ads 推送连接及关联账号。
- 自定义授权：按推送连接或具体广告账号维度，勾选需授权的资源范围
- 完成所有权限配置后，点击「保存」按钮，权限配置即时生效
4.3 创建推送任务
4.3.1 手动推送
在分群历史详情中，可对某个已计算完成的分群版本发起手动推送。
操作路径：
- 进入「分群管理」。
- 打开目标分群详情。
- 进入分群历史详情。
- 点击「立即推送」。
- 选择推送通道、账号或平台所需字段。
- 确认后提交推送任务。
4.3.2 自动推送
当前版本暂不支持自动推送。自动推送能力以后续产品实际支持情况为准。
5. 推送后查看结果
5.1 在 神策数据上查看人群包
推送任务创建后，可在神策侧（分群>推送详情>推送记录 / 数据管理 > 通用数据集成 >推送任务）查看任务执行状态、推送人数、失败原因等信息。任务状态以页面展示为准。
| 状态 | 说明 |
|---|---|
| 等待中 | 任务已创建，等待执行 |
| 推送中 | 系统正在向目标平台推送数据 |
| 成功 | 目标平台已接收本次推送 |
| 失败 | 推送未成功，需查看失败原因 |
| 部分成功 | 部分子任务成功，部分子任务失败，需查看明细 |
失败任务支持在有效期内（3天）手动重试。若失败原因是授权失效、账号权限不足或平台凭证错误，请先修复连接配置后再重试。
5.2 在 Google Ads 平台上查看人群包
推送完成后，可在 Google Ads 后台查看对应的 Customer Match 受众。平台侧通常存在处理延迟，若神策显示推送成功但平台侧暂未展示，请稍后刷新平台后台。
操作步骤：
- 登录 Google Ads 后台
- 进入 Audience manager
- 在 Your data segments 中查找对应的受众列表
- 查看列表名称、状态、规模及处理结果
说明：
- 广告平台侧受众处理通常存在一定延迟，列表状态和规模更新可能不是实时完成。
- 若受众规模异常偏小，可优先检查字段质量、平台资格、账号状态及匹配结果。
- 受众创建成功后，还需在广告系列中正确引用，方可用于后续投放。
6. 常见问题
6.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 权限通常已可满足要求。
6.2 广告账户 ID 校验失败
请确认填写的是目标 Google Ads 广告账号的 Customer ID，且填写时已去掉横杠，仅保留数字。
例如，页面显示为 123-456-7890 时，实际填写值应为 1234567890。
6.3 服务账号可推送哪些广告账号？
服务账号可推送的广告账号范围，取决于其在 Google Ads 中被授予的访问范围。
- 若服务账号被直接添加到广告账号，则通常仅可推送该账号
- 若服务账号被添加到 经理账号，则通常可通过该 经理账号 访问其已关联的广告账号
实际推送时，还需同时满足目标广告账号具备 Customer Match 使用资格。
6.4 为什么创建连接时仅支持广告账户手动配置，不支持自动同步拉取？
当前版本暂不通过 API 自动同步拉取 Google Ads 广告账户。由于 Google Ads 账号访问链路较复杂，自动拉取结果不一定能准确反映实际可用于推送的目标广告账号范围。为降低误选账号导致的错误触达风险，当前版本采用广告账户手动配置方式。
6.5 Email、Phone 入库时已做加密，还能推送到广告平台吗？
只有标准 SHA256 加密值或明文值可以正常推送；非 SHA256 加密值即使推送也大概率无效。
Google 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：广告投放实际触达的人数，受用户在线状态、广告预算、风控、投放策略、是否开启扩量等因素影响。
说明：神策推送成功仅表示数据已成功提交至广告平台，不代表广告平台全部匹配成功。最终可用于投放的人群规模，以广告平台侧展示的受众规模或匹配结果为准。