Show Menu
화제×

Adobe Analytics Framework 사용자 지정

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

프레임워크에 대해 생성된 javascript 정보

페이지가 Adobe Analytics 프레임워크와 연결되어 있고 페이지에 Analytics 모듈에 대한 참조가 포함되어 있으면, analytics.sitecatalyst.js 파일이 자동으로 페이지에 생성됩니다.
페이지의 javascript는 s_code.js Adobe Analytics 라이브러리가 정의하는 s_gi 개체를 만들고 해당 속성에 값을 할당합니다. 객체 인스턴스의 이름은 입니다 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에는 프레임워크에서 구성할 수 있는 사전 정의된 변수가 많이 있습니다. 기본적으로 일반 Analytics Analytics의 기본 설정 목록에 ​있는 InlineStatsVariables 에는 Lifetime, Currency Lifetime, CurrencyCode 및 InlineTrack Stats 변수가 포함됩니다.
목록에 변수 이름과 값을 추가할 수 있습니다. 이러한 사전 정의된 변수와 추가하는 모든 변수는 analytics.sitecatalyst.js 파일에서 s 개체의 속성을 구성하는 데 사용됩니다. 다음 예제에서는 javascript 코드에서 값의 추가된 prop10 속성이 어떻게 CONSTANT 표시되는지를 보여 줍니다.
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 호출이 수행되어도 여전히 기본값으로 연결됩니다.

Adobe Analytics Framework에 사용자 정의 JavaScript 추가

# 영역의 javascript 에서 무료로 제공되는 상자를 사용하면 Adobe Analytics 프레임워크에 사용자 지정 코드를 추가할 수 있습니다.
추가한 코드는 analytics.sitecatalyst.js 파일에 추가됩니다. 따라서 에 정의된 s javascript 객체의 인스턴스인 변수에 액세스할 수 s_gi s_code.js 있습니다. 예를 들어 다음 코드를 추가하는 것은 이전 섹션의 예인 prop10 CONSTANT 변수를 추가하는 것과 같습니다.
s.prop10= 'CONSTANT';
analytics.sitecatalyst.js 파일(Adobe Analytics s-code.js 파일의 컨텐츠 포함)의 코드에는 다음 코드가 포함되어 있습니다.
if (s.usePlugins) s.doPlugins(s)
다음 절차에서는 javascript 상자를 사용하여 Adobe Analytics 추적을 사용자 지정하는 방법을 보여 줍니다. Adobe Analytics 플러그인을 사용해야 하는 경우 AEM에 통합하십시오 .
  1. 다음 javascript 코드를 상자에 추가하여 s.doPlugins 실행합니다.
    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 호출에서 정의되지 않음 *으로 전송됩니다.
  2. s_doPlugins 함수에 javascript 코드를 추가합니다.
다음 예제에서는 "|"의 일반적인 구분 기호를 사용하여 페이지에서 캡처된 데이터를 계층적 순서로 연결합니다.
Adobe Analytics 프레임워크에는 다음 구성이 있습니다.
  • Adobe prop2 Analytics 변수는 pagedata.sitesection 사이트 속성에 매핑됩니다.
  • Adobe prop3 Analytics 변수는 pagedata.subsection 사이트 속성에 매핑됩니다.
  • 다음 코드가 Free-from javascript 상자에 추가됩니다.
    s.usePlugins=true;
     function s_doPlugins(s) {
     s.prop1 = s.prop2+'|'+s.prop3;
     }
     s.doPlugins=s_doPlugins;
    
    
  • 프레임워크를 사용하는 웹 페이지를 방문하거나 편집 모드에서 페이지를 다시 로드하거나 미리 볼 때 Adobe Analytics에 대한 호출이 수행됩니다.
예를 들어 다음 값이 Adobe Analytics에서 생성됩니다.

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

모든 Adobe Analytics 프레임워크에 통합된 사용자 정의 JavaScript 코드를 제공합니다. 페이지의 Adobe Analytics 프레임워크에 사용자 정의 자유 형식 javascript가 포함되어 있지 않으면 /libs/cq/analytics/components/sitecatalyst/config.js.jsp 스크립트가 생성하는 javascript가 analytics.sitecatalyst.js 파일에 추가됩니다. 기본적으로 스크립트는 주석 처리되므로 아무런 영향을 주지 않습니다. 이 코드는 다음과 s.usePlugins 같이 설정됩니다 false .
/* 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.usePlugins true 설정하여 함수의 모든 코드가 실행되도록 해야 s_doPlugins 합니다. 코드를 사용자 정의하려면 고유한 javascript를 사용하는 config.js.jsp 파일을 오버레이합니다. Adobe Analytics 플러그인을 사용해야 하는 경우 AEM에 통합하십시오 .
/libs/cq/analytics/components/sitecatalyst/config.js.jsp 파일을 편집하지 마십시오. 특정 AEM 업그레이드 또는 유지 관리 작업은 원본 파일을 다시 설치하여 변경 사항을 제거할 수 있습니다.
  1. CRXDE Lite에서 /apps/cq/analytics/components 폴더 구조를 만듭니다.
    1. /apps 폴더를 마우스 오른쪽 단추로 클릭하고 만들기 > 폴더 만들기를 클릭합니다.
    2. 폴더 cq 이름으로 지정하고 #을 클릭합니다.
    3. 마찬가지로 analytics components 폴더를 만듭니다.
  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. 함수에서 실행할 JavaScript 코드를 추가한 다음 모두 저장을 클릭합니다. s_doPlugins
페이지 프레임워크의 자유 형식 javascript에 텍스트가 있는 경우(공백만 포함) config.js.jsp는 무시됩니다.

AEM에서 Adobe Analytics 플러그인 사용

Adobe Analytics 플러그인에 대한 javascript 코드를 입수하고 AEM의 Adobe Analytics 프레임워크에 통합합니다. 사용자 정의 JavaScript 코드에서 사용할 수 sitecatalyst.plugins 있도록 해당 범주의 클라이언트 라이브러리 폴더에 코드를 추가합니다.
예를 들어, getQueryParams 플러그인을 통합하면 사용자 지정 javascript의 s_doPlugins 함수에서 플러그인을 호출할 수 있습니다. 다음 예제 코드는 Adobe Analytics 호출이 트리거될 때 레퍼러의 URL에서 쿼리 문자열을 "pid"로 ​전송합니다.
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 client library 폴더에는 이러한 플러그인이 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 에도 추가해야 합니다.