實作Analytics的伺服器端頁面命名

Adobe Analytics使用屬 s.pageName 性來唯一識別頁面，並關聯為頁面收集的資料。 通常，您會在AEM中執行下列工作，以指派值給AEM傳送至Analytics的此屬性：

• 使用Analytics雲端服務架構將CQ變數對應至Analytics屬 s.pageName 性。 (請參 閱對應元件資料與Adobe Analytics屬性)。

• 設計頁面元件，使其包含您對應至屬性的CQ變 s.pageName 數。 (請參 閱「自訂元件的實施Adobe Analytics追蹤」)。

若要在「網站」主控台和「內容分析」中公開Analytics報表資料，AEM需要每個頁面 s.pageName 的屬性值。 AEM Analytics Java API定義您實 AnalyticsPageNameProvider 作的介面，以提供「網站」主控台和「內容分析」與屬性的 s.pageName 值。 您的 AnaltyicsPageNameProvider 服務會解析伺服器上的pageName屬性以用於報告，因為它可使用用戶端上的Javascript動態設定以用於追蹤。

預設Analytics頁面名稱提供者服務

服 DefaultPageNameProvider 務是預設服務，可決定用來擷取頁 s.pageName 面Analytics資料的屬性值。 此服務可與AEM基礎頁面元件( /libs/foundation/components/page)搭配運作。 此頁元件定義要映射到屬性的以下CQ變 s.pageName 量：

• pagedata.path: 值會設為頁面路徑。
• pagedata.title: 值會設為頁面標題。
• pagedata.navTitle: 此值會設為頁面導覽標題。

服 DefaultPageNameProvider 務會決定這些CQ變數中哪些變數會對應至Analytics雲 s.pageName 端服務架構中的屬性。 然後，服務會決定用於擷取分析報表資料的適當頁面屬性：

• pagedata.path: 服務使用 page.getPath()

• pagedata.title: 服務使用 page.getTitle()

• pagedata.navTitle: 服務使用 page.getNavigationTitle()

對 page 像是頁面的 com.day.cq.wcm.api.Page Java對象。

如果您未將CQ變數對應至 s.pageName 架構中的屬性，則會從頁 s.pageName 面路徑產生值。 例如，路徑所在的頁面 /content/geometrixx/en 使用的 content:geometrixx:en 值 s.pageName。

在Analytics報告中維持連續性

若要維持頁面分析資料的完整歷史記錄，需要用於頁面的s.pageName屬性值永遠不變。 不過，基礎頁面元件所定義的分析屬性可輕鬆變更。 例如，移動頁面會變更報表 pagedata.path 歷史記錄的值，並中斷報表歷史記錄的連續性：

• 為先前路徑收集的資料不再與頁面相關聯。
• 如果不同頁面使用其他頁面曾經使用的路徑，則不同頁面會繼承該路徑的資料。

為確保報告的連續性，其 s.pageName 值應具有以下特徵：

• 唯一.
• 穩定。
• 人類可讀。

例如，自訂頁面元件可包含作者用來為頁面指定唯一ID的頁面屬性，該唯一ID用作屬性的 s.pageProperties 值：

• 該頁面包含分析變數，其設定為儲存在頁面屬性中之唯一ID的值。
• 分析變數會對應至Analytics s.pageProperties 架構中的屬性。
• 您對AnalyticsPageNameProvider介面的實作會擷取用於查詢頁面Analytics資料的頁面屬性值。

實作Analytics頁面名稱提供者服務

將介面 com.day.cq.analytics.sitecatalyst.AnalyticsPageNameProvider 實作為OSGi服務，以自訂擷取屬性值的 s.pageName 邏輯。 「網站」頁面分析和「內容分析」使用服務從Analytics擷取報表資料。

AnalyticsPageNameProvider介面定義您必須實作的兩種方法：

• getPageName: 傳回 String 代表要用作屬性之值的 s.pageName 值。

• getResource: 傳回 org.apache.sling.api.resource.Resource 代表與屬性關聯之頁面的物 s.pageName 件。

這兩種方法都 com.day.cq.analytics.sitecatalyst.AnalyticsPageNameContext 會將物件當作參數。 類 AnalyticsPageNameContext 別提供分析呼叫的上下文相關資訊：

• 頁面資源的基本路徑。
• Analytics Framework 雲端服務設定的物件。
• 頁面 Resource 的物件。
• 頁面 ResourceResolver 的物件。

類還為頁面名稱提供setter。

範例AnalyticsPageNameProvider實作

下列範例實 AnalyticsPageNameProvider 作支援自訂頁面元件：

• 該元件擴展了基礎頁元件。
• 該對話框包含作者用來指定屬性值的字 s.pageName 段。
• 屬性值儲存在頁面實例的節 jcr:content點的pageName屬性中。
• 會呼叫儲存屬性 s.pageName 的分析屬性 pagedata.pagename。 此屬性會映射至Analytics s.pageName 架構中的屬性。

如果框架映射 getPageName 已正確配置，則以下方法實現將返回pageName節點屬性的值：

