迁移指南：从 Instagram (IX) 到 Meta 业务插件 v2

作为我们的 Instagram 行动号召按钮 [由即时体验 (IX) 集成提供支持] 合作伙伴之一，您应该制定有关 Meta 业务插件 (MBE) v2 的以下要求，才能保留您的订餐行动号召按钮和订餐快拍贴图功能：

1. 身份验证网址：使您的商家可以从 Facebook 或 Instagram 加入 MBE。
2. Webhooks：用于在每次您的一个商家安装或卸载 MBE 时都收到即时通知。
3. 触发 Pixel 像素代码事件：这有助于您的商家更好地定位新客户，提升您网站上的交易量，并直接衡量 MBE 集成帮助商家提升业绩的成效。

您完成 MBE 开发和测试后，Meta 将审核和验证您的集成。集成获批后，您的应用即可向公众用户开放。

前期准备

• 如果您还没有注册成为 Meta 开发者，请完成此步骤，以使用我们的开发者工具和创建 Meta 应用。
• 如果您还没有创建 Meta 应用，请完成此步骤。
• 您可以使用已发布/正式版应用创建测试版应用，并将其用于执行各种新开发和测试。
• 您的应用（已发布/正式版和测试版）必须为企业应用类型，且其所有者必须是已认证企业的商务管理平台。详细了解如何验证企业以及如何向企业添加您的应用。
• 请联系您的 Meta 合作伙伴并向其分享应用编号，以便合作伙伴授权您使用 MBE manage_business_extension 功能。获批之后，您就可以开始实现工作。

通过开发者面板设置集成

Meta 业务插件开发者面板是开发者应用面板中的一款产品。您的应用获得 MBE 功能之后，您应该使用开发者面板来设置并验证集成（括身份验证网址和 Webhooks 端点）。

第 1 步：在您的 Facebook 开发者应用页面中添加 MBE 开发者面板。

第 2 步：在“设置”选项卡上，选择 Food and Drink 作为您唯一的行业，选择 Instagram Call to Action Button 和 Page Surface Call To Action Button 作为功能，并在“通配符网域”卡片上选择您的应用所服务的所有网域。

第 3 步：构建身份验证网址后，在“设置”选项卡上使用“业务应用”界面来验证您的网址（如有任何错误，将列于此处）。获得绿色勾号后，您就可以前往 Meta 业务应用执行端到端测试。

第 4 步：构建 Webhooks 后，请在 Webhooks 产品上进行设置。如果该设置如预期完成，“概览”选项卡上的“Webhooks 已验证”项目将获得一个绿色勾号。

第 5 步：在触发必要的 Pixel 像素代码事件后，完成 Pixel 像素代码问卷（包含一个验证 Pixel 像素代码实现情况的视频）。

第 6 步：通过在“集成审核”选项卡的“集成审核”卡片中提供详情，帮助我们的团队验证和批准您的集成。应在详情中提供您平台的登录凭证，用于登录您的身份验证网址。请添加录屏文件链接，该链接应显示端到端入门体验和您已启用的各种功能。

第 7 步：完成 MBE 实现后，根据开发者面板“概览”选项卡中的检查清单完成操作。请在“集成审核”选项卡中填写应用详情表单和集成审核表单。点击提交按钮，将开始审核流程。集成获得批准后，您就可以通过“发布”选项卡，向公众用户发布自己的应用。详细了解集成审核流程以及如何从我们的团队接收反馈和当前状态。

构建身份验证网址

业务应用在各个 Meta 界面均可使用，企业可以在这些业务应用中发现第三方业务应用并与之建立联系，以低廉的技术成本完成业务工具设置，从而发展壮大、实现业务目标。

MBE v2 使用身份验证网址作为一个可信赖的渠道，在您的平台与 Instagram/Facebook 之间分享用户的业务配置（名称、行动号召网址等）。

您的身份验证网址必须接受一个 GET 查询参数 redirect_uri。对于该网址，我们建议您：

