安装Data Connection

在安装扩展之前,查看先决条件

安装扩展

Data Connection扩展可从Adobe市场获得。 从服务器的命令行安装此扩展时,它将作为服务连接到Adobe Commerce安装。 该过程完成后,Data Connection ​和​ Commerce Services Connector ​将出现在Commerce 管理员 ​的​ 服务 ​下的​ 系统 ​菜单中。

Data Connection扩展管理员视图

IMPORTANT
虽然扩展名已从Experience Platform连接器更改为Data Connection,但包名仍为experience-platform-connector以支持向后兼容性。
  1. 要下载experience-platform-connector包,请从命令行运行以下命令:

    code language-bash
    composer require magento/experience-platform-connector
    

    此元包包含以下模块和扩展:

    • module-experience-connector-admin — 更新管理员UI,以便您能够为特定Adobe Commerce实例选择数据流ID。
    • module-experience-connector — 在Storefront事件SDK中设置Organization IDdatastreamId
    • data-services — 提供店面事件的属性上下文。 例如,发生结帐事件时,将包含有关购物车中有多少商品的信息以及这些商品的产品属性数据。
    • services-id — 使用沙盒和生产API密钥将您的Adobe Commerce实例连接到Adobe Commerce SaaS,并连接到Adobe Experience Platform以检索IMS组织ID。
    • orders-connector — 将订单状态服务连接到您的Adobe Commerce实例。
  2. (可选)要包含Live Search数据(包含搜索事件),请安装Live Search扩展。

  3. (可选)要包含B2B数据(包含申请事件),请安装B2B扩展

安装Adobe I/O事件

安装experience-platform-connector扩展后,必须安装Adobe Commerce的Adobe I/O事件。

以下步骤适用于云基础架构和内部部署安装的Adobe Commerce。

  1. 如果您正在运行Commerce 2.4.4或2.4.5,请使用以下命令加载事件模块:

    code language-bash
    composer require magento/commerce-eventing=^1.0 --no-update
    

    Commerce 2.4.6及更高版本会自动加载这些模块。

  2. 更新项目依赖关系。

    code language-bash
    composer update
    
  3. 启用新模块:

    code language-bash
    bin/magento module:enable Magento_AdobeCommerceEventsClient Magento_AdobeCommerceEventsGenerator Magento_AdobeIoEventsClient Magento_AdobeCommerceOutOfProcessExtensibility
    

根据部署类型最终完成安装:内部部署或云基础架构上的Adobe Commerce 。

内部部署

在内部部署环境中,您必须手动启用代码生成和Adobe Commerce事件:

bin/magento events:generate:module
bin/magento module:enable Magento_AdobeCommerceEvents
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento config:set adobe_io_events/eventing/enabled 1

在云基础架构上

在云基础架构上的Adobe Commerce中,在.magento.env.yaml中启用ENABLE_EVENTING全局变量。 了解更多

stage:
   global:
      ENABLE_EVENTING: true

提交更新的文件并将其推送到云环境。 部署完成后,使用以下命令启用发送事件:

bin/magento config:set adobe_io_events/eventing/enabled 1

安装B2B扩展

对于B2B商家,请安装以下扩展以包含申请列表事件数据。

通过从命令行运行以下命令来下载magento/experience-platform-connector-b2b扩展:

composer require magento/experience-platform-connector-b2b

更新Data Connection扩展 update

要更新Data Connection扩展,请从命令行运行以下命令:

composer update magento/experience-platform-connector --with-dependencies

或者,对于B2B商家:

composer update magento/experience-platform-connector-b2b --with-dependencies

要更新到主要版本,例如从2.0.0到3.0.0,请按如下方式编辑项目的根Composer .json文件:

  1. 打开根composer.json文件并搜索magento/experience-platform-connector

  2. require部分中,更新版本号,如下所示:

    code language-json
    "require": {
       ...
       "magento/experience-platform-connector": "^3.0",
       ...
     }
    
  3. 保存 composer.json。 然后,从命令行运行以下命令:

    code language-bash
    composer update magento/experience-platform-connector –-with-dependencies
    

    或者,对于B2B商家:

    code language-bash
    composer update magento/experience-platform-connector-b2b --with-dependencies
    

卸载Data Connection扩展 uninstall

要卸载Data Connection扩展,请参阅卸载模块

recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840