> For the complete documentation index, see [llms.txt](https://docs.bizspring.co.kr/growth-platform-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bizspring.co.kr/growth-platform-user-guide/growth-platform-tm-1/undefined-2.md).

# 분석 스크립트 적용 가이드

{% hint style="info" %}
전환 데이터, TAM, 부정클릭 차단, 바이럴 마케팅, 쇼핑광고 분석  ADMONSTER(순위 입찰) 앱 사용을 위해 설치되어야 하는 분석스크립트 적용 가이드입니다. 

통합 스크립트는 분석할 사이트에 반드시 설치하여야 하며, 환경변수 스크립트는 분석이 필요한 항목을 선별하여 설치할 수 있습니다.
{% endhint %}

## **1. (필수) 통합 스크립트** <a href="#id-1e9a3092-4e6b-4844-ac4f-88589e8cc2c2" id="id-1e9a3092-4e6b-4844-ac4f-88589e8cc2c2"></a>

통합 스크립트는 웹사이트 분석을 위해 <mark style="color:red;">**전체 페이지에 필수적으로 삽입**</mark>해야 합니다.

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

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

<figure><img src="/files/p42EIGzK5LxMxGAJHrXf" alt=""><figcaption></figcaption></figure>

```javascript
<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.1.js';f.parentNode.insertBefore(j,f);})(window,'_gp',document,'script','BSGPObj');
  _gp('프로파일 번호','page');
</script>
```

※ 통합 스크립트는 MANAGER CONSOLE > 데이터 활용 설정 페이지에서 확인 가능하며, 프로파일 번호는 스크립트 내에서 확인 하실 수 있습니다.&#x20;

***

## **2. (선별) 환경변수 스크립트** <a href="#id-293c9d2c-6a1a-4d23-aac1-ad6c99971af7" id="id-293c9d2c-6a1a-4d23-aac1-ad6c99971af7"></a>

환경변수 스크립트는 전체 페이지에 적용하지 않으며 <mark style="color:red;">**해당 환경변수의 설정이 필요한 페이지에만 선별적으로 적용**</mark>합니다.

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

{% hint style="danger" %}
&#x20;<mark style="color:red;">**HTML 코드 내에서 (필수)기본 스크립트보다 반드시 위쪽에 위치해야 합니다**</mark><mark style="color:red;">.</mark>

제공되는 환경변수 전체를 적용할 필요는 없으며 <mark style="color:red;">**필요한 환경변수만을 선별적으로 적용하는 것이 가능**</mark>합니다.

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

### **2.1 환경변수 간략 요약표** <a href="#id-7a132172-94b0-46c4-b6f4-98e4162a4dc2" id="id-7a132172-94b0-46c4-b6f4-98e4162a4dc2"></a>

| \_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 코드값** <a href="#a8ba9179-5db9-4af6-b53d-425a572aa16c" id="a8ba9179-5db9-4af6-b53d-425a572aa16c"></a>

| 코드값            | 용도                     |
| -------------- | ---------------------- |
| RGR            | 회원 가입                  |
| LIR            | 로그인                    |
| PLV            | 상품 리스트 페이지             |
| PDV            | 상품 상세 조회               |
| SCI 또는 PRDCRT  | 장바구니에 추가               |
| SCO 또는 PRDCRTR | 장바구니에서 삭제              |
| ODR            | 주문(구매) 완료              |
| PRDRV          | 상품평 조회                 |
| CTTCS          | 고객 지원 문의               |
| PRDFVR         | 상품 즐겨찾기 추가             |
| PRDFVRR        | 상품 즐겨찾기 삭제             |
| PRDODRC        | 구매 취소                  |
| BKG            | 예약                     |
| BKGC           | 예약 취소                  |
| PRMMBR         | 고급/정기 멤버십 가입           |
| PRDRR          | 상품평 등록                 |
| EVTWD          | 회원 탈퇴 연관 이벤트 (이탈방어 행동) |
| PRDSHR         | 상품/콘텐츠 공유              |
| BRDCF          | 브랜드 채널 Follow          |
| CLAIM          | 클레임/컴플레인 접수            |

### &#x20;<a href="#b8ec68f8-bcf1-4a27-a496-7c20afe8214a" id="b8ec68f8-bcf1-4a27-a496-7c20afe8214a"></a>

### **2.3 상품 조회** <a href="#b8ec68f8-bcf1-4a27-a496-7c20afe8214a" id="b8ec68f8-bcf1-4a27-a496-7c20afe8214a"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

| 구분    | 적용 위치     | 환경 변수                                                               |
| ----- | --------- | ------------------------------------------------------------------- |
| 상품 조회 | 상품 상세 페이지 | <p>\_TRK\_PI </p><p>\_TRK\_PN </p><p>\_TRK\_PNC</p><p>\_TRK\_MF</p> |

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

### &#x20;<a href="#b8ec68f8-bcf1-4a27-a496-7c20afe8214a" id="b8ec68f8-bcf1-4a27-a496-7c20afe8214a"></a>

### **2.4 주문 완료** <a href="#b8ec68f8-bcf1-4a27-a496-7c20afe8214a" id="b8ec68f8-bcf1-4a27-a496-7c20afe8214a"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

| 구분 | 적용 위치     | 환경 변수                                                                                                  |
| -- | --------- | ------------------------------------------------------------------------------------------------------ |
| 주문 | 주문 완료 페이지 | <p>\_TRK\_PI</p><p>\_TRK\_ODN </p><p>\_TRK\_OA </p><p>\_TRK\_OE </p><p>\_TRK\_OP </p><p>\_TRK\_OPC</p> |

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

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

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

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

```
<script type="text/javascript">
  _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의 상품코드";
</script>
```

### **2.5 장바구니 담기 버튼**  <a href="#ceadfe18-8908-4750-bc05-2518f9b9b701" id="ceadfe18-8908-4750-bc05-2518f9b9b701"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

| 구분      | 적용 위치     | 환경 변수                                                            |
| ------- | --------- | ---------------------------------------------------------------- |
| 장바구니 담기 | 상품 상세 페이지 | <p>\_TRK\_PI <br>\_TRK\_PN </p><p>\_TRK\_PNC</p><p>\_TRK\_MF</p> |

\
클릭 이벤트는 PC 버전의 경우에는 mousedown으로 Mobile 버전의 경우에는 touchstart로 적용합니다.

```javascript
<script type="text/javascript">
    document.querySelector("버튼 선택자").addEventListener("mousedown", function() {
      _TRK_PI = "SCI";
      _TRK_PN = "상품명";
      _TRK_PNC = "상품 코드";
      _TRK_MF = "브랜드명";
      _gp("프로파일 번호","conv");
    });
 </script>
```

### **2.6 회원 가입** <a href="#a55bd6b0-301a-4438-b9e7-2f1c9f9363bc" id="a55bd6b0-301a-4438-b9e7-2f1c9f9363bc"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

<table><thead><tr><th width="245.33333333333331">구분</th><th>적용 위치</th><th>환경 변수</th></tr></thead><tbody><tr><td>회원 가입</td><td>회원 가입 완료 페이지</td><td><p>_TRK_PI</p><p>_TRK_SX</p><p>_TRK_AG</p><p>_TRK_RK</p></td></tr></tbody></table>

```javascript
<script type="text/javascript">
  _TRK_PI = "RGR";
  _TRK_SX = "";    // M:남성, F:여성, U:미지정
  _TRK_AG = "";    // A ~ O
  _TRK_RK = "";    // 회원 ID/회원 번호
</script>
```

### **2.7 로그인** <a href="#id-07d74fa1-da50-4732-9025-94663ad22299" id="id-07d74fa1-da50-4732-9025-94663ad22299"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

| 구분  | 적용 위치      | 환경 변수                                                            |
| --- | ---------- | ---------------------------------------------------------------- |
| 로그인 | 로그인 완료 페이지 | <p>\_TRK\_PI</p><p>\_TRK\_SX</p><p>\_TRK\_AG</p><p>\_TRK\_RK</p> |

```javascript
<script type="text/javascript">
  _TRK_PI = "LIR";
  _TRK_SX = "";    // M:남성, F:여성, U:미지정
  _TRK_AG = "";    // A ~ O
  _TRK_RK = "";    // 회원 ID/회원 번호
</script>
```

{% hint style="warning" %}
**참고**

**\_TRK\_PI의 경우 아래와 같이 코드값으로 정의**

회원 가입 완료 페이지는 RGR, 로그인 성공시 LIR&#x20;

**\_TRK\_SX의 경우 아래와 같이 코드값으로 정의**

남성은 M, 여성은 F, 미지정은 U

**\_TRK\_AG의 경우 A\~O 알파벳 코드값으로 정의**

**\_TRK\_RK의 경우 회원을 식별할 수 있는 고유값(ID/번호/시퀀스/해시 등) 문자열로 정의**
{% endhint %}

| 속성 | 속성명     | 데이터 범위  |
| -- | ------- | ------- |
| 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)이 회원가입 완료하였을 경우**

