Meta 业务插件常见问题

Meta 业务插件 (MBE) 集成常见问题解答。

安装

Commerce/Shops onboarding flows are currently only available to select partners in a closed beta. If you are interested in receiving access in the future, please contact your Facebook representative and review this document for reference.

Ensure that the merchant has MBE currently installed and has selected all applicable business assets during onboarding.

请确保应用面板中开发者面板 > 设置选项卡下的“启用目录”复选框已启用。

企业/卖家可以在管理视图中配置企业功能,但无法更新关联至 FBE 的商务管理平台、广告帐户、公共主页、Pixel 像素代码、目录等 Facebook 资产。此外,企业/卖家还可以在 FBE 设置流程中修改设置以关联不同资产。

根据您的业务需求,您可以在设置 > 渠道下配置适当的值,选择创建以下一个或多个流程:

  • 默认流程(渠道无需参数)- 能够让卖家为动态广告设置 Facebook Pixel 像素代码、Facebook 公共主页、广告帐户和目录。
  • COMMERCE — 该流程能够让卖家创建电商账户,其中包含可站内结账的 Facebook 店铺和 Instagram 购物渠道。此外,还提供在流程内选择站外店铺的选项。
  • COMMERCE_OFFSITE - 该流程能够让卖家创建电商账户,其中包含站外 Facebook 店铺和站外 Instagram 购物。
  • FEED - 该流程可让零售商同步其目录更新。仅建议拥有信息库/目录功能,且未进行网站托管的合作伙伴使用。
  • MARKETPLACE - Marketplace 与 FBE 集成专用流程。建议以下对象使用:FBE 设置流程中仅需要执行公共主页和商务管理平台步骤,之后利用 FBE 管理视图设置合作广告的合作伙伴。
  • SIGNALS - 该流程能够让用户触发 Facebook Pixel 像素代码和转化 API 事件。该流程不支持将 Facebook 目录作为资产。仅建议拥有网站托管功能,且没有目录功能的合作伙伴使用。

以下为 FBE 企业登录过程中选择公共主页时可能遇到的几种常见情况。请注意,FBE 流程中的工具提示会明确说明您无法选择某个资产的具体原因。不同情况下的原因可能不同。

公共主页可供选择:

  • 如果所选公共主页并非由任何商务管理平台所有,则该公共主页将由所选商务管理平台认领
  • 如果所选公共主页由另一个商务管理平台所有,但不是该商务管理平台的首选主页,则该公共主页将转让给所选商务管理平台

公共主页不可选择:

  • 如果公共主页由另一个商务管理平台所有,且为其首选主页
  • 如果公共主页由商务管理平台所有,但由于政策违规等原因而被停用

合作伙伴可以为自己的应用申请 Page Public Metadata Access 功能,以使应用能够查询公共主页公开字段。如需详细了解此功能,请参阅此文档以及此文档

如果 instagram_profiles 字段不在其中,这意味着访问口令中不包含与 Instagram 相关的权限(例如,instagram_basic),且/或企业尚未将任何 Instagram 商家主页与 FBE 相连接。如需详细了解 FBE 安装 API,请参阅此文档

这意味着应用中缺少某些权限。请注意,商务管理平台相关操作所需的主要权限为 business_management

我们支持此列表中大多数货币,牙买加元、保加利亚列瓦、白俄罗斯卢布、乌克兰赫夫米、老挝基普、斯里兰卡卢比除外。

警告:如果在登录网址配置设置中提供了不受支持的货币,FBE 安装将会失败。建议合作伙伴允许卖家启动 FBE 前,先检查卖家是否使用的是受支持的货币。

确保除拥有 Facebook 商家主页或 Instagram 业务主页管理员权限之外,您还拥有与当前 FBE 连接关联的 Facebook 商务管理平台的管理员权限。请按照此处说明学习如何为 Facebook 商务管理平台添加管理员。

测试

No, system user access tokens can't be generated for test users.

Merchants can remove assets in the management view of MBE after installation.

Ensure that your app has been approved for "advanced access" for any permission you're using in the scopes of your business login URL, and that the permissions are “active” for your app.

There are two types of test accounts available via the developer panel.

  1. Testers: Tester role can be assigned to a user-generated Facebook profile. Reference

  2. Test User: Test users are simulated Facebook user accounts. They cannot interact with real Facebook users. Reference

Review each to decide which is better for your testing use case.

疑难解答

For troubleshooting, it's best to uninstall (with a DELETE request) and then re-install MBE for a particular merchant.

A good first step is uninstalling and then re-installing MBE. If they're still experiencing issues, they can reach out in the "Contact Us" link of MBE onboarding or the "Help Center" form on the MBE management view UI.

一般问题

Your app must be whitelisted to have approval to use the Meta Business Extension. If you aren't approved for MBE, you'll encounter errors while trying to set up your MBE assets. Contact your partner manager to confirm that your app has been whitelisted for MBE.

This is a closed beta. Please reach out to your Meta partner manager for more information.

目录

Facebook Business 扩展程序 (FBE) v2 使用目录获取企业库存。目录可支持各种功能,如动态广告、店铺和公共主页服务彩笺。它是集成的可选部分,但对这些功能来说是必需的。

请参阅 FBE 目录 API 文档了解实施详情和支持的字段。

您的应用需要在发布前通过应用审查获取已获批准的目录权限 (catalog_management)。

在您的企业登入实作的范围参数中添加 catalog_management 权限,该权限可让您的应用创建、读取、更新、删除企业拥有的目录。

