概览

我们鼓励您通读本指南，集成尽可能多的电商 API 元素，理想情况是集成与您的用例相关的所有元素。

开发者身份范围

作为一名开发者，您的身份最有可能是以下其中一类：

卖家：您效力于一家自身拥有自定义技术堆栈的电子商务公司，并且希望与 Meta 的电商 API 集成，以便借助 Meta 的技术经营一家（或多家）店铺。
技术代理/合作伙伴：您效力于一家电子商务平台公司，或效力于为现有电子商务企业提供软件服务但自身没有店铺的公司（统称电子商务技术代理或合作伙伴），并且希望代表您平台支持的多家店铺与 Meta 的电商 API 集成。

无论是哪一种类别，当客户与使用我们的电商 API 管理的商品和店铺互动时，集成质量都将带来有意义的影响。本指南的重点在于为希望实现以下目标的合作伙伴开发者提供帮助：

与我们的电商 API 集成。
了解与 Meta 电商 API 构建优质集成所需的所有元素的概况和“重点”。
了解此类集成如何带来积极的业务成果：发掘新客户、达成更多销售额，以及成功利用 Meta 的广告达到同样的效果。

买家身份考量因素

买家会在深思熟虑后做出购买决定。他们会设法找到与考虑购买的商品相关的各种信息。他们希望物超所值，并且期待在店铺中找到与卖家自有网站上相同的折扣和优惠。他们需要及时了解已下订单的最新动态，包括准确的配送、追踪和退货信息。

为 Meta 提供所有此类元素是提高店铺转化率的关键。

高级开发者流程

Meta 允许第三方开发者构建系统，此类系统可以通过一系列电商 API 端点（这些端点是图谱 API 的一部分）与 Instagram 和 Facebook 开放平台建立集成。在此，我们介绍高级开发者流程，以及建立优质电商 API 集成所需的组件。

前提条件

您必须采用商家设置，并在 Meta 上完成认证
您必须签署必要的电商合同，其中包括技术代理修正案和补充条款
您必须了解图谱 API 的概念，此 API 是从 Meta 电子商务平台读取数据和向其写入数据的关键途径

第 1 步：创建开发者应用

若要向这些图谱 API 端点发出请求，您首先需要在 Meta 开发者网站中创建一个应用。在这种情况下，应用代表的是您的第三方软件有权在 Meta 系统上访问的一系列功能。您向 Meta 系统发出的每次 API 调用都与此应用关联，并且您的功能会决定您的软件有权调用哪些 API。此应用与您在 Meta 上的商家实体相关联。Meta 数据模型的设计方式是：您为在 Meta 上经营业务而创建的所有资产均由该商家实体对象拥有。拥有应用的同一个商家实体对象还拥有您的 Facebook 公共主页、Instagram 帐户、广告帐户和商品目录。

第 2 步：创建访问口令（使用测试帐户）

您需要在每次调用 API 时提供访问口令，这是应用前审批流程的一部分。您的应用可以借此访问口令代表用户访问 Meta 开放平台。访问口令与数字密钥的功能相同，可以令用户保持已登录 Facebook 的状态，以便每次您的第三方软件需要代表该用户访问 Meta 开放平台时，用户无需重新输入密码。

作为一名合作伙伴开发者，如果想要建立可以管理多个店铺的电子商务集成，就需要存储多个访问口令，每个在 Facebook 和 Instagram 渠道上开展销售活动的店铺对应一个。

首先，创建一个测试电子商务帐户，关联资产并生成一个相应的访问口令，用于开发电商 API 集成。

我们建议使用系统用户备份的访问口令来访问电商 API，因为从常规用户那里获得的访问口令可能会在一段时间后失效，或者该用户会更改他们的 Facebook 密码。系统用户是指对商务管理平台拥有或管理的资产发起 API 调用的服务器或软件。请参阅 API 集成设置，获取分步说明。

第 3 步：建立电商 API 集成（使用测试帐户）

首先，使用在第 2 步中创建的测试电子商务帐户与目录、订单管理和优惠 API 并行集成：与目录 API 集成，建立并运行高质量的最新目录，进而增强购买体验，影响购买决策。与订单管理 API 集成，以便管理买家在 Facebook 和 Instagram 渠道中所下订单的生命周期。与优惠 API 集成，以便同步不同类型的优惠，并在有优惠的情况下处理购买和退款。

了解如何与这些 API 集成，以达到我们的店铺质量标准。

第 4 步：提交应用以供审核

