Meta 业务插件开发者面板

Meta 业务插件开发者面板是应用面板中的一款可用产品。这一部分将说明如何通过该面板设置和验证您的 Meta 业务插件集成。

访问 Meta 业务插件开发者面板

  1. 前往应用面板,点击您想配置的应用名称,加载其应用面板。若您尚无应用,请创建 Meta 应用,选择业务类型。
  2. 打开应用面板之后,点击添加产品
  3. 在产品列表中,找到 Meta 业务插件(您可能需要点击查看更多产品)。
  4. 在产品卡片上,点击设置
  5. Meta 业务插件 (MBE) 开发者面板此时已被添加至应用面板的左边栏。通过浏览选项卡,您会看到一个检查清单,其中列有需完成的待办事项和设置步骤,如完成条件设置目录选择功能等。
  6. 开始执行准备工作阶段的步骤,然后点击设置选项卡(可从左侧的菜单访问),填写其余信息。
  7. 提交集成以供审核:使用 MBE 开发者面板中的集成审核选项卡。在集成获得批准后,您可以访问发布状态选项卡,由此向公开用户发布您的应用程序。详细了解集成审核流程。

无法在产品列表中找到 Meta 业务插件?

  • 如果您无法在产品列表中找到 Meta 业务插件的原因是您的应用需要具备 manage_business_extension 私密权限,请联系您的 Meta 合作伙伴,将该应用加入白名单并在授权之后通知您。
  • 您的应用必须为“业务”应用类型,才能访问 Meta 业务插件开发者面板。

“概览”选项卡

“概览”选项卡中的检查清单列出了您 MBE 集成的部分内容,即在将该集成提交给我们团队审核之前您需要编写、构建和验证的所有项目。

此检查清单旨在为您提供易于理解的指导,确保您不会遗漏任何必要步骤。当您填写设置选项卡中的步骤时,系统会自动将检查清单上的项目标记为“未完成”、“可选”、“有错误”或者“完成”。

“设置”选项卡

您应在设置选项卡中配置并验证集成中的大部分内容。在开始之前,请思考您的应用将为您的企业提供的用例、身份验证工具和功能。这样可确保您设置正确地配置并构建合适的工具。

  • 我的应用将用于哪些用例(垂直领域)?例如:预约、商业和餐厅预订等。请点击此处,查看 MBE 支持的全部用例清单。
  • 我希望应用为企业提供哪些功能?例如:Instagram 行动号召 (CTA)、Messenger 聊天等。

这个选项卡中的每个不同部分都会提供验证,以帮助您发现当前集成是否存在任何错误,需要您在将集成应用到企业之前修复。例如,在构建企业登录或者身份验证网址时,如果使用的任何配置值无效(不支持的货币、格式错误的 extras 对象、不完整的功能配置等),则点击保存按钮时会出现错误,并且系统会将卡片标记为“有错误”。

示例

Webhooks

您可以使用 Webhooks 卡片进行 Webhooks 配置并对此配置作出修改。系统将测试并验证此处输入的回调网址和验证口令。经验证后,系统将自动订阅 fbe_install Webhooks,但您也可使用卡片底部的开关按钮切换订阅状态。


通配符网域

使用开发者面板通配符网域在 Pixel 像素代码上运行通用验证。我们也会使用这些验证来确定可能会从 MBE 受益的企业。我们需要您在平台中添加所有可用的企业网址格式。


示例

  • https://www.example.com
  • https://www.example.com/*
  • 企业可能拥有自定义子网域的情况:
    • https://www.*.example.com
  • 您要求企业拥有强制性路径的情况:
    • https://www.example.com/some_mandatory_path/*
    • https://www.example.com/*/some_mandatory_path/*

Pixel 像素代码问卷

请通过完成 Pixel 像素代码问卷,仔细思考 Pixel 像素代码的实现方式。问卷位于“设置”选项卡配置 Pixel 像素代码卡片中。点击“配置”按钮,打开问卷。在集成审核期间,我们将会借助您在问卷中给出的答案来了解触发您 Pixel 像素代码的实现方式。

“集成审核”选项卡

您可以在此选项卡中启动集成审核流程。只有在完成“概览”选项卡中检查清单列出的所有必要项之后,您才能提交集成以供审核。

“发布状态”选项卡

集成获得批准后,即可访问此选项卡。您可在此处点击发布应用按钮,以向公众发布您的应用程序。

“调试工具”选项卡

此选项卡中提供了两个可于应用发布后使用的工具。在您开始指导用户启用时,可使用这两个工具详细了解企业的 Facebook 业务插件连接,解决影响企业启用的问题。

尝试帮助企业启用时,我们推荐您首先使用这些调试工具(例如,当企业向您的客户支持团队报告出现无法连接的问题,或期望的功能效果不如人意,您可以使用这些调试工具)。这些工具可以帮助您识别这些问题是否出现在您这边,以及您能否自行解决问题。

应用配置不当错误

这里列出了因 MBE 集成配置错误而导致企业无法启用的各类安装错误。您可以找到各种错误类型影响的企业数量(显示为“总数量”)。

使用右侧下拉菜单查看特定时间范围内(上月、当周、当天)的错误列表。

示例


如何解决出现的错误

企业使用您的企业登录和身份验证网址启用时,您必须向 Facebook 发送 extras 对象,而此面板所列全部错误都是 extras 对象上的配置错误所致。

修复这些错误需要识别 extras 对象的哪部分缺失或有格式错误,或者使用无效值。列出的每类错误都会提及成因,因此您可以依据 Facebook 业务插件参考文档验证集成发送的 extras 值。

一些常见示例包括:

  • setup 中的 currency 字段格式不正确 — 这表示对于某些企业,Facebook 不支持您在 extras 对象中发送的一些货币值。

  • business_config 中的 ig_cta 字段包含无效值 — 这表示用于启用 Instagram 行动号召 (CTA) 的字段或者值并非 ig_cta 对象的期望值。

Meta 业务插件调试工具

您可以使用此工具获取特定企业的状态和详细信息。您可以通过提供企业的 external_business_id,来确认他们是否已经连接到 MBE。对于已连接企业,您可以获取已连接资产的详情(例如公共主页、Instagram、目录、Pixel 像素代码等)以及通过连接启用的 MBE 功能清单。