Salesforce 与 Meta Conversions API 集成指南

核心要点

• 你可以通过 Meta Conversions API 将 Salesforce 中选定的潜在客户状态变更回传给 Facebook，让广告系统掌握线索质量，进而有针对性地调整投放策略。

• 利用 CRM 事件优化广告前，需要确保标识符准确无误、事件定义清晰，并经过充分测试。

借助 Meta Conversions API，你可以将服务器或 CRM 中的事件数据发送给 Meta。在 Salesforce 集成方案中，这些事件可以对应合格线索、已预约咨询或已完成购买。

关键的转变发生在初次咨询之后。比如，一个广告活动带来了 100 条线索，另一个只带来 40 条，但后者吸引的用户往往预算充足、需求明确，而不是随便看看，最终促成的深入沟通反而更多。将这些数据回传，能让 Meta 了解你真正看重的业务成果，从而在后续投放中精准优化。

首先要对“转化成果”统一定义。与销售团队明确什么样的线索才算合格线索，并确定要把 Salesforce 中的哪些动态更新回传给 Meta，比如已预约咨询或已成交。

你可以通过原名 Data Cloud 的 Data 360 连接 Salesforce 与 Meta。其内置的 Meta Conversions API 连接器能将潜在客户的更新动态回传给 Meta。例如，可以在销售流程中某个线索推进到新阶段时触发同步。

前提是拥有 Data 360 及其 Ad Audiences 功能的使用权限，该功能需要额外购买许可。

随着销售流程推进，你可以随时向 Meta 回传潜在客户的最新动态。例如，当销售团队将某条线索标记为“可开展销售沟通”时，就可以触发一次更新。

三种方案对比如下：

上述 Stape Conversion Tracking 应用与自定义连接方案均依赖 Webhook。当指定事件发生时（例如线索在 Salesforce 中变为特定状态），Webhook 就会自动发送数据通知。

使用 Stape 应用时，直接在应用设置中勾选线索状态和客户信息即可；而采用自定义连接方案，则需要自行创建并维护这些回传规则。

你可以借助 Google Tag Manager (GTM) 的服务端版本，即服务端 Google Tag Manager（server GTM）来接收这些消息。你可以自主选择要包含哪些信息以及发送到哪里，这也是服务端追踪的一种形式。

Stape 应用同样支持与 server GTM 搭配使用。它能将 Salesforce 中的更新推送给 server GTM，再由后者整理并转发至 Meta 或其他关联平台。

你也可以通过以下任一工具，将 Salesforce 中的潜客状态更新发送给 Meta：

当 Salesforce 中的潜客状态发生变化时，Stape 转化追踪 Salesforce 应用可以自动向 Meta 发送更新。 

2. 选择更新发送方式。 参考上一节的对比，选择 Meta Conversions API Gateway、Signals Gateway 或 server GTM。在连接该应用前，请先在你的 Stape 账户 中配置好所选工具。

3. 填写连接信息。该应用需要相应的 ID 和访问代码才能连接到所选工具。请访问下方链接查找所需详情。

4. 指定应用读取客户信息的路径。 针对你要发送的每项信息（例如邮箱地址或电话号码），选择其在 Salesforce 中的存储位置。如果你记录了 Meta Lead ID，也一并选出它的位置。该 ID 是用户通过 Meta 表单提交潜客信息时由 Meta 分配的编号。此步骤为选填项，下拉列表仅显示团队已添加到 Salesforce 中的字段。

5. 选择要发送哪些潜客更新。 选出需要上报给 Meta 的潜客状态，并为每项更新命名。每次上报同一状态时，请使用相同的名称。随后点击保存并连接（Save and Connect）。

6. 完成 server GTM 的配置（若选择了此项）。 Server GTM 需要借助 Stape 的 Data Client 来读取应用推送的更新，并通过 Meta Conversions API 标签将其发送给 Meta。请按照 Salesforce 应用配置指南进行设置，并包含用于标识数据源来自 Salesforce 的信息。

7. 检查更新是否成功送达 Meta。在 Salesforce 中创建一个测试潜客来检验连接是否正常。接着，将其状态更改为在第 5 步中选定要发送给 Meta 的某种状态。

如果你需要自定义从 Salesforce 发送更新的规则，可以使用该选项。例如，你可能希望在销售团队将某个潜客标记为符合沟通条件时，第一时间同步给 Meta。

以下步骤介绍了如何利用 Salesforce Flow 和 server GTM 搭建 Salesforce 到 Meta 的自定义连接。本例中使用的 /salesforce 路径就是该自定义配置的一部分。

如果你选用 Stape 转化追踪应用，请参考我们的Salesforce 应用配置指南。完成 server GTM 的配置后，该应用会自动发送你选定的潜客状态更新，无需再专门创建 Salesforce Flow 来同步这些内容。

第 1 步：选择要发送的更新内容

先从一个你想要追踪的变更开始。例如，当潜客达到销售沟通条件时，你可以发送一个名为 SalesQualified 的事件。

确定要包含哪些信息。

