Facebook Ads 对接指南
准备 Meta 开发者应用的凭据，并在观远连接器中完成 Facebook 广告账户授权。
1. 适用范围
本文适用于有 Meta 广告账户访问权限、需要通过观远连接器同步广告账户及成效数据的客户。当前连接器为“Facebook ADS”平台授权方式，数据账户需要客户端 ID 和客户端密钥。
2. 准备 Meta 应用凭据与授权配置
2.1 打开 Meta 开发者应用
使用具备应用管理权限的账号进入Meta for Developers 的 My Apps 页面，打开用于 Marketing API 的应用；没有应用时从该页面创建。Meta 官方维护的Marketing API 入门资料说明，需要在应用后台添加 Marketing API，并使用有相应权限的账号获取访问令牌。
2.2 获取 App ID 和 App Secret
在目标应用的 App settings → Basic 中核对 App ID 和 App Secret。观远连接器表单里的“客户端 ID”对应 App ID，“客户端密钥”对应 App Secret。只复制同一应用的这一对凭据；不要把 App Secret 放进截图或公开文档。前往 Meta 官方应用后台查看凭据。
2.3 配置授权
当前连接器会请求 ads_read、ads_management 和 business_management，并使用回调地址 https://apiconnector.guandata.com/auth-callback/FACEBOOK_ADS。请在应用的 Facebook Login / Facebook Login for Business 设置中核对有效 OAuth 重定向 URI，并确认登录授权人可以访问目标广告账户。Meta 官方的Marketing API 入门资料区分了自有广告账户与代管其他广告账户时的权限等级；实际所需访问级别以 Meta 应用审核结果为准。
| 所需信息 | Meta 页面 | 用途 |
|---|---|---|
| App ID | 目标应用 → App settings → Basic | 标识发起授权的应用 |
| App Secret | 同一应用的 App settings → Basic | 完成授权码与访问令牌交换 |
| 广告账户访问权限 | 核对 Marketing API 权限与应用访问级别 | 决定授权后可读取的数据范围 |
3. 创建观远连接器数据账户
- 进入“数据账户管理”，点击“新增数据账户”，在“所属平台”中选择“Facebook ADS”。
- 填写便于识别的账户名称，并输入同一 Meta 应用的 App ID 与 App Secret。
- 点击“立即授权”，在 Meta 页面使用有目标广告账户访问权限的账号确认授权。状态显示“已完成”后，点击“确定”保存。
字段填写对照
| Meta 信息 | 连接器字段 | 是否必填 | 官方获取入口 |
|---|---|---|---|
| 不涉及 | 账户名称 | 是 | 自行填写便于识别的名称。 |
| App ID | 客户端 ID（clientId） | 是 | 目标应用的 App settings → Basic |
| App Secret | 客户端密钥（clientSecret） | 是 | 同一应用的 App settings → Basic |
授权与保存
如果授权页提示重定向 URI 不匹配，请核对应用中配置的回调地址；如果提示权限不足，请核对应用权限、应用访问级别和授权人的广告账户权限。授权未完成时不要直接保存数据账户。
4. 常见问题
| 问题 | 处理建议 |
|---|---|
| 找不到客户端 ID 或密钥 | 确认已打开 Meta 开发者后台的目标应用，并在 App settings → Basic 中查看 App ID / App Secret。 |
| 授权后没有目标广告账户 | 核对当前登录账号是否拥有目标广告账户访问权限，以及应用所获的 Marketing API 权限。 |
| 授权到期或失效 | 在数据账户中重新执行授权，并确认应用凭据未更新。 |