```javascript
<script type="text/javascript">
 _TRK_SX = "F";    // M:남성, F:여성, U:미지정
 _TRK_AG = "H";    // A ~ O
 _TRK_RK = "customer1";  // 회원 ID/회원 번호
</script>
```

### **2.8 사용자 정의 전환 지표** <a href="#id-7a132172-94b0-46c4-b6f4-98e4162a4dc2" id="id-7a132172-94b0-46c4-b6f4-98e4162a4dc2"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

| \_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 |

**예시) 회원수, 주문수 외 예약상담수를 전환으로 설정하고자 할 경우** &#x20;

```
<script type="text/javascript">
  _TRK_G1 = "1";
 </script>
```

### &#x20;<a href="#id-500e97e1-427d-45c4-abfb-8eae84d4a123" id="id-500e97e1-427d-45c4-abfb-8eae84d4a123"></a>

### **2.9 사용자 정의 이벤트(\_TRK\_ENV\_XXX)** <a href="#id-500e97e1-427d-45c4-abfb-8eae84d4a123" id="id-500e97e1-427d-45c4-abfb-8eae84d4a123"></a>

> 환경변수 스크립트는 HTML 코드 내에서 (필수) <mark style="color:red;">기본 스크립트보다 반드시 위쪽에 위치</mark>해야 합니다.