请将“新潜在客户”和“已准备好进行销售沟通的潜在客户”视为两个独立的事件。 

步骤 2. 配置服务端 GTM 以接收更新

首先，按照服务端容器设置指南创建服务端容器，并将其托管在 Stape 上。服务端容器包含接收追踪信息并将其分发到目标平台的各项工具和规则。

接下来，添加 Stape 的 Data Client。该客户端用于读取 Salesforce 发送的更新，以便在服务端 GTM 中使用这些数据。

1. 1.

   下载模板。打开 Data Client 下载页面，依次点击 Code → Download ZIP，解压下载的压缩包。在解压出的文件夹中找到名为 template.tpl 的文件，这就是稍后需要导入的文件。

2. 2.

   在 Google Tag Manager 中打开服务端容器。接下来的步骤将在 Google Tag Manager 中完成。打开 Templates，然后在 Client Templates 下点击 New。

3. 3.

   导入文件。点击右上角的三点菜单 → 点击 Import → 在解压的文件夹中选择 template.tpl → 点击 Save。

4. 4.

   创建 Data Client。打开 Clients → 点击 New → 打开 Client Configuration → 选择 Data Client。为它命名，例如“Salesforce updates”。

5. 5.

   设置 Salesforce 推送更新的路径。打开 Accepted Path Settings → 点击 Add path → 输入 /salesforce → 点击 Save。

路径是指网址末尾的部分。例如，如果你的标记服务器地址是 https://track.example.com，加上该路径后就是 https://track.example.com/salesforce。

步骤 3. 创建 Salesforce Flow 以实现自定义连接

配置 Salesforce 连接设置。这些设置用于保存服务器地址以及 Salesforce 连接该服务器所需的详细信息。

在 Salesforce 中，进入 Setup → Flows。Flow 是一组自动执行的规则。

你需要配置一个满足以下要求的 Flow：

• 检测潜在客户何时变更为你指定的状态。

• 等待 Salesforce 保存更改后，在后台发送更新。

• 附带在步骤 1 中选取的客户详细信息及事件数据。

若要添加发送步骤，请依次选择 Action → Create HTTP Callout，然后选择 POST。这会指示 Salesforce 向你的服务器发送数据。请填入你的 Stape 服务器地址及前面配置的路径，例如 /salesforce。

推送的消息必须采用 JSON 格式，以便接收端工具读取这一结构化数据。你需要准备好相应的数据格式，并将 Salesforce 中的实际数据填充进去。具体配置请参考 Salesforce 的 HTTP Callout 操作指南。

将 Flow 设置为仅在状态变更时发送更新，避免在修改备注等无关信息时重复发送同一事件。

在正式应用于生产数据之前，请先在独立的测试环境（Salesforce 沙盒）中测试该 Flow。

步骤 4. 配置将更新发送至 Meta 的代码

首先，确认服务端 GTM 能够正常接收 Salesforce 推送的消息。参考 Stape 的 Webhook 测试指南，使其在 Preview 模式中可见。

打开Event Data，核对需要的信息是否已正常显示。接着，针对 Meta 代码所需的各项参数创建 Event Data 变量。变量的作用是告诉代码去哪里读取对应的值，例如邮箱地址或事件名称。

1. 在 Google Tag Manager 中打开你的服务端容器。

2. 点击左侧菜单的模板。在代码模板下方，点击搜索社区模板库。

3. 点击搜索图标，搜索 Facebook Conversions API。Meta Conversions API 代码在模板库中使用的就是这个名称。

4. 选择由 stape-io 提供的模板，然后点击添加至工作区。确认其申请的权限无误后，点击添加。

模板添加完成后，接下来就可以用它来创建代码了。

5. 打开左侧菜单中的代码 → 点击新建。

6. 点击代码配置 → 选择 Facebook Conversions API。

7. 为代码起一个清晰的名称，例如“Meta Salesforce updates”。

接下来进行如下配置：

• 在 Event Name Setup Method 下选择 Override，以便自定义事件名称。

• 输入你的 Meta Pixel ID 和 API Access Token。这两项参数用于指定数据接收端，并授权该代码发送数据。

• 在 Action Source 下，针对本例中线索状态的自动更新，选择 System Generated。

• 在 User Data 下，选择包含客户详细信息的变量。

• 在 Server Event Data Override 下，添加事件 ID 以及状态变更发生的时间。

最后，添加一个同时满足以下两个条件的触发器：

• Client Name 等于你在第 2 步中为 Data Client 设置的确切名称。如果之前命名为 Salesforce updates，这里同样填入 Salesforce updates。

• Event Name 等于 SalesQualified（即本例中使用的传入事件名称）。如果你设置了其他传入事件名称，请填入对应的名称。

只有同时满足这两个条件时，代码才会触发。保存该触发器和代码。

第 5 步：验证更新能否从 Salesforce 顺利同步至 Meta

打开 Meta 事件管理工具 → 测试事件。参考 Stape 的测试指南，将测试代码复制到代码的 Test ID 字段中。