应用审核是应用开发流程当中不可或缺的一部分。您可以请求个别权限，并描述您的应用如何使用请求到的权限为您支持的商家助力，以此发起应用审核。在此流程中，我们会验证您的应用是否以已获批准的方式使用我们的产品和 API。详细了解应用审核流程。

第 5 步：实现引导卖家使用 Meta 电商平台的流程

实现引导卖家使用 Meta 电商平台的最佳途径。此流程结束时，系统会为您支持的每个卖家生成一个访问口令，您需要存储该口令，并在代表相关卖家调用 API 时使用。

了解有关如何创建符合店铺质量标准的理想入门引导集成的详细说明。

第 6 步：优化电商 API 集成（使用生产环境帐户）

优化集成，以便处理不同的连线案例场景，以及妥善处理故障。了解并采纳最佳实践指南中列出的推荐的集成最佳实践。最后，使用真实订单测试集成情况。

集成质量标准

下表列出了按不同类别划分的卖家待办任务 (JTBD)、任务优先级别（0 为最高）、这些任务是 Meta 专属任务还是适用于其他渠道、关联的 Meta 电商集成质量标准要求，以及有待增强之处。

类别	卖家的待办任务 (JTBD)	优先级别	多渠道/Meta 专属	质量标准：最低要求	质量标准：增强功能
入门引导和管理店铺	店铺入门引导	0	Meta 专属	第三方必须使用 FBE
	查看并解决店铺问题（包括 BI 问题）	0
	查看店铺的成效分析和建议	1	Meta 专属	N/A
	定制店铺的外观与风格	2	Meta 专属	N/A
	回复 Meta 买家/与之交流	0	两者皆是（许多卖家倾向于使用 Messenger/IGDM/WhatsApp 回复客户，而其他卖家依赖第三方工具与客户交流）	N/A
管理目录	添加/移除/编辑商品，保持目录的丰富性与时效性	0	多渠道	第三方必须将商品目录与 Meta 同步，并处理错误。请针对非波动字段使用可扩展的同步机制（每 24 小时同步一次完整目录，每 1 小时同步一次变量）。以近乎实时的频率（至少每 15 分钟）同步一次高波动性字段（库存和价格）的最新信息	第三方应与 Meta 同步商品系列精品栏
	查看并解决 Meta 特定的商品问题（如 BI 标记）	0	多渠道（不过可以在 Meta 界面中解决实际问题，如 BI 申诉）	第三方必须通过明确的行动号召 (CTA) 向卖家展示诊断信息
	审核并使用社群内容 (UGC)	1	Meta 专属	N/A
推广/投放店铺广告	投放店铺广告	0	Meta 专属	第三方必须采用卖家设置，并通过 Pixel 像素传回广告信号	第三方应采用卖家设置，并通过 CAPI 传回广告信号
	查看效果和分析（广告）	0	多渠道	N/A
	查看效果和分析（自然销量）	1	两者皆是（虽然有些工具可以汇总概括指标，但我们如今可通过 CM 提供更深层次的自然销量指标）	N/A
	投放优惠	0	多渠道	第三方必须处理包含相关 Meta 资助折扣和以下标准卖家资助折扣的订单（履行、取消、退款）：分配给一个订单中单个商品的折扣、分配给一个订单中多个商品的折扣（可能有剩余）、包邮折扣、买赠优惠类折扣如果第三方是折扣的可信数据源：第三方必须使用优惠 API（目前是一个尚未开放的功能）与 Meta 同步标准折扣，否则：第三方必须向卖家提供电商管理工具重定向链接，以与 Meta 同步所有标准折扣
	开展 Instagram 商品发布计划	2	Meta 专属	N/A
	开展 Instagram 直播购物活动	2	Meta 专属	N/A
	发布标记商品的自然帖子	2	Meta 专属	N/A
管理付款	管理站内结账的付款详情	0	Meta 专属	第三方必须使用 FBE。
	收款/处理退款	0	多渠道		第三方应公布从 Meta 获取的财务报告
	收款/处理退款	0	多渠道
	处理拒付问题	0	两者皆是
	生成税务报告并查核销售情况	0	多渠道
处理并履行订单	管理收到的订单	0	多渠道	第三方必须接收并答复 Meta 传向 OMS 的信息
	履行订单	0	多渠道	第三方必须将订单状态（履行、取消、退款）从 OMS 同步到 Meta
	处理买家与卖家发起的退货和退款	0	多渠道	第三方必须将订单状态（履行、取消、退款）从 OMS 同步到 Meta	第三方应通过 Meta 处理买家发起的退货