Show Menu
화제×

Analytics에 대한 서버측 페이지 이름 지정 구현

Adobe Analytics에서는 이 s.pageName 속성을 사용하여 페이지를 고유하게 식별하고 페이지에 대해 수집된 데이터를 연결합니다. 일반적으로 AEM에서 다음 작업을 수행하여 AEM이 Analytics에 전송하는 이 속성에 값을 지정합니다.
사이트 콘솔 및 컨텐츠 인사이트에서 Analytics 보고서 데이터를 표시하려면 AEM에서 각 페이지에 대한 s.pageName 속성 값이 필요합니다. AEM Analytics Java API는 사이트 콘솔 및 컨텐츠 인사이트를 속성 값으로 제공하기 위해 구현하는 AnalyticsPageNameProvider 인터페이스를 정의합니다 s.pageName . 추적 목적으로 클라이언트에서 Javascript를 사용하여 동적으로 설정할 수 있으므로 서비스는 보고용으로 서버의 pageName 속성을 해결합니다. AnaltyicsPageNameProvider

기본 분석 페이지 이름 공급자 서비스

서비스는 DefaultPageNameProvider 페이지의 Analytics 데이터를 검색하는 데 사용할 s.pageName 속성 값을 결정하는 기본 서비스입니다. 서비스는 AEM 기반 페이지 구성 요소( /libs/foundation/components/page )와 함께 작동합니다. 이 페이지 구성 요소는 s.pageName 속성에 매핑될 다음과 같은 CQ 변수를 정의합니다.
  • pagedata.path :이 값은 페이지 경로로 설정됩니다.
  • pagedata.title :이 값은 페이지 제목으로 설정됩니다.
  • pagedata.navTitle :이 값은 페이지 탐색 제목으로 설정됩니다.
서비스는 DefaultPageNameProvider s.pageName 이러한 CQ 변수 중 Analytics 클라우드 서비스 프레임워크의 속성에 매핑되는 변수를 결정합니다. 그런 다음 서비스는 분석 보고서 데이터를 검색하는 데 사용할 적절한 페이지 속성을 결정합니다.
  • pagedata.path :서비스는 page.getPath()
  • pagedata.title :서비스는 page.getTitle()
  • pagedata.navTitle :서비스는 page.getNavigationTitle()
개체는 페이지의 Java page com.day.cq.wcm.api.Page 개체입니다.
CQ 변수를 프레임워크의 s.pageName s.pageName 속성에 매핑하지 않으면 에 대한 값이 페이지 경로에서 생성됩니다. 예를 들어 경로가 있는 페이지는 에 대한 값을 /content/geometrixx/en 사용합니다 content:geometrixx:en``s.pageName .
DefaultPageNameProvider 서비스는 100의 서비스 등급을 사용합니다.

Analytics 보고에서 연속성 유지

페이지에 대한 분석 데이터의 전체 내역을 유지 관리하려면 페이지에 사용되는 s.pageName 속성 값이 변경되지 않아야 합니다. 하지만 기초 페이지 구성 요소가 정의하는 분석 속성은 쉽게 변경할 수 있습니다. 예를 들어 페이지를 이동하면 값이 변경되고 보고 내역의 연속성이 pagedata.path 끊어집니다.
  • 이전 경로에 대해 수집된 데이터는 더 이상 페이지와 연결되지 않습니다.
  • 다른 페이지가 한 번 사용한 경로를 사용하는 경우 다른 페이지는 해당 경로에 대한 데이터를 상속합니다.
보고 연속성을 보장하려면 값이 다음 특성을 s.pageName 가져야 합니다.
  • 고유.
  • 안정적입니다.
  • 사람이 읽을 수 있습니다.
예를 들어, 사용자 지정 페이지 구성 요소에는 작성자가 s.pageProperties 속성 값으로 사용되는 페이지의 고유 ID를 지정하는 데 사용하는 페이지 속성이 포함될 수 있습니다.
  • 이 페이지에는 페이지 속성에 저장된 고유 ID의 값으로 설정된 분석 변수가 포함되어 있습니다.
  • analytics 변수는 Analytics 프레임워크의 s.pageProperties 속성에 매핑됩니다.
  • AnalyticsPageNameProvider 인터페이스를 구현하면 페이지 Analytics 데이터를 쿼리하는 데 사용할 페이지 속성의 값이 검색됩니다.
Analytics 컨설턴트에게 s.pageName 가치 있는 효과적인 전략 개발에 대한 도움을 요청하십시오.

Analytics 페이지 이름 공급자 서비스 구현

인터페이스를 OSGi 서비스로 구현하여 com.day.cq.analytics.sitecatalyst.AnalyticsPageNameProvider 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 메서드의 다음 구현은 페이지에 대한 리소스 개체를 반환합니다.
     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 + "\"";
    }
}