`clickCollectionEnabled`

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

開發人員

clickCollectionEnabled屬性是布林值，可決定Web SDK是否自動收集連結資料。如果您未設定此變數，其預設值為true，這表示預設會自動收集連結追蹤資料。若您偏好手動追蹤連結資料，將此屬性設定為false很有用。

啟用clickCollectionEnabled時，下列XDM元素會自動填入資料：

xdm.web.webInteraction.name
xdm.web.webInteraction.type
xdm.web.webInteraction.URL

此布林值啟用時，系統預設會自動追蹤內部連結、下載連結和退出連結。如果您想要進一步控制自動連結追蹤，Adobe建議使用clickCollection物件。

自動連結追蹤邏輯

如果沒有<a>屬性，Web SDK會追蹤<area>和onClick HTML元素上的所有點按。點選是透過附加至檔案的擷取點選事件接聽程式擷取。當按一下有效的連結時，下列邏輯就會依序執行：

如果連結符合downloadLinkQualifier中值的條件，或如果連結包含download HTML屬性，xdm.web.webInteraction.type會設為"download" （如果已啟用clickCollection.downloadLinkEnabled）。
如果連結目標網域與目前的window.location.hostname不同，xdm.web.webInteraction.type會設為"exit" （如果已啟用clickCollection.exitLinkEnabled）。
如果連結不符合"download"或"exit"的資格，xdm.web.webInteraction.type會設為"other"。

在所有情況下，xdm.web.webInteraction.name皆設為連結文字標籤，xdm.web.webInteraction.URL設為連結目的地URL。如果您也想要將連結名稱設定為URL，您可以使用filterClickDetails物件中的clickCollection回呼覆寫此XDM欄位。

執行clickCollectionEnabled命令時設定configure布林值。如果您在設定Web SDK時省略此屬性，其預設值為true。如果您偏好手動設定false和xdm.web.webInteraction.type，請將此值設為xdm.web.webInteraction.value。

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});

支援開啟Shadow DOM個元素

Web SDK支援 開啟陰影DOM 元素內連結的自動點選追蹤。

許多現代網站都使用Web元件來建置可重複使用且封裝的使用者介面元素。這些元件通常使用名為 陰影DOM 的技術，將其內部結構和樣式與頁面的其餘部分分開。

有兩種型別的陰影DOM：

Open Shadow DOM：在頁面上執行的JavaScript可存取內部結構。其他指令碼可與元件內容互動或檢查元件內容。
封閉影子DOM：內部結構在元件外部隱藏在JavaScript中，因此無法存取以進行追蹤或操作。

Web SDK會自動追蹤<a>開啟Shadow DOM<area>內和專案上的點按次數，就像主要檔案中連結一樣。此追蹤可確保使用開啟Shadow DOM的Web元件中的連結點選會包含在您的分析資料中。不會追蹤 已關閉的影子DOM 內的點按，因為其內部結構在元件外部作業的JavaScript程式碼中是隱藏的。

啟用或停用網頁SDK標籤擴充功能的點按集合

請參閱Web SDK擴充功能檔案中的資料彙集組態設定，瞭解如何使用標籤執行這些動作。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1