转化 API

最佳实践 — 转化 API

您可以将这些最佳实践用作一般建议，助自己成功集成转化 API。本文中的建议旨在帮助您最有效地使用转化 API。请遵循实现及实现后建议，确保顺利集成并在与 Meta 共享数据时取得最佳结果。

除了下列最佳实践外，我们还建议您观看此视频，以获得有关使用转化 API 的实践教程。该视频将指导您完成以下工作：

使用转化 API 分享的网络、应用和实体店铺事件需要特定参数。如需获取必要参数的列表，请参见此处。

实施

设置广告系列时，简化帐户结构，并使用下列已构建的广告系列最佳实践：

设置冗余事件

除了 Meta Pixel 像素代码之外，我们还建议您使用转化 API，并使用这两种工具分享相同的事件。我们将之称为冗余事件设置。例如，如果使用 Meta Pixel 像素代码分享 Purchase、Initiate Checkout 和 Contact 事件，您还应该使用转化 API 从服务器中分享这些相同的事件。

一些网站事件在通过 Pixel 像素代码分享时，可能会因网络连接问题或页面加载错误而丢失，此时您便可使用转化 API 分享这些事件。此外，一些其他类型的重要事件和数据会在离线时产生，或在之后无法使用 Pixel 像素代码时出现，此时您也可使用转化 API 分享这些内容。

确保可删除重复的冗余事件

使用 Meta Pixel 像素代码和转化 API 发送冗余事件时，请确保两个事件都使用相同的 event_name，并且包含 external_id 与 fbp 的组合或 event_id。我们建议包含所有这些参数，以帮助 Meta 合理删除重复事件及减少相同事件的重复报告。详细了解删除重复事件、何时需要删除以及如何进行设置。

发送必要参数和推荐参数

以下服务器事件和客户信息参数为必要项：

参数类型何时为必要项

action_source

服务器事件

全部事件

event_source_url

服务器事件

全部网站事件

client_user_agent

客户信息

全部网站事件

使用转化 API，即表示您同意：就您所知，action_source 参数准确无误。我们还建议加入所有事件的 external_id 和 event_id 事件参数。

发送额外的客户信息参数可能有助于提高事件匹配质量。只有相匹配的事件才能用于广告归因和广告投放优化，匹配质量越高，效果越好。虽然不匹配的事件不能用于归因或广告投放优化，但仍可用于基本成效衡量。高质量客户信息参数的示例包括：

  • 邮箱 (em)
  • IP 地址 (client_ip_address)
  • 姓名（fn 和 ln）
  • 手机号 (ph)

匹配基准要求

随着图谱 API 13.0 版本的发布，我们将更新基准要求，以确定哪些客户信息参数组合对转化 API 事件有效。当某个事件的客户信息参数组合太过宽泛以至无法进行有效匹配时，这些变更将有助我们提供更有效的反馈。

如果某个事件仅包含由以下其中一种组合（或其子集）构成的客户信息参数，则将视为无效。

  • ct + country + st + zp + ge + client_user_agent
  • db + client_user_agent
  • fn + ge
  • ln + ge

例如，如果某个事件仅包含客户信息参数 ge、ct、st 与 country（这些参数的组合可对应美国加利福尼亚州门洛帕克的一位男士），便会遭拒，因为这些客户信息参数是以上其中一种组合的子集。

请务必刷新 fbp 和 fbc 参数

fbp 和 fbc 参数是 Cookie 值，通常设于网站访客的浏览器中，并与 Meta 的第一方 Cookie 解决方案有关，且可能会发生更改。如果将这些参数作为用户参数发送，您应定期更新它们的值。

当 Meta Pixel 像素代码已在您的网站上实现，并且可供检索以用于转化 API 请求时，这些值将被设为第一方 Cookie。

实时分享事件

在事件发生时分享有助于您的广告系列获得最佳效果。您可以使用转化 API 实时分享或分批实时分享服务器事件。

使用测试事件

我们建议使用测试事件工具验证转化 API 连接。通常，开发者应将自己的客户信息参数（例如姓名、邮箱、手机号）用于测试事件，因为如果这些事件与 Facebook 或 Meta 帐户不匹配，便可能遭到丢弃。

测试事件工具可用于：

  • 验证您是否已正确设置服务器事件，以及我们是否已完成接收。
  • 通过查看已处理和已去重的事件，验证您是否已正确删除重复事件。
  • 调试任何异常活动。

了解如何使用测试事件工具测试服务器事件。

使用负载帮手

在负载帮手工具中填写必要和推荐的数据参数字段，以查看如何正确构建负载，并获得所应添加参数的建议。

使用 Business SDK

我们文档中的代码示例包括以 Python、Java、Ruby、PHP 和 Node 语言编写的 Business SDK 示例。这些代码示例可以省去一些开发工作，比如对用户参数的哈希处理即可在 Business SDK 中自动完成。

如果不打算使用 Business SDK，我们建议您实施哈希处理。

对线下事件使用转化 API

转化 API 支持所有线下事件，并且应用作这类事件的综合容器。示例包括实体店销售、手机来电、在设备（如智能电视或游戏机）上进行的操作以及线下订阅。

发送线下事件时，请务必包含 action_source 事件参数，并选择适当的值（不应是 website）。您需要使用操作来源确定事件用于哪些广告目标。

使用转化 API，即表示您同意：就您所知，action_source 参数准确无误。

适合合作伙伴的其他最佳实践

经销商：发送 partner_agent 字符串

代表广告主分享事件的合作伙伴或经销商应发送唯一的 partner_agent 字符串，并在其中包含记录在案的平台名称。如果可以，请与您的专属 Meta 代表共同决定合适的经销商字符串。

网站平台：广告主入门引导

默认情况下，网站平台合作伙伴可考虑有选择地提供转化 API，或是让广告主自行选择。Meta Pixel 像素代码和转化 API 使用相同的商务条款，我们建议您让客户自行选择在设置 Meta Pixel 像素代码时是否也使用转化 API 分享他们的数据。虽然我们认为使用这两种工具能够长期加强和确保数据共享的安全性，但仍建议您向客户提供转化 API 和 Meta Pixel 像素代码的相关信息，以帮助他们作出明智选择。

实现后

检查事件匹配质量

如果使用转化 API 分享服务器事件，您可以在事件管理工具中看到每个事件的事件匹配质量 (EMQ)。事件的 EMQ 分数（满分 10 分）表示服务器事件的客户信息在与 Facebook 或 Meta 帐户匹配时的成效。如需进一步了解有关 EMQ 最佳实践的详情，请点击此处。

事件匹配质量目前仅适用于网站事件。对于其他事件类型（例如线下事件和实体店事件、应用事件、高潜客户、内测或 Beta 测试阶段的任何集成），请联系您的 Meta 代表，获取有关提高事件匹配质量的指导。

执行测试

在使用转化 API 时，我们建议您测试并优化 Meta 广告策略。一些测试选项包括：

  • 转化提升调研：了解使用服务器事件对广告表现的提升效果。

  • 拆分对比测试：了解哪种广告系列策略可以获得最佳和最有效的广告表现优化结果。

详细了解