> 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/install.md).
# 설치 가이드
## 분석 스크립트란
***
분석을 위해 사이트 소스에 적용해야 하는 자바스크립트로 만들어진 태그입니다.
스크립트 설치 전까지는 리포트 페이지에서 분석 데이터가 표시되지 않기 때문에
회원가입을 완료하셨다면 바로 스크립트 설치를 진행해 주세요!
## 무료 설치 지원
***
* 스크립트 설치가 어렵다면 에이스카운터의 전문 개발자를 통해 설치 대행 서비스를 맡겨 보세요.
* 설치는 최초 1회 무료 설치 지원 드립니다.
* 소스를 수정할 수 있는 [FTP](/guide/utilize/term/ftp.md) 정보 (FTP 주소, PORT, ID, PW)를 전달 주셔야 합니다.
* [**설치 대행 서비스 신청하기**](https://www.acecounter.com/stat/my/my_codeset_info.amz)(서비스 로그인 후 신청 가능)
## 스크립트 설치 방법
***
\[스크립트 다운로드 방법]
스크립트 파일은 에이스카운터에 로그인하여 아래 절차대로 다운로드해 주세요.
**1.** [**\[서비스 관리 > 분석 스크립트\] 메뉴**](https://www.acecounter.com/stat/my/my_script.amz)**를 통해 분석 스크립트 다운로드 메뉴를 실행해 주세요**
**2. 등록한 서비스에 대해 \[다운로드] 버튼을 클릭하여 스크립트를 다운로드해 주세요**
**3. 다운로드한 분석 스크립트 압축파일을 압축 해제해 주세요**
압축 파일명은 일반적으로 script(사이트 도메인주소) .zip 입니다.
**4. 웹 서버(FTP)의 공통 영역 소스에 공통 스크립트/환경 변수를 설치해 주세요**
스크립트 파일 내 파일 목록
## 1. 공통 스크립트
**📢 ****필수로 설치해야 되는 스크립트입니다.**
***
\[스크립트 삽입 위치]
HTML 파일 내 위치한 **\와 \사이 또는 \와 \ 사이**입니다.
※ 환경 변수를 세팅하는 경우, 공통 스크립트는 환경 변수보다 하단에 위치해야 하므로 Footer(하단 공통부분)에 설치하는 것을 권장합니다.
## 2. 환경 변수 - 회원 분석
**📢 ****필수 스크립트는 아니며 분석을 원하는 데이터에 따라 선택적으로 설치해 주세요.**
***
회원 분석, 구매 분석, 내부 검색어 데이터 확인을 위한 스크립트에 해당됩니다.
### 2-1. 환경 변수 기본 설치 위치
공통 스크립트 보다 **상단에 환경 변수 스크립트가 삽입**되어야 정상적인 분석이 가능합니다.
하단에 보는 환경 변수 스크립트 예시를 운영하시는 사이트에 알맞게 설정해 주세요.
### 2-2. 회원가입 / 해지 페이지 설치
‘회원가입 아이디(m\_jid)’에 대해 실제 사용 중인 변수와 연동할 수 있도록 설정해야 합니다.
PHP 사이트의 경우 '\'
ASP 사이트의경우 ‘<%=ID변수%>’
세팅 완료 후, [**\[분석통계 > 회원\]**](https://www.acecounter.com/stat/view/statview11_2.amz) 메뉴에서 수집된 통계 확인하실 수 있습니다.
※ 회원에 대한 아이디별 분석을 위해서는 [**회원 아이디별 분석 신청**](https://www.acecounter.com/stat/my/my_id_analysis.amz) 필요합니다.
### 2-3. 로그인 페이지 설치
로그인한 사용자의 정보를 에이스카운터 변수에 세팅합니다.
(로그인 처리 페이지에 설치)
* 기본항목 : ID, 나이, 성별, 결혼 여부
* 직접 세팅 : m\_ud1, m\_ud2, m\_ud3 (예: 회원 구분, 지역 등 구분 원하는 항목에 대해 직접 정의 가능)
※ m\_ud1, m\_ud2, m\_ud3 변수를 이용하기 위해서는 에이스카운터 관리자 페이지의 [**\[설정 > 회원그룹\]**](https://www.acecounter.com/stat/view/manager6_1.amz)에서 사용자 정의 변수 설정이 필요합니다.
### 2-4. 설치된 로그인 페이지 소스 예시
회원 로그인 시 메인 페이지로 재호출 시키는 경우 소스 보기가 되지 않을 수 있습니다.
설치가 완료되면 [**\[분석통계 > 회원 분석\]**](https://www.acecounter.com/stat/view/statview11_2.amz)에서 확인하실 수 있습니다.
## 3. 환경 변수 - 구매 분석
***
### 3-1. 제품 상세 페이지 설치
**제품의 노출수, 구매율, 장바구니 담긴수, 이탈 매출** 분석을 위한 설치입니다.
제품 상세 페이지에 다운로드 파일의 samples 폴더 내에 위치한 제품상세 분석 스크립트 파일
(1-Product\_Detail.txt)을 설치하고 에이스카운터 변수에 각 속성 값을 담고 있는 변수를 세팅해 주세요.
제품 상세 스크립트는 항상 공통 스크립트 보다 상단에 위치해야 합니다. (공통 스크립트는 필수 설치)
수집된 데이터는 [**\[분석통계>제품\]**](https://www.acecounter.com/stat/view/statview15_2.amz) 메뉴에서 확인하실 수 있습니다.
### 3-2. 장바구니 페이지 설치
**장바구니 수량 변경, 포기한 제품, 이탈 매출** 분석 등을 위한 설치입니다.
장바구니 페이지에 다운로드 파일의 samples 폴더 내에 위치한 장바구니 분석 스크립트 파일 (2-Cart\_Inout.txt)을 설치합니다.
에이스카운터 변수에 각 속성 값을 담고 있는 변수를 세팅해 주세요.
장바구니 스크립트는 항상 공통 스크립트 보다 상단에 위치해야 합니다. (공통 스크립트는 필수 설치)
수집된 데이터는 [**\[분석통계>장바구니\]**](https://www.acecounter.com/stat/view/statview17_2.amz) 메뉴에서 확인하실 수 있습니다.
※ 장바구니 액션 함수 적용 후 분석 스크립트를 삭제하는 경우 스크립트 오류가 발생할 수 있습니다. 따라서 try-catch 예외 처리 구문 안에 액션 함수를 적용해야 하며, 분석 스크립트를 삭제하는 경우 적용한 액션 함수도 삭제해야 합니다.
### 3-3. 구매완료 페이지 설치
**구매한 제품, 수량, 매출액, 구매율, 구매당 매출액** 분석 등을 위한 설치입니다.
구매완료 페이지에 다운로드 파일의 samples 폴더 내에 위치한 구매완료 분석 스크립트 파일
(3-Buy\_Finish.txt)을 설치합니다. 에이스카운터 변수에 각 속성 값을 담고 있는 변수를 세팅해 주세요.
구매완료 스크립트는 항상 공통 스크립트 보다 상단에 위치해야 합니다. (공통 스크립트는 필수 설치)
수집된 구매 데이터는 [**\[분석통계>구매자\]**](https://www.acecounter.com/stat/view/statview14_2.amz) 메뉴에서 확인하실 수 있습니다.
### 3-4. 결제수단 분석
> **결제수단 분석이 가능한 경우**
구매완료 페이지가 있고, 구매완료 페이지에 '결제수단' 정보 확인이 가능한 경우 설치 및 분석이 가능합니다. 결제수단 분석은 '이커머스' 또는 '모바일 웹' 버전에서 확인할 수 있습니다.
> **결제수단 변수 직접 설치하기**
1\. 분석 스크립트 파일을 다운로드합니다.
2\. 분석 스크립트 파일 sample 폴더에 있는 구매완료 분석 스크립트 파일(3\_Buy\_Finish.txt)을 구매완료 페이지에 설치합니다.
3\. 결제정보 세팅에서 페이지 소스에 확인되는 결제수단 변수를 세팅합니다.
> 결제수단 변수: var m\_pay='무통장 입금; [**\[설치 가이드 확인\]**](https://nhnent.dooray.com/share/drive-files/ajjt1imxmtj4.5oAg72cXTlafotXrsz1MmA)
> **결제수단 분석&활용**
네이버페이에는 '결제형'과 '주문형' 두 가지 서비스 타입이 있습니다.
* **결제형**은 결제만 네이버 페이로 하고, **'쇼핑몰 구매완료 페이지'에 돌아오는 형태로** 에이스카운터 스크립트로 분석이 가능합니다.
* **주문형**은 네이버 ID 로그인 후 **네이버 쇼핑으로 넘어가 구매완료까지 이뤄지므로** 에이스카운터 스크립트로 분석이 불가합니다.
* 주문형의 경우 [**네이버페이 API 연동 가이드**](https://www.acecounter.com/www2/files/AceCounter_NPAY_%EC%97%B0%EB%8F%99%EA%B0%80%EC%9D%B4%EB%93%9C.pdf)를 확인하셔서 직접 연동 세팅 후 분석이 가능합니다. (대행 설치 불가)
> **고객이 가장 선호하는 결제 수단을 편리하게 배치**
많은 쇼핑몰들이 호스팅사의 기본 배치를 결제 수단 선택에도 사용하고 있는데요! 배치 순서, 옵션들을 최대한 활용하여 구매완료까지 매끄럽게 도달하게 할 수 있습니다. 결제수단을 어떻게 배치해야 하는지 고민된다면 데이터를 확인하여 결정해 보세요.
> **신용카드별 구매 분석도? Yes**
결제수단명을 카드명으로 세분화하여 세팅하는 경우 카드별 구매 데이터 분석도 가능합니다. 카드사 청구할인, 카드사별 쿠폰 등의 이벤트를 진행했다면 해당 기간 동안 특정 카드의 매출이 얼마나 올랐는지 클릭만으로 간편하게 분석할 수 있습니다. 기존 데이터를 기반으로 이벤트 참여율 등을 예측하고 새로운 프로모션도 계획해 볼 수 있습니다.
> **결제수단 데이터 확인하기**
[**\[구매자 > 결제수단 분석\]**](https://www.acecounter.com/stat/view/statview14_13.amz) 통계 화면
[**\[구매자 > 구매분석 > 구매상세 팝업\]**](https://www.acecounter.com/stat/popup/4_2_detail.amz) 내 개별 구매자의 결제 수단 정보 확인
## 4. 내부 검색어
***
### 4-1. 내부 검색어 분석이란?
사이트 내에 내부 콘텐츠 검색 기능이 있는 경우 방문자가 사이트에 유입하여 어떤 검색어(키워드)로 내부 콘텐츠를 검색하고 관심을 가지는지 분석하여 제공합니다.
\[사이트 검색창 예시]
### 4-2. 내부 검색어 분석이 필요한 이유
방문자들은 검색에 익숙해져 있고 원하는 것을 검색해서 빠르게 찾길 원합니다.
검색어와 관련된 정확한 상품과 콘텐츠가 노출된다면 자연스럽게 전환으로 이어질 것이며,
검색 결과가 없거나 콘텐츠가 미비한 경우 이탈이 생길 수 있습니다.
내부 검색어 분석을 통해 **방문자들이 사이트에 원하는 것을 파악**할 수 있습니다.
많은 사람이 사이트에 방문하도록 마케팅을 하는 것도 중요하지만
사이트 안에서 방문자들이 어떤 행동을 하는지 분석하는 것 또한 매우 중요합니다.
### 4-3. 내부 검색어 분석을 위한 환경변수 설치
내부 검색어는 사이트 내부에서 **어떤 검색어를 많이 검색하는지** 분석하기 위한 설치입니다.
내부 검색을 처리하는 페이지에 다운로드 파일의 samples 폴더 내에 위치한
제품검색 분석 스크립트 파일(4-Product\_Search\_m.txt)을 설치합니다.
내부 검색 분석 결과는 분석통계의 [**\[콘텐츠 > 내부 검색어\]**](https://www.acecounter.com/stat/view/statview9_8.amz)에서 확인하실 수 있습니다.