将Commerce数据连接到Adobe Experience Platform
安装Data Connection扩展时,在Commerce 管理员 的 服务 下的 系统 菜单中会显示两个新的配置页面。
- Commerce服务连接器
- Data Connection
要将Adobe Commerce实例连接到Adobe Experience Platform,必须配置这两个连接器,从Commerce服务连接器开始,然后使用Data Connection扩展完成。
配置Commerce服务连接器
如果以前安装过Adobe Commerce服务,则您可能已配置Commerce服务连接器。 如果没有,则必须在Commerce Services Connector页面上完成以下任务:
- 登录到您的Commerce帐户以检索您的生产和沙盒API密钥。
- 选择SaaS数据空间。
- 登录到您的Adobe帐户以检索您的组织ID。
配置Commerce Services连接器后,再配置Data Connection扩展。
配置Data Connection扩展
在本节中,您将了解如何配置Data Connection扩展。
添加服务帐户和凭据详细信息
如果您计划收集和发送历史订单数据或客户配置文件数据,则必须添加服务帐户和凭据详细信息。 此外,如果您正在配置Audience Activation扩展,则必须完成这些步骤。
如果您仅收集和发送店面或后台数据,则可以跳到常规部分。
步骤1:在Adobe Developer Console中创建项目
在Adobe Developer Console中创建一个验证Commerce的项目,以便它能进行Experience PlatformAPI调用。
要创建项目,请按照身份验证和访问Experience PlatformAPI教程中所述的步骤操作。
在学习本教程时,请确保您的项目具备以下条件:
此步骤的结果将创建一个配置文件,供您在下一步中使用。
步骤2:下载配置文件
下载工作区配置文件。 将此文件的内容复制并粘贴到Commerce管理员的 服务帐户/凭据详细信息 页面。
-
在Commerce管理员中,导航到 商店 >设置> 配置 > 服务 > Data Connection。
-
从 Adobe Developer授权类型 菜单中选择您实施的服务器到服务器授权方法。 Adobe建议使用OAuth。 已弃用JWT。 了解更多。
-
(仅限JWT)将
private.key
文件的内容复制并粘贴到 客户端密钥 字段中。 使用以下命令复制内容。code language-bash cat config/private.key | pbcopy
有关
private.key
文件的详细信息,请参阅服务帐户(JWT)身份验证。 -
将
<workspace-name>.json
文件的内容复制到 服务帐户/凭据详细信息 字段。{width="700" modal="regular"}
-
单击 保存配置。
-
单击 Test connection 按钮以确保您输入的服务帐户和凭据信息正确。
常规
-
在管理员中,转到 系统 >服务> Data Connection。
{width="700" modal="regular"}
-
在 常规 下的 设置 选项卡中,验证与您的Adobe Experience Platform帐户关联的ID,该ID已在Commerce Services Connector中配置。 组织ID是全局的。 每个Adobe Commerce实例只能关联一个组织ID。
-
在 范围 下拉列表中,将上下文设置为 网站。
-
(可选)如果您已经将AEP Web SDK (alloy)部署到您的站点,请启用该复选框并添加AEP Web SDK的名称。 否则,请将这些字段留空,Data Connection扩展将为您部署一个字段。
note note NOTE 如果您指定自己的AEP Web SDK,Data Connection扩展将使用与该SDK关联的数据流ID,而不是此页面上指定的数据流ID(如果有)。
数据收集
在此部分中,您可以指定要收集并发送到Experience Platform边缘的数据类型。 有三种类型的数据:
要确保Adobe Commerce实例可以开始数据收集,请查看先决条件。
请参阅活动主题以了解有关店面、后台和配置文件事件的更多信息。
-
如果要发送店面行为数据,请选择 店面事件。
-
如果要发送订单状态信息(如订单已下达、已取消、已退款或已发货),请选择 后台事件。
note note NOTE 如果选择 后台事件,则所有后台数据都会发送到Experience Platform边缘。 如果购物者选择退出数据收集,您必须在Experience Platform中明确设置购物者的隐私偏好设置。 这与店面事件不同,店面事件收集器已根据购物者偏好处理同意。 了解更多有关在Experience Platform中设置购物者的隐私首选项的信息。 -
(如果您使用自己的AEP Web SDK,请跳过此步骤。) 在Adobe Experience Platform中创建数据流或选择要用于收集的现有数据流。 在 数据流ID 字段中输入该数据流ID。
-
输入要包含Commerce数据的 数据集ID。 要查找数据集ID,请执行以下操作:
- 打开Experience PlatformUI,然后在左侧导航中选择 数据集 以打开 数据集 仪表板。 仪表板列出您组织的所有可用数据集。 将显示每个列出数据集的详细信息,包括其名称、数据集所遵循的架构以及最近一次摄取运行的状态。
- 打开与数据流关联的数据集。
- 在右侧窗格中,查看有关数据集的详细信息。 复制数据集ID。
-
若要确保根据cron作业按计划更新后台事件数据,必须将
Sales Orders Feed
索引更改为Update by Schedule
。-
在 管理员 侧边栏上,转到 System > Tools>Index Management。
-
选中
Sales Orders Feed
索引器的复选框。 -
将 Actions 设置为
Update by Schedule
。 -
如果您是首次启用后台数据,请运行以下命令来重新索引并触发重新同步。 只要cron作业设置正确,后续的重新同步就会自动进行。
code language-bash bin/magento index:reindex sales_order_data_exporter_v2
code language-bash bin/magento saas:resync --feed orders
-
字段描述
完成新用户引导后,店面数据开始流入Experience Platform边缘。 后台数据大约需要5分钟才能显示在边缘。 根据cron时间表,可以在Edge看到后续更新。
发送客户个人资料数据
有两种类型的配置文件数据可发送到Experience Platform:配置文件记录和时间序列配置文件事件。
配置文件记录包含购物者在Commerce实例中创建配置文件时保存的数据,例如购物者的姓名。 如果您的架构和数据集配置正确🔗,则会向Experience Platform发送配置文件记录,并将其转发到Adobe的配置文件管理和分段服务: Real-Time CDP。
时间序列配置文件事件包含有关购物者配置文件信息的数据,例如,购物者在您的网站上创建、编辑或删除帐户的情况。 将配置文件事件数据发送到Experience Platform时,该数据会位于可供其他DX产品使用的数据集中。
-
确保您已提供服务帐户和凭据详细信息。
-
确保您为配置文件记录数据摄取和时间序列配置文件事件数据摄取指定了架构和数据集。
-
如果要将配置文件数据发送到Experience Platform,请在 客户配置文件 复选框中放置复选标记。
-
输入 配置文件数据集ID。
配置文件记录数据必须使用的数据集必须与您当前用于行为和后台事件数据的数据集不同。
-
如果您不想通过用于行为数据和后台数据的相同数据流ID流式传输配置文件事件,请通过相同数据流ID 从 流式传输客户配置文件中删除复选标记,然后输入要改用的数据流ID。
配置文件记录在Real-Time CDP中可用大约需要10分钟。 配置文件事件会立即开始流式传输。
字段描述
发送历史订单数据
Adobe Commerce最多收集5年的历史订单数据和状态。 您可以使用Data Connection扩展将该历史数据发送到Experience Platform,以丰富您的客户配置文件并根据这些过去的订单个性化客户体验。 该数据存储在Experience Platform内的数据集中。
虽然Commerce已收集历史订单数据,但您必须完成多个步骤才能将该数据发送到Experience Platform。
观看本视频,了解有关历史订单的更多信息,然后完成以下步骤来实施历史订单收集。
设置订单同步服务
订单同步服务使用消息队列框架和RabbitMQ。 完成这些步骤后,订单状态数据可以同步到SaaS,在发送到Experience Platform之前需要执行此操作。
启用订单同步服务后,您可以在 Data Connection 页面中指定历史订单日期范围。
指定订单历史记录日期范围
指定要发送给Experience Platform的历史订单的日期范围。
-
在管理员中,转到 系统 >服务> Data Connection。
-
选择 订单历史记录 选项卡。
{width="700" modal="regular"}
-
在 订单历史记录同步 下,从设置复制数据集ID 复选框已启用。 这将确保您使用在 设置 选项卡中指定的相同数据集。
-
在 从 和 到 字段中,指定要发送的历史订单数据的日期范围。 您不能选择超过五年的日期范围。
-
选择 Start Sync 以触发同步开始。 历史订单数据是批处理数据,而不是店面和后台的流数据。 批量数据大约需要45分钟才能到达Experience Platform。
字段描述
数据自定义
在 数据自定义 选项卡上,您可以查看在Commerce中配置并发送到Experience Platform的任何自定义属性。
{width="700" modal="regular"}
为订单创建自定义属性并将它们发送到Experience Platform时,Commerce中的属性名称必须与Experience Platform上Commerce架构中的属性名称匹配。 如果两者不匹配,则可能很难识别差异。 如果您的名称不匹配,自定义订单属性 表可以帮助解决此问题。
自定义订单属性 表提供了在Experience Platform中的Commerce后台和Commerce架构之间自定义订单属性的配置和映射的可见性。 此表允许您查看跨不同来源的订单层和订单项目层自定义属性,从而更容易识别缺少或未对齐的属性。 它还显示数据集ID以帮助区分实时数据集和历史数据集,因为每个数据集可以具有自己的自定义属性。
如果在表中的自定义属性名称旁边没有出现绿色复选标记,则表示源中的属性名称不匹配。 在一个源中更正属性名称,将出现绿色复选标记,指示名称现在匹配。
- 如果在Experience Platform架构中更新了属性名称,则必须在 数据自定义 选项卡上保存配置以触发Experience Platform架构更改。 单击 Refresh 按钮时,此更改将反映在 自定义订单属性 表中。
- 如果属性名称在Commerce中更新,则必须生成订单事件以更新 自定义订单属性 表中的名称。 此更改将在大约60分钟后反映出来。
详细了解如何设置自定义属性。
字段描述
确认已收集事件数据
要确认正在从Commerce存储中收集数据,请使用Adobe Experience Platform Debugger来检查您的Commerce网站。 确认正在收集数据后,通过运行返回来自您创建的数据集的数据的查询,可以验证店面和后台事件数据是否显示在边缘。
-
在Experience Platform的左侧导航中选择 查询,然后单击Create Query。
-
当查询编辑器打开时,输入从数据集选择数据的查询。
例如,您的查询可能如下所示:
code language-sql SELECT * from `your_dataset_name` ORDER by TIMESTAMP DESC
-
查询运行后,结果将显示在 控制台 选项卡旁边的 结果 选项卡中。 此视图显示查询的表格输出。
在此示例中,您看到来自commerce.productListAdds
、commerce.productViews
、web.webpagedetails.pageViews
等的事件数据。 通过此视图,可验证您的Commerce数据是否已到达边缘。
如果结果不符合预期,请打开您的数据集并查找任何失败的批量导入。 了解有关批处理导入疑难解答的详细信息。
验证配置文件数据是否显示在Experience Platform中
如果Experience Platform中未显示配置文件数据,请参阅Commerce知识库以获取故障排除建议。
后续步骤
在将Commerce数据发送到Experience Platform边缘时,其他Adobe Experience Cloud产品(如Adobe Journey Optimizer)可以使用该数据。 例如,您可以将Journey Optimizer配置为侦听某些事件,并根据该事件数据触发针对首次用户或存在放弃购物车的电子邮件。 了解如何通过在Journey Optimizer中创建客户历程来扩展Commerce平台。