1. 允许用户登录您的平台，并提供一个在您平台上注册新账户的选项（即“注册”）。
2. 如果您的平台支持每个账户有多个企业，则提供一个用户界面，以便用户选择将您平台上的哪个所需企业与其在 Facebook 上的形象关联。
3. 获取收到的 redirect_uri 查询参数，将经过编码的 extras 对象作为查询参数附加到其末尾处。
4. 将用户重定向至得到的网址（仅适用于收到的 redirect_uri 与我们的正则表达式匹配时）。

示例 — 使用 extras 对象来配置一个企业，并启用其 Instagram 主页行动号召和 Facebook 公共主页行动号召

{
  "setup": {
    "external_business_id": "<YOUR_ID_FOR_THE_BUSINESS>", //e.g. "foo-123"
    "timezone": "<BUSINESS_TIMEZONE>", //e.g. "America/Los_Angeles"
    "currency": "<BUSINESS_CURRENCY>", //e.g. "USD"
    "business_vertical": "FOOD_AND_DRINK"
  },
  "business_config": {
    "business": {
      "name": "<BUSINESS_NAME>"  //e.g. "Foo Business"
    },
    "ig_cta": {
      "enabled": true,
      "cta_button_text": "Order Food",
      "cta_button_url": "<BUSINESS_URL_FOR_CTA>"  //e.g. "https://partner-site.com/foo-business/order"
    },
     "page_cta": {
         "enabled": true,
         "cta_button_text": "Order Food",
         "cta_button_url": "<BUSINESS_URL_FOR_CTA>", // e.g. "https://partner-site.com/foo-business/order"
         "below_button_text": "Powered by <YOU>"
     }
  },
  "repeat": false 
}

如需详细了解完整的实现和测试流程，请参阅业务应用。

构建 Webhooks

用户通过“业务应用”安装、更新或卸载您的应用后，您会通过 Webhooks 收到该操作的详情。

如要设置 Webhooks，您需要执行下列操作：

1. 您应在一个安全的服务器上构建一个端点，该服务器应能处理来自 Facebook 的 POST 请求。
2. 在您应用的应用面板中配置 Webhooks 产品，以订阅 User 对象的 fbe_install 字段。

如需详细了解完整的实现和设置流程，请参阅 Webhooks。

触发 Pixel 像素代码事件

Meta Pixel 像素代码是 Meta 业务插件 v2 不可或缺的一部分。我们要求您为自己平台上每个集成了 MBE 的企业准确触发以下 Pixel 像素代码标准事件。

必要事件

• 对于订餐流程中涉及的所有公共主页：触发 PageView
• 下单后：触发 Purchase

非必要事件

• 某款商品添加到订单时，触发 AddToCart。

通过调用 Pixel 像素代码的 fbq('track') 函数，并将事件名称和（非必要的）JSON 对象用作其参数，可触发所有标准事件。例如，购物事件要求在调用中加入货币及其值作为一个参数：

fbq('track', 'Purchase', {currency: "USD", value: 30.00});

如需详细了解完整的实现流程，请参阅触发 Pixel 像素代码事件。

Pixel 像素代码帮手

强烈建议您安装我们的 Pixel 像素代码帮手 Chrome 插件。Pixel 像素代码帮手提供极其宝贵的反馈，可帮助您验证 Pixel 像素代码是否正常工作，特别是在您开始追踪转化量（此时很容易遇到格式错误）时。

集成审核和发布

完成 MBE 实现后，根据开发者面板“概览”选项卡中的检查清单完成操作。请在“集成审核”选项卡中填写应用详情表单和集成审核表单。点击提交按钮，将开始审核流程。

集成审核是 Meta 验证您 Meta 业务插件集成的过程。集成获得批准后，您就可以通过“发布”选项卡，向公众用户发布自己的应用。详细了解集成审核流程。

在开发者面板的“集成审核”选项卡上提交集成后，您可以在“集成审核”卡片的提交记录版块中查看状态、更新以及审核人员提供的反馈。

我们的审核人员会提供详细的反馈。如果您的应用被拒绝，请完成所有必要步骤，再开始新的审核流程。点击“集成审核”选项卡中的重新提交按钮，即可开始新审核流程。