1. 产品概述
本功能支持将神策系统内的用户分群同步至 Google Ads，生成可用于广告投放的受众列表。
用户可通过事件、属性、标签等组合构建目标分群，分群创建完毕后即可发起人群推送，推送成功的受众数据将同步至 Google Ads，支持应用于再营销、相似受众拓展、定向投放、人群排除等各类广告投放场景。
适用版本：SA 3.0.4 及以上版本。
使用限制：使用该功能前，需先开通「海外人群包推送」，并安装 Google Ads 对应平台插件。完成插件配置与账号授权后，即可在分群页面创建推送任务，选择 Google Ads 作为目标渠道，并提交人群包推送。
2. 推送至 Google Ads 前准备工作
在神策后台创建 Google Ads 推送连接前，需先完成 Google Ads 与 Google Cloud 平台侧授权配置，并获取以下字段：
- 服务账号（Service Account）
- 服务账号密钥（Service Account Key）
- 开发者令牌（Developer Token）
- 广告账户 ID（Google Ads Account ID）
注：Google 页面菜单名称可能因账号类型、页面版本或语言设置不同而略有差异，请以实际页面展示为准
2.1 申请开发者令牌（Developer Token）
2.1.1 创建或确认 Google Ads 经理账号
Google Ads 的 Developer Token 通常需基于 Google Ads 经理账号（Manager Account）申请。
因此，在进行后续 API 对接前，请先确认当前已拥有可用的 Google Ads 经理账号；若尚未创建，请先参考官方文档完成创建
2.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 |
|
2.2 生成服务账号和服务账号秘钥（Service Account、Service Account Key）
2.2.1 创建 Google Cloud 项目并启用 Google Ads API
Service Account 需基于 Google Cloud 项目创建，且目标项目需先启用 Google Ads API
| 步骤说明 | 截图 |
| 登录 Google Cloud 控制台（需登录 Google 账号后查看） | |
|
|
|
|
2.2.2 创建 Service Account
启用 Google Ads API 后，需在 Google Cloud 项目中创建 Service Account
| 步骤说明 |
截图 |
|
|
|
|
2.2.3 下载 Service Account Key
创建 Service Account 后，需下载对应的 JSON 格式密钥文件
| 步骤说明 |
截图 |
|
|
2.3 获取广告账户列表
Service Account 可访问的账号，取决于其被添加到哪些 Google Ads 广告账号或经理账号中。添加至经理账号后，该经理账号下已关联的广告账号原则上均可访问，并可用于人群包推送。
2.3.1 配置 Service Account 的 Google Ads 访问权限
对于人群包推送场景，通常授予 Standard 权限即可满足使用需求。
| 步骤说明 |
截图 |
|
。
|
注：若页面未提供 Admin 访问级别，可先按实际可选权限完成添加；对于人群包推送场景，通常 Standard 权限即可满足使用 |
|
权限级别升级（Standard 升级为 Admin）：对于人群包推送场景，通常授予 Standard 权限即可满足使用需求；如有更高权限要求，请以实际业务和管理员策略为准
|
添加成功后，可返回 Access and security 的用户列表，在该服务账号对应的 Access level 下拉菜单中将权限升级为 Admin（如当前业务或 API 调用确有需要） |
|
2.3.2 关联经理账号与广告账号
经理账号用于统一管理一个或多个广告账号；广告账号是实际进行广告投放和人群包触达的目标账号。
若服务账号邮箱已添加至经理账号，则通常可通过该经理账号访问其已关联的广告账号，并用于人群包推送。
| 步骤说明 |
截图 |
|
|
|
|
2.2.3 获取经理账号下的广告账号列表（Customer ID List）
- 使用经理账号登录 Google Ads。
- 进入左侧导航栏 Accounts。
- 切换到账号列表页，可查看该经理账号下的广告账号。
- 确认列表中已展示 Customer ID 列。
- 点击页面右上方的下载图标。
- 选择导出格式，例如 CSV 或 Excel CSV。
- 下载后，从文件中提取 Customer ID 列，即为广告账号 ID 列表。
2.2.4 Customer Match 使用资格说明
若后续需将神策人群包推送至 Google Ads 进行广告触达，请先确认目标广告账号具备 Customer Match 使用资格。Google 官方通常不提供单独的资格查询页面，建议结合 Customer Match 政策及账号后台实际可用状态综合判断，例如是否可正常创建、上传并使用 Customer List。若账号不满足相关要求，即使推送连接创建成功，仍可能无法正常进行人群包触达。
Customer Match 政策：https://support.google.com/adspolicy/answer/6299717
3. 操作步骤
3.1 创建推送通道
完成 Google 平台侧授权准备后，可在神策后台创建 Google Ads 推送连接
在「数据管理」→「通用数据集成」→「数据源管理」，找到「受众推送」分类。在受众推送平台列表中选择「Google Ads 」，点击进入 Google Ads 连接管理 页面
点击 Google Ads 连接管理 页面右上角 创建，在弹出的 添加连接 抽屉中填写配置项如下：
- 连接名称：自定义填写便于识别的名称，例如：华东区-Google主投放账号
- 服务账号（Service Account）：在 Google Cloud 中创建的 Service Account
- 服务账号秘钥（Service Account Key）：上传该服务账号对应的 JSON 格式密钥文件
- 开发者令牌（Developer Token）：填写 Google Ads API 对应的 Developer Token（必须提供访问权限为 Basic Level 的 Developer Token）
- 广告账户（Google Ads Account ID）：填写目标 Google Ads 广告账号 ID，支持单个或批量录入。Google Ads 后台账号中 Customer ID 格式通常为 123-456-7890。在神策创建连接时填写时需去掉横杠，仅保留数字1234567890。
- 字段映射/推送字段：定义神策侧用户标识字段与目标平台用户识别字段之间的对应关系。，用于目标平台识别和匹配用户。推送的字段需严格遵循 Google Customer Match 格式规范，本期仅支持 Email 与 Phone 两种用户标识字段，Google Ads 平台字段格式要求如下：
- Email 字段：
- 需为完整合规的有效邮箱，包含用户名、@符号及合法域名；
- 内容不得包含空格、冗余符号及 #、&、* 等非法特殊字符。
- 示例：zhangsan@example.com、lisi.123@gmail.com。
- Phone 字段：
- 统一采用 E.164 国际标准格式：以 + 开头，依次拼接国家代码、区号、电话号码，禁止使用空格、括号、横杠等分隔符号。
- 中国手机号示例：+8613800138000（+86 为中国国家代码）。
- 固定电话示例：+861088886666（+86 为中国国家区号，10 为北京地区区号）
- Email 字段：
完成填写后，点击 测试连接。测试通过后，点击 提交，完成 Google Ads 推送连接创建。
3.2 广告账户授权
- 在「平台管理」→「成员与角色」→「角色管理」的在角色列表中定位目标角色，点击「授权对象」进入权限配置页面。
- 在列表中，找到「推送插件管理」分类，勾选 「Google Ads 推送授权 / Meta Ads 推送授权」权限项。
- 点击「配置」，设置该角色可使用的推送连接及广告账号范围：
- 全部广告账号：授权角色使用系统内所有已配置的 Google Ads 推送连接及关联账号。
- 自定义授权：按推送连接或具体广告账号维度，勾选需授权的资源范围
- 完成所有权限配置后，点击「保存」按钮，权限配置即时生效
3.3 创建推送任务
在 分群管理 -> 分群详情 -> 分群历史详情中，选择一条计算成功的分群版本，点击操作列中的 立即推送。
点击 立即推送 后，打开 创建推送 抽屉，配置项如下
- 推送名称：默认使用当前分群名称，用于识别本次推送。不可修改。
- 分群版本：当前选择的分群历史版本时间。不可修改。
- 分群结果数：当前分群版本的用户数。不可修改。
- 推送通道：选择已配置且当前角色可用的
Google Ads推送通道， - 广告账户 ：海外广告平台必填，选择已配置且当前角色可用的广告账号
- 字段映射 / 推送字段：
- Google Ads 支持选择以下字段进行用户匹配： Email、Phone 字段映射；
- 配置要求：
- 至少选择一个字段。
- 支持同时选择 Email 和 Phone。多字段推送时，Google Ads 按「或」逻辑进行匹配，即任一字段匹配成功即可识别该用户。
- 可推送结果数预估：完成必填配置后，点击
预估查看可推送结果数，用于判断当前分群历史版本中实际满足目标平台推送要求的用户数量。建议提交前执行
3.4 查看推送任务
3.4.1 在分群详情页查看
可在 分群管理 -> 分群详情 -> 推送记录 中，查看该分群对应的推送任务及执行结果。
适用场景：适用于查看单个分群的推送记录及执行结果。
3.4.2 在推送任务页查看
可在 数据管理 -> 通用数据集成 -> 推送任务 中，搜索、查看、管理推送任务
适用场景：适用于统一查看全部分群的推送任务。
3.5 在 Google Ads 平台上查看人群包
推送完成后，可在 Google Ads 后台查看对应的 Customer Match 受众。
操作步骤：
- 登录 Google Ads 后台
- 进入 Audience manager
- 在 Your data segments 中查找对应的受众列表
- 查看列表名称、状态、规模及处理结果
说明：
- 广告平台侧受众处理通常存在一定延迟，列表状态和规模更新可能不是实时完成。
- 若受众规模异常偏小，可优先检查字段质量、平台资格、账号状态及匹配结果。
- 受众创建成功后，还需在广告系列中正确引用，方可用于后续投放。
4. 常见问题
4.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 权限通常已可满足要求。
4.2 广告账户 ID 校验失败
请确认填写的是目标 Google Ads 广告账号的 Customer ID，且填写时已去掉横杠，仅保留数字。
例如，页面显示为 123-456-7890 时，实际填写值应为 1234567890。
4.3 服务账号可推送哪些广告账号？
服务账号可推送的广告账号范围，取决于其在 Google Ads 中被授予的访问范围。
- 若服务账号被直接添加到广告账号，则通常仅可推送该账号
- 若服务账号被添加到 经理账号，则通常可通过该 经理账号 访问其已关联的广告账号
实际推送时，还需同时满足目标广告账号具备 Customer Match 使用资格。
4.4 为什么创建连接时仅支持广告账户手动配置，不支持自动同步拉取？
当前版本暂不通过 API 自动同步拉取 Google Ads 广告账户。由于 Google Ads 账号访问链路较复杂，自动拉取结果不一定能准确反映实际可用于推送的目标广告账号范围。为降低误选账号导致的错误触达风险，当前版本采用广告账户手动配置方式。
4.5 Email、Phone 入库时已做加密，还能推送到广告平台吗？
只有标准 SHA256 加密值或明文值可以正常推送；非 SHA256 加密值即使推送也大概率无效。
Google Ads、Meta Ads 等广告平台要求 Email、Phone 使用标准 SHA256 哈希值进行匹配。神策推送时会判断字段值是否已是 SHA256 格式：
- 若已是 SHA256 格式：直接上传到目标平台。
- 若不是 SHA256 格式：神策会先进行 SHA256 加密后再上传至目标平台。
如果客户入库时使用了 MD5、加盐 SHA256 或其他非标准加密方式，神策可能会将其识别为非 SHA256 并再次加密，最终都会导致广告平台无法正确匹配用户。
建议：Email、Phone 保持明文入库，或使用广告平台认可的标准 SHA256 哈希值入库。
4.6 为什么分群结果数、可推送结果数、广告平台匹配人数不一致？
这是正常现象。用户从神策分群到广告平台触达，会经过字段过滤、数据加密、平台匹配、广告投放等环节，每一步人数都可能减少。
- 整体关系通常为：
分群结果数 M ≥ 可推送结果数 N ≥ 广告平台匹配人数 P - 若广告仅基于该受众定向投放，通常：
广告平台匹配人数 P ≥ 实际触达人数 Q
指标口径说明如下：
- 分群结果数 M：神策分群计算出的目标用户总数。
- 可推送结果数 N：根据本次字段映射筛选后，具备有效 Email / Phone 等推送字段，并完成平台要求加密处理的用户数，按用户去重统计。
- 广告平台匹配人数 P：广告平台收到数据后，与自身用户库匹配成功并进入受众池的人数。
- 实际触达人数 Q：广告投放实际触达的人数，受用户在线状态、广告预算、风控、投放策略、是否开启扩量等因素影响。
说明：神策推送成功仅表示数据已成功提交至广告平台，不代表广告平台全部匹配成功。最终可用于投放的人群规模，以广告平台侧展示的受众规模或匹配结果为准。