clickCollection
clickCollection物件包含數個變數,可協助您控制自動收集的連結資料。 當您想要在資料收集中包含或排除型別的連結時,請使用這些變數。
Web SDK 2.25.0或更新版本支援此功能。
clickCollection物件中有以下變數:
-
clickCollection.internalLinkEnabled:判斷目前網域內的連結是否已自動追蹤的布林值。 例如,https://example.com/index.html到https://example.com/product.html。 -
clickCollection.downloadLinkEnabled:布林值,可判斷資料庫是否根據downloadLinkQualifier屬性追蹤符合下載資格的連結。 -
clickCollection.externalLinkEnabled:判斷是否自動追蹤外部網域連結的布林值。 例如,https://example.com到https://example.net。 -
clickCollection.eventGroupingEnabled:布林值,可判斷程式庫是否等到下一頁才傳送連結追蹤資料。 當下一頁載入時,結合連結追蹤資料與頁面載入事件。 啟用此選項可減少您傳送給Adobe的事件數。 如果internalLinkEnabled已停用,此變數就不會執行任何動作。 -
clickCollection.sessionStorageEnabled:判斷連結追蹤資料是否儲存在工作階段存放區,而非本機變數的布林值。 如果internalLinkEnabled或eventGroupingEnabled已停用,則此變數不會產生任何效用。Adobe強烈建議您在單頁應用程式之外使用
eventGroupingEnabled時啟用此變數。 如果eventGroupingEnabled在sessionStorageEnabled停用時啟用,則按一下新頁面會導致連結追蹤資料遺失,因為它不會保留在工作階段存放區中。 由於單頁應用程式通常不會導覽至新頁面,因此SPA頁面不需要工作階段儲存空間。 -
filterClickDetails:回呼函式,提供您收集之連結追蹤資料的完整控制項。 您可以使用此回呼函式來變更、模糊化或中止傳送連結追蹤資料。 如果您想要省略特定資訊(例如連結內的個人識別資訊),此回呼相當實用。
使用Web SDK標籤擴充功能按一下集合設定
在設定標籤延伸模組時,選取下列任一選項:
-
收集內部連結
-
事件群組選項:
- 沒有事件群組
- 使用工作階段存放區進行事件分組
- 使用本機物件的事件群組
-
-
收集外部連結
-
收集下載連結
-
篩選點按屬性
- 使用您的Adobe ID憑證登入experience.adobe.com。
- 導覽至資料彙集 > 標籤。
- 選取所需的標籤屬性。
- 導覽至擴充功能,然後按一下Adobe Experience Platform Web SDK卡片上的設定。
- 向下捲動至資料彙集區段,然後選取所需的點選集合設定。
- 按一下儲存,然後發佈您的變更。
篩選條件點選屬性回呼會開啟自訂程式碼編輯器,讓您插入想要的程式碼。 在程式碼編輯器中,您可以存取下列變數:
content.clickedElement:被點按的DOM元素。content.pageName:發生點選時的頁面名稱。content.linkName:點選連結的名稱。content.linkRegion:點選連結的區域。content.linkType:連結型別(退出、下載或其他)。content.linkURL:點選連結的目的地URL。return true:立即以目前的變數值結束回呼。return false:立即結束回呼並中止資料收集。
任何在content外部定義的變數都可以使用,但不包含在傳送給Adobe的承載中。
使用Web SDK JavaScript程式庫按一下集合設定
執行configure命令時,在clickCollection物件中設定所需的變數。 如果未設定,則此物件的預設設定取決於clickCollectionEnabled的值。
internalLinkEnabled:符合clickCollectionEnableddownloadLinkEnabled:符合clickCollectionEnabledexternalLinkEnabled:符合clickCollectionEnabledeventGroupingEnabled:預設值為false;必須明確啟用sessionStorageEnabled:預設值為false;必須明確啟用filterClickDetails:不包含函式;必須明確登入
internalLinkEnabled時啟用eventGroupingEnabled,因為它會減少計入合約使用量的事件數量。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";
}
}
}
});