public String getPageName(AnalyticsPageNameContext context) {
        String pageName = null;

        Framework framework = context.getFramework();
        Resource resource = context.getResource();

        if (resource != null && framework != null && framework.mapsSCVariable(S_PAGE_NAME)) {
            String cqVar = framework.getMapping(S_PAGE_NAME);
            Page page = resource.adaptTo(Page.class);
            if (cqVar.equals("pagedata.pagename")) {
                pageName = page.getProperties().get("pageName",null);
            }
        }
        return pageName;
    }

getResource方法的以下實現返回該頁的Resource對象：

     public Resource getResource(AnalyticsPageNameContext context) {
        Resource res = null;

        Framework framework = context.getFramework();
        ResourceResolver resolver = context.getResourceResolver();
        String pageName = context.getPageName();
        String basePath = context.getBasePath();

        if (pageName != null && basePath != null && resolver != null
                && framework != null && framework.mapsSCVariable(S_PAGE_NAME)) { 
            String cqVar = framework.getMapping(S_PAGE_NAME);
            if (cqVar.equals("pagedata.pagename")) {
             Iterator<Resource>
             hits = resolver.findResources(createQuery(pageName, basePath, "pagename"), Query.JCR_SQL2);
             if (hits.hasNext()) {
              res = hits.next();
              res = res.getParent();
             }
            }
        }
        return res;
    }

    private String createQuery(String pageName, String basePath, String propName) {
        return "SELECT * FROM [cq:PageContent] WHERE ISDESCENDANTNODE(["
                + basePath + "]) and [" + propName + "] = \"" + pageName + "\"";
    }

以下代碼代表整個類，包括配置服務的SCR注釋。 請注意，服務排名為200，會覆寫預設服務。

/*************************************************************************
 *
 * ADOBE CONFIDENTIAL
 * __________________
 *
 * Copyright 2019 Adobe Systems Incorporated
 * All Rights Reserved.
 *
 * NOTICE:  All information contained herein is, and remains
 * the property of Adobe Systems Incorporated and its suppliers,
 * if any.  The intellectual and technical concepts contained
 * herein are proprietary to Adobe Systems Incorporated and its
 * suppliers and may be covered by U.S. and Foreign Patents,
 * patents in process, and are protected by trade secret or copyright law.
 * Dissemination of this information or reproduction of this material
 * is strictly forbidden unless prior written permission is obtained
 * from Adobe Systems Incorporated.
 **************************************************************************/
package com.day.cq.analytics.sitecatalyst;
 
import java.util.Iterator;
 
import javax.jcr.query.Query;
 
import org.apache.sling.api.resource.Resource;
import org.apache.sling.api.resource.ResourceResolver;
import org.osgi.framework.Constants;
import org.osgi.service.component.annotations.Component;

import com.day.cq.analytics.sitecatalyst.AnalyticsPageNameContext;
import com.day.cq.analytics.sitecatalyst.AnalyticsPageNameProvider;
import com.day.cq.analytics.sitecatalyst.Framework;
import com.day.cq.wcm.api.Page;
 
import static com.day.cq.analytics.sitecatalyst.AnalyticsPageNameContext.S_PAGE_NAME;
 
/**
 * Default implementation of {@link AnalyticsPageNameProvider} that resolves
 * page title, path or navTitle if mapped in {@link Framework}.
 */
@Component(
    service = { AnalyticsPageNameProvider.class },
    property = {
        Constants.SERVICE_DESCRIPTION + "=Example Page Name Resolver implementation",
        Constants.SERVICE_RANKING + ":Integer=200"
    }
) 
public class ExamplePageNameProvider implements AnalyticsPageNameProvider {
    public String getPageName(AnalyticsPageNameContext context) {
        String pageName = null;

        Framework framework = context.getFramework();
        Resource resource = context.getResource();

        if (resource != null && framework != null && framework.mapsSCVariable(S_PAGE_NAME)) {
            String cqVar = framework.getMapping(S_PAGE_NAME);
            Page page = resource.adaptTo(Page.class);
            if (cqVar.equals("pagedata.path")) {
                pageName = page.getProperties().get("pageName",null);
            }
        }
        return pageName;
    }
 
    public Resource getResource(AnalyticsPageNameContext context) {
        Resource res = null;

        Framework framework = context.getFramework();
        ResourceResolver resolver = context.getResourceResolver();
        String pageName = context.getPageName();
        String basePath = context.getBasePath();

        if (pageName != null && basePath != null && resolver != null
                && framework != null && framework.mapsSCVariable(S_PAGE_NAME)) { 
            String cqVar = framework.getMapping(S_PAGE_NAME);
            if (cqVar.equals("pagedata.pagename")) {
                Iterator<Resource>
                hits = resolver.findResources(createQuery(pageName, basePath, "pagename"), Query.JCR_SQL2);
                if (hits.hasNext()) {
                    res = hits.next();
                    res = res.getParent();
                }
            }
        }
        return res;
    }
 
    private String createQuery(String pageName, String basePath, String propName) {
        return "SELECT * FROM [cq:PageContent] WHERE ISDESCENDANTNODE(["
                + basePath + "]) and [" + propName + "] = \"" + pageName + "\"";
    }
}