분석 스크립트 적용 가이드

CTS(CTS 전환 데이터가 포함된 일부 메), LOGGER, TAM, ADM(순위 입찰) 앱 사용을 위해 설치되어야 하는 분석스크립트 적용 가이드입니다.

기본 스크립트는 분석할 사이트내 필수로 설치하여야 하며, 환경변수 스크립트는 분석이 필요한 항목을 선별하여 설치할 수 있습니다.

1. (필수) 기본 스크립트

기본 스크립트는 웹사이트 분석을 위해 전체 페이지에 필수적으로 삽입해야 합니다.

프로그래밍 언어로 구현된 대부분의 웹사이트들은 공통 레이아웃을 가지고 있습니다. 공통 레이아웃에는 일반적으로 헤더(탐색 및 메뉴 부분) 또는 푸터(회사 정보, 저작권 정보 등 공통적인 HTML 코드를 포함하고 있는 부분) 같은 공통적인 UI(사용자 인터페이스) 요소들이 포함됩니다.

모든 페이지에 개별적으로 삽입하면 유지 보수에 어려움이 있을 수 있기 때문에, 한 번의 작업으로 전체 페이지에 적용될 수 있도록 푸터 파일 내의 </body> 태그 위쪽에 삽입합니다.

<script type="text/javascript">
  (function(b,s,t,c,k){b[k]=s;b[s]=b[s]||function(){(b[s].q=b[s].q||[]).push(arguments)}; var f=t.getElementsByTagName(c)[0],j=t.createElement(c);j.async=true;j.src='//fs.bizspring.net/gp/gp.v.1.0.js';f.parentNode.insertBefore(j,f);})(window,'_gp',document,'script','BSGPObj');
  _gp('프로파일 번호','land');
</script>

---

2. (선별) 환경변수 스크립트

환경변수 스크립트는 전체 페이지에 적용하지 않으며 해당 환경변수의 설정이 필요한 페이지에만 선별적으로 적용합니다.

예를 들어, 주문완료에 대한 전환추적을 하고 싶은 경우에는 사용자가 결제를 완료하면 이동되는 페이지(일반적으로 '주문이 완료되었습니다.'라고 결과를 표시하는 페이지)에 삽입합니다.

HTML 코드 내에서 (필수)기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

제공되는 환경변수 전체를 적용할 필요는 없으며 필요한 환경변수만을 선별적으로 적용하는 것이 가능합니다.

환경변수 값에 쌍따옴표(“) 또는 작은따옴표(‘)가 들어갈 수 없습니다.

2.1 환경변수 간략 요약표

_TRK_PND	상품명
_TRK_MF	상품 카테고리
_TRK_OP	주문상품명
_TRK_OPC	주문상품코드
_TRK_OE	주문수량
_TRK_OA	주문금액
_TRK_OAP	할인전 금액
_TRK_SX	회원 성별
_TRK_AG	회원 나이
_TRK_IK	내부 검색어 전달
_TRK_RK	고객 ID/고객번호
_TRK_CC	외부캠페인코드
_TRK_IC	내부캠페인코드

2.2 상품 조회

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
상품 조회	상품 상세 페이지	_TRK_PI _TRK_PN _TRK_PND _TRK_MF

<script type="text/javascript">
  _TRK_PI = "PDV";
  _TRK_PN = "상품코드";
  _TRK_PND = "상품명";
  _TRK_MF = "브랜드명";
</script>

2.3 장바구니 담기

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
장바구니 담기	상품 상세 페이지	_TRK_PI _TRK_PN _TRK_PND _TRK_MF

클릭 이벤트는 PC 버전의 경우에는 mousedown으로 Mobile 버전의 경우에는 touchstart로 적용합니다. 버튼 클릭 후 페이지 이동이 있는 경우 setTimeout()을 통해 로그 유실을 방지합니다.