| 구분     | 적용 위치      | 환경 변수                 |
| ------ | ---------- | --------------------- |
| 사용자 정의 | 사용자 정의 페이지 | \_TRK\_ENV\_XXX(변수정의) |

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

\
**예시) \_TRK\_ENV\_CREDITSCORE이고 값이 “800”이고 클릭 이벤트로 설정한 경우**

클릭 이벤트는 PC 버전의 경우에는 mousedown으로 Mobile 버전의 경우에는 touchstart로 적용합니다.

```javascript
<script type="text/javascript">
    document.querySelector("버튼 선택자").addEventListener("mousedown", function() {
      _TRK_ENV_CREDITSCORE = “800";
      _gp("프로파일 번호","conv");
    });
 </script>
```

{% hint style="warning" %}
**참고**

① \_TRK\_ENV\_XXX (변수명 이름) 사용 시 변수명 이름 설정 시 소문자, 숫자 사용이 가능합니다.

② \_TRK\_ENV\_XXX (사용자 정의 이벤트) 스크립트는 설치 후 담당자에게 문의 바랍니다

③ 사용자 정의 이벤트로 사용한 이벤트명은 TAM 세그먼트 추출 시 세그먼트 조건 설정 항목에서 확인  수 있게 커스텀 해드립니다.
{% endhint %}