MBE Pixel 像素代码和转化 API 入门引导

通过 Meta 业务插件 (FBE) 的 Pixel 像素代码和转化 API 流程，用户可以创建或选择自己的商务管理平台、公共主页和 Meta Pixel 像素代码。我们建议具有网站托管功能的合作伙伴使用此流程。使用完成此流程后返回的 Pixel 像素代码，合作伙伴可通过浏览器或转化 API 代表其客户向 Facebook 发送事件。此流程没有目录功能。

准备工作

您的应用必须归已认证企业的商务管理平台所有。详细了解如何认证企业。
需要具有以下访问权限级别、功能和权限的 Facebook 应用：
- 访问权限级别：高级访问级别
- 功能：广告管理标准访问级别
- 公开权限：ads_management、pages_read_engagement 和 ads_read
- 私人权限：manage_business_extension — 这是一项私人权限，用于要求您的 Facebook 代表将您的应用添加到允许名单。
- 系统用户访问口令：向转化 API 发送事件需要使用访问口令。如要代表客户生成访问口令，请使用通过 FBE 返回的访问口令，并通过进行额外的 API 调用将其转换为系统用户访问口令。

必要配置

extras 对象

字段类型说明

字段	类型	说明
`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。

setup

使用该对象来定义最终用户的 Facebook 形象设置

字段	描述
`external_business_id` 字符串	必要代表客户企业的独立企业编号。我们将该编号用作独立的标识符。例如，如果卖家的公司名为“Fubar”，则其 `external_business_id` 可以是“fubar-123”。
`timezone` 字符串	可选企业所在时区。请参阅可选的时区值。
`currency` 字符串	可选企业目录商品使用的默认货币，格式为三字母 ISO 货币代码。请参阅支持的货币代码。
`business_vertical` 枚举	必要企业关联的垂直领域值：`ECOMMERCE`
`merchant_settings_id` 字符串	可选从 Facebook 业务插件 v1 升级版本时使用。若要从 v1 转换至 v2，请联系您的 Facebook 代表。
`domain` 字符串	COMMERCE 和 COMMERCE_OFFSITE 渠道的必要字段用于 Instagram 手动审核的网域。例如：`https://exampleshop.partnersite.com`。
`channel` 枚举	必要为合作伙伴提供一种配置 FBE 转化 API 流程的方法。对于该转化 API 流程，此字段值应为 `CONVERSIONS_API`。 `CONVERSIONS_API` — 允许最终用户创建或选择商务管理平台、广告帐户和 Meta Pixel 像素代码对象的流程。创建这些对象后，最终用户将可通过转化 API 或浏览器 Pixel 像素代码，从自己的网站中向 Facebook 发送事件。
`business_manager_id` 字符串	可选用户现有商务管理平台的编号，合作伙伴可以输入该编号以在设置流程中为用户进行预选。
`ad_account_id` 字符串	可选用户现有广告帐户的编号，合作伙伴可以输入该编号以在设置流程中为用户进行预选。
`page_id` 字符串	可选用户现有 Facebook 公共主页的编号，合作伙伴可以输入该编号以在设置流程中为用户进行预选。
`ig_profile_id` 字符串	可选用户现有 Instagram 商家主页的编号，合作伙伴可以输入该编号以在设置流程中为用户进行预选。
`pixel_id` 字符串	可选用户现有 Pixel 像素代码的编号，合作伙伴可以输入该编号以在设置流程中为用户进行预选。
`catalog_id` 字符串	可选用户现有目录的编号，合作伙伴可以输入该编号以在设置流程中为用户进行预选。

business_config

使用该对象为最终用户配置企业设置。其中包括行动号召 (CTA) 等更多内容。每个字段都包含一个链接到下方对应表格的“类型”。

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