在 Salesforce 测试环境中创建一条示例线索，并将其状态修改为第 1 步中所选的状态。

检查并确认以下几点：

• 服务端 GTM 的预览中已出现该更新。

• Meta 返回的状态码为 200，表示请求已成功发送（查看路径：服务端 GTM 预览 → Request → 发送至 Meta 的出站请求 → Response）。

• Meta 的测试事件中已显示该事件。

• 事件名称、ID、时间戳以及客户详细信息均准确无误。

测试全部通过后，移除测试代码和临时预览配置。发布服务端 GTM 的更改，并将测试无误的流程部署到 Salesforce 正式环境中。

当你将 Salesforce 的更新（例如线索转化为客户）同步给 Meta 时，Meta 需要确认这条更新对应的是哪位用户。邮箱地址、电话号码等信息有助于 Meta 将这些动态与用户的 Facebook 或 Instagram 账号进行匹配。

事件匹配质量（EMQ）是 Meta 针对这些客户信息匹配有效性给出的评分，满分为 10 分。得分越高，说明你传输的信息越有助于匹配，但这并不代表广告带来了更多销量。

想要提升同步给 Meta 的客户信息质量，重点可以做好以下三项核查：

• 保存有助于 Meta 识别潜客的标识码。针对网站端潜客，请将可用的 _fbp 和 _fbc 代码保存在 Salesforce 中，它们分别用于识别访客的浏览器以及广告点击行为。针对 Meta 即时表单（用户直接在 Facebook 或 Instagram 上填写的表单）获取的潜客，务必保存原始的 Meta Lead ID。这是 Meta 为每次表单提交生成的唯一标识码，不能用 Salesforce 自身的记录 ID 替代。

• 按 Meta 要求的格式处理客户信息。电子邮箱和电话号码必须遵循 Meta 的格式规范，并经过 SHA256 哈希处理，将原始数据转换为由字母和数字组成的代码。请确认用于向 Meta 推送 Salesforce 更新的工具（例如 Salesforce Data 360、Stape 的 Conversion Tracking 应用、网关，或服务端 GTM 中的 Stape Meta Conversions API 标签）是否已自动完成格式化与哈希。若已处理，切勿重复哈希。

浏览器代码、广告点击代码和 Meta Lead ID（fbp、fbc 和 lead_id）请直接发送，无需哈希。

• 检查数据连接实际发送的内容。查看最近几条 Salesforce 更新推送给 Meta 的具体数据，确认勾选共享的客户信息是否确实包含在内。例如，即便配置时勾选了邮箱字段，但如果该字段本身为空也是徒劳。若要发送用于识别网络连接的 IP 地址，请使用客户的真实 IP，切勿使用 Salesforce 服务器的 IP 地址代入。

下表汇总了各类常见问题的排查要点。请先根据实际现象找到对应说明，再逐一排查建议的检查项，确认可能需要调整的配置。

客户可能在看到你的 Meta 广告后，通过电话或前往实体店完成购买。这类购买行为即属于 线下转化。如果你在 Salesforce 中记录了这些交易，可以将购买详情发送给 Meta，从而将这些销售额与对应的广告关联起来。

发送事件时，需要向 Meta 标明该行为发生的场景。这项信息被称为 行动来源（Action Source）。例如：

• 如果是通过电话完成的购买，请使用 phone_call。

• 如果是在实体店内完成的购买，请使用 physical_store。

如果你使用的是服务端 GTM（无论是搭配 Stape Conversions Tracking Salesforce 应用还是 Salesforce Flow），请按照以下步骤操作：

1. 1.
2. 2.

   点击左侧菜单中的 Tags（代码）。

3. 3.

   打开此前创建的用于同步 Salesforce 更新的 Meta Conversions API 代码。

4. 4.

   点击 Tag Configuration（代码配置），然后找到 Action Source 下拉菜单。

根据你要发送的事件选择对应选项：

• 若购买是通过电话完成并通过 Salesforce Flow 上报，请选择 Phone Call。

• 若购买是在实体店内完成并通过 Salesforce Flow 上报，请选择 Physical Store。

• 若是由我们的 Conversion Tracking 应用发送潜在客户状态更新，请选择 System Generated。

当把 Stape 的 Conversion Tracking 应用连接到任意网关（Meta CAPIG 或 Signals Gateway）时，Action Source 并不是应用内可修改的设置项。你只需选择要发送哪些潜在客户状态变更及客户详细信息。如需自行设置 Action Source，请使用服务端 GTM，并在 Meta Conversions API 代码中进行选择。

如果你使用 Salesforce Data 360 发送潜在客户状态更新，其 配置指南会指引你将 Action Source 选为 system_generated。在这种情况下，你上报的是 Salesforce 中潜在客户记录的变更，例如销售跟进电话后的状态更新。

销售确认后，请发送 Purchase 事件，并附上交易金额、币种以及购买发生的具体日期和时间。 

如需查看视频示例，可观看我们的 线下转化研讨会。应用演示部分始于 23:00，服务端 GTM 演示部分始于 36:11。

这篇文章对你有帮助吗？