数据收集配置设置
通过此配置部分,可决定如何跨扩展收集数据。
- 使用您的Adobe ID凭据登录experience.adobe.com。
- 导航到Data Collection > Tags。
- 选择所需的标记属性。
- 导航到Extensions,然后在 Configure 信息卡上选择Adobe Experience Platform Web SDK。
- 向下滚动到 Data collection 部分。
可以使用以下选项:
On before event send callback
用于评估和修改发送到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的标记。
Collect internal link clicks
一个复选框,允许收集网站或资产内部的链接跟踪数据。 此复选框的标记等同于JavaScript库中的clickCollection.internalLinkEnabled。 启用此复选框后,将显示事件分组选项:
- No event grouping:链接跟踪数据将在单独的事件中发送到Adobe。 在单独事件中发送链接点击次数可能会增加发送到Adobe Experience Platform的数据在合同中的使用量。
- Event grouping using session storage:将链接跟踪数据存储在会话存储中,直到出现下一个“页面查看”事件。 在下一个被视为“页面查看”的事件中,存储的链接跟踪数据将与“页面查看”事件有效负载合并。 Adobe建议在跟踪内部链接时启用此设置。
- Event grouping using local object:将链接跟踪数据存储在本地对象中,直到出现下一个“页面查看”事件。 如果访客导航到新的浏览器页面,则链接跟踪数据将丢失。 此设置在单页应用程序的上下文中最为有用。
当有效负载中包含以下元素时,标记库会将给定事件视为“页面查看”:
xdm.web.webPageDetails.name包含字符串值xdm.web.webPageDetails.pageViews.value大于0
Collect external link clicks
用于启用外部链接集合的复选框。 此复选框的标记等同于JavaScript库中的clickCollection.externalLinkEnabled。
Collect download link clicks
用于启用下载链接集合的复选框。 此复选框的标记等同于JavaScript库中的clickCollection.downloadLinkEnabled。
Download link qualifier
将链接URL限定为下载链接的正则表达式。 此字符串的标记等同于JavaScript库中的downloadLinkQualifier。
Filter click properties
一个回调函数,用于在集合之前评估和修改与点击相关的属性。 此函数在On before event send callback之前运行,其标记等同于JavaScript库中的clickCollection.filterClickDetails。 在代码编辑器中,您可以访问以下变量:
content.clickedElement:被单击的DOM元素。content.pageName:发生点击时的页面名称。content.linkName:点击链接的名称。content.linkRegion:点击链接的区域。content.linkType:链接类型(退出、下载或其他)。content.linkURL:点击链接的目标URL。return true:使用当前变量值立即退出回调。return false:立即退出回调并中止收集数据。- 在
content之外定义的任何变量都可以使用,但不包含在发送到Adobe的有效负载中。
onBeforeLinkClickSend。 使用 Filter click properties 回调筛选或调整点击数据,或使用 On before event send callback 筛选或调整发送到Adobe的整体有效负载。 如果同时设置了 Filter click properties 回调和 On before link click send 回调,则只运行 Filter click properties 回调。上下文设置
自动收集访客信息,这将为您填充特定XDM字段。 您可以选择 All default context information 或Specific context information。 该标记等同于JavaScript库中的context。
- Web:收集有关当前页面的信息。
- Device:收集有关用户设备的信息。
- Environment:收集有关用户浏览器的信息。
- Place context:收集有关用户位置的信息。
- High entropy user-agent hints:收集有关用户设备的更多详细信息。