clickCollection

clickCollection物件包含數個變數,可協助您控制自動收集的連結資料。 當您想要在資料收集中包含或排除型別的連結時,請使用這些變數。

必須啟用clickCollectionEnabled

Web SDK 2.25.0或更新版本支援此功能。

clickCollection物件中有以下變數:

  • clickCollection.internalLinkEnabled:判斷目前網域內的連結是否已自動追蹤的布林值。 例如,https://example.com/index.htmlhttps://example.com/product.html

  • clickCollection.downloadLinkEnabled:布林值,可判斷資料庫是否根據downloadLinkQualifier屬性追蹤符合下載資格的連結。

  • clickCollection.externalLinkEnabled:判斷是否自動追蹤外部網域連結的布林值。 例如,https://example.comhttps://example.net

  • clickCollection.eventGroupingEnabled:布林值,可判斷程式庫是否等到下一頁才傳送連結追蹤資料。 當下一頁載入時,結合連結追蹤資料與頁面載入事件。 啟用此選項可減少您傳送給Adobe的事件數。 如果internalLinkEnabled已停用,此變數就不會執行任何動作。

  • clickCollection.sessionStorageEnabled:判斷連結追蹤資料是否儲存在工作階段存放區,而非本機變數的布林值。 如果internalLinkEnabledeventGroupingEnabled已停用,則此變數不會產生任何效用。

    Adobe強烈建議您在單頁應用程式之外使用eventGroupingEnabled時啟用此變數。 如果eventGroupingEnabledsessionStorageEnabled停用時啟用,則按一下新頁面會導致連結追蹤資料遺失,因為它不會保留在工作階段存放區中。 由於單頁應用程式通常不會導覽至新頁面,因此SPA頁面不需要工作階段儲存空間。

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

使用Web SDK標籤擴充功能按一下集合設定

設定標籤延伸模組時,選取下列任一選項:

  • 收集內部連結

    • 事件群組選項:

      • 沒有事件群組
      • 使用工作階段存放區進行事件分組
      • 使用本機物件的事件群組
  • 收集外部連結

  • 收集下載連結

  • 篩選點按屬性

  1. 使用您的Adobe ID憑證登入experience.adobe.com
  2. 導覽至​ 資料彙集 > 標籤
  3. 選取所需的標籤屬性。
  4. 導覽至​ 擴充功能,然後按一下Adobe Experience Platform Web SDK卡片上的​ 設定
  5. 向下捲動至資料彙集區段,然後選取所需的點選集合設定。
  6. 按一下​ 儲存,然後發佈您的變更。

篩選條件點選屬性回呼會開啟自訂程式碼編輯器,讓您插入想要的程式碼。 在程式碼編輯器中,您可以存取下列變數:

  • 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:符合clickCollectionEnabled
  • downloadLinkEnabled:符合clickCollectionEnabled
  • externalLinkEnabled:符合clickCollectionEnabled
  • eventGroupingEnabled:預設值為false;必須明確啟用
  • sessionStorageEnabled:預設值為false;必須明確啟用
  • filterClickDetails:不包含函式;必須明確登入
TIP
Adobe建議在啟用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";
      }
    }
  }
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636