Commerce Services Connector

某些Adobe Commerce和Magento Open Source功能由Commerce Services提供支持,并部署为SaaS(软件即服务)。 若要使用这些服务,必须使用生产和沙盒API密钥连接Commerce实例,并在配置中指定数据空间。 您只需为每个Commerce实例配置一次连接即可。

可用服务 availableservices

下面列出了可通过Commerce Services Connector访问的Commerce功能:

服务
可用性
由Adobe Sensei支持的Product Recommendations
Adobe Commerce
由Adobe Sensei支持的Live Search
Adobe Commerce
Payment Services
Adobe Commerce和Magento Open Source
Site-Wide Analysis Tool
Adobe Commerce
Catalog Service
Adobe Commerce
Data Connection
Adobe Commerce

架构

从较高层面来看,Commerce Services Connector由以下核心元素组成:

Commerce服务连接器架构

以下部分将更详细地讨论其中各个元素。

凭据 apikey

生产和沙盒API密钥从许可证所有者的Commerce帐户生成。 Commerce帐户由唯一的Commerce ID (MageID)标识。 商户组织的许可证所有者可以为产品Recommendations或Live Search等服务生成API密钥,前提是帐户处于良好状态。

这些密钥可在“需要知道”的基础上与系统集成商或代表许可证持有人管理项目和环境的开发团队共享。 已被许可证所有者授予Shared Access的开发者无法代表他们生成密钥,即使商户的组织位于其帐户上的Switch Accounts下拉列表中。

此外,解决方案集成商也有权使用Commerce Services。 如果您是解决方案集成商,Commerce合作伙伴合同的签名者应生成API密钥。

NOTE
许可证所有者通常是Adobe Commerce客户的主要联系人,并不总是与Adobe Commerce on cloud infrastructure项目的项目所有者相同。

生成生产和沙盒API密钥 genapikey

  1. https://account.magento.com{:target="_blank"}登录到您的Commerce帐户。

  2. 在​ Magento ​选项卡下,在侧栏中选择​ API门户

  3. 从​ 环境 ​菜单中,选择​ 生产 ​或​ 沙盒

  4. 在​ API密钥 ​部分中输入名称,然后单击​ 新增 ​打开对话框下载新密钥。

    下载私钥

    note warning
    WARNING
    此对话框提供了复制或下载密钥的唯一机会。
  5. 单击​ 下载,然后单击​ 取消

  6. 对每个环境(生产和沙盒)重复上述步骤。

    API密钥 ​部分现在显示您的API(公共)密钥。 当您选择或创建SaaS项目时,需要生产和沙盒密钥(公共+私有)。

SaaS配置 saasenv

Commerce实例必须配置有SaaS项目和SaaS数据空间,以便Commerce Services能够将数据发送到正确的位置。 SaaS项目对所有SaaS数据空间进行分组。 SaaS数据空间用于收集和存储使Commerce Services能够工作的数据。 某些此类数据可从Commerce实例中导出,而某些数据可从店面的购物者行为中收集。 然后,该数据将保留到安全云存储中。

对于Product Recommendations,SaaS数据空间包含目录和行为数据。 通过在Commerce配置中选择实例,您可以将Commerce实例指向SaaS数据空间。

WARNING
请仅在生产Commerce安装中使用生产SaaS数据空间,以避免数据冲突。 否则,您可能会用测试数据污染生产站点数据,从而导致部署延迟。 例如,可能会从暂存数据(如暂存URL)错误地覆盖您的生产产品数据。

选择或创建SaaS项目 createsaasenv

要选择或创建SaaS项目,请从存储的Commerce许可证所有者请求Commerce API密钥:

NOTE
如果在Commerce配置中未看到​ Commerce Services Connector ​部分,则必须为所需的Commerce 服务安装Commerce模块。
  1. 在​ 管理员 ​侧边栏上,转到​ 系统 >服务> Commerce服务连接器

    如果在Commerce配置中未看到​ Commerce Services Connector ​部分,请为所需的Commerce 服务安装Commerce模块。 另外,确保已安装magento/module-services-id包。

  2. 在​ 沙盒API密钥 ​和​ 生产API密钥 ​部分中,粘贴您的密钥值。

    私钥必须在私钥的开头包含----BEGIN PRIVATE KEY---,在私钥的结尾包含----END PRIVATE KEY----

  3. 单击​ 保存

与您的密钥关联的任何SaaS项目都显示在​ SaaS标识符 ​部分的​ 项目 ​字段中。

  1. 如果不存在任何SaaS项目,请单击​ 创建项目。 然后在​ 项目 ​字段中,输入SaaS项目的名称。

    创建SaaS项目时,Commerce会根据您的Commerce许可证生成一个或多个SaaS数据空间:

    • Adobe Commerce — 一个生产数据空间;仅两个测试数据空间。 在具有多个暂存环境的Cloud Pro项目中,您可以通过提交支持请求,为每个暂存环境请求额外的测试数据空间。
    • Magento Open Source — 一个生产数据空间;无测试数据空间
  2. 选择要用于Commerce存储当前配置的​ 数据空间

NOTE
如果您有单独的实例要与Commerce服务集成,请提交支持票证,以便为每个额外的实例请求新的SaaS项目。 在支持人员创建SaaS项目后,请使用相同的API密钥为实例配置Commerce Services集成,并为数据空间选择新的SaaS项目。
WARNING
如果您在“我的帐户”的“API门户”部分生成新密钥,请立即更新管理员配置中的API密钥。 如果您在管理员中生成新密钥但未更新它们,则SaaS扩展不再有效,并且您会丢失宝贵的数据。

若要更改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数据导出指南

recommendation-more-help
3d5a1200-3287-4b90-a075-6c594f65d80e