분석 스크립트 적용 가이드 — Growth Platform™ User Guide
핵심 요약
- 전환 데이터, TAM, 부정클릭 차단, 바이럴 마케팅, 쇼핑광고 분석 및 ADMONSTER 앱 사용을 위해 설치하는 분석 스크립트 적용 가이드입니다.
- 통합 스크립트는 분석 대상 사이트 전체 페이지의 </body> 태그 위쪽(공통 푸터 파일)에 반드시 삽입해야 하는 필수 스크립트입니다.
- 환경변수 스크립트는 회원가입, 로그인, 상품조회, 장바구니, 주문완료 등 필요한 이벤트가 발생하는 페이지에만 선별적으로 적용합니다.
- 환경변수 스크립트는 항상 HTML 코드 내에서 필수 기본 스크립트보다 위쪽에 위치해야 하며, 값에 따옴표를 사용할 수 없습니다.
- _TRK_G1~G10(사용자 정의 전환 지표)과 _TRK_ENV_XXX(사용자 정의 이벤트)를 통해 회원수·주문수 외의 커스텀 전환 항목도 설정할 수 있습니다.
# 분석 스크립트 적용 가이드
> 전환 데이터, TAM, 부정클릭 차단, 바이럴 마케팅, 쇼핑광고 분석 ADMONSTER(순위 입찰) 앱 사용을 위해 설치되어야 하는 분석스크립트 적용 가이드입니다.
>
> 통합 스크립트는 분석할 사이트에 반드시 설치하여야 하며, 환경변수 스크립트는 분석이 필요한 항목을 선별하여 설치할 수 있습니다.
1. (필수) 통합 스크립트
통합 스크립트는 웹사이트 분석을 위해 전체 페이지에 필수적으로 삽입해야 합니다.
프로그래밍 언어로 구현된 대부분의 웹사이트들은 공통 레이아웃을 가지고 있습니다. 공통 레이아웃에는 일반적으로 헤더(탐색 및 메뉴 부분) 또는 푸터(회사 정보, 저작권 정보 등 공통적인 HTML 코드를 포함하고 있는 부분) 같은 공통적인 UI(사용자 인터페이스) 요소들이 포함됩니다.
모든 페이지에 개별적으로 삽입하면 유지 보수에 어려움이 있을 수 있기 때문에, 한 번의 작업으로 전체 페이지에 적용될 수 있도록 푸터 파일 내의 \ 태그 위쪽에 삽입합니다.
(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.1.js';f.parentNode.insertBefore(j,f);})(window,'_gp',document,'script','BSGPObj');
_gp('프로파일 번호','page');
※ 통합 스크립트는 MANAGER CONSOLE > 데이터 활용 설정 페이지에서 확인 가능하며, 프로파일 번호는 스크립트 내에서 확인 하실 수 있습니다.
***
2. (선별) 환경변수 스크립트
환경변수 스크립트는 전체 페이지에 적용하지 않으며 해당 환경변수의 설정이 필요한 페이지에만 선별적으로 적용합니다.
예를 들어, 주문완료에 대한 전환추적을 하고 싶은 경우에는 사용자가 결제를 완료하면 이동되는 페이지(일반적으로 '주문이 완료되었습니다.'라고 결과를 표시하는 페이지)에 삽입합니다.
> HTML 코드 내에서 (필수)기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
>
> 제공되는 환경변수 전체를 적용할 필요는 없으며 필요한 환경변수만을 선별적으로 적용하는 것이 가능합니다.
>
> 환경변수 값에 쌍따옴표(") 또는 작은따옴표(‘)가 들어갈 수 없습니다.
2.1 환경변수 간략 요약표
| \_TRK\_PI | 페이지/이벤트 식별 코드 |
|---|---|
| \_TRK\_PN | 상품명 |
| \_TRK\_PNC | 상품 코드 |
| \_TRK\_MF | 브랜드명 |
| \_TRK\_ODN | 주문 번호 |
| \_TRK\_OA | 주문 금액 |
| \_TRK\_OE | 주문 수량 |
| \_TRK\_OP | 주문 상품명 |
| \_TRK\_OPC | 주문 상품 코드 |
| \_TRK\_SX | 회원 성별 |
| \_TRK\_AG | 회원 연령 |
| \_TRK\_RK | 회원 ID/회원 번호 |
| \_TRK\_CC | 외부 캠페인 코드 |
| \_TRK\_IC | 내부 캠페인 코드 |
2.2 \_TRK\_PI 코드값
| 코드값 | 용도 |
|---|---|
| RGR | 회원 가입 |
| LIR | 로그인 |
| PLV | 상품 리스트 페이지 |
| PDV | 상품 상세 조회 |
| SCI 또는 PRDCRT | 장바구니에 추가 |
| SCO 또는 PRDCRTR | 장바구니에서 삭제 |
| ODR | 주문(구매) 완료 |
| PRDRV | 상품평 조회 |
| CTTCS | 고객 지원 문의 |
| PRDFVR | 상품 즐겨찾기 추가 |
| PRDFVRR | 상품 즐겨찾기 삭제 |
| PRDODRC | 구매 취소 |
| BKG | 예약 |
| BKGC | 예약 취소 |
| PRMMBR | 고급/정기 멤버십 가입 |
| PRDRR | 상품평 등록 |
| EVTWD | 회원 탈퇴 연관 이벤트 (이탈방어 행동) |
| PRDSHR | 상품/콘텐츠 공유 |
| BRDCF | 브랜드 채널 Follow |
| CLAIM | 클레임/컴플레인 접수 |
###
2.3 상품 조회
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| 구분 | 적용 위치 | 환경 변수 |
|---|---|---|
| 상품 조회 | 상품 상세 페이지 |
_TRK_PI
_TRK_PN
_TRK_PNC
_TRK_MF
|
_TRK_PI = "PDV";
_TRK_PN = "상품명";
_TRK_PNC = "상품 코드";
_TRK_MF = "브랜드명";
###
2.4 주문 완료
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| 구분 | 적용 위치 | 환경 변수 |
|---|---|---|
| 주문 | 주문 완료 페이지 |
_TRK_PI
_TRK_ODN
_TRK_OA
_TRK_OE
_TRK_OP
_TRK_OPC
|
주문수량, 주문금액의 변수는 숫자만 호출합니다.
_TRK_PI = "ODR";
_TRK_ODN = "주문 번호";
_TRK_OA = "주문 금액";
_TRK_OE = "주문 수량";
_TRK_OP = "주문 상품명";
_TRK_OPC = "주문 상품 코드";
\
2개 이상 상품을 구매할 경우 세미콜론으로 구분하여 변수를 호출합니다.
**예시) 동시에 A 상품 300원 \* 10개 + B 상품 200원 \* 4개 + C 상품 500원 \* 1개를 주문한 경우**
_TRK_PI = "ODR";
_TRK_ODN = "odn_20231031_30148217";
_TRK_OA = "3000;800;500";
_TRK_OE = "10;4;1";
_TRK_OP = "A의 상품명;B의 상품명;C의 상품명";
_TRK_OPC = "A의 상품코드;B의 상품코드;C의 상품코드";
2.5 장바구니 담기 버튼
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| 구분 | 적용 위치 | 환경 변수 |
|---|---|---|
| 장바구니 담기 | 상품 상세 페이지 |
_TRK_PI
_TRK_PN
_TRK_PNC
_TRK_MF
|
\
클릭 이벤트는 PC 버전의 경우에는 mousedown으로 Mobile 버전의 경우에는 touchstart로 적용합니다.
document.querySelector("버튼 선택자").addEventListener("mousedown", function() {
_TRK_PI = "SCI";
_TRK_PN = "상품명";
_TRK_PNC = "상품 코드";
_TRK_MF = "브랜드명";
_gp("프로파일 번호","conv");
});
2.6 회원 가입
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| 구분 | 적용 위치 | 환경 변수 |
|---|---|---|
| 회원 가입 | 회원 가입 완료 페이지 | _TRK_PI _TRK_SX _TRK_AG _TRK_RK |
_TRK_PI = "RGR";
_TRK_SX = ""; // M:남성, F:여성, U:미지정
_TRK_AG = ""; // A ~ O
_TRK_RK = ""; // 회원 ID/회원 번호
2.7 로그인
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| 구분 | 적용 위치 | 환경 변수 |
|---|---|---|
| 로그인 | 로그인 완료 페이지 |
_TRK_PI
_TRK_SX
_TRK_AG
_TRK_RK
|
_TRK_PI = "LIR";
_TRK_SX = ""; // M:남성, F:여성, U:미지정
_TRK_AG = ""; // A ~ O
_TRK_RK = ""; // 회원 ID/회원 번호
> 참고
>
> \_TRK\_PI의 경우 아래와 같이 코드값으로 정의
>
> 회원 가입 완료 페이지는 RGR, 로그인 성공시 LIR
>
>
>
> \_TRK\_SX의 경우 아래와 같이 코드값으로 정의
>
> 남성은 M, 여성은 F, 미지정은 U
>
>
>
> \_TRK\_AG의 경우 A\~O 알파벳 코드값으로 정의
>
>
>
> \_TRK\_RK의 경우 회원을 식별할 수 있는 고유값(ID/번호/시퀀스/해시 등) 문자열로 정의
| 속성 | 속성명 | 데이터 범위 |
|---|---|---|
| A | 0\~3세 | 0\~3 |
| B | 4\~6세 | 4\~6 |
| C | 7\~12세 | 7\~12 |
| D | 13\~15세 | 13\~15 |
| E | 16\~18세 | 16\~18 |
| F | 19\~22세 | 19\~22 |
| G | 23\~24세 | 23\~24 |
| H | 25\~29세 | 25\~29 |
| I | 30\~34세 | 30\~34 |
| J | 35\~39세 | 35\~39 |
| K | 40\~49세 | 40\~49 |
| L | 50\~59세 | 50\~59 |
| M | 60\~69세 | 60\~69 |
| N | 70\~79세 | 70\~79 |
| O | 80세 이상 | 80\~150 |
\
예시) ID가 customer1인 25\~29세(H) 의 여성(F)이 회원가입 완료하였을 경우
_TRK_SX = "F"; // M:남성, F:여성, U:미지정
_TRK_AG = "H"; // A ~ O
_TRK_RK = "customer1"; // 회원 ID/회원 번호
2.8 사용자 정의 전환 지표
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| \_TRK\_G1 | 전환 지표 속성 1 |
|---|---|
| \_TRK\_G2 | 전환 지표 속성 2 |
| \_TRK\_G3 | 전환 지표 속성 3 |
| \_TRK\_G4 | 전환 지표 속성 4 |
| \_TRK\_G5 | 전환 지표 속성 5 |
| \_TRK\_G6 | 전환 지표 속성 6 |
| \_TRK\_G7 | 전환 지표 속성 7 |
| \_TRK\_G8 | 전환 지표 속성 8 |
| \_TRK\_G9 | 전환 지표 속성 9 |
| \_TRK\_G10 | 전환 지표 속성 10 |
예시) 회원수, 주문수 외 예약상담수를 전환으로 설정하고자 할 경우
_TRK_G1 = "1";
###
2.9 사용자 정의 이벤트(\_TRK\_ENV\_XXX)
> 환경변수 스크립트는 HTML 코드 내에서 (필수) 기본 스크립트보다 반드시 위쪽에 위치해야 합니다.
| 구분 | 적용 위치 | 환경 변수 |
|---|---|---|
| 사용자 정의 | 사용자 정의 페이지 | \_TRK\_ENV\_XXX(변수정의) |
_TRK_ENV_XXX = "값";
\
예시) \_TRK\_ENV\_CREDITSCORE이고 값이 “800”이고 클릭 이벤트로 설정한 경우
클릭 이벤트는 PC 버전의 경우에는 mousedown으로 Mobile 버전의 경우에는 touchstart로 적용합니다.
document.querySelector("버튼 선택자").addEventListener("mousedown", function() {
_TRK_ENV_CREDITSCORE = “800";
_gp("프로파일 번호","conv");
});
> 참고
>
> ① \_TRK\_ENV\_XXX (변수명 이름) 사용 시 변수명 이름 설정 시 소문자, 숫자 사용이 가능합니다.
>
> ② \_TRK\_ENV\_XXX (사용자 정의 이벤트) 스크립트는 설치 후 담당자에게 문의 바랍니다
>
> ③ 사용자 정의 이벤트로 사용한 이벤트명은 TAM 세그먼트 추출 시 세그먼트 조건 설정 항목에서 확인 수 있게 커스텀 해드립니다.
자주 묻는 질문
통합 스크립트는 어디에 설치해야 하나요?
분석할 사이트의 모든 페이지에 공통으로 적용되도록 공통 레이아웃을 가진 푸터 파일 내의 </body> 태그 위쪽에 삽입하면 됩니다. 이렇게 하면 모든 페이지에 개별적으로 삽입하지 않아도 한 번의 작업으로 전체 페이지에 적용됩니다.
환경변수 스크립트는 모든 페이지에 넣어야 하나요?
아니요, 환경변수 스크립트는 해당 환경변수 설정이 필요한 페이지에만 선별적으로 적용하면 됩니다. 예를 들어 주문완료 전환추적이 필요하면 결제 완료 후 이동되는 페이지에만 삽입하면 됩니다.
환경변수 스크립트를 적용할 때 주의할 점이 있나요?
환경변수 스크립트는 HTML 코드 내에서 반드시 필수 기본 스크립트보다 위쪽에 위치해야 합니다. 또한 환경변수 값에는 쌍따옴표(")나 작은따옴표(')를 사용할 수 없습니다.
2개 이상의 상품을 동시에 주문한 경우 주문 정보는 어떻게 입력하나요?
2개 이상 상품을 구매할 경우 _TRK_OA, _TRK_OE, _TRK_OP, _TRK_OPC 등의 변수 값을 세미콜론(;)으로 구분하여 각각 순서대로 호출하면 됩니다.
회원가입 시 성별과 연령은 어떤 값으로 입력하나요?
_TRK_SX는 남성 M, 여성 F, 미지정 U로 입력하고, _TRK_AG는 연령대에 따라 A~O의 알파벳 코드값으로 정의합니다. _TRK_RK에는 회원을 식별할 수 있는 ID나 회원 번호 등의 고유값을 문자열로 입력합니다.