통합Finteza JavaScript Client설치

추적 스크립트 설치 방법

추적 스크립트를 추가하려면, 웹사이트 페이지에 간단한 코드를 삽입하세요. 웹사이트를 Finteza 패널 에서 열고 Settings으로 이동:

웹사이트의 추적 코드 받기

추적 코드를 복사하고 <head></head> 태그 안의 모든 웹사이트 페이지에 붙여넣기 하세요.

아직 Finteza에 웹사이트를 등록하지 않았다면, Websites 섹션에서 Add를 클릭하세요. 웹사이트 이름과 주소를 지정하여 즉시 추적 코드를 수령하세요.


반드시 웹사이트의 모든 페이지에 추적 코드를 삽입해야 하며, 그렇지 않으면 방문 통계가 완성되지 않습니다.


#

삽입 코드는 다음과 같습니다:

<script type="text/javascript">
  (function(a,e,f,g,b,c,d){a[b]||(a.FintezaCoreObject=b,a[b]=a[b]||function(){(a[b].q=a[b].q||[]).push(arguments)},a[b].l=1*new Date,c=e.createElement(f),d=e.getElementsByTagName(f)[0],
   c.async=!0,c.defer=!0,c.src=g,d&&d.parentNode&&d.parentNode.insertBefore(c,d))})
  (window,document,"script","{SCRIPT_URL}","fz");
  fz("register","website","{WEBSITE_ID}");
</script>

복사한 코드에서, {SCRIPT_URL} 은 Finteza 서버에서 다운 받은 메인 추적 스크립트의 URL 주소로 교체됩니다. {WEBSITE_ID} 는 Finteza 패널에서 웹 사이트 ID로 교체됩니다

코드를 삽입 후, 다음 fz() 함수가 웹페이지의 메인 컨텍스트 창에 나타납니다. 가용성을 확인하려면, 콘솔에서 window.fz 를 실행하세요. 이 함수는 Finteza와의 상호작용을 위한 메소드 호출에 사용됩니다 웹사이트 등록 예시:

fz("register","website","{WEBSITE_ID}");

만약 fz 함수 이름이 이미 사용 중이라면, 다른 이름을 사용하세요. 그러기 위해서는, 메소드 선언을 변경하고 추적 코드에서 두 곳을 호출하세요:

(window,document,"script","{SCRIPT_URL}","fz-your-name");
fz-your-name("register","website","{WEBSITE_ID}");

(Finteza 서버에서 다운로드 한) 메인 추적 스크립트는 다른 요소와 관계 없이 페이지에 비동기적으로 삽입됩니다. 따라서, 메인 페이지의 로딩 속도가 느려지지 않습니다.

웹사이트 등록 매개변수 #

본 삽입 코드에는 웹 사이트 방문 이벤트를 Finteza로 보내는 fz("register", ...) 함수 호출이 포함되어 있습니다. 이 함수는 몇 가지 추가적인 매개변수를 지원합니다:

매개변수

유형

설명

trackHash

boolean

웹 페이지 해시 (앵커) 변경 사항 추적을 사용하세요.
 
기본적으로, 웹 페이지 내의 앵커 링크를 통한 전환은 추적되지 않습니다. 웹 페이지가 처음 열린 것에 한해서 만 페이지 뷰로 간주됩니다. 이와 같은 처리 방법은 전체 콘텐츠가 하나의 긴 페이지(단일 페이지 애플리케이션)에 위치하는 웹사이트의 경우에는 적합하지 않을 수 있습니다.

 

본 매개변수를 활성화하여 Finteza가 웹 페이지 URL의 해시 변경 사항을 추적하도록 하세요. 해시가 변경될 때마다 새로운 웹 페이지 방문 이벤트가 시스템에 전송됩니다.

trackLinks

boolean

웹 사이트 페이지에 있는 외부 링크에서 클릭을 추적하세요.

 

웹사이트에서 여러 외부 링크를 사용하는 경우 (예, 광고 네트워크와의 협력), 해당 매개변수로 사용자가 어떻게 웹사이트를 떠나는지 정확하게 알아낼 수 있습니다.

 

외부 링크를 클릭할 때마다, 특별한 이벤트가 Finteza로 전송됩니다. 이 같은 이벤트에 대한 보고서는 다음 웹사이트의 Pages — Exits에서 확인할 수 있습니다: Finteza 패널.

timeOnPage

boolean

사용자가 웹 페이지에서 보낸 시간을 정확하게 산출하세요.

 

기본적으로, 매개변수는 입장 시간과 내부 전환 시간의 차이로 산출됩니다. 그러나, 이러한 산출법은 이후 내부적인 웹 페이지 전환이 없는 마지막 방문 페이지에는 적용이 불가능합니다.

 

산출이 가능한 경우, 자바스크립트 클라이언트는 Finteza에 특별한 이벤트를 15초 단위로 전송해 사용자가 여전히 웹 페이지에 있음을 알립니다. 따라서, 단일 보기에서도 소요 시간을 보다 정확하게 추적 할 수 있습니다.

 

해당 이벤트는 사용자가 웹 페이지에서 보낸 처음 2분 동안만 전송됩니다.

추가 매개 변수 사용 예시:

fz( "register""website", {
    "id":"cacgfaknbbubiozaeidyvhoisrajbdvjqg",
    "trackHash"true,
    "trackLinks"true,
    "accurateBounceRate"true,
    "timeOnPage"true
} );

콘텐츠 보안 정책 사용 시 #

콘텐츠 보안 정책 표준은 웹사이트 페이지에 악성 코드를 도입하는 것과 관련된 공격을 예방하도록 구축되었습니다. 해당 보안 정책을 사용하는 경우, 각각의 웹 페이지 헤더에 상응하는 선언으로 Finteza 추적 스크립트가 문자열로 다운로드 되는 웹 사이트에 대한 예외를 추가하세요. 예:

Content-Security-Policy: script-src 'self' content.mql5.com;

그렇지 않으면, 브라우저가 core.js 로딩을 차단하게 되어 웹사이트 통계 수집이 불가능해집니다.

X-DNS-Prefetch-Control을 이용한 다운로드 가속화 #

추적 스크립트 다운로드를 가속화하려면, X-DNS-Prefetch-Control 명령을 모든 웹사이트 페이지의 헤더에 추가하세요:

<meta http-equiv='x-dns-prefetch-control' content='on'>
<link rel='dns-prefetch' href='https://content.mql5.com'>

스크립트의 위치를 브라우저에 표시해주기 때문에, 스크립트 자체를 다운로드 할 때 시간을 들이지 않고 (웹 페이지를 다운로드 시) 주소를 즉시 해결할 수 있습니다.

웹 사이트를 통한 스크립트 다운로드 프록시 처리 #

Finteza 스크립트 다운로드가 차단되지 않도록 하려면, 웹사이트를 이용해 프록시 처리하는 것을 권장합니다.