Commerce Services Connector

某些Adobe Commerce和Magento Open Source功能由Commerce Services提供支持,并部署为SaaS(软件即服务)。 若要使用这些服务,必须使用生产和沙盒API密钥连接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
密钥标识符​ Production ​和​ Sandbox ​未引用您的环境。 对于每个环境(例如本地、开发、暂存或生产环境),您要将同一组API密钥使用到。
许可证所有者通常是Adobe Commerce客户的主要联系人,并不总是与Adobe Commerce on cloud infrastructure项目的项目所有者相同。

生成生产和沙盒API密钥 genapikey

  1. https://account.magento.com登录到您的Commerce帐户。

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

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

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

    下载私钥

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

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

    API密钥 ​部分现在显示您的API(公共)密钥。 当您在与许可证关联的任何环境/安装中选择或创建SaaS项目时,您需要所有四个密钥(生产和沙盒密钥,Public+Private)。

SaaS配置 saasenv

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

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

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

SaaS数据空间配置

所有Adobe Commerce商家均可访问每个SaaS项目的一个生产数据空间和两个测试数据空间。

您可以在任何非生产环境中使用测试数据空间,但前提是不同时在多个环境中使用相同的数据空间。 要在其他环境中使用测试数据空间,请先执行数据清理,然后再在该环境中选择和配置数据空间。

对于具有多个暂存环境的Adobe Commerce Cloud Pro项目,您可以通过提交支持请求,为每个暂存环境请求额外的测试数据空间。 但是,如果您只有一个暂存环境并且需要额外的测试数据空间,则可以使用以下选项:

  • 联系客户成功团队或您指定的客户成功经理以请求额外的暂存环境。 这另外还有额外费用。
  • 提交支持请求以获取额外的测试数据空间,并指明该额外数据空间的业务理由。 此请求有待审批。

选择或创建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. 在​ Sandbox API Keys ​和_Production API Keys_​部分中,粘贴您的键值。

    • 私钥必须在密钥的开头包含----BEGIN PRIVATE KEY---,在密钥的结尾包含----END PRIVATE KEY----
    • 如果您没有实际密钥的副本,请向帐户所有者索取这些密钥,然后将值插入配置。
    note warning
    WARNING
    如果通过查询数据库备份或快照并将这些值粘贴到配置中来添加密钥值,则会应用额外的加密层,并且密钥将无法正常工作。
  3. 单击​ 保存

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

  1. 如果不存在任何SaaS项目,请单击​ 创建项目。 然后在​ 项目 ​字段中,输入SaaS项目的名称。
NOTE
为避免混淆,请勿使用特定的Commerce服务作为项目的名称,例如​ Live SearchProduct Recommendations ​或​ Data Connection。 除非已为多个SaaS项目配置了您的许可证,否则您可以为多个服务使用同一SaaS项目。
  1. 选择要用于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