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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bizspring.co.kr/growth-platform-user-guide/growth-platform-tm-1/undefined-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
