將Adobe使用者端資料層與AEM核心元件搭配使用

上次更新: 2024-01-26
  • 建立對象:
  • Intermediate
    Developer

Adobe Client Data Layer匯入了標準方法,用以收集和儲存訪客的網頁體驗相關資料,並且讓這項資料易於存取。 Adobe Client Data Layer不受平台限制,但已完全整合至核心元件,以與AEM搭配使用。

注意

想要在AEM網站上啟用Adobe使用者端資料層嗎? 請參閱此處的指示.

探索資料層

只要使用瀏覽器和現場的開發工具,您就可以瞭解Adobe Client Data Layer的內建功能 WKND參考網站.

注意

以下熒幕擷取畫面是從Chrome瀏覽器擷取的。

  1. 瀏覽至 https://wknd.site/us/en.html

  2. 開啟您的開發人員工具,並在 主控台

    window.adobeDataLayer.getState();
    

    若要檢視AEM網站上資料層的目前狀態,請檢查回應。 您應該會看到頁面和個別元件的相關資訊。

    Adobe資料層回應

  3. 在主控台中輸入下列內容,將資料物件推送至資料層:

    window.adobeDataLayer.push({
        "component": {
            "training-data": {
                "title": "Learn More",
                "link": "learn-more.html"
            }
        }
    });
    
  4. 執行命令 adobeDataLayer.getState() 再次檢視並找到專案 training-data.

  5. 接著,新增path引數以僅傳回元件的特定狀態:

    window.adobeDataLayer.getState('component.training-data');
    

    只傳回單一元件資料專案

使用事件

最佳實務是根據資料層的事件觸發任何自訂程式碼。 接下來,探索註冊及接聽不同事件。

  1. 在主控台中輸入下列Helper方法:

    function getDataObjectHelper(event, filter) {
        if (event.hasOwnProperty("eventInfo") && event.eventInfo.hasOwnProperty("path")) {
            var dataObject = window.adobeDataLayer.getState(event.eventInfo.path);
            if (dataObject != null) {
                for (var property in filter) {
                    if (!dataObject.hasOwnProperty(property) || (filter[property] !== null && filter[property] !== dataObject[property])) {
                        return;
                    }
                    return dataObject;
                }
            }
        }
        return;
    }
    

    上述程式碼會檢查 event 物件並使用 adobeDataLayer.getState 方法以取得觸發事件的物件目前狀態。 接著helper方法檢查 filter 且僅當目前 dataObject 符合傳回的篩選條件。

    注意

    這很重要 以在本練習中重新整理瀏覽器,否則主控台JavaScript會遺失。

  2. 接下來,輸入當 Teaser 元件會顯示在 輪播.

    function teaserShownHandler(event) {
        var dataObject = getDataObjectHelper(event, {"@type": "wknd/components/teaser"});
        if(dataObject != null) {
            console.log("Teaser Shown: " + dataObject['dc:title']);
            console.log(dataObject);
        }
    }
    

    teaserShownHandler 函式呼叫 getDataObjectHelper 函式並傳遞篩選器 wknd/components/teaser 作為 @type 以篩選掉其他元件所觸發的事件。

  3. 接下來,將事件接聽程式推播至資料層,以接聽 cmp:show 事件。

    window.adobeDataLayer.push(function (dl) {
         dl.addEventListener("cmp:show", teaserShownHandler);
    });
    

    cmp:show 事件是由許多不同元件觸發,例如在 輪播,或當在「 」中選取新標籤時 標籤 元件。

  4. 在頁面上,切換轉盤幻燈片並觀察主控台陳述式:

    切換轉盤並檢視事件接聽程式

  5. 停止接聽 cmp:show 事件,從資料層移除事件監聽器

    window.adobeDataLayer = window.adobeDataLayer || [];
    window.adobeDataLayer.push(function(dl) {
        dl.removeEventListener("cmp:show", teaserShownHandler);
    });
    
  6. 返回頁面並切換輪播幻燈片。 請注意,不會再記錄任何陳述式,且不會聆聽事件。

  7. 接著,建立觸發頁面顯示事件時所呼叫的事件處理常式:

    function pageShownHandler(event) {
        var dataObject = getDataObjectHelper(event, {"@type": "wknd/components/page"});
        if(dataObject != null) {
            console.log("Page Shown: " + dataObject['dc:title']);
            console.log(dataObject);
        }
    }
    

    請注意,資源型別 wknd/components/page 用於篩選事件。

  8. 接下來,將事件接聽程式推播至資料層,以接聽 cmp:show 事件,呼叫 pageShownHandler.

    window.adobeDataLayer = window.adobeDataLayer || [];
    window.adobeDataLayer.push(function (dl) {
         dl.addEventListener("cmp:show", pageShownHandler);
    });
    
  9. 您應該會立即看到隨頁面資料引發的主控台陳述式:

    頁面顯示資料

    cmp:show 頁面事件會在頁面頂端的每個頁面載入時觸發。 您可能會問,當頁面明確已載入時,為何觸發事件處理常式?

    Adobe Client Data Layer的獨特功能之一,是您可以註冊事件接聽程式 早於晚於 資料層已初始化,這有助於避免競爭條件。

    Data Layer會維護已依序發生之所有事件的佇列陣列。 根據預設,資料層會針對發生於「 」中的事件觸發事件回呼 過去 和中的事件 未來. 您可從過去或未來篩選事件。 如需詳細資訊,請參閱檔案.

後續步驟

有兩個選項可讓您持續學習,第一個選項是檢視 收集頁面資料並將其傳送到Adobe Analytics 此教學課程會示範如何使用Adobe使用者端資料層。 第二個選項是,學習如何 使用AEM元件自訂Adobe使用者端資料層

其他資源

本頁內容