数据收集配置设置 data-collection
通过此配置部分,可决定如何跨扩展收集数据。
- 使用您的Adobe ID凭据登录到CX Enterprise。
- 导航到数据收集 > 标记。
- 选择所需的标记属性。
- 导航到扩展,然后在Adobe Experience Platform Web SDK卡片中选择配置。
- 向下滚动到 数据收集 部分。
可以使用以下选项:
在事件发送回调之前
用于评估和修改发送到Adobe的有效负载的回调函数。 在代码编辑器中,您可以访问以下变量:
content.xdm:事件的XDM有效负载。content.data:事件的数据对象有效负载。return true:立即退出回调,并使用content对象中的当前值将数据发送到Adobe。return false:立即退出回调并中止向Adobe发送数据。
在content之外定义的任何变量都可以使用,但不包含在发送到Adobe的有效负载中。
// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};
// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";
// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();
// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;
// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
return true;
}
// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
return false;
}
false。 在第一个事件中返回false可能会对个性化产生负面影响。此回调是相当于JavaScript库中onBeforeEventSend的标记。
收集内部链接点击次数
一个复选框,允许收集网站或资产内部的链接跟踪数据。 此复选框的标记等同于JavaScript库中的clickCollection.internalLinkEnabled。 启用此复选框后,将显示事件分组选项:
- 无事件分组:链接跟踪数据在单独的事件中发送到Adobe。 在单独事件中发送链接点击次数可能会增加发送到Adobe Experience Platform的数据在合同中的使用量。
- 使用会话存储进行事件分组:将链接跟踪数据存储在会话存储中,直到出现下一个“页面查看”事件。 在下一个被视为“页面查看”的事件中,存储的链接跟踪数据将与“页面查看”事件有效负载合并。 Adobe建议在跟踪内部链接时启用此设置。
- 使用本地对象进行事件分组:将链接跟踪数据存储在本地对象中,直到出现下一个“页面查看”事件。 如果访客导航到新的浏览器页面,则链接跟踪数据将丢失。 此设置在单页应用程序的上下文中最为有用。
当有效负载中包含以下元素时,标记库会将给定事件视为“页面查看”:
xdm.web.webPageDetails.name包含字符串值xdm.web.webPageDetails.pageViews.value大于0
收集外部链接点击次数
用于启用外部链接集合的复选框。 此复选框的标记等同于JavaScript库中的clickCollection.externalLinkEnabled。
收集下载链接点击次数
用于启用下载链接集合的复选框。 此复选框的标记等同于JavaScript库中的clickCollection.downloadLinkEnabled。
下载链接限定符
将链接URL限定为下载链接的正则表达式。 此字符串的标记等同于JavaScript库中的downloadLinkQualifier。
筛选点击属性
一个回调函数,用于在集合之前评估和修改与点击相关的属性。 此函数在事件发送回调之前的On之前运行,其标记等同于JavaScript库中的clickCollection.filterClickDetails。 在代码编辑器中,您可以访问以下变量:
content.clickedElement:被单击的DOM元素。content.pageName:发生点击时的页面名称。content.linkName:点击链接的名称。content.linkRegion:点击链接的区域。content.linkType:链接类型(退出、下载或其他)。content.linkURL:点击链接的目标URL。return true:使用当前变量值立即退出回调。return false:立即退出回调并中止收集数据。- 在
content之外定义的任何变量都可以使用,但不包含在发送到Adobe的有效负载中。
onBeforeLinkClickSend。 使用 筛选点击属性 回调筛选或调整点击数据,或者使用 在事件发送回调前开启 筛选或调整发送到Adobe的整体有效负载。 如果同时设置了 筛选条件点击属性 回调和 在链接点击之前打开 回调,则只有 筛选条件点击属性 回调运行。上下文设置
自动收集访客信息,这将为您填充特定XDM字段。 您可以选择 所有默认上下文信息 或特定上下文信息。 该标记等同于JavaScript库中的context。
- Web:收集有关当前页面的信息。
- 设备:收集有关用户设备的信息。
- 环境:收集有关用户浏览器的信息。
- 放置上下文:收集有关用户位置的信息。
- 高熵用户代理提示:收集有关用户设备的更多详细信息。
- 每个页面查看仅向Adobe Analytics发送一次反向链接:防止将重复的反向链接数据发送到Adobe Analytics。