<script type="text/javascript">
  document.querySelectorAll("장바구니담기 버튼 선택자").forEach(function(element) {
    element.addEventListener("mousedown 또는 touchstart", function() {
      _TRK_PI = "SCI";
      _TRK_PN = "상품코드";
      _TRK_PND = "상품명";
      _TRK_MF = "브랜드명";
      _gp("프로파일 번호","conv");

      setTimeout(function () {
        location.href = "이동할 URL"; // 예: 장바구니 페이지
      }, 300);
    });
  });
</script>

상품조회 스크립트를 적용하여 해당 페이지에 _TRK_PN, _TRK_PND, _TRK_MF 변수가 이미 설정되어 있는 경우에는 _TRK_PI 변수만 설정합니다.

<script type="text/javascript">
  document.querySelectorAll("장바구니담기 버튼 선택자").forEach(function(element) {
    element.addEventListener("mousedown 또는 touchstart", function() {
      _TRK_PI = "SCI";
      _gp("프로파일 번호","conv");

      setTimeout(function () {
        location.href = "이동할 URL"; // 예: 장바구니 페이지
      }, 300);
    });
  });
</script>

※ _gp() 방식으로 로그 수집이 누락될 경우

로거에서이벤트 수집 로그가 누락될 경우 _trk_flashEnvView() 방식으로 대체 적용할 수 있습니다.

<script type="text/javascript">
  document.querySelectorAll("장바구니담기 버튼 선택자").forEach(function(element) {
    element.addEventListener("mousedown 또는 touchstart", function() {
      _trk_flashEnvView(
        '_TRK_PI=SCI', //이벤트 구분값
        '_TRK_PN=상품코드',
        '_TRK_PND=상품명',
        '_TRK_MF=브랜드명'
      );

      setTimeout(function () {
        location.href = "이동할 URL"; // 예: 장바구니 페이지
      }, 300);
    });
  });
</script>

스크립트 삽입이 어려운 CMS 환경이나 에디터 페이지 등에서는 아래와 같이 onmousedown 속성을 이용해 HTML 태그에 직접 수집 이벤트를 삽입할 수 있습니다.

<!-- 예시: 이미지 버튼 클릭 시 로그 수집 -->
<img
  src="/img/add-to-cart.png"
  width="100"
  height="30"
  alt="장바구니 담기"
  onmousedown="_trk_flashEnvView('_TRK_PI=SCI','_TRK_PN=상품코드','_TRK_PND=상품명','_TRK_MF=브랜드명'); location.href='이동할 URL';"
/>

onmousedown 방식은 빠르게 적용할 수 있으나, 복잡한 로직 처리나 유지 보수에는 한계가 있습니다. 가능하면 JavaScript 이벤트 바인딩 방식 사용을 권장합니다.

2.4 주문 완료

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
주문	주문 완료 페이지	_TRK_PI _ TRK_ODN _TRK_OA _TRK_OE _TRK_OP _TRK_OPC _TRK_OAP

주문수량, 주문금액의 변수는 숫자만 호출합니다.

<script type="text/javascript">
  _TRK_PI = "ODR";
  _TRK_ODN = "주문번호";
  _TRK_OA = "주문금액";
  _TRK_OE = "주문수량";
  _TRK_OP = "주문상품명";
  _TRK_OPC = "주문상품코드";
  _TRK_OAP = "할인전금액";
</script>

2개 이상 상품을 구매할 경우 세미콜론으로 구분하여 변수를 호출합니다.

예시) 동시에 A 상품 300원 * 10개 + B 상품 200원 * 4개 + C 상품 500원 * 1개를 주문한 경우

<script type="text/javascript">
  _TRK_PI = "ODR";
  _TRK_ODN = "주문번호";
  _TRK_OA = "3000;800;500";
  _TRK_OE = "10;4;1";
  _TRK_OP = "A의 상품명;B의 상품명;C의 상품명";
  _TRK_OP = "A의 상품코드;B의 상품코드;C의 상품코드";
  _TRK_OAP = "2000;400;300";
</script>

2.5 특정 카테고리

