# 구 버전 스크립트 설치 가이드

{% hint style="info" %}
구 버전에 따라 설치 가이드를 확인해주세요.

* <mark style="color:blue;">프로</mark> 버전 : 공통 스크립트만 설치
* <mark style="color:orange;">이비즈</mark> 버전 : 공통 스크립트 + 환경 변수 스크립트(회원분석만)
* <mark style="color:purple;">이커머스 / 모바일웹</mark> 버전 : 공통 스크립트 + 환경 변수 스크립트(회원분석/구매분석/내부검색어 모두 해당)
  {% endhint %}

{% tabs %}
{% tab title="공통 스크립트" %}

#### 1. 공통 스크립트 기본 설치 위치 <a href="#common-location" id="common-location"></a>

복사 또는 다운로드 한 공통 스크립트를 운영하시는 사이트에 설정된 소스를 고려하여 알맞은 위치에 삽입하시기 바랍니다.

기본적인 분석 스크립트의 삽입 위치는 HTML 파일 내 위치한 <mark style="color:red;">**\<body>와 \</body>사이 또는 \<head>와 \</head> 사이**</mark>입니다.

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

※ 환경 변수를 세팅하는 경우, 공통 스크립트는 환경 변수보다 하단에 위치해야 하므로 Footer(하단 공통부분)에 설치하는 것을 권장합니다.

#### 2. 공통 파일이 있는 경우(Header 또는 Footer) <a href="#common-file" id="common-file"></a>

복사 또는 다운로드 한 공통 스크립트를 사이트의 <mark style="color:red;">**Header(상단 공통부분) 또는 Footer(하단 공통부분)**</mark>에 설치합니다.

1. FTP에 접속하여 도메인에 연결되는 기본 페이지를 확인
2. 기본 페이지인 index.php 파일을 열어 include 파일이 있는지 확인
3. 확인한 공통 파일이 다른 페이지에서도 include 되고 있는지 확인

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

만약 모든 페이지에서 copy.php 파일을 include 하는 경우

4\. copy.php 파일을 열어 분석 스크립트 붙여 넣어주세요

5\. 수정한 파일을 저장하고, 업로드합니다

#### 3. 공통 js 파일이 있는 경우 <a href="#common-js" id="common-js"></a>

공통 js 파일이 ‘common.js’ 인 경우

1. 웹 페이지의 소스 내 common.js 파일의 경로와 FTP 서버 내 common.js 파일의 경로가 동일해야 합니다.
2. common.js 파일 내 하단에 자<mark style="color:red;">**바스크립트 선언문을 삭제한 공통 스크립트(acecounter\_script.txt)를 삽입**</mark>합니다.

※ 분석 스크립트를 설치하실 때 \<script language='javascript'>와 \</script>가 중복 삽입될 경우 분석 스크립트가 정상적으로 작동하지 않습니다.

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

일반적으로 페이지에 동적인 콘텐츠를 표현하기 위해, 다양한 형태의 javascript(자바스크립트)를 사용하여 개별 js 파일 (javascript 업로드 형태)로 저장하여 관리합니다.

js 파일이 대부분의 페이지에 설치되어 있다면, 분석 스크립트의 \<script language='javascript'>와 \</script>사이의 내용을 js 파일에 복사하여 삽입해주세요.

#### 4. 공통 파일이 없는 경우 <a href="#no-common-file" id="no-common-file"></a>

공통 파일이 없는 경우, 분석하고자 하는 <mark style="color:red;">**모든 콘텐츠 HTML 페이지 하단에 공통 스크립트를 설치**</mark>하여야 합니다.

분석 스크립트가 적용되어 있는 페이지에 대해서만, 데이터 수집/분석이 가능합니다.

에이스카운터 홈페이지를 예를 들면 제품 소개, 교육센터 메뉴의 페이지뷰를 확인하고 싶으신 경우 각각의 페이지 소스에 분석 스크립트를 설치해야 합니다.

분석하고자 하는 전체 페이지에 공통 스크립트가 삽입될 수 있도록 설치해 주시기 바랍니다.

<figure><img src="/files/fAjZOGuhWazl2sGzXIU5" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="환경 변수 스크립트" %}

### 1. 환경 변수 - 회원 분석 <a href="#member-analysis" id="member-analysis"></a>

회원 분석, 구매 분석, 내부 검색어 데이터 확인을 위한 스크립트에 해당됩니다.

#### 1-1. 환경 변수 기본 설치 위치 <a href="#member-location" id="member-location"></a>

공통 스크립트 보다 <mark style="color:red;">**상단에 환경 변수 스크립트가 삽입**</mark>되어야 정상적인 분석이 가능합니다.

하단에 보여는 환경 변수 스크립트 예시를 운영하시는 사이트에 알맞게 설정해 주세요.

<figure><img src="/files/4PqdDiJymf05N3F3VjGD" alt=""><figcaption></figcaption></figure>

#### 1-2. 회원가입 / 해지 페이지 설치 <a href="#member-signup" id="member-signup"></a>

‘회원가입 아이디(\_jid)’에 대해 실제 사용 중인 변수와 연동할 수 있도록 설정해야 합니다.

PHP 사이트의 경우 '\<?=$ID변수?>'

ASP 사이트의경우 ‘<%=ID변수%>’

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

※ 회원에 대한 아이디별 분석을 위해서는 <mark style="color:purple;">**회원 아이디별 분석 신청**</mark>이 필요합니다.

#### 1-3. 로그인 페이지 설치 <a href="#member-login" id="member-login"></a>

로그인한 사용자의 정보를 에이스카운터 변수에 세팅합니다.

(로그인 처리 페이지에 설치)

* 기본항목 : ID, 나이, 성별, 결혼 여부
* 직접 세팅 : \_ud1, \_ud2, \_ud3 (예: 회원 구분, 지역 등 구분 원하는 항목에 대해 직접 정의 가능)

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

<figure><img src="/files/5TVmZ5g739XO8l4SIgEd" alt=""><figcaption></figcaption></figure>

※ \_ud1, \_ud2, \_ud3 변수를 이용하기 위해서는 에이스카운터 관리자 페이지의 <mark style="color:purple;">**\[설정 > 회원그룹]**</mark>에서 사용자 정의 변수 설정이 필요합니다.

#### 1-4. 설치된 로그인 페이지 소스 예시 <a href="#member-login-example" id="member-login-example"></a>

회원 로그인 시 메인 페이지로 재호출 시키는 경우 소스 보기가 되지 않을 수 있습니다.

설치가 완료되면 <mark style="color:red;">**\[분석통계 > 회원 분석]**</mark>에서 확인하실 수 있습니다.

***

### 2. 환경 변수 - 구매 분석 <a href="#purchase-analysis" id="purchase-analysis"></a>

#### 2-1. 제품 상세 페이지 설치 <a href="#purchase-product-detail" id="purchase-product-detail"></a>

**제품의 노출수, 구매율, 장바구니 담긴수, 이탈 매출** 분석을 위한 설치입니다.

제품 상세 페이지에 다운로드 파일의 samples 폴더 내에 위치한 제품상세 분석 스크립트 파일

<mark style="color:red;">(1-Product\_Detail.txt)</mark>을 설치하고 에이스카운터 변수에 각 속성 값을 담고 있는 변수를 세팅해 주세요.

제품 상세 스크립트는 항상 공통 스크립트 보다 상단에 위치해야 합니다. (공통 스크립트는 필수 설치)

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

#### 2-2. 장바구니 페이지 설치 <a href="#purchase-cart" id="purchase-cart"></a>

**장바구니 수량 변경, 포기한 제품, 이탈 매출** 분석 등을 위한 설치입니다.

장바구니 페이지에 다운로드 파일의 samples 폴더 내에 위치한 장바구니 분석 스크립트 파일

<mark style="color:red;">(2-Cart\_Inout.txt)</mark>을 설치합니다. 에이스카운터 변수에 각 속성 값을 담고 있는 변수를 세팅해 주세요.

장바구니 스크립트는 항상 공통 스크립트 보다 상단에 위치해야 합니다. (공통 스크립트는 필수 설치)

※ 장바구니 액션 함수 적용 후 분석 스크립트를 삭제하는 경우 스크립트 오류가 발생할 수 있습니다. 따라서 try-catch 예외 처리 구문 안에 액션 함수를 적용해야 하며, 분석 스크립트를 삭제하는 경우 적용한 액션 함수도 삭제해야 합니다.

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

#### 2-3. 장바구니 수량 변경 액션 처리 예제 <a href="#purchase-cart-update" id="purchase-cart-update"></a>

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

#### 2-4) 구매완료 페이지 설치

**구매한 제품, 수량, 매출액, 구매율, 구매당 매출액** 분석 등을 위한 설치입니다.

구매완료 페이지에 다운로드 파일의 samples 폴더 내에 위치한 구매완료 분석 스크립트 파일

<mark style="color:red;">(3-Buy\_Finish.txt)</mark>을 설치합니다. 에이스카운터 변수에 각 속성 값을 담고 있는 변수를 세팅해 주세요.

구매완료 스크립트는 항상 공통 스크립트 보다 상단에 위치해야 합니다. (공통 스크립트는 필수 설치)

***

### 3. 내부 검색어 <a href="#internal-search" id="internal-search"></a>

사이트 내부에서 검색 기능을 제공하는 경우 **어떤 검색어를 많이 검색하는지** 분석하기 위한 설치입니다.

다운로드 파일의 환경 변수 파일(variable) 내에 내부 검색어<mark style="color:red;">(var \_skey = ‘’;)</mark>를 설정해 주세요.

내부 검색 분석 결과는 분석통계의 <mark style="color:red;">**\[콘텐츠 > 내부 검색어]**</mark>에서 확인하실 수 있습니다.

<figure><img src="/files/zY1CyZJ1Pi1Qar812JIF" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# 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://acecounter.gitbook.io/guide/pre/script.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.
