Commerce Services Connector
某些Adobe Commerce和Magento Open Source功能由Commerce Services提供支持,并部署为SaaS(软件即服务)。 若要使用这些服务,必须使用生产和沙盒API密钥连接Commerce实例,并在配置中指定数据空间。 您只需为每个实例配置一次连接即可。
可用服务 availableservices
下面列出了可通过Commerce Services Connector访问的Commerce功能:
架构
从较高层面来看,Commerce Services Connector由以下核心元素组成:
以下部分将更详细地讨论其中各个元素。
凭据 apikey
生产和沙盒API密钥从许可证所有者的Commerce帐户生成。 Commerce帐户由唯一的Commerce ID (MageID)标识。 商户组织的许可证所有者可以为产品Recommendations或Live Search等服务生成API密钥,前提是帐户处于良好状态。
这些密钥可在“需要知道”的基础上与系统集成商或代表许可证持有人管理项目和环境的开发团队共享。 已被许可证所有者授予Shared Access的开发者无法代表他们生成密钥,即使商户的组织位于其帐户上的Switch Accounts下拉列表中。
此外,解决方案集成商也有权使用Commerce Services。 如果您是解决方案集成商,Commerce合作伙伴合同的签名者应生成API密钥。
生成生产和沙盒API密钥 genapikey
-
在https://account.magento.com登录到您的Commerce帐户。
-
在 Magento 选项卡下,在侧栏中选择 API门户。
-
从 环境 菜单中,选择 生产 或 沙盒。
-
在 API密钥 部分中输入名称,然后单击 新增 打开对话框下载新密钥。
note warning WARNING 此对话框提供了复制或下载密钥的唯一机会。 -
单击 下载,然后单击 取消。
-
对每个环境(生产和沙盒)重复上述步骤。
API密钥 部分现在显示您的API(公共)密钥。 当您在与许可证关联的任何环境/安装中选择或创建SaaS项目时,您需要所有四个密钥(生产和沙盒密钥,Public+Private)。
SaaS配置 saasenv
Commerce实例必须配置有SaaS项目和SaaS数据空间,以便Commerce Services能够将数据发送到正确的位置。 SaaS项目对所有SaaS数据空间进行分组。 SaaS数据空间用于收集和存储使Commerce Services能够工作的数据。 某些此类数据可从Commerce实例中导出,而某些数据可从店面的购物者行为中收集。 然后,该数据将保留到安全云存储中。
对于Product Recommendations,SaaS数据空间包含目录和行为数据。 通过在Commerce配置中选择实例,您可以将Commerce实例指向SaaS数据空间。
如果发生这种情况,提交支持请求以请求数据清理。
SaaS数据空间配置
所有Adobe Commerce商家均可访问每个SaaS项目的一个生产数据空间和两个测试数据空间。
您可以在任何非生产环境中使用测试数据空间,但前提是不同时在多个环境中使用相同的数据空间。 要在其他环境中使用测试数据空间,请先执行数据清理,然后再在该环境中选择和配置数据空间。
对于具有多个暂存环境的Adobe Commerce Cloud Pro项目,您可以通过提交支持请求,为每个暂存环境请求额外的测试数据空间。 但是,如果您只有一个暂存环境并且需要额外的测试数据空间,则可以使用以下选项:
- 联系客户成功团队或您指定的客户成功经理以请求额外的暂存环境。 这另外还有额外费用。
- 提交支持请求以获取额外的测试数据空间,并指明该额外数据空间的业务理由。 此请求有待审批。
选择或创建SaaS项目 createsaasenv
要选择或创建SaaS项目,请从存储的Commerce许可证所有者请求Commerce API密钥:
-
在 管理员 侧边栏上,转到 系统 >服务> Commerce服务连接器。
如果在Commerce配置中未看到 Commerce Services Connector 部分,请为所需的Commerce 服务安装Commerce模块。 另外,确保已安装
magento/module-services-id
包。 -
在 Sandbox API Keys 和_Production API Keys_部分中,粘贴您的键值。
- 私钥必须在密钥的开头包含
----BEGIN PRIVATE KEY---
,在密钥的结尾包含----END PRIVATE KEY----
。 - 如果您没有实际密钥的副本,请向帐户所有者索取这些密钥,然后将值插入配置。
note warning WARNING 如果通过查询数据库备份或快照并将这些值粘贴到配置中来添加密钥值,则会应用额外的加密层,并且密钥将无法正常工作。 - 私钥必须在密钥的开头包含
-
单击 保存。
与您的密钥关联的任何SaaS项目都显示在 SaaS标识符 部分的 项目 字段中。
- 如果不存在任何SaaS项目,请单击 创建项目。 然后在 项目 字段中,输入SaaS项目的名称。
- 选择要用于Commerce存储当前配置的 数据空间。
若要更改SaaS项目或数据空间的名称,请单击其中任一项目或数据空间旁边的 重命名。 更改名称不会影响您的服务,因为名称只是一个标签,可帮助您识别和区分项目和数据空间。
IMS组织(可选) organizationid
要将您的Adobe Commerce实例连接到Adobe Experience Platform,请使用Adobe ID登录到您的Adobe帐户。 登录后,与您的Adobe帐户关联的IMS组织将显示在此部分中。
SaaS数据导出
当您的Commerce实例成功连接到Commerce Services时,SaaS数据导出过程会将Commerce数据从Commerce服务器导出到Commerce SaaS Services,以便将其同步到连接的Commerce服务。 在Admin中,您可以使用数据管理仪表板检查同步状态。 有关详细信息,请参阅SaaS数据导出指南。