선택적 측정 활성화
분석 업계에서 가장 가벼운 JavaScript 스니펫 중 하나를 보유하게 되어 자랑스럽습니다.
기본 스크립트의 옵션 수를 근본적으로 제한하여 이를 달성했습니다. 대신 Histat을 사용하려는 방식에 맞게 조정된 선택적 스크립트 확장으로 향상된 측정을 제공합니다. 이 접근 방식을 사용하면 실제로 웹사이트에서 사용될 코드만 로드할 수 있습니다.
Histat 계정에 새 사이트를 추가할 때 또는 사이트 설정의 일반 섹션에 있는 사이트 설치 영역에서 이러한 선택적 측정을 활성화할 수 있습니다.
:::팁 측정 선택에 따라 스니펫이 변경됩니다. 사이트에 삽입해야 하는 추적 스니펫은 향상된 측정 선택에 따라 변경됩니다. 선택적 측정을 변경할 때는 모든 추적이 예상대로 작동하도록 최신 스니펫을 사이트에 삽입해야 합니다. :::
다음은 선택적 측정 목록입니다.
| 선택적 측정 | 설명 |
|---|---|
| 아웃바운드 링크 | 자동으로 아웃바운드 링크의 클릭 추적 |
| 파일 다운로드 | 자동으로 파일 다운로드 추적 |
| 404 오류 페이지 | 자동으로 404 오류 페이지 추적 |
| 해시된 페이지 경로 | URL 해시 기반 라우팅에서 #을 사용하는 페이지 경로를 자동으로 추적 |
| 사용자 정의 이벤트 | 링크 클릭, 양식 제출 및 기타 HTML 요소 클릭과 같은 사용자 정의 이벤트 추적을 허용합니다. |
| 사용자 정의 속성 | 페이지 뷰 또는 사용자 정의 이벤트를 보내 사용자 정의 메트릭을 만들 때 사용자 정의 속성(Google 애널리틱스에서 사용자 정의 차원이라고도 함)을 첨부할 수 있습니다. |
| 전자상거래 수익 | 사용자 정의 이벤트에 동적 금전적 가치를 할당하고 수익 귀속을 추적할 수 있습니다. |
고급 추적 옵션
위의 목록(script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js 및 script.revenue.js) 외에도 몇 가지 고급 추적 옵션을 사용할 수 있습니다. 이러한 옵션은 사이트 온보딩 목록에 포함되지 않으므로 추적 스니펫에 수동으로 삽입해야 합니다.
| 확장 프로그램 | 설명 |
|---|---|
| script.compat.js | Internet Explorer에서 사용자 추적(≥IE11)을 위한 호환성 모드 |
| script.local.js | 하이브리드 앱에서 유용한 로컬호스트에서도 분석이 추적되도록 허용 |
| script.manual.js | 페이지뷰를 자동으로 트리거하지 않음 . 또한 식별자를 사용하여 URL을 수정하기 위해 사용자 정의 위치 지정을 허용합니다. 사용자 정의 쿼리 매개변수를 추적하는 데 사용할 수도 있습니다. |
추적 스니펫을 수동으로 변경하는 방법
예를 들어, 스니펫의 기본 스크립트 이름은 script.js입니다. 웹사이트가 로컬 호스트에 있고 해당 방문을 추적하려는 경우 다른 확장자 script.local.js로 스크립트를 로드하는 옵션이 있습니다.
이 경우 사이트에 삽입해야 하는 스니펫은 다음과 같습니다(data-domain 속성을 Histat에 추가한 도메인으로 변경해야 함):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
이러한 확장자를 원하는 대로 혼합하고 일치시키고 결합할 수 있습니다. 예를 들어, 해시 기반 라우팅과 아웃바운드 링크 클릭 추적을 모두 사용하고 싶다면 다음과 같이 결합할 수 있습니다. script.hash.outbound-links.js.
이 경우 사이트에 삽입해야 하는 스니펫은 다음과 같습니다(data-domain 속성을 Histat에 추 가한 도메인으로 변경해야 함):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
또는 script.revenue.js 확장 프로그램을 사용하여 전자상거래 수익을 추적하고 script.local.js 확장 프로그램을 사용하여 로컬호스트 트래픽을 추적하려는 경우 스니펫은 다음과 같아야 합니다.
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
그리고 사이트에 해당 스니펫 하나만 삽입하면 되며 다른 것은 필요 없습니다.
script.compat.js
기본 Histat 스크립트는 구성 옵션을 읽기 위해 document.currentScript API를 사용하기 때문에 Internet Explorer에서 작동하지 않습니다. script.compat.js 확장을 포함하고 스크립트 태그에 id="plausible"을 정의하여 Histat을 호환 모드에서 실행할 수 있습니다. 그러면 Histat이 자신을 찾을 수 있습니다. 이것은 IE11 이상에서만 작동합니다. 다음과 같이 표시되어야 합니다.
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
기본적으로 Histat 스크립트는 처음 로드될 때 페이지 뷰를 트리거합니다. 또한 History API에 리스너를 연결하고 history.pushState를 사용하면 자동으로 페이지 뷰를 트리거합니다. 이것은 대부분의 웹사이트에 유용하지만, 웹사이트에서 페이지뷰가 트리거되는 시점을 완벽하게 제어하려는 경우 수동 모드도 제공합니다.
이것의 사용 사례 중 하나는 Turbo(이전 Turbolinks)를 사용할 때입니다. 이 경우 사용하는 라이브러리에 따라 turbo:load 또는 turbolinks:load 브라우저 이벤트에서 Histat 페이지뷰를 수동으로 트리거해야 합니다. 다음은 그 방법입니다.
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- `plausible` 함수를 정의하여 이벤트를 수동으로 트리거 -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) </script>
<!-- turbolinks 탐색에서 페이지뷰 트리거 -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
turbolinks를 사용할 때는 터보 탐색 중에 Histat 스크립트가 로드되어 실행되지 않도록 해야 합니다. 스크립트를 웹사이트의 <head> 섹션으로 이동하거나 data-turbo-eval="false" 속성을 사 용해야 할 수도 있습니다.
manual.js를 사용할 때 'pageview'로 모든 스크립트 호출은 같은 페이지에서 호출하더라도 별도의 페이지뷰로 계산됩니다.
페이지 URL에 사용자 지정 위치 지정
또한, manual 스크립트 확장을 사용하면 이벤트에 u라는 특수 옵션을 제공할 수 있습니다. 이를 통해 페이지의 URL을 지정할 수 있으며 사용자 지정 위치를 지정하는 데 사용할 수 있습니다.
특히 URL에 사용자 고유 식별자가 포함된 여러 페이지를 편집하고 집계하는 데 유용합니다.
전체 페이지 URL에 대한 사용자 지정 쿼리 매개변수 추적
기본적으로 Histat은 개인 정보 보호를 위해 ref, source, utm_source, utm_medium, utm_campaign, utm_content 및 utm_term의 모든 쿼리 매개변수를 제거합니다.
즉, yoursite.com/blog/index.php?article=some_article&page=11과 같은 페이지는 Histat 대시보드의 "인기 페이지" 보고서에서 yoursite.com/blog/index.php로 보고됩니다.