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. 如果 eventGroupingEnabled 已啟用,但 sessionStorageEnabled 會停用,按一下新頁面會導致連結追蹤資料遺失,因為它不會保留在工作階段存放區中。 雖然可以停用 sessionStorageEnabled 在單頁應用程式中,這不適用於非SPA頁面。

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

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

選取 啟用點選資料收集 核取方塊,當 設定標籤擴充功能. 啟用此核取方塊會顯示下列與點按集合相關的選項:

  • 內部連結

    • 啟用事件分組
    • 啟用工作階段儲存
  • 外部連結

  • 下載連結

  • 篩選點按屬性

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

此 篩選點按屬性 callback會開啟自訂程式碼編輯器,讓您插入所需的程式碼。 在程式碼編輯器中,您可以存取下列變數:

  • content.clickedElement:被點按的DOM元素。
  • content.pageName:點選發生的頁面名稱。
  • content.linkName:點按的連結名稱。
  • content.linkRegion:點選連結的區域。
  • content.linkType:連結型別(退出、下載或其他)。
  • content.linkURL:點按連結的目的地URL。
  • return true:使用目前的變數值立即結束回呼。
  • return false:立即結束回呼並中止資料收集。

任何定義於外部的變數 content 可使用,但不包含在傳送至Adobe的裝載中。

使用Web SDK JavaScript程式庫按一下集合設定

在內設定所要的變數 clickCollection 物件 configure 命令。 如果未設定,則此物件的預設設定取決於 clickCollectionEnabled.

  • internalLinkEnabled:符合 clickCollectionEnabled
  • downloadLinkEnabled:符合 clickCollectionEnabled
  • externalLinkEnabled:符合 clickCollectionEnabled
  • eventGroupingEnabled:預設為 false;必須明確啟用
  • sessionStorageEnabled:預設為 false;必須明確啟用
  • filterClickDetails:不包含函式;必須明確註冊
TIP
Adobe建議啟用 eventGroupingEnabled,因為有助於減少計入合約使用量的事件數量。
alloy("configure", {
  edgeConfigId: "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