Adobe Analytics 프레임워크 사용자 지정

Adobe Analytics 프레임워크은 Adobe Analytics으로 추적되는 정보를 결정합니다. 기본 프레임워크를 사용자 정의하려면 javascript를 사용하여 사용자 정의 추적을 추가하고, Adobe Analytics 플러그인을 통합하고, 추적에 사용되는 프레임워크에서 일반 설정을 변경합니다.

생성된 Javascript for Frameworks정보

페이지가 Adobe Analytics 프레임워크과 연결되어 있고 페이지에 Analytics 모듈](/docs/experience-manager-65/administering/integration/adobeanalytics.html?lang=ko)에 대한 [참조가 포함되어 있으면, analytics.sitecatalyst.js 파일이 페이지에 대해 자동으로 생성됩니다.

페이지의 javascript는 s_gi객체(s_code.js Adobe Analytics 라이브러리가 정의하는 객체)를 만들고 해당 속성에 값을 할당합니다. 개체 인스턴스의 이름은 s입니다. 이 섹션에 표시되는 코드 예제에서는 이 s 변수에 대한 여러 참조를 만듭니다.

다음 예제 코드는 analytics.sitecatalyst.js 파일의 코드와 유사합니다.

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;

s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

사용자 정의 Javascript 코드를 사용하여 프레임워크를 사용자 지정하는 경우 이 파일의 내용이 변경됩니다.

Adobe Analytics 속성 구성

Adobe Analytics에는 프레임워크에서 구성할 수 있는 사전 정의된 변수가 많이 있습니다. 기본적으로 일반 분석 설정 목록에 charset, cookieLifetime, currencyCodetrackInlineStats 변수가 포함되어 있습니다.

aa-22

변수 이름과 값을 목록에 추가할 수 있습니다. 이러한 사전 정의된 변수와 추가하는 모든 변수는 analytics.sitecatalyst.js 파일에서 s 개체의 속성을 구성하는 데 사용됩니다. 다음 예제에서는 값 CONSTANT의 추가된 prop10 속성이 javascript 코드로 어떻게 표시되는지 보여 줍니다.

var s_account = "my_sitecatalyst_account";
var s = s_gi(s_account);
s.fpCookieDomainPeriods = "3";
s.currencyCode= 'USD';
s.trackInlineStats= true;
s.linkTrackVars= 'None';
s.charSet= 'UTF-8';
s.linkLeaveQueryString= false;
s.linkExternalFilters= '';
s.linkTrackEvents= 'None';
s.trackExternalLinks= true;
s.linkDownloadFileTypes= 'exe,zip,wav,mp3,mov,mpg,avi,wmv,doc,pdf,xls';
s.prop10= 'CONSTANT';
s.linkInternalFilters= 'javascript:,'+window.location.hostname;
s.trackDownloadLinks= true;

s.visitorNamespace = "mynamespace";
s.trackingServer = "xxxxxxx.net";
s.trackingServerSecure = "xxxxxxx.net";

다음 절차를 사용하여 목록에 변수를 추가합니다.

  1. Adobe Analytics 프레임워크 페이지에서 일반 분석 설정 영역을 확장합니다.

  2. 변수 목록 아래에서 항목 추가를 클릭하여 목록에 새 변수를 추가합니다.

  3. 왼쪽 셀에서 변수 이름을 입력합니다(예: prop10).

  4. 오른쪽 열에 변수 값을 입력합니다(예: CONSTANT).

  5. 변수를 제거하려면 변수 옆에 있는 (-) 단추를 클릭합니다.

노트

변수 및 값을 입력할 때 올바른 형식 및 맞춤법이 적용되었는지 확인하거나 올바른 값/변수 쌍으로 호출이​되지 않습니다. 철자가 틀린 변수와 값을 사용하면 호출이 발생하지 않도록 할 수도 있습니다.

이러한 변수가 올바르게 설정되었는지 확인하려면 Adobe Analytics 담당자에게 문의하십시오.

주의

Adobe Analytics 호출이 제대로 작동하도록 하기 위해 이 목록에 있는 일부 변수는 필수​입니다(예:currencyCode, charSet)

따라서 프레임워크 자체에서 제거되더라도 Adobe Analytics 호출이 수행되어도 여전히 기본값으로 연결됩니다.

사용자 지정 Javascript를 Adobe Analytics Framework에 추가

일반 분석 설정 영역의 javascript에서 무료로 제공되는 상자를 사용하면 Adobe Analytics 프레임워크에 사용자 지정 코드를 추가할 수 있습니다.

aa-21

추가하는 코드가 analytics.sitecatalyst.js 파일에 추가됩니다. 따라서 s_code.js에 정의된 s_gi javascript 객체의 인스턴스인 s 변수에 액세스할 수 있습니다. 예를 들어 다음 코드를 추가하는 것은 이전 섹션의 예인 CONSTANT 값의 prop10이라는 변수를 추가하는 것과 같습니다.

s.prop10= 'CONSTANT';

Adobe Analytics s-code.js 파일의 내용을 포함하는 analytics.sitecatalyst.js 파일의 코드에는 다음 코드가 포함되어 있습니다.

if (s.usePlugins) s.doPlugins(s)

다음 절차에서는 javascript 상자를 사용하여 Adobe Analytics 추적을 사용자 지정하는 방법을 보여 줍니다. Javascript에서 Adobe Analytics 플러그인을 사용해야 하는 경우 AEM에 통합합니다.

  1. s.doPlugins이(가) 실행되도록 다음 javascript 코드를 상자에 추가합니다.

    s.usePlugins=true;
    function s_doPlugins(s) {
        //add your custom code here
    }
    s.doPlugins=s_doPlugins;
    
    주의

    이 코드는 기본 드래그 앤 드롭 인터페이스 또는 Adobe Analytics 보기의 인라인 javascript를 통해 수행할 수 없는 방식으로 사용자 지정된 Adobe Analytics 호출에서 변수를 보내려면 필요합니다.

    사용자 지정 변수가 s_doPlugins 함수 외부에 있으면 Adobe Analytics 호출에서 해당 변수는 *undefined *로 전송됩니다.

  2. s_doPlugins 함수에 javascript 코드를 추가합니다.

다음 예제에서는 "|"의 일반적인 구분 기호를 사용하여 페이지에 캡처된 데이터를 계층적 순서로 연결합니다.

Adobe Analytics 프레임워크에는 다음과 같은 구성이 있습니다.

  • prop2 Adobe Analytics 변수는 pagedata.sitesection 사이트 속성에 매핑됩니다.

  • prop3 Adobe Analytics 변수는 pagedata.subsection 사이트 속성에 매핑됩니다.

  • 무료 javascript 상자에 다음 코드가 추가됩니다.

    s.usePlugins=true;
     function s_doPlugins(s) {
     s.prop1 = s.prop2+'|'+s.prop3;
     }
     s.doPlugins=s_doPlugins;
    
  • 프레임워크를 사용하는 웹 페이지를 방문하거나 편집 모드에서 페이지를 다시 로드하거나 미리 볼 때 Adobe Analytics 호출이 수행됩니다.

예를 들어 Adobe Analytics에서 다음 값이 생성됩니다.

aa-20

모든 Adobe Analytics 프레임워크에 대한 전역 사용자 지정 코드 추가

모든 Adobe Analytics 프레임워크에 통합된 사용자 정의 Javascript 코드를 제공합니다. 페이지의 Adobe Analytics 프레임워크에 사용자 정의 자유 형식 javascript가 포함되어 있지 않으면 /libs/cq/analytics/components/sitecatalyst/config.js.jsp 스크립트가 생성하는 javascript가 analytics.sitecatalyst.js 파일에 추가됩니다. 기본적으로 스크립트는 주석으로 처리되므로 효과가 없습니다. 이 코드에서는 s.usePluginsfalse으로 설정합니다.

/* Plugin Config */
/*
s.usePlugins=false;
function s_doPlugins(s) {
    //add your custom plugin code here
}
s.doPlugins=s_doPlugins;
*/

analytics.sitecatalyst.js 파일의 코드(Adobe Analytics s_code.js 파일의 컨텐츠를 포함)에는 다음 코드가 포함되어 있습니다.

if (s.usePlugins) s.doPlugins(s)

따라서 JavaScript는 s.usePluginstrue으로 설정하여 s_doPlugins 함수의 코드가 실행되도록 해야 합니다. 코드를 사용자 정의하려면 고유한 javascript를 사용하는 config.js.jsp 파일을 오버레이합니다. Javascript에서 Adobe Analytics 플러그인을 사용해야 하는 경우 AEM에 통합합니다.

노트

/libs/cq/analytics/components/sitecatalyst/config.js.jsp 파일을 편집하지 마십시오. 특정 AEM 업그레이드 또는 유지 관리 작업은 원본 파일을 다시 설치하여 변경 내용을 제거할 수 있습니다.

  1. CRXDE Lite에서 /apps/cq/analytics/components 폴더 구조를 만듭니다.

    1. /apps 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 폴더 만들기를 클릭합니다.
    2. cq을 폴더 이름으로 지정하고 [확인]을 클릭합니다.
    3. 마찬가지로 analyticscomponents 폴더를 만듭니다.
  2. 방금 만든 components 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 구성 요소 만들기를 클릭합니다. 다음 속성 값을 지정합니다.

    • 레이블: sitecatalyst
    • 제목: sitecatalyst
    • Super Type: /libs/cq/analytics/components/sitecatalyst
    • 그룹: hidden
  3. [확인] 단추가 활성화될 때까지 [다음]을 반복해서 클릭한 다음 [확인]을 클릭합니다.

    sitecatalyst 구성 요소에는 자동으로 생성된 sitecatalyst.jsp 파일이 포함되어 있습니다.

  4. sitecatalyst.jsp 파일을 마우스 오른쪽 단추로 클릭하고 [삭제]를 클릭합니다.

  5. sitecatalyst 구성 요소를 마우스 오른쪽 단추로 클릭하고 만들기 > 파일 만들기를 클릭합니다. 이름 config.js.jsp을 지정한 다음 [확인]을 클릭합니다.

    config.js.jsp 파일은 편집을 위해 자동으로 열립니다.

  6. 파일에 다음 텍스트를 추가한 다음 [모두 저장]을 클릭합니다.

    <%@page session="true"%>
    /* Plugin Config */
    s.usePlugins=true;
    function s_doPlugins(s) {
        //add your custom plugin code here
    }
    s.doPlugins=s_doPlugins;
    

    이제 /apps/cq/analytics/components/sitecatalyst/config.js.jsp 스크립트가 생성하는 javascript 코드가 Adobe Analytics 프레임워크을 사용하는 모든 페이지에 대해 analytics.sitecatalyst.js 파일에 삽입됩니다.

  7. s_doPlugins 함수에서 실행할 Javascript 코드를 추가한 다음 모두 저장을 클릭합니다.

주의

텍스트가 페이지 프레임워크의 자유형 javascript에 있는 경우(공백만 포함) config.js.jsp는 무시됩니다.

AEM에서 Adobe Analytics 플러그인 사용

Adobe Analytics 플러그인용 javascript 코드를 입수하고 이를 AEM의 Adobe Analytics 프레임워크에 통합합니다. 사용자 지정 javascript 코드에 사용할 수 있도록 sitecatalyst.plugins 범주의 클라이언트 라이브러리 폴더에 코드를 추가합니다.

예를 들어 getQueryParams 플러그인을 통합하면 사용자 지정 javascript의 s_doPlugins 함수에서 플러그인을 호출할 수 있습니다. 다음 예제 코드는 Adobe Analytics 호출이 트리거될 때 레퍼러의 URL에서 "pid"​의 쿼리 문자열을 eVar1​으로 전송합니다.

s.usePlugins=true;
function s_doPlugins(s) {
   // take the query string from the referrer
   s.eVar1=s.getQueryParam('pid','',document.referrer);
}
s.doPlugins=s_doPlugins;

AEM은 기본적으로 사용할 수 있도록 다음과 같은 Adobe Analytics 플러그인을 설치합니다.

  • getQueryParam()
  • getPreviousValue()
  • split()

/libs/cq/analytics/clientlibs/sitecatalyst/plugins 클라이언트 라이브러리 폴더에는 sitecatalyst.plugins 카테고리에 이러한 플러그인이 포함되어 있습니다.

노트

플러그인용 새 클라이언트 라이브러리 폴더를 만듭니다. /libs/cq/analytics/clientlibs/sitecatalyst/plugins 폴더에 플러그인을 추가하지 마십시오. 이 방법은 AEM을 다시 설치하거나 업그레이드하는 동안 sitecatalyst.plugins 카테고리에 대한 기여도를 덮어쓰지 않도록 합니다.

다음 절차를 사용하여 플러그인에 대한 클라이언트 라이브러리 폴더를 만듭니다. 이 절차를 한 번만 수행하면 됩니다. 클라이언트 라이브러리 폴더에 플러그인을 추가하려면 다음 절차를 사용하십시오.

  1. 웹 브라우저에서 CRXDE Lite을 엽니다. (http://localhost:4502/crx/de)

  2. /apps/my-app/clientlibs 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 노드 만들기를 클릭합니다. 다음 속성 값을 입력한 다음 [확인]을 클릭합니다.

    • 이름:내 플러그인과 같은 클라이언트 라이브러리 폴더의 이름

    • 유형:cq:ClientLibraryFolder

  3. 방금 만든 클라이언트 라이브러리 폴더를 선택하고 오른쪽 하단에 있는 속성 막대를 사용하여 다음 속성을 추가합니다.

    • 이름:카테고리
    • 유형:문자열
    • 값:sitecatalyst.plugins
    • 다중:selected

    편집 창에서 확인을 클릭하여 속성 값을 확인합니다.

  4. 방금 만든 클라이언트 라이브러리 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 파일 만들기를 클릭합니다. 파일 이름 유형의 js.txt에 대해 확인을 클릭합니다.

  5. 모두 저장을 클릭합니다.

다음 절차를 사용하여 플러그인 코드를 얻고, 코드를 AEM 저장소에 저장하고, 코드를 클라이언트 라이브러리 폴더에 추가합니다.

  1. Adobe Analytics 계정을 사용하여 sc.omniture.com에 로그인합니다.

  2. 랜딩 페이지에서 도움말 > 도움말 홈으로 이동합니다.

  3. 왼쪽의 목차 메뉴에서 구현 플러그인을 클릭합니다.

  4. 추가할 플러그인에 대한 링크를 클릭하고 페이지가 열리면 플러그인에 대한 javascript 소스 코드를 찾은 다음 코드를 선택하고 복사합니다.

  5. 클라이언트 라이브러리 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 파일 만들기를 클릭합니다. 파일 이름에 통합하려는 플러그인 이름 뒤에 .js를 입력한 다음 확인을 클릭합니다. 예를 들어 getQueryParam 플러그인을 통합하는 경우 getQueryParam.js 파일의 이름을 지정합니다.

    파일을 만들면 편집을 위해 열립니다.

  6. 플러그인 javascript 코드를 파일에 붙여 넣고 모두 저장을 클릭한 다음 파일을 닫습니다.

  7. 클라이언트 라이브러리 폴더에서 js.txt 파일을 엽니다.

  8. 새 행에서 플러그인이 포함된 파일 이름(예: getQueryParam.js)을 추가합니다. 그런 다음 [모두 저장]을 클릭하고 파일을 닫습니다.

노트

플러그인을 사용할 때는 지원 플러그인을 통합해야 합니다. 그렇지 않으면 플러그인 javascript가 지원 플러그인의 함수에 수행하는 호출을 인식하지 못합니다. 예를 들어 getPreviousValue() 플러그인이 제대로 작동하려면 split() 플러그인이 필요합니다.

지원 플러그인의 이름도 js.txt​에 추가해야 합니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free