구분	적용 위치	환경 변수
특정 카테고리	카테고리 분석 페이지	_TRK_CP

<script type="text/javascript">
  _TRK_CP = "소속 카테고리명 변수";
</script>

2.6 회원 가입

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
회원 가입	회원 가입 완료 페이지	_TRK_PI _TRK_SX _TRK_AG

<script type="text/javascript">
  _TRK_PI = "RGR";
  _TRK_SX = "";
  _TRK_AG = "";
</script>

2.7 로그인

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
로그인	로그인 완료 페이지	_TRK_PI _TRK_SX _TRK_AG

<script type="text/javascript">
  _TRK_PI = "LIR";
  _TRK_SX = “”;
  _TRK_AG = “”;
</script>

2.8 회원특성 분류

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
성별		_TRK_SX
연령		_TRK_AG

<script type="text/javascript">
  _TRK_SX = “”; // M, F, U
  _TRK_AG = “”; // A ~ G 
</script>

참고

_TRK_PI의 경우 아래와 같이 코드값으로 정의

회원 가입 완료 페이지는 RGR, 로그인 성공시 LIR 그외는 2.11 참고

_TRK_SX의 경우 아래와 같이 코드값으로 정의

남성은 M, 여성은 F, 그 외는 U

_TRK_AG의 경우 A~Z 알파벳 코드값으로 정의

속성	속성명	데이터 범위
A	10대 이하	0~19
B	20대	20~29
C	30대	30~39
D	40대	40~49
E	50대	50~59
F	60대	60~69
G	70대 이상	70~150

예시) level B(20대) 의 여성이 회원가입 완료하였을 경우

<script type="text/javascript">
  _TRK_PI = “RGR”; 
  _TRK_SX = “F”;
  _TRK_AG = “B”;
</script>

2.9 내부 검색어

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

구분	적용 위치	환경 변수
내부 검색어	검색 완료 페이지	_TRK_IK

<script type="text/javascript">
  _TRK_IK = "검색어 변수"; 
</script>

2.10 _TRK_ENV_XXX 변수 정의

환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.

정의되어 있는 환경변수 이외에 사용할 경우 _TRK_ENV_ 뒤에 이름(XXX) 정의해주고 값을 할당

<script type="text/javascript">
  _TRK_ENV_XXX = "값";
</script>

예시) 환경변수가 _TRK_ENV_PDA1이고 값이 “1”인 경우

<script type="text/javascript">
  _TRK_ENV_PDA1 = “1”; 
</script>

ENV 변수	용도
_TRK_ENV_PDA1	상품 속성 #1
_TRK_ENV_PDA2	상품 속성 #2
_TRK_ENV_PDA3	상품 속성 #3
_TRK_ENV_PDA4	상품 속성 #4
_TRK_ENV_PDA5	상품 속성 #5
_TRK_ENV_PDA6	상품 속성 #6
_TRK_ENV_PDA7	상품 속성 #7
_TRK_ENV_PDA8	상품 속성 #8
_TRK_ENV_PDA9	상품 속성 #9
_TRK_ENV_PDA10	상품 속성 #10
_TRK_ENV_CPN	쿠폰 사용
_TRK_ENV_CPND	쿠폰 코드
_TRK_ENV_AIC	장바구니 추가 금액
_TRK_ENV_ACA	장바구니 삭제 금액
_TRK_ENV_IKR	내부검색어 검색결과 여부
_TRK_ENV_IKP	내부검색어 검색결과수

2.11 _TRK_PI 코드값

코드값	용도
RGR	회원가입
LIR	로그인
LGO	로그아웃
PLV	상품 리스트 페이지
PDV	상품 상세 조회
PRV	상품 리뷰 조회
ATF	관심상품에 추가
SCI	장바구니에 추가
SCO	장바구니에서 삭제
OCV	장바구니 페이지 조회
OCF	체크아웃
ODR	주문(구매)
WPR	리뷰 작성
FOD	첫 구매 여부
CODR	구매 취소