`clickCollection`

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

建立對象：

開發人員

clickCollection物件包含數個變數，可協助您控制自動收集的連結資料。當您想要在資料收集中包含或排除型別的連結時，請使用這些變數。網頁SDK 2.25.0或更新版本支援此功能。

此變數需要下列所有專案：

必須啟用clickCollectionEnabled。
如果您使用clickCollection.filterClickDetails，已棄用的方法onBeforeLinkClickSend必須為空白。
事件裝載必須在訪客造訪的某個時間點包含xdm.web.webPageDetails.name中的值。

如果您的實作不符合上述所有要求，則此物件不會產生任何效用。

clickCollection物件中有以下屬性：

屬性

類型

說明

internalLinkEnabled

boolean

決定是否自動追蹤目前網域內的連結。例如，https://example.com/index.html到https://example.com/product.html會被視為內部連結。

downloadLinkEnabled

boolean

判斷資料庫是否根據downloadLinkQualifier屬性追蹤符合下載資格的連結。

externalLinkEnabled

boolean

決定是否自動追蹤外部網域的連結。例如，https://example.com到https://example.net會被視為外部連結。

eventGroupingEnabled

boolean

決定程式庫是否等到下一個「頁面檢視」事件才傳送連結追蹤資料。當裝載中包含下列元素時，程式庫會將事件視為「頁面檢視」：

xdm.web.webPageDetails.name包含字串值
xdm.web.webPageDetails.pageViews.value大於0

當「頁面檢視」事件載入時，程式庫會將儲存的連結追蹤資料與該事件中的其餘資料結合。啟用此選項可減少您傳送至Adobe的事件總數。如果internalLinkEnabled已停用，此變數就不會執行任何動作。

sessionStorageEnabled

boolean

判斷連結追蹤資料是否儲存在工作階段存放區中，而非本機變數中。如果internalLinkEnabled或eventGroupingEnabled已停用，則此變數不會產生任何效用。
Adobe強烈建議您在單頁應用程式之外使用eventGroupingEnabled時啟用此變數。如果eventGroupingEnabled在sessionStorageEnabled停用時啟用，則按一下新頁面會導致連結追蹤資料遺失，因為它不會保留在工作階段存放區中。由於單頁應用程式通常不會導覽至新頁面，因此SPA頁面不需要工作階段儲存空間。

filterClickDetails

function

一種回呼函式，可針對您收集的連結追蹤資料提供完整控制項。您可以使用此回呼函式來變更、模糊化或中止傳送連結追蹤資料。如果您想要省略特定資訊（例如連結內的個人識別資訊），此回呼相當實用。

如果您未在configure命令中設定此物件，則此物件的預設設定取決於clickCollectionEnabled的值：

internalLinkEnabled：符合clickCollectionEnabled
downloadLinkEnabled：符合clickCollectionEnabled
externalLinkEnabled：符合clickCollectionEnabled
eventGroupingEnabled：預設值為false；必須明確啟用
sessionStorageEnabled：預設值為false；必須明確啟用
filterClickDetails：不包含函式；必須明確登入

TIP

Adobe建議在啟用eventGroupingEnabled時啟用internalLinkEnabled，因為它會減少計入合約使用量的事件數量。

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: true,
  clickCollection: {
    internalLinkEnabled: true,
    downloadLinkEnabled: true,
    externalLinkEnabled: true,
    eventGroupingEnabled: true,
    sessionStorageEnabled: true,
    filterClickDetails: function(content) {
      // If the link is a clickable telephone number, anonymize it
      if(content.linkUrl?.includes("tel:")) {
        content.linkName = content.linkUrl = "Phone number";
      }
      // If the link is an email address, anonymize it
      if(content.linkUrl?.includes("mailto:")) {
        content.linkName = content.linkUrl = "Email address";
      }
    }
  }
});

設定網頁SDK標籤擴充功能的點選集合

可以使用資料收集組態設定，在網頁SDK標籤擴充功能中設定這些設定。

recommendation-more-help

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