비공개 접근 정보를 노출하지 않고 정적 웹사이트에 Stats4U 설치하기
기술 검토 완료:
이 글의 내용
정적 웹사이트는 자체 호스트에서 PHP를 실행하거나 방문자 데이터베이스를 유지하지 않아도 Stats4U 카운터를 로드할 수 있습니다. 브라우저가 Stats4U에서 삽입 리소스를 불러오고 집계는 서비스에서 이루어집니다. 설치 성공 여부는 게시된 HTML, 호스트 정책, 방문자 브라우저가 필요한 요청을 허용하는지에 달려 있습니다.
- 공개 코드와 비공개 접근 정보 분리
- 템플릿에 삽입 코드 게시
- 요청과 보고서 한계 확인
공개 삽입 코드 준비하기
- 새 카운터는 디자인을 선택하고 생성된 코드를 복사합니다. 기존 카운터는 번호를 유지합니다. 사이트를 편집하기 전에 비공개 관리 링크를 안전하게 저장합니다. 계정 없이 작동하는 카운터라도 소유자 접근 권한은 보호해야 합니다.
- 카운터가 표시될 공통 HTML 템플릿 위치에는 공개 삽입 코드만 넣습니다. 정적 사이트 생성기는 이 템플릿을 게시되는 페이지에 반영해야 합니다. 배포 후 생성된 HTML을 확인합니다. 원본 컴포넌트를 편집했다는 사실만으로 실제 페이지에 코드가 포함됐다고 볼 수는 없습니다.
- 소유자 토큰, 관리 링크, API 키는 공개 HTML과 저장소에 넣지 않습니다. 일반 삽입에는 카운터 번호와 공개 디자인 옵션이면 충분합니다. 커밋하기 전에 복사한 전체 내용을 검토하고, 비공개 북마크를 설치 지침으로 게시하지 않습니다.
호스트에서 지원하는 설치 방식 사용하기
외부 스크립트를 허용하는 곳에서는 생성된 JavaScript 코드와 호스팅된 s4u.js 주소를 사용합니다. 그래야 설치된 코드에 업데이트가 반영됩니다. 내려받은 사본은 별도로 갱신하지 않으면 복사한 버전에 머무르며, 웹사이트를 변경해도 자동으로 갱신되지 않습니다.
이미지, Markdown, BBCode만 허용되는 곳에서는 해당 형식으로 생성된 코드를 사용합니다. 이미지 요청을 집계할 수 있지만 페이지 세부 정보는 HTTP Referer나 명시적으로 제공한 주소에 따라 달라집니다. 선택 사항인 자동 이벤트에는 JavaScript가 필요하며, 이미지만으로는 확인된 폼 처리 결과를 관찰할 수 없습니다.
게시 결과를 안전하게 확인하기
접근이 허가된 자체 테스트 페이지를 브라우저 네트워크 패널에서 확인합니다. 카운터 번호, 중복 코드, 차단된 리소스를 살핍니다. Content Security Policy, 편집기 필터, 브라우저 확장 프로그램이 스크립트나 이미지 로드를 막을 수 있습니다. 배지를 표시하기 위해 광범위한 보안 보호를 해제하지 않습니다.
일반 페이지 방문도 집계될 수 있습니다. 설치 진단을 위해 계수 이미지 주소를 수동으로 열거나 반복 새로고침하지 않습니다. 보이지 않는 디자인은 배지가 없어도 정상적으로 로드될 수 있습니다. 무언가를 표시하려고 코드를 추가하기보다 요청과 해당 보고서를 확인합니다.
카운터가 관찰할 수 없는 내용 이해하기
카운터는 Stats4U에 도달한 요청과 지원되는 측정값을 보고합니다. 정적 호스트가 처리한 모든 요청, 서버 오류, 실패한 다운로드, 대역폭은 볼 수 없습니다. 해당 정보에는 호스트에서 제공하는 로그나 자체 모니터링이 필요합니다. 정적 호스팅이라고 해서 이런 정보가 반드시 제공되지 않는 것은 아닙니다.
정적 사이트도 콘텐츠 유지 관리, 게시 계정 보호, 적절한 개인정보 안내가 필요합니다. 카운터가 이런 책임을 없애 주지는 않습니다. 선택 사항인 캠페인 또는 이벤트 측정은 설정을 이해한 뒤에만 활성화합니다. 기본 코드를 설치한다고 모든 고급 보고서에 데이터가 채워지는 것은 아닙니다.
올바른 삽입 방식 선택 및 게시
설치 안내에서는 사용 가능한 코드 형식과 삽입 후 확인 방법을 설명합니다.
설치 안내 열기