整合

使用AEM Assets和Adobe Experience Platform Launch設定資產分析

上次更新： 2023-12-04

主題：
Asset Insights
檢視有關此主題的更多資訊

建立對象：
Intermediate

Developer

AEM Assetsas a Cloud Service、AEM Assets 6.5

在這個由五部分組成的影片系列中，我們將逐步解說透過Adobe Launch部署的資產Experience Manager分析功能的設定和設定。

第1部分：資產分析概觀

資產分析概觀。安裝核心元件、範例影像元件和其他內容套件，為您的環境做好準備。

架構圖

注意

請務必下載最新版本的核心元件用於您的實作。

影片使用非最新版本的核心元件v2.2.2；在繼續下一節之前，請務必使用最新版本。

下載資產分析範例影像內容
下載最新AEM WCM核心元件

第2部分：啟用範例影像元件的資產分析追蹤

增強核心元件及使用Proxy元件（範例影像元件）進行Asset Insights。編輯內容頁面範本原則，為參照網站啟用範例影像元件。

注意

影像核心元件包含停用資產UUID （在JCR中建立的節點的唯一識別碼值）追蹤功能，以停用UUID追蹤功能

核心影像元件使用 data-asset-id 父項中的屬性 <div> 標籤中，以啟用/停用此功能。 Proxy元件會以下列變更覆寫核心元件。

移除 data-asset-id 從image.html中<img>元素的父div
新增 data-aem-asset-id 直接新增至image.html中的<img>元素
新增 data-trackable='true' image.html中<img>元素的值
data-aem-asset-id 和 data-trackable='true' 會保留在相同的節點層級

注意

data-aem-asset-id='image.UUID' 和 data-trackable='true' 是資產曝光數需要呈現的關鍵屬性。對於資產點選深入分析，除了上述出現在<img>標籤中的資料屬性外，父標籤必須具有有效的href值。

第3部分：Adobe Analytics — 建立報表套裝，啟用即時資料收集和AEM Assets報表

具有即時資料收集的報表套裝是為資產追蹤所建立。 AEM Assets Insights設定是使用Adobe Analytics憑證。

注意

您的Adobe Analytics報表套裝必須啟用即時資料收集和AEM資產報表。啟用「AEM資產報表」會保留分析變數，以追蹤資產分析。

如需AEM Assets前瞻分析設定，您需要下列憑證

資料中心
Analytics公司名稱
Analytics使用者名稱
共用機密(可從下列取得： Adobe Analytics >管理員>公司設定>網站服務)。
報表套裝（務必選取用於資產報表的正確報表套裝）

第4部分：使用Adobe Experience Platform Launch新增Adobe Analytics擴充功能

新增Adobe Analytics擴充功能、建立頁面載入規則，以及將AEM與Launch與Adobe IMS技術帳戶整合。

注意

請務必將所有變更從作者執行個體復寫至發佈執行個體。

規則1 ：頁面追蹤器(pagetracker.js)

//For AEM 6.3
<script type="text/javascript" src="http://localhost:4503/etc/clientlibs/foundation/assetinsights/pagetracker.js"></script>

//For AEM 6.4
<script type="text/javascript" src="http://localhost:4503/etc.clientlibs/dam/clientlibs/assetinsights/pagetracker.js"></script>

頁面追蹤器實作兩個回呼（以資產內嵌程式碼註冊）

<code>assetAnalytics.core.assetLoaded<code> ：在為asset-DOM-element分派'load'事件時呼叫。
<code>assetAnalytics.core.assetClicked<code> ：在asset-DOM-element傳送「click」事件時呼叫，這只有在資產 — DOM-element具有錨記作為具有有效外部「href」屬性的父項時才會相關

最後，頁面追蹤器實作初始化函式為。

<code>assetAnalytics.dispatcher.init()<code> ：呼叫以初始化頁面追蹤器元件。從網頁產生任何asset-insights-events （曝光數和/或點選數）之前，必須先叫用此選項。
<code>assetAnalytics.dispatcher.init()<code> ：可選擇接受AppMeasurement物件 — 如果提供，不會嘗試建立AppMeasurement物件的例項。

規則2：影像追蹤器 — 動作1 (asset-insights.js)

/*
 * AEM Asset Insights
 */

var sObj = window.s;
_satellite.notify('in assetAnalytics customInit');
(function initializeAssetAnalytics() {
 if ((!!window.assetAnalytics) && (!!assetAnalytics.dispatcher)) {
 _satellite.notify('assetAnalytics ready');
 /** NOTE:
  Copy over the call to 'assetAnalytics.dispatcher.init()' from Assets Pagetracker
  Be mindful about changing the AppMeasurement object as retrieved above.
  */
 assetAnalytics.dispatcher.init(
                                "",  /** RSID to send tracking-call to */
                                "",  /** Tracking Server to send tracking-call to */
                                "",  /** Visitor Namespace to send tracking-call to */
                                "",  /** listVar to put comma-separated-list of Asset IDs for Asset Impression Events in tracking-call, e.g. 'listVar1' */
                                "",  /** eVar to put Asset ID for Asset Click Events in, e.g. 'eVar3' */
                                "",  /** event to include in tracking-calls for Asset Impression Events, e.g. 'event8' */
                                "",  /** event to include in tracking-calls for Asset Click Events, e.g. 'event7' */
                                sObj  /** [OPTIONAL] if the webpage already has an AppMeasurement object, please include the object here. If unspecified, Pagetracker Core shall create its own AppMeasurement object */
                                );
 sObj.usePlugins = true;
 sObj.doPlugins = assetAnalytics.core.updateContextData;
}
 else {
 _satellite.notify('assetAnalytics not available. Consider updating the Custom Page Code', 4);
 }
})();

規則2：影像追蹤器 — 動作2 (image-tracker.js)

/*
 * AEM Asset Insights
 */

document.querySelectorAll('[data-aem-asset-id]').forEach(function(element) {
    assetAnalytics.core.assetLoaded(element);
    var parent = element.parentElement;
    if (parent.nodeName == "A") {
        parent.addEventListener("click", function() {
            assetAnalytics.core.assetClicked(this)
        });
    }
});

assetAnalytics.core.assetLoaded() ：會在頁面載入完成時叫用，並會為所有可追蹤的影像觸發資產曝光數
載有載入資產清單的Analytics變數： contextData['c.a.assets.idList']
assetAnalytics.core.assetClicked() ：當資產DOM元素包含錨記且錨記具有有效href值時會叫用。資產經點按後，系統會建立Cookie，且以點按的資產ID作為其值。（Cookie名稱： a.assets.clickedid）
載有載入資產清單的Analytics變數： contextData['c.a.assets.clickedid']
來源： contextData['c.a.assets.source']

主控台除錯陳述式

//Launch Build Info
_satellite.buildInfo

//Enables debug messages
_satellite.setDebug(true);

//Asset Insight JS Object
assetAnalytics

//List of trackable images
document.querySelectorAll(".cmp-image__image");

影片中參考兩個Google Chrome瀏覽器擴充功能，作為偵錯Analytics的方式。其他瀏覽器也提供類似的擴充功能。

也可以使用下列Chrome擴充功能，將DTM切換為除錯模式： Launch與DTM交換器. 這可讓您更容易檢視是否有任何與DTM部署相關的錯誤。此外，您可以透過任何瀏覽器，手動將DTM切換為除錯模式 開發人員工具 — > JS主控台 新增下列程式碼片段：

第5部分：測試分析追蹤和同步分析資料

設定AEM Asset報表同步工作排程器及Assets Insights報表