转化 API

设置转化 API 作为平台

如果您将提供 Meta Pixel 像素代码设置服务纳入自己的标签管理服务范围，您可能需要考虑添加转化 API 的各项功能。与转化 API 集成可以让您的客户直接向 Facebook 发送网站事件，而无需依赖浏览器 Pixel 像素代码事件。

服务器事件与浏览器事件对比

开始对比之前，请务必先了解服务器事件与 Meta Pixel 像素代码之间的关系。服务器事件通过转化 API 发送，在成效衡量、报告和优化方面的使用方式与浏览器 Pixel 像素代码事件相同。

如果发送浏览器 Pixel 像素代码事件好比通过航空邮件发送邮件，发送服务器事件则好比通过货运发送邮件。两者都是将包（有关某一事件的数据）传输到目标位置地址（一个 Pixel 像素代码编号）的机制。因此，强烈建议您在自己的平台上构建转化 API 集成，作为您当前 Meta Pixel 像素代码服务的一个扩展（而不是一个单独的插件或服务），理由如下：

  • 服务器事件使用 Pixel 像素代码编号作为目标位置
  • 在发送到 Facebook 之后，系统会以同样的方式处理服务器事件与浏览器 Pixel 像素代码事件
  • 去重将更容易实现
  • 便于客户使用。例如，在默认情况下，服务器事件可以与浏览器事件一起发送。

您的平台与转化 API 集成之后，建议立即通过浏览器和服务器发送相同的网站事件。这种冗余有助于确保信号的可靠性。之前因各种网络原因可能已在浏览器端丢失的事件，现在可通过转化 API 获取。

如要通过浏览器和服务器发送事件，您必须为相应事件正确设置相同的 event_id，从而允许 Facebook 为您的事件正确执行去重处理。

前提条件

  1. 提供一个可将事件分享到 Facebook 的网络平台。例如：网站创建工具、标签管理工具或 AdTech 平台。
  2. 根据 Facebook 业务工具条款的要求，在与 Facebook 分享事件数据时，向用户发送相应通知并获得其同意。
  3. 拥有 Facebook 代表
  4. 满足标准转化 API 集成的前提条件，拥有：

如要开始以平台形式提供转化 API，您的应用需要通过应用审核。在应用审核流程中，您必须申请以下访问权限级别、功能和权限：

立即开始

如果您是第一次使用转化 API，请按照以下步骤分别创建业务账户、Meta 应用、Meta Pixel 像素代码和系统用户。然后，您便可使用您系统用户的访问口令通过转化 API 发送服务器事件。

第 1 步：创建业务账户。

第 2 步：在新建的业务账户下创建 Meta 应用。

第 3 步：在新建的业务账户下创建 Meta Pixel 像素代码：

第 4 步：生成系统用户访问口令。

第 5 步：向 Meta Pixel 像素代码发送服务器事件。

代表客户发送事件

成功将服务器事件发送到自己的 Meta Pixel 像素代码后，关于如何代表客户发送事件，您有多个选择。

对于由合作伙伴的商务管理平台拥有或管理的 Meta Pixel 像素代码

  1. 在商务管理平台中，前往用户部分，选择系统用户选项卡。点击要用于转化 API 的特定系统用户。
  2. 前往分配资产对话框，并选择 Pixel 像素代码。然后，选择您要代表其发送事件的 Pixel 像素代码。
  3. 对于每个 Pixel 像素代码，选择管理 Pixel 像素代码权限，然后点击保存更改。
  4. 返回您的系统用户详情页面。验证所选择的 Pixel 像素代码显示在相应位置上。

对于不由合作伙伴管理的 Facebook Pixel 像素代码

您首先必须请求获得代表客户发送事件的授权。您可选用以下身份验证方法：

Facebook 业务插件（推荐）

拥有 Facebook 业务插件 (FBE) 之后，该插件便可通过以下流程返回代表客户发送事件所需的所有必要信息。FBE 会提供一个端点，用于检索在客户的商务管理平台中创建的系统用户访问口令。此流程会用到发送服务器事件的权限，并且会以安全可靠的方式自动完成。

