Facebook 广告和线索接入（完善版）
概述
Facebook 广告和线索接入（完善版）的操作说明。
开始之前
[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。
操作说明
Facebook（Meta）广告和线索接入用于将广告账户、广告层级数据以及 Lead Ads 即时表单线索同步到纷享销客，便于统一分配、跟进和分析。
- 已购买并开通 Facebook 连接器，且当前员工拥有营销通和集成平台的配置权限。
- 准备可正常登录 Meta 的账号。该账号需具备目标业务资产的管理权限，包括广告账户、Facebook 公共主页和即时表单线索访问权限。
- 确认目标广告账户、公共主页和即时表单属于同一业务组合，或已正确共享给当前账号。
- 授权前允许浏览器弹窗及第三方 Cookie，避免在无痕模式下操作。
- 提前确认 CRM 线索必填字段、负责人和去重规则，避免同步后产生缺字段或重复线索。
权限建议：使用专门的企业授权账号并遵循最小权限原则；不要在截图、文档或群聊中展示访问令牌、客户密钥等敏感信息。
开通插件并完成授权
1 开启 Facebook 广告插件
- 联系客户经理购买并开通 Facebook 连接器。
- 进入营销通 > 系统设置 > 插件中心 > 营销插件。
- 找到Facebook 广告并打开插件开关。
检查结果：插件状态显示为已开启，当前账号可以看到 Facebook 连接器配置入口。
2 进入连接器并授权
- 进入系统管理 > 集成平台管理 > 连接器。
- 选择Facebook 连接器或Facebook 广告连接器。不同版本的页面名称可能略有差异。
- 在连接配置页发起 OAuth 授权，使用具备目标业务资产权限的 Meta 账号登录。
- 授权时保留业务所需的广告账户、公共主页和线索访问权限，不要跳过资产选择。
- 返回连接器页面，确认授权状态为已授权。
若页面提示授权成功但没有可选广告账户或公共主页，请先在 Meta Business Suite 中检查业务资产归属、账号角色和线索访问权限，再重新授权。
配置连接对象
连接对象决定可以从 Facebook 获取哪些数据。建议先完成广告对象，再配置即时表单及线索对象。
- 打开连接器的连接对象页，点击新建。
- 选择自主获取主对象，从已授权账号读取可用对象。
- 按实际业务范围选择广告账户、公共主页和即时表单，避免一次接入无关资产。
- 依次创建广告系列、广告组、广告以及即时表单/线索相关对象；对象名称以当前连接器实际返回结果为准。
- 检查对象字段是否完整，尤其是各层级 ID、名称、状态、时间、表单 ID 和线索 ID。
Facebook 广告层级：广告系列（Campaign） > 广告组（Ad Set） > 广告（Ad）。原 Google 文档中的关键词和关键词投放计划不适用于 Facebook，不应复制到本接入流程。
配置数据集成流
1 推荐配置与启用顺序
- 广告系列集成流。
- 广告组集成流。
- 广告集成流及投放明细集成流（如连接器提供）。
- 即时表单及表单线索集成流。
Facebook 广告数据与表单线索是两类独立数据，应分别配置连接对象和集成流。
广告对象之间存在关联关系。首次同步历史数据时，先完成上游对象并验证成功，再启用下游对象，避免广告组或广告找不到对应广告系列。
2 广告数据接入范围
Facebook 连接器既支持即时表单线索，也支持广告相关数据。广告数据应按平台层级分别创建连接对象和集成流，不包含 Google 广告中的关键词、关键词投放计划等对象。
广告系列（Campaign）：建议同步广告系列 ID、名称、状态、投放目标、预算、开始时间和结束时间。
广告组（Ad Set）：建议同步广告组 ID、所属广告系列 ID、名称、状态、预算、出价策略、优化目标和受众信息。
广告（Ad）：建议同步广告 ID、所属广告组 ID、所属广告系列 ID、名称、状态和创意标识。
投放明细/成效数据：连接器提供时，可同步日期、曝光、覆盖人数、点击、消耗、CTR、CPC、CPM、转化和线索数等指标。
具体对象和指标以当前 Facebook 连接器实际返回结果为准；广告账户时区、币种和归因窗口需要在上线前统一确认。
3 新建广告与线索集成流
- 进入系统管理 > 集成平台管理 > 数据集成流，点击新建数据集成流。
- 数据源选择已授权的 Facebook 连接器及对应连接对象。
- 目标对象选择 CRM 中用于承接数据的对象；线索数据通常写入线索对象。
- 设置集成流名称。建议包含平台、对象和用途，例如“Facebook-LeadAds-线索同步”。
- 配置查询频率和同步时间窗口。广告统计可按日同步；线索有及时性要求时，按连接器支持的最短周期设置。
4 配置广告与线索字段映射
Facebook 广告数据和即时表单线索应分别映射：先保留广告层级的原始 ID 与上下级关系，再配置 CRM 线索必填字段和广告归因字段。
| 对象/类型 | 源字段或固定值 | CRM 目标字段 |
|---|---|---|
| 公共固定值 | 广告渠道（ad_source） | |
| 公共固定值 | 广告营销 | 活动类型（event_type） |
| 公共固定值 | 预设业务 | 业务类型（record_type） |
| 公共固定值 | 有效员工 ID | 负责人（owner） |
| 广告系列（Campaign） | name | 市场活动名称（name） |
| 广告系列（Campaign） | start_time / stop_time | 开始日期（begin_time）/ 结束日期（end_time） |
| 广告系列（Campaign） | status / effective_status | 状态（原）（status） |
| 广告系列（Campaign） | id / objective / daily_budget / lifetime_budget | Facebook 广告系列 ID / 投放目标 / 预算 |
| 广告组（Ad Set） | name / campaign / campaign_id | 市场活动名称 / 父级市场活动（parent_id） |
| 广告组（Ad Set） | id / start_time / end_time / status | Facebook 广告组 ID / 开始日期 / 结束日期 / 状态 |
| 广告组（Ad Set） | daily_budget / lifetime_budget / bid_strategy / optimization_goal | 预算 / 出价策略 / 优化目标 |
| 广告（Ad） | name / adset / adset_id | 市场活动名称 / 父级市场活动（parent_id） |
| 广告（Ad） | id / campaign_id / adset_id / status / creative_id | 对应 Facebook ID / 状态 / 广告创意 ID |
| 广告成效（Insights） | date_start / date / spend / clicks / impressions | 投放日期 / 消费（costs）/ 点击（clicks）/ 展现（shows） |
| 广告成效（Insights） | 广告或广告组关联 / reach / ctr / cpc / cpm / conversions / leads | 市场活动名称（marketing_event_id）/ 对应成效指标字段 |
关联与唯一键：广告系列、广告组和广告分别以 campaign_id、adset_id、ad_id 作为外部唯一标识；广告组成流通过 campaign_id 查找父级广告系列，广告成效明细关联到已同步的最低可用广告层级。若 CRM 目标对象中没有 Facebook ID、CTR、CPC、CPM、转化数或线索数等字段，应先创建对应的文本或数字字段，再配置映射。字段名称可能因连接器版本略有差异，应选择语义相同的实际返回字段。
表单线索映射：先映射 CRM 必填字段，再补充广告归因字段。推荐至少配置以下内容：
- 姓名/联系人名称：对应即时表单中的姓名字段。
- 手机、邮箱、公司、职位、国家/地区、城市：按表单实际字段一一映射。
- 线索来源：固定为 Facebook 或 Meta Lead Ads，便于筛选和统计。
- 负责人：填写有效员工 ID；可在系统管理 > 部门与员工中查询。
- 广告账户 ID、公共主页 ID、广告系列 ID、广告组 ID、广告 ID、表单 ID：保留原始平台标识，便于归因和排查。
- Facebook 线索 ID（lead_id）：建议作为外部唯一标识或去重依据。
- 创建时间：统一确认时区。报表口径需区分 Meta 广告账户时区和企业 CRM 时区。
- 隐私政策同意项、自定义问题答案：仅同步业务必要字段，并映射到合适的 CRM 字段。
字段变化处理：即时表单新增、删除或重命名问题后，应重新获取连接对象字段并检查映射，确认无误后再恢复集成流。
5 去重和更新策略
- 优先使用 Facebook 线索 ID 作为唯一键，避免轮询窗口重叠时重复创建；按手机号或邮箱去重时需明确空值、国家区号和大小写规则；同时确认重复数据是更新、跳过还是新建，并与 CRM 现有规则保持一致。
6 历史数据同步
- 首次上线先选择较小时间范围试跑，验证通过后再扩大历史范围。
- 按“广告系列 > 广告组 > 广告/投放明细”的顺序同步广告数据。
- 线索历史数据按表单和时间范围同步，并确认 Meta API 对历史线索的可查询范围。
- 不要套用 Google 关键词对象“选择 1 天即可同步全部历史”的特殊规则；Facebook 应以连接器实际返回结果为准。
启用前验证
- 保存集成流配置但暂不大范围启用，先使用测试广告账户或小时间窗口执行一次。
- 在集成流运行日志中确认请求成功、读取条数、写入条数和失败条数。
- 在 CRM 中抽查至少一条线索，核对姓名、联系方式、来源、负责人、广告层级 ID、表单 ID 和创建时间。
- 确认同一条 Facebook 线索重复执行后不会再次创建。
- 验证通过后按上游到下游的顺序启用集成流，并记录启用时间和配置负责人。
日常运维与数据安全
- 定期检查授权状态、运行日志和失败告警。授权账号角色变化、密码变更或 Meta 权限策略调整后，可能需要重新授权。
- 表单或 CRM 字段发生变化时，先暂停相关集成流，刷新连接对象并更新字段映射。
- 只同步业务必要的个人信息，按企业隐私政策配置访问权限、留存周期和删除流程。
- 截图前遮盖广告账户 ID、公共主页 ID、员工 ID、个人信息和授权凭证。
常见问题
1 授权后看不到广告账户或公共主页
检查当前 Meta 账号是否拥有目标业务资产权限，公共主页和广告账户是否属于同一业务组合，以及该账号是否获得线索访问权限。修正后重新授权。
2 可以同步广告数据，但收不到表单线索
检查即时表单是否已发布、公共主页是否选对、账号是否具备 Lead Access 权限、线索连接对象是否创建，以及线索集成流是否启用。
3 表单字段缺失或映射失效
表单问题发生变更后，重新获取连接对象字段并更新映射。CRM 必填字段未映射时，通常会导致写入失败。
4 出现重复线索
确认是否使用 Facebook 线索 ID 去重，并检查多个集成流是否同步了相同表单、轮询时间窗口是否重叠，以及失败重试是否配置为幂等写入。
5 集成流运行失败或长时间无数据
依次检查授权状态、集成流状态、查询时间范围、广告账户和表单选择、运行日志错误信息。若权限失效，重新授权后再次试跑。
上线验收清单
- Facebook 插件已开启，连接器状态为已授权。
- 广告账户、公共主页和即时表单均可正常读取。
- 广告层级对象按顺序创建并完成历史数据验证。
- CRM 必填字段、负责人、来源和 Facebook 线索 ID 已正确映射。
- 去重策略、时区和历史同步范围已确认。
- 测试线索成功写入 CRM，运行日志无未处理错误。
- 敏感信息已从配图和示例中遮盖。
Facebook 广告和线索接入操作说明
- 联系客户经理购买 Facebook 连接器订单后，前往营销通-系统设置-插件中心-Facebook 广告打开插件。
- 前往系统管理页面，集成平台管理-连接器-Facebook 广告连接器，进入连接器。
- 进入 Facebook 广告连接器进行广告授权。
配置连接对象详细说明
新建连接对象，点击自主获取主对象。
配置集成流
1 配置表单集成流
- 前往集成平台管理-数据集成流-新建数据集成流。
- 集成流的查询频率设置成每天轮询一次，每次凌晨 1:00 执行。
- 配置集成流的字段映射。可根据表单字段和线索必填字段，按需配置映射。
- 配置完成后保存并启用。
注意：有广告相关对象彼此存在关联关系，得优先同步被关联的对象数据。因此，启用时优先开启并同步广告系列历史数据，再开启并同步广告组历史数据，再同步关键词历史数据，最后在同步广告投放明细、关键词投放计划和关键词投放明细。
预期结果与验证
完成上述操作后，在对应页面检查处理结果，并与本步骤的目标核对。