> For the complete documentation index, see [llms.txt](https://acecounter.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://acecounter.gitbook.io/guide/script-setting/basic-script.md).

# 기본 스크립트 설치

### 분석 스크립트란 <a href="#undefined" id="undefined"></a>

***

웹사이트의 방문자 데이터 및 주요 행동 데이터를 수집하기 위해 사이트 소스 코드에 적용하는 자바스크립트(JavaScript) 태그입니다. 스크립트 설치가 완료되어야 분석 리포트에 데이터가 수집 및 표시되므로, 회원가입 후 가장 먼저 스크립트 설치를 진행해 주세요!

### 스크립트 직접 설치가 어려우신가요? <a href="#undefined-1" id="undefined-1"></a>

***

* 스크립트 설치가 어렵다면 에이스카운터의 전문 개발자를 통해 설치 대행 서비스를 맡겨 보세요.
* 설치는 최초 1회 무료 설치 지원 드립니다.
* 소스를 수정할 수 있는 [FTP](https://acecounter.gitbook.io/guide/utilize/term/ftp) 정보 (FTP 주소, PORT, ID, PW)를 전달 주셔야 합니다.
* [**설치 대행 서비스 신청하기**](https://www.acecounter.com/stat/my/my_codeset_info.amz)(서비스 로그인 후 신청 가능)

### 스크립트 설치 절차 <a href="#undefined-2" id="undefined-2"></a>

***

#### **STEP 1. 분석 스크립트 다운로드**

**1.** [**\[서비스 관리 > 분석 스크립트\] 메뉴**](https://www.acecounter.com/stat/my/my_script.amz)**를 통해 분석 스크립트 다운로드 메뉴를 실행해 주세요**

<img src="https://acecounter.gitbook.io/guide/~gitbook/image?url=https%3A%2F%2F510786081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9VJlv4yu9CkXoSK0uuq6%252Fuploads%252FBsdTuZHen7Tz90WM8Mtn%252F%25EC%2595%25A0%25EB%2584%2590%25EB%25A6%25AC%25ED%258B%25B1%25EC%2584%25A4%25EC%25B9%2598%25EA%25B0%2580%25EC%259D%25B4%25EB%2593%259C_1-1.png%3Falt%3Dmedia%26token%3D2a3ffc2f-ad23-4fc0-9666-b1e507a4ccf2&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=fbd8db4c80b6c80612436afa4593ce99&#x26;sv=3" alt="" height="203" width="806">

**2. 등록한 서비스에 대해 \[다운로드] 버튼을 클릭하여 스크립트를 다운로드해 주세요**

<img src="https://acecounter.gitbook.io/guide/~gitbook/image?url=https%3A%2F%2F510786081-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F9VJlv4yu9CkXoSK0uuq6%252Fuploads%252FfWQyLAdEzvgo4VYmRQSU%252F%25EC%2595%25A0%25EB%2584%2590%25EB%25A6%25AC%25ED%258B%25B1%25EC%2584%25A4%25EC%25B9%2598%25EA%25B0%2580%25EC%259D%25B4%25EB%2593%259C_1-2.png%3Falt%3Dmedia%26token%3Dec2167b1-11ff-4324-a677-676a39ab97a7&#x26;width=768&#x26;dpr=3&#x26;quality=100&#x26;sign=b5a20b6793da016861b4e070ebfa8ab9&#x26;sv=3" alt="" height="65" width="806">

**3. 다운로드한 분석 스크립트 압축파일을 압축 해제해 주세요**

압축 파일명은 일반적으로 script(사이트 도메인주소) .zip 입니다.

#### STEP 2. 웹 서버(FTP) 소스에 스크립트 적용

압축을 해제한 스크립트 파일 목록을 확인한 뒤, 웹 서버 공통 영역 소스에 공통 스크립트 및 환경변수 스크립트를 설치합니다.

* 📄 [공통 스크립트 설치](/guide/script-setting/basic-script/common-script.md): 모든 페이지에서 동작하며 기본 방문/유입 데이터를 수집합니다.
* 📄 [환경변수 스크립트  설치](/guide/script-setting/basic-script/variables.md): 회원가입, 장바구니, 구매완료 등 주요 전환 페이지에 적용하여 상세 데이터를 수집합니다.

#### STEP 3. 스크립트 설치 정상 여부 확인

설치를 마친 후 아래 2가지 방법으로 데이터 수집 상태를 테스트할 수 있습니다.

**📊 \[분석 리포트 > 실시간 방문자] 메뉴에서 빠르게 확인하기**

&#x20;      1\. 스크립트를 설치한 웹사이트 페이지에 직접 접속합니다.

&#x20;      2\. 에이스카운터의 \[분석 리포트 > 실시간 방문자] 메뉴를 열어봅니다.

&#x20;      3\. 접속 기록이 실시간으로 확인되면 공통 스크립트가 정상 동작하는 것입니다.

**🛠️ Chrome 확장 프로그램으로 상세 변수 검증하기**

회원가입 정보, 제품명, 구매금액 등 상세 환경변수 파라미터가 정확히 전송되는지 확인하려면 전용 검증 도구를 활용해 보세요.

&#x20;      1\. [AceCounter 설치 확인 프로그램](https://chromewebstore.google.com/detail/eckkhbdopjhjafkmlbbjmnippoedjbei)을 설치합니다.

&#x20;      2\. 스크립트가 설치된 페이지 접속 후 새로고침(F5)을 실행합니다.

&#x20;      3\. 화면로 실제 전송되는 수집 요청, 파라미터, 환경변수 상세값을 점검할 수 있습니다.