FBE Marketplace 入门引导

借助 Facebook 业务插件 (FBE)，您的卖家可以通过关联 Facebook 公共主页或商务管理平台等现有 Facebook 资产，或者创建全新资产，在 Facebook 旗下应用中轻松投放广告。FBE 可用来帮助 Marketplace 上的卖家无缝开始使用 Meta 解决方案。

以下为 Marketplace 流程的专用重要步骤。我们建议您在使用这些步骤时，同时参考主要开发者文档。

FBE Marketplace 流程

合作伙伴 = Marketplace

FBE = Facebook 业务插件（Facebook 拥有的用户界面）

私人权限
1. manage_business_extension — 这是一项私人权限，用于要求您的 Meta 代表将您的应用添加到白名单。
公开权限（在 Marketplace 需要通过应用审核申请这些权限）。
1. business_management — 必须使用此权限，方能取回通过 FBE 创建的商务管理平台编号，以及使用商务管理平台 API 来管理企业资产。
2. ads_management — 必须使用此权限方能代表客户管理卖家广告。

卖家（品牌）通过 Marketplace 网站启用 FBE 设置弹窗
卖家通过 FBE 入门引导流程，并且完成核心资产（商务管理平台、公共主页等）的设置
FBE 返回卖家已成功设置的资产编号（通过 API 或 Webhooks）。Marketplace 收到编号后，您便可通过 API 或用户界面（使用商务管理平台内的“合作中心”工具）创建或分享细分目录。
卖家启动 FBE 管理视图。他们可以在此查看已创建细分目录的状态，以及接受服务条款（如果这是卖家首次从 Marketplace 收到细分目录要求）。
Marketplace 会将卖家重定向至广告创建流程（现有的制作工具流程 - 广告管理工具等。）

字段类型说明

字段	类型	说明
`setup`	setup 对象	必填卖家的 Facebook 设置，例如，他们的唯一身份识别信息 (`external_business_id`)，或者其目录的货币 (`currency`)。请参阅 setup 对象详情。
`business_config`	business_config 对象	必填 Facebook Business 扩展程序用于配置 Facebook Business 扩展程序流程的配置对象。请参阅 `business_config` 对象详情。
`repeat`	布尔值	必填将此值设置为 `false`。

setup

setup 对象

必填

卖家的 Facebook 设置，例如，他们的唯一身份识别信息 (external_business_id)，或者其目录的货币 (currency)。请参阅 setup 对象详情。

business_config

business_config 对象

必填

Facebook Business 扩展程序用于配置 Facebook Business 扩展程序流程的配置对象。请参阅 business_config 对象详情。

repeat

布尔值

必填

将此值设置为 false。

字段	描述
`external_business_id` 类型：字符串	必要。代表客户企业的独立企业编号。我们将该编号用作独立的标识符。例如，如果卖家的公司名为“Fubar”，则其 `external_business_id` 可以是“fubar-123”。
`timezone` 类型：字符串	必要。企业所在时区。请参阅可选的时区值。
`currency` 类型：字符串	必要。企业目录商品使用的默认货币，格式为以三个字母表示的 ISO 货币代码。请参阅支持的货币代码。
`business_vertical` 类型：枚举	必要。 Marketplace 中与企业关联的垂直领域为 `ECOMMERCE`
`merchant_settings_id` 类型：字符串	可选。从 Facebook 业务插件 v1 升级版本时使用。若要从 v1 转换至 v2，请联系您的 Facebook 代表。
`channel` 类型：枚举	必要。为合作伙伴提供一种途径，便于合作伙伴向用户表达有关需要额外步骤或约束的功能的意图：注意：Marketplace 专用 FBE 流程的 `channel` 为 `MARKETPLACE`。请确保在 `channel` 字段中传递此值。
`business_manager_id` 类型：字符串	可选。用户现有商务管理平台的商务管理平台编号，合作伙伴可以输入该编号，从而在设置流程中为用户进行预选。
`page_id` 类型：字符串	可选。用户现有 Facebook 公共主页的公共主页编号，合作伙伴可以输入该编号，从而在设置流程中为用户进行预选。

使用此对象为最终用户配置企业设置，包括 Messenger 等。每个字段包含一个链接到下方相应表格的“类型”。

字段	描述
`business` FBEBusinessPropertiesConfigData	必要。最终用户的企业信息
`messenger_chat` FBEMessengerChatConfigData	可选。最终用户 Facebook 公共主页上的 Messenger 聊天功能，例如 `enabled` 和 `domains`
`catalog_feed_scheduled` FBECatalogFeedConfigData	可选。确定 Facebook 业务插件是否应该使用信息库方法，即从 `feed_url` 抓取目录商品
`page_cta` FBEPageCtaConfigData	可选。最终用户公共主页上的行动号召 (CTA) 按钮，例如 `cta_button_text`、`cta_button_url` 等。
`ig_cta` FBEIGCtaConfigData	可选。此类功能用于 Instagram 行动号召的功能，例如 `enabled`、`cta_button_text`、`cta_button_url` 等。
`messenger_menu` FBEMessengerMenuConfigData	可选。此类功能用于 Messenger 固定菜单的功能，例如 `cta_button-text` 和 `cta_button_url`

在完成 FBE 设置，且通过 Webhooks 或 API 成功返回资产编号后，启动 FBE 管理视图。