此端点需要用户访问口令作为输入参数。如果是 FBE 新用户，在完成 FBE 设置后，请调用此端点，以便获取系统用户访问口令。现有用户需要请求重新验证身份，然后才能调用新的 API 端点。

客户端系统用户访问口令

如果使用此方案，您必须让客户通过 Pixel 像素代码设置中的转化 API 手动创建系统用户访问口令。然后，您便可使用该口令向广告主的 Pixel 像素代码发送事件。

系统用户或管理员级系统用户必须安装用于生成访问口令的应用。完成此项设置后，您的应用即可代表该系统用户或管理员级系统用户调用 API。

请按照我们的入门指南文档操作，向您的广告主请求系统用户口令。记得使用您自己的 Meta Pixel 像素代码和访问口令进行测试。

客户将 Meta Pixel 像素代码分享到合作伙伴的商务管理平台

借助此方案，客户可以通过商务管理平台设置或通过 API 向合作伙伴分享他们的 Meta Pixel 像素代码。然后，您可以将合作伙伴系统用户分配给客户的 Pixel 像素代码，并生成一个访问口令，用于发送服务器事件。

使用 partner_agent 字段将事件归因到您的平台

如要将转化 API 事件归因到您的平台，请使用 partner_agent 字段。如此一来，在代表客户发送事件时，您便可以设置自己的平台标识符。请与您的 Facebook 代表一起商定平台标识符。然后，在发送所有服务器事件时一并发送该值。

事件有效负载示例

如果您的平台标识符是 datapartner，代表客户发送的购买事件有效负载示例如下所示：

    
{
  "data": [
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "event_name": "PageView",
      "event_time": 1579645238
    },
    {
      "user_data": {
        "em": "8159ea0e33c51a774b83104ee562784f9b1836c852102046e4bd8385706fe7ca"
      },
      "custom_data": {
        "currency": "USD",
        "value": "50"
      },
      "event_name": "Purchase",
      "event_time": 1579645238
    }
  ],
  "partner_agent": "datapartner"
}

常见问题

Sending events sent via the Conversions API is just like sending events via Facebook Pixel. The only difference is that the event is sent via the server, instead of the browser. So, why make an effort to integrate with the Conversions API? Here are some important use cases:

Capture offline and down-funnel events

If someone uses an advertisers’ website to sign up for a credit card, they can send events such as ViewContent, Application Start, and Application Submit via the browser to the Facebook Pixel. However, the end user still needs to be approved for this credit card. The Approval event happens offline and cannot be sent via browser. To register this final step, the advertiser can send the Approval via the Conversions API.

Signal resiliency

Browser side events can be lost for many reasons:

  • The user might navigate away before the page has finished loading.
  • Ad blockers could prevent the event from firing.
  • The changing internet landscape might change the way inter-domain messages are sent.

These examples can all be mitigated by sending events via the Conversions API.

Sensitive data

Many advertisers have expressed concerns about sharing data via the browser when that data could be seen or inspected. This can be mitigated by sending data via the Conversions API.

For example, advertisers may want to send data like profit margin or lifetime value (LTV) along with a purchase event. This way, ads can be optimized towards a specific type of customer.

固定链接

Since browser events are always vulnerable to obstacles, we recommend that you only send events collected from the Conversions API sources. For example, if:

  • One of the ways your customer ingests data into your platform is via a browser JavaScript tag, or
  • You send that data to Facebook via the Conversions API

the data is open to the browser-side risks.

To take full advantage of the Conversions API, no part of the data flow should be reliant on the browser.

固定链接

We recommend that you provide advertisers with a way to test this connection on your own platform.

  1. Send a test event via the Conversions API to the advertiser’s pixel. Look for a 200 return code.
  2. Update the status of the connection appropriately.
固定链接

Facebook tries to deduplicate identical events sent through the Facebook Pixel and the Conversions API. We determine if events are identical based on their event_id and event_name. For more information, see Handling Duplicate Pixel and Conversions API Events.

固定链接

The external_id parameter is a string that represents a user on an advertiser's system. These IDs help improve ads attribution and create audiences.

You can send external_ids via browser or the Conversions API, but you must be consistent across channels. For example, if you send a browser pixel event with external_id set to 123, your server event for that same user should also have external_id set to 123.

固定链接