[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}
使用Adobe Experience Platform Tags收集Commerce数据
虽然您可以使用Data Connection扩展发布和订阅店面活动，但一些商家可能已经在使用数据收集解决方案，例如Adobe Experience Platform标记。 对于这些商家，Adobe Commerce在使用Adobe Commerce Event SDK的Data Connection扩展中提供仅发布选项。
Data Connection带有标记的扩展数据流
在本主题中，您将了解如何将Data Connection扩展提供的店面事件值映射到您已在使用的Adobe Experience Platform标记解决方案。
从Adobe Commerce收集事件数据
收集Commerce事件数据：
-
安装Adobe Commerce Events SDK。 有关PHP店面，请参阅安装主题。 有关PWA Studio店面，请参阅PWA Studio指南。
note note NOTE 请 不 配置组织ID和数据流ID。
将Commerce店面数据映射到Adobe Experience Platform
要将Commerce店面数据映射到Adobe Experience Platform，请从Adobe Experience Platform标记中配置并安装以下内容：
-
在 创作 下，选择 扩展 并安装和配置以下扩展：
-
将标记发布到开发环境。
-
按照下面的 事件映射 步骤配置特定事件的数据元素和规则。
事件映射
由于使用标记的数据收集与使用Adobe Commerce事件SDK的数据收集不同，因此了解这两个框架中使用的等效术语很重要。
规则操作 — 事件处理程序(发送到Adobe Experience Platform)
使用特定于Adobe Commerce的事件数据更新Adobe Experience Platform标记中的数据元素和规则时，您需要执行一些常用步骤。
例如，让我们将Adobe Commerce signOut事件添加到Adobe Experience Platform标记。 除了您设置的特定值之外，下面列出的步骤说明了如何添加数据元素和规则，这些规则适用于您添加到标记的所有Adobe Commerce事件。
-
创建数据元素：
创建新数据元素 -
将 Name 设置为
sign out。 -
将 扩展 设置为
Adobe Experience Platform Web SDK。 -
将 数据元素类型 设置为
XDM object。 -
选择要更新的 沙盒 和 架构。
-
在 用户帐户 > 注销 下，将 访客注销 中的 值 设置为
1。
更新注销值 -
选择 保存。
-
创建规则：
创建新规则 -
选择 EVENTS 下的 添加。
-
将 扩展 设置为
Adobe Client Data Layer。 -
将 事件类型 设置为
Data Pushed。 -
选择 特定事件 并将 事件/密钥设置为
sign-out以注册。 -
选择 保留更改 以保存新规则。
-
添加操作。
-
将 扩展 设置为
Adobe Experience Platform Web SDK。 -
将 操作类型 设置为
Send Event。 -
将 实例 设置为
Alloy。 -
将 Type 设置为
userAccount.logout。 -
将 XDM数据 设置为
%sign out%。 -
单击 保存。
您在架构中为来自Adobe Commerce的
signOut事件创建了一个数据元素。 此外，您还创建了一个规则，该规则具有从Adobe Commerce店面触发该事件时应发生的特定操作。
在标签中，为下述每个Adobe Commerce事件重复上述步骤。
可用事件
对于以下每个事件，请按照上述步骤将Adobe Commerce事件映射到您的XDM。
注销
购物者尝试注销时触发。
数据元素
创建以下数据元素：
-
注销：
- 名称：
Sign out - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
userAccount>logout - 访客注销： 值 =
1
- 名称：
规则
- 名称：
Sign out - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
sign-out
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
userAccount.logout - XDM数据：
%sign-out%
登录
购物者尝试登录时触发。
数据元素
创建以下数据元素：
-
帐户电子邮件：
- 名称：
account email - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.emailAddress
- 名称：
-
帐户类型：
- 名称：
account type - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.accountType
- 名称：
-
帐户ID：
- 名称：
account id - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径*：
accountContext.accountId
- 名称：
-
登录：
- 名称：
sign in - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
person>accountID - 帐户ID： 值 =
%account id% - 字段组：
person>accountType - 帐户类型： 值 =
%account type% - 字段组：
person>personalEmailID - 个人电子邮件地址： 值 =
%account email% - 字段组：
personalEmail>address - 地址： 值 =
%account email% - 字段组：
userAccount>login - 访客登录： 值 =
1
- 名称：
规则
- 名称：
sign in - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
sign-in
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
userAccount.login - XDM数据：
%sign in%
createAccount
购物者尝试创建帐户时触发。
数据元素
创建以下数据元素：
-
帐户电子邮件：
- 名称：
account email - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.emailAddress
- 名称：
-
帐户类型：
- 名称：
account type - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.accountType
- 名称：
-
帐户ID：
- 名称：
account id - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.accountId
- 名称：
-
创建帐户：
- 名称：
Create account - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
person>accountID - 帐户ID： 值 =
%account id% - 字段组：
person>accountType - 帐户类型： 值 =
%account type% - 字段组：
person>personalEmailID - 个人电子邮件地址： 值 =
%account email% - 字段组：
personalEmail>address - 地址： 值 =
%account email% - 字段组：
userAccount>createProfile - 帐户配置文件创建： 值 =
1
- 名称：
规则
- 名称：
Create account - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
create-account
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
userAccount.createProfile - XDM数据：
%create account%
editAccount
购物者尝试编辑帐户时触发。
数据元素
创建以下数据元素：
-
帐户电子邮件：
- 名称：
account email - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.emailAddress
- 名称：
-
帐户类型：
- 名称：
account type - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.accountType
- 名称：
-
帐户ID：
- 名称：
account id - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.accountId
- 名称：
-
编辑帐户：
- 名称：
Edit account - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
person>accountID - 帐户ID： 值 =
%account id% - 字段组：
person>accountType - 帐户类型： 值 =
%account type% - 字段组：
person>personalEmailID - 个人电子邮件地址： 值 =
%account email% - 字段组：
personalEmail>address - 地址： 值 =
%account email% - 字段组：
userAccount>updateProfile - 帐户配置文件创建： 值 =
1
- 名称：
规则
- 名称：
Edit account - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
edit-account
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
userAccount.updateProfile - XDM数据：
%edit account%
pageView
任何页面加载时触发。
数据元素
创建以下数据元素：
-
页面名称：
- 名称：
page name - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
pageContext.pageName
- 名称：
规则
- 名称：
page view - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
page-view
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
web.webPageDetails.pageViews - XDM数据：
%page view%
产品视图
任何产品页面加载时触发。
数据元素
创建以下数据元素：
-
产品名称：
- 名称：
product name - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.name
- 名称：
-
产品SKU：
- 名称：
product sku - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.sku
- 名称：
-
产品图像URL：
- 名称：
product image - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.mainImageUrl
- 名称：
-
产品货币：
- 名称：
product currency - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.currencyCode
- 名称：
-
货币代码：
- 名称：
currency code - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('product currency') || _satellite.getVar('storefront').storeViewCurrencyCode - 名称：
-
特价：
- 名称：
special price - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.specialPrice
- 名称：
-
正常价格：
- 名称：
regular price - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.regularPrice
- 名称：
-
产品价格：
- 名称：
product price - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('product regular price') || _satellite.getVar('product special price') - 名称：
-
产品视图：
- 名称：
product view - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
productListItems。 选择 提供单个项目 并单击 添加项目 按钮。 由于此视图适用于PDP，因此您可以使用单个项目进行填充。 - 字段组：
productListItems>name - 名称： 值 =
%product name% - 字段组：
productListItems>SKU - SKU： 值 =
%product sku% - 字段组：
productListItems>priceTotal - 总价：值 =
%product price% - 字段组：
productListItems>currencyCode - 货币代码： 值 =
%currency code% - 字段组：
productListItems>ProductImageUrl - ProductImageUrl： 值 =
%product image% - 字段组：
commerce>productViews>value - 值： 值 =
1
- 名称：
规则
- 名称：
product view - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
product-page-view
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.productViews - XDM数据：
%product view%
searchRequestSent
由“键入时搜索”弹出框中的事件以及搜索结果页面上的事件触发。
数据元素
创建以下数据元素：
-
搜索输入
- 名称：
search input - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
searchInputContext.units[0]
- 名称：
-
搜索输入短语
- 名称：
search input phrase - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('search input').phrase; - 名称：
-
搜索输入排序
- 名称：
search input sort - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const searchInput = _satellite.getVar('search input'); const sortFromInput = searchInput ? searchInput.sort : []; const sort = sortFromInput.map((searchSort) => { return { attribute: searchSort.attribute, order: searchSort.direction, }; }); return sort; - 名称：
-
搜索输入筛选器
- 名称：
search input filters - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const searchInput = _satellite.getVar('search input'); const filtersFromInput = searchInput ? searchInput.filter : []; const filters = filtersFromInput.map( (searchFilter) => { let value = []; let isRange = false; if (searchFilter.eq) { value.push(searchFilter.eq); } else if (searchFilter.in) { value = searchFilter.in; } else if (searchFilter.range) { isRange = true; value.push(String(searchFilter.range.from)); value.push(String(searchFilter.range.to)); } return { attribute: searchFilter.attribute, value, isRange, }; } ); return filters; - 名称：
-
搜索请求：
- 名称：
search request - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
siteSearch>phrase - 值：尚不可用
- 字段组：
siteSearch>sort。 选择 提供整个对象。 - 字段组：
siteSearch>filter。 选择 提供整个对象。 - 字段组：
searchRequest>id - 唯一标识符： 值 =
%search request ID% - 字段组：
searchRequest>value - 值： 值 =
1
- 名称：
规则
- 名称：
search request sent - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
search-request-sent
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
searchRequest - XDM数据：
%search request%
searchResponseReceived
当Live Search返回“键入时搜索”弹出框或搜索结果页面的结果时触发。
数据元素
创建以下数据元素：
-
搜索结果：
- 名称：
search results - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
searchResultsContext.units[0]
- 名称：
-
产品的搜索结果编号：
- 名称：
search result number of products - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('search result').products.length; - 名称：
-
搜索结果产品：
- 名称：
search result products - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const searchResult = _satellite.getVar('search result'); const productsFromResult = searchResult.products ? searchResult.products : []; const products = productsFromResult.map( (product) => { return { SKU: product.sku, name: product.name }; } ); return products; - 名称：
-
搜索结果建议：
- 名称：
search result products - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const searchResult = _satellite.getVar('search result'); const suggestionsFromResult = searchResult.suggestions ? searchResult.suggestions : []; const suggestions = suggestionsFromResult.map((suggestion) => suggestion.suggestion); return suggestions; - 名称：
-
产品图像URL：
- 名称：
product image - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.mainImageUrl
- 名称：
-
搜索响应：
- 名称：
search response - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
siteSearch>suggestions。 选择 提供整个对象。 - 数据元素：
%search result suggestions% - 字段组：
siteSearch>numberOfResults - 值：
%search result number of products% - 字段组：
productListItems。 选择 提供整个对象。 - 字段组：
productListItems>ProductImageUrl - ProductImageUrl： 值 =
%product image% - 数据元素：
%search result products% - 字段组：
searchResponse>id - 唯一标识符： 值 =
%search response ID% - 字段组：
searchResponse>value - 值： 值 =
1
- 名称：
规则
- 名称：
search response received - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
search-response-received
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
searchResponse - XDM数据：
%search response%
addToCart
将产品添加到购物车时或购物车中的产品数量每次递增时触发。
数据元素
创建以下数据元素：
-
产品名称：
- 名称：
product name - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.name
- 名称：
-
产品SKU：
- 名称：
product sku - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.sku
- 名称：
-
货币代码：
- 名称：
currency code - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.currencyCode
- 名称：
-
产品特价：
- 名称：
product special price - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.specialPrice
- 名称：
-
产品图像URL：
- 名称：
product image - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.mainImageUrl
- 名称：
-
产品正常价格：
- 名称：
product regular price - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.regularPrice
- 名称：
-
产品 价格：
- 名称：
product price - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('product regular price') || _satellite.getVar('product special price') - 名称：
-
购物车：
- 名称：
cart - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
shoppingCartContext
- 名称：
-
购物车ID：
- 名称：
cart id - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('cart').id - 名称：
-
添加到购物车：
- 名称：
add to cart - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
productListItems。 选择 提供单个项目 并单击 添加项目 按钮。 由于此视图适用于PDP，因此您可以使用单个项目进行填充。 - 字段组：
productListItems>name - 名称： 值 =
%product name% - 字段组：
productListItems>SKU - SKU： 值 =
%product sku% - 字段组：
productListItems>priceTotal - 总价：值 =
%product price% - 字段组：
productListItems>currencyCode - 字段组：
productListItems>ProductImageUrl - ProductImageUrl： 值 =
%product image% - 货币代码： 值 =
%currency code% - 字段组：
commerce>cart>cartID - 购物车ID： 值 =
%cart id% - 字段组：
commerce>productListAdds>value - 值： 值 =
1
- 名称：
规则
- 名称：
add to cart - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
add-to-cart
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.productListAdds - XDM数据：
%add to cart%
openCart
创建新购物车时触发，在将产品添加到空购物车时发生。
数据元素
创建以下数据元素：
-
打开购物车：
- 名称：
open cart - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
commerce>productListOpens>value - 值： 值 =
1 - 字段组：
commerce>cart>cartID - 购物车ID： 值 =
%cart id% - 字段组：
productListItems。 对于productListItems，可以预计算多个项。 选择 productListItems > 提供整个数组。
- 名称：
规则
- 名称：
open cart - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
open-cart
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.productListOpens - XDM数据：
%open cart%
viewCart
任何购物车页面加载时触发。
数据元素
创建以下数据元素：
-
店面：
- 名称：
storefront - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
storefrontInstanceContext
- 名称：
-
产品图像URL：
- 名称：
product image - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.mainImageUrl
- 购物车：
- 名称：
cart - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
shoppingCartContext
- 名称：
-
购物车ID：
- 名称：
cart id - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('cart').id - 名称：
-
产品列表项：
- 名称：
product list items: - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const storefrontContext = _satellite.getVar('storefront'); const cart = _satellite.getVar('cart'); const returnList = []; cart.items.forEach(item => { const selectedOptions = []; item.configurableOptions?.forEach(option => { selectedOptions.push({ attribute: option.optionLabel, value: option.valueLabel, }); }); const productListItem = { SKU: item.product.sku, name: item.product.name, quantity: item.quantity, priceTotal: item.prices.price.value * item.quantity, currencyCode: item.prices.price.currency ? item.prices.price.currency : storefrontContext.storeViewCurrencyCode, selectedOptions: selectedOptions, }; returnList.push(productListItem); }); return returnList; - 名称：
-
查看购物车：
- 名称：
view cart - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
productListItems。 对于productListItems，可以存在多个预先计算的项。 选择 productListItems > 填充整个数组。 - 数据元素：
%product list items% - 字段组：
productListItems>ProductImageUrl - ProductImageUrl： 值 =
%product image% - 字段组：
commerce>cart>cartID - 购物车ID： 值 =
%cart id% - 字段组：
commerce>productListViews>value - 值： 值 =
1
- 名称：
规则
- 名称：
view cart - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
shopping-cart-view
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.productListViews - XDM数据：
%view cart%
removeFromCart
当从购物车中删除产品或每次购物车中的产品数量减少时触发。
数据元素
创建以下数据元素：
-
产品名称：
- 名称：
product name - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.name
- 名称：
-
产品SKU：
- 名称：
product sku - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.sku
- 名称：
-
货币代码：
- 名称：
currency code - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.currencyCode
- 名称：
-
产品特价：
- 名称：
product special price - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.specialPrice
- 名称：
-
产品正常价格：
- 名称：
product regular price - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.pricing.regularPrice
- 名称：
-
产品 价格：
- 名称：
product price - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('product regular price') || _satellite.getVar('product special price') - 名称：
-
购物车：
- 名称：
cart - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
shoppingCartContext
- 名称：
-
购物车ID：
- 名称：
cart id - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('cart').id - 名称：
-
从购物车中移除：
- 名称：
remove from cart - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
productListItems。 选择 提供单个项目 并单击 添加项目 按钮。 由于此视图适用于PDP，因此您可以使用单个项目进行填充。 - 字段组：
productListItems>name - 名称： 值 =
%product name% - 字段组：
productListItems>SKU - SKU： 值 =
%product sku% - 字段组：
productListItems>priceTotal - 总价：值 =
%product price% - 字段组：
productListItems>currencyCode - 货币代码： 值 =
%currency code% - 字段组：
commerce>cart>cartID - 购物车ID： 值 =
%cart id% - 字段组：
commerce>productListRemovals>value - 值： 值 =
1
- 名称：
规则
- 名称：
remove from cart - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
remove-from-cart
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.productListRemovals - XDM数据：
%remove from cart%
initiateCheckout
购物者单击结帐按钮时触发。
数据元素
创建以下数据元素：
-
店面：
- 名称：
storefront - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
storefrontInstanceContext
- 名称：
-
产品图像URL：
- 名称：
product image - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.mainImageUrl
- 名称：
-
购物车：
- 名称：
cart - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
shoppingCartContext
- 名称：
-
购物车ID：
- 名称：
cart id - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('cart').id - 名称：
-
产品列表项：
- 名称：
product list items - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const storefrontContext = _satellite.getVar('storefront'); const cart = _satellite.getVar('cart'); const returnList = []; cart.items.forEach(item => { const selectedOptions = []; item.configurableOptions?.forEach(option => { selectedOptions.push({ attribute: option.optionLabel, value: option.valueLabel, }); }); const productListItem = { SKU: item.product.sku, name: item.product.name, quantity: item.quantity, priceTotal: item.prices.price.value * item.quantity, currencyCode: item.prices.price.currency ? item.prices.price.currency : storefrontContext.storeViewCurrencyCode, selectedOptions: selectedOptions, }; returnList.push(productListItem); }); return returnList; - 名称：
-
启动签出：
- 名称：
initiate checkout - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
productListItems。 对于productListItems，可以存在多个预先计算的项。 选择 productListItems > 填充整个数组。 - 数据元素：
%product list items% - 字段组：
productListItems>ProductImageUrl - ProductImageUrl： 值 =
%product image% - 字段组：
commerce>cart>cartID - 购物车ID： 值 =
%cart id% - 字段组：
commerce>checkouts>value - 值： 值 =
1
- 名称：
规则
- 名称：
initiate checkout - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
initiate-checkout
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.checkouts - XDM数据：
%initiate checkout%
placeOrder
购物者下订单时触发。
数据元素
创建以下数据元素：
-
帐户电子邮件：
- 名称：
account email - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
accountContext.emailAddress
- 名称：
-
店面：
- 名称：
storefront - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
storefrontInstanceContext
- 名称：
-
产品图像URL：
- 名称：
product image - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
productContext.mainImageUrl
- 名称：
-
购物车：
- 名称：
cart - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
shoppingCartContext
- 名称：
-
购物车ID：
- 名称：
cart id - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('cart').id - 名称：
-
顺序：
- 名称：
order - 扩展：
Adobe Client Data Layer - 数据元素类型：
Data Layer Computed State - [可选]路径：
orderContext
- 名称：
-
Commerce订单：
- 名称：
commerce order - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const order = _satellite.getVar('order'); const storefront = _satellite.getVar('storefront'); if (order.payments && order.payments.length) { payments = order.payments.map(payment => { return { paymentAmount: payment.total, paymentType: payment.paymentMethodCode, transactionID: order.orderId.toString(), }; }); } else { payments = [ { paymentAmount: order.grandTotal, paymentType: order.paymentMethodCode, transactionID: order.orderId.toString(), }, ]; } return { purchaseID: order.orderId.toString(), currencyCode: storefront.storeViewCurrencyCode, payments, }; - 名称：
-
订单运输：
- 名称：
order shipping - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const order = _satellite.getVar('order'); return { shippingMethod: order.shipping.shippingMethod, shippingAmount: order.shipping.shippingAmount || 0, } - 名称：
-
促销ID：
- 名称：
promotion id - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash return _satellite.getVar('order').appliedCouponCode - 名称：
-
产品列表项：
- 名称：
product list items - 扩展：
Core - 数据元素类型：
Custom Code - 打开编辑器：
code language-bash const storefrontContext = _satellite.getVar('storefront'); const cart = _satellite.getVar('cart'); const returnList = []; cart.items.forEach(item => { const selectedOptions = []; item.configurableOptions?.forEach(option => { selectedOptions.push({ attribute: option.optionLabel, value: option.valueLabel, }); }); const productListItem = { SKU: item.product.sku, name: item.product.name, quantity: item.quantity, priceTotal: item.prices.price.value * item.quantity, currencyCode: item.prices.price.currency ? item.prices.price.currency : storefrontContext.storeViewCurrencyCode, selectedOptions: selectedOptions, }; returnList.push(productListItem); }); return returnList; - 名称：
-
下单：
- 名称：
place order - 扩展：
Adobe Experience Platform Web SDK - 数据元素类型：
XDM object - 字段组：
productListItems。 对于productListItems，可以存在多个预先计算的项。 选择 productListItems > 填充整个数组。 - 数据元素：
%product list items% - 字段组：
productListItems>ProductImageUrl - ProductImageUrl： 值 =
%product image% - 字段组：
commerce>order - 唯一标识符： 值 =
%commerce order% - 字段组：
commerce>shipping - 唯一标识符： 值 =
%order shipping% - 字段组：
commerce>promotionID - 促销活动ID： 值 =
%promotion id% - 字段组：
commerce>purchases>value - 值： 值 =
1 - 个人电子邮件地址： 值 =
%account email% - 字段组：
personalEmail>address - 地址： 值 =
%account email%
- 名称：
规则
- 名称：
place order - 扩展：
Adobe Client Data Layer - 事件类型：
Data Pushed - 特定事件：
place-order
操作
- 扩展：
Adobe Experience Platform Web SDK - 操作类型：
Send event - 类型：
commerce.order - XDM数据：
%place order%
在店面活动中设置标识
店面事件包含基于personalEmail（对于帐户事件）和identityMap（对于所有其他店面事件）字段的配置文件信息。 Data Connection扩展将基于这两个字段加入并生成配置文件。 但是，每个字段在创建用户档案时需要遵循的不同步骤：
personalEmail— 仅适用于帐户事件。 按照上面列出的步骤、规则和操作操作identityMap— 适用于所有其他店面事件。 请参阅以下示例。
示例
以下步骤显示如何在Data Connection扩展中使用identityMap配置pageView事件：
-
使用适用于ECID的自定义代码配置数据元素：
使用自定义代码配置数据元素 -
选择Open Editor并添加以下自定义代码：
code language-javascript return alloy("getIdentity").then((result) => { var identityMap = { ECID: [ { id: ecid, primary: true } ], email: [ { id: email, primary: false } ] }; _satelite.setVar("identityMap", identityMap); }); -
使用设置为ECID的
identityMap更新XDM架构：
将identityMap设置为ECID -
定义检索ECID的规则操作：
检索ECID
在后台事件中设置身份
与使用ECID标识和链接用户档案信息的店面事件不同，后台事件数据基于SaaS，因此无ECID可用。 对于后台活动，您必须使用电子邮件来唯一标识购物者。 在此部分中，您将了解如何使用电子邮件将后台事件数据链接到ECID。
-
创建身份映射元素。
创建后台标识映射 -
选择Open Editor并添加以下自定义代码：
const IdentityMap = {
"ECID": [
{
id: _satellite.getVar('ECID'),
primary: true,
},
],
};
if (_satellite.getVar('account email')) {
IdentityMap.email = [
{
id: _satellite.getVar('account email'),
primary: false,
},
];
}
return IdentityMap;
-
将此新元素添加到每个
identityMap字段。
更新每个identityMap
设置同意
在Adobe Commerce中安装Data Connection扩展时，默认情况下会启用数据收集同意。 选择退出通过mg_dnt Cookie进行管理。 如果您选择使用mg_dnt管理同意，则可以按照此处列出的步骤操作。 Adobe Experience Platform Web SDK文档提供了多个用于管理同意的其他选项。
-
为
mg_dntCookie创建 核心自定义代码 数据元素(%do not track cookie%)：
创建不跟踪数据元素 -
创建一个 Core Custom Code 数据元素(
%consent%)，如果设置了Cookie，则返回out，否则返回in：
创建同意数据元素 -
使用
%consent%数据元素配置Adobe Experience Platform Web SDK扩展：
经同意更新SDK
警告
- 未执行步骤以关闭Experience Platform收集结果，导致事件被重复计数
- 未按照本主题所述设置映射/事件可能会影响Adobe Analytics展示板
- 如果禁用了数据收集，则无法通过Data Connection扩展设置Target