2. 공통스크립트 설치 - nhn/ace.guide.script GitHub Wiki

공통스크립트 설치 방법 가이드입니다.

AceCounter+ 스크립트가 설치 되어 있는 페이지만 분석/수집이 가능합니다.

구성

2.1 설치 방법

서비스 관리 페이지에서 복사 및 다운로드(AceCounter Plus_Script_v9.txt) 한 공통스크립트를 웹페이지에 노출시킵니다.
공통스크립트는 가급적 footer 영역에 노출 시키기를 권장합니다.

Q : 반드시 footer영역을 사용해야 하나요?
footer 영역이 없다면 head, body 영역에 삽입해도 동작에 문제는 없습니다.
다만 상세분석을 위한 환경변수 삽입시 문제를 발생시킬 수 있기 때문에 아래 가이드를 참조 부탁드립니다.

- 참고사항)  
사용자가 페이지 로딩이 완료되기 전에 브라우저를 종료하거나 다른 링크(컨텐츠 클릭)로 이동할 경우
수집률이 다소 차이가 있을 수 있습니다.

a. 공통 파일로 설치하기 (권장) - Javascript

별도의 common파일을 생성하고 노출을 원하는 페이지에 common파일을 링크합니다.

Q : 공통파일을 사용하는 이유는 뭔가요?
일반적으로 웹페이지는 다양하나 형태의 동적인 컨텐츠를 관리하기 때문에 AceCounter+ 공통스크립트는 별도의 js파일로 분리하여 관리하시기를 권장합니다.

설치2

<footer>
    <script type="text/javascript" src="AcpCommon.js">    
    </script>
</footer>

b. 직접 설치하기

노출을 원하는 페이지에 script태그를 사용하여 공통스크립트를 직접 노출 시킵니다.

공통 파일을 사용하지 않는 경우 모든 콘텐츠 HTML 페이지에 공통스크립트를 설치해야 합니다.

설치1

<footer>
    <script type="text/javascript">
        var _AceTM = (function (_j, _s, _b, _o, _y) {
            //중략
        })(0,'0', 'atm.acecounter.com','ac.js',window._AceTM||{});
    </script>
</footer>

c. 기타 - php 설정 확인

FTP 접속후 도메인에 연결되는 기본 페이지 확인 : 기본페이지 index.php

기본페이지인 index.php 파일을 열어 include 파일이 있는지 확인 :

index.php

</div>
<? include("AcpCommon.php"); ?>

AcpCommon.php 파일이 다른페이지에도 include 되고 있는지 확인 :

other.php

</div>
<? include("AcpCommon.php"); ?>


2.2 설치 시 주의사항 - 필독

AceCounter+ 공통스크립트 설치시 자주 발생하는 사항입니다.

a. 공통스크립트 Service ID 및 태그 값 확인

일반적으로 서비스 관리 페이지에서 제공해드리는 공통스크립트에는 고객님에 해당하는 Service ID와 태그 값이 자동으로 입력 되어있습니다.

var _AceTM = (function (_j, _s, _b, _o, _y) {
        //중략
    })({ServiceID},{tag}, 'atm.acecounter.com','ac.js',window._AceTM||{});

여러개의 서비스에서 AceCounter+ 를 사용 중에 간혹 다른 서비스에 공통스크립트를 그대로(혹은 복사) 사용하시는 경우가 종종 발생합니다.

반드시 신규 서비스 사용시 서비스 관리 페이지를 통하여 다운로드 하시기를 권장해드립니다.

b. Script 태그 중복 삽입 에러

설치 페이지 및 설치 파일(AceCounter Plus_Script_v9.txt)에서 제공하는 스크립트는 script 태그가 포함되어 있습니다.
아래와 같이 중복 삽입된 사례가 많으니 주의하십시요.

AcpCommon.js :

<!--AceCounter-Plus Log Gathering for AceTag Manager V.9.2.20170103-->
<script type="text/javascript">
var _AceTM = (function (_j, _s, _b, _o, _y) {
        //중략
    })(0,'0', 'atm.acecounter.com','ac.js',window._AceTM||{});
</script>
<!--AceCounter-Plus Log Gathering for AceTag Manager End -->

고객페이지.html :

<footer>
    <script type="text/javascript" src="AcpCommon.js">
        //AcpCommon.js 내에 script태그가 존재하여 에러 발생!!!
    </script>
</footer
⚠️ **GitHub.com Fallback** ⚠️