获取以下操作的工作演示视频后,请提交应用审核申请:

  • 在启用流程期间申请目录权限
  • 将目录推送至已关联的目录
  • 同步目录后启用目录支持的功能

我们的应用审核团队会使用您提供的说明和录屏文件测试并验证您应用的目录 Facebook 集成。如果未通过审核,请务必仔细阅读我们提供的反馈以了解原因。您应重新提交审核,为审核人员提供更多更新后的详细信息。

请参阅我们的应用审核未通过结果指南,获取有关如何成功通过应用审核的建议,了解如何告知 Facebook 合作伙伴管理平台您未通过审核并获取其他帮助

所选资产相互关联,多种原因均可能导致目录不符合资格。部分可能的原因包括:

  • 您选中的页面已经链接至另一个目录
  • 您的目录已关联另一个电商帐户
  • 如果您的目录已用于测试版应用,则您无法在生产中使用同一个目录

迁移

FBE 2.0 中,Facebook 公共主页或 Instagram 商家主页可关联至多个合作伙伴平台(视应用编号而定)。不过,同一个主页仅能关联一个合作伙伴平台一次。

不会。就 Messenger 聊天而言,合作伙伴平台可在企业登录中的 business_config 设置 messenger_chat。就主页店铺而言,企业/卖家需要在迁移后在管理视图中将其启用。

There is a guide to migrate from MBE 2.0 to 3.0 in our documentation, but you can reach out to your Meta partner manager or engineering contact with specific questions.

插件

不支持。这两个插件现已在 FBE 管理视图中停用。Messenger 聊天是自 2021 年起唯一受支持的插件。

Messenger 允许清单中的网域必须使用 HTTPS。合作伙伴应使用协议编号(即 https://)验证网域字段网址。

详细了解如何配置 FBEMessengerChatConfigData 对象。

合作伙伴更容易验证 Messenger 网域是否可用,还能让企业/卖家免受设置网域期间可能遇到的困扰。合作伙伴能够在 FBE 企业登录中的 business_config 中设置 messenger_chat.domains,并设置 messenger_chat.enabled=false

企业/卖家之后便能在管理视图中启用 Messenger 插件,合作伙伴也能通过功能配置 API 为企业/卖家提供启用途径。

集成审核

集成审核就是 Facebook 审查您 FBE 集成的过程。您的应用完成集成审核后,便可供公共用户(即企业用户和卖家)使用。

达到所有要求之后,您就能在应用的 FBE 开发者面板 > 概览选项卡中申请集成审核。为了加快审核流程,您还应该与我们的审查人员或您的 Facebook 代表分享一份端到端工作演示视频,其中包含所有您实施的 FBE 功能。

成功完成审核之前,只有应用管理员和开发者能够发起 FBE 流程。

Please reach out to your Meta partner manager, or submit a new integration review.

SDK/API/Webhooks/移动版

是的,FBE 可在移动版浏览器上使用,也可以通过原生 Android 或 iOS 应用程序使用网页视图启用。详细了解如何在移动设备上启用 FBE

必须有访问口令才能调用图谱 API。此处描述了不同类型的访问口令。

开启管理视图前,您可调用 Facebook 登录获取 access_token,随后使用该 access_token 调用功能配置 API

示例代码:

  function launchFBEManagementView(access_token) {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: <EXTERNAL_BUSINESS_ID>,
    }, function(response){
      // call Feature Configuration API with access_token here
    });
  }

    FB.getLoginStatus(function(response) {
    if (response.status === 'connected') {
      // returns a User Access Token with scopes requested
      access_token = response.authResponse.accessToken;

      // launch Management View
      launchFBEManagementView(access_token);
    } else {
      FB.login(function (response) {
        if (response.authResponse) {
          // returns a User Access Token with scopes requested
          access_token = response.authResponse.accessToken;

          // launch Management View
          launchFBEManagementView(access_token);
        } else {
          console.log('User cancelled login or did not fully authorize.');
        }
      }, {});
    }
  });

店铺

如要使用 Instagram 购物执行站外或站内流程,则您必须拥有一个 Instagram 业务帐户。个人 Instagram 帐户不符合资格。如果您的 Instagram 业务帐户尚未建立品牌形象,或者销售的商品不符合资格要求,那么您的账户可能不符合业务要求,您可在六 (6) 个月内申请重新验证。详情请参阅资格要求

一个电商帐户只能拥有站外店铺或者站内店铺。您也可以将站内店铺转换为站外店铺,或将站外店铺转换为站内店铺。如果您的公司同时需要站内和站外店铺,则您必须使用不同资产执行两次启用流程。

所选资产相互关联,多种原因均可能导致目录不符合资格。部分原因包括:

  • 用户不是拥有该页面的企业的管理员
  • 页面已关联不同的企业管理平台

联系我们

您可以使用商务管理平台中的直接支持工具,直接向我们的团队寻求帮助:

  • 预约、预订、订餐服务合作伙伴:使用服务业 Facebook Business 扩展程序主题
  • 商业合作伙伴:使用市场合作伙伴:技术支持主题或直接联系您的 Facebook 合作伙伴管理平台。

如果您未在直接支持下拉菜单中找到所需主题,请通过电子邮件联系您的 Facebook 合作伙伴管理平台代表获取支持。

直接支持已与商务管理平台高度集成。请务必将团队所有成员添加为公司商务管理平台用户,以便他们使用直接支持工具提交问题和漏洞。请按照此处说明了解如何添加。

Throughout the FBE onboarding UI there is a “Having an Issue? Contact Us” link at the bottom of the page. Merchants should use this link to get FBE support.