설명
플러그 앤 플레이 워드프레스용 개인정보 보호 친화적인 애널리틱스
코코 애널리틱스는 워드프레스 사이트를 위한 개인정보 보호 친화적인 분석 플러그인입니다.
외부 서비스를 사용하지 않으므로 어떠한 데이터도 제3자와 공유되지 않습니다. 개별 방문자에 대한 구체적인 정보는 수집되지 않으며 집계된 수만 수집됩니다.
광고를 판매하는 타사와 방문자 데이터를 공유하지 마세요. 대용량 추적 스크립트로 웹사이트 속도를 저하시키지 마세요. 데이터를 해방하고 소유하세요!
코코 애널리틱스를 사용하면 방문자의 개인정보를 완전히 존중하면서 중요한 통계에 집중할 수 있습니다.
라이브 데모는 여기에서 볼 수 있습니다.
코코 애널리틱스는 타사 서비스 계정이 필요 없는 무료 플러그인입니다. 자체 서버에서 완전히 실행됩니다.
특징
- 플러그 앤 플레이: 플러그인을 설치하고 활성화하면 통계가 자동으로 수집됩니다.
- 외부 서비스에 저장하지 않음: 어떤 데이터도 서버 밖으로 나가지 않습니다.
- 개인정보나 어떤 방문자 관련 정보도 추적되지 않습니다.
- 쿠키 없음: 사용할 추적 방법을 쿠키 기반, 쿠키 없음 또는 전혀 사용하지 않음 중에서 선택할 수 있습니다.
- 빠름: 페이지뷰 수백 건을 거뜬히 동시에 처리합니다.
- 가벼운: 페이지에 추가되는 자바스크립트는 500바이트(!)에 불과합니다. 데이터베이스에서 1년치 데이터는 10MB 미만의 저장 공간을 차지합니다.
- GDPR을 준수하도록 설계되었습니다.
- Metrics: 총 페이지뷰, 고유 페이지뷰, 참조자 URL은 모두 필수 지표입니다.
- 참조자 스팸: 참조자 스팸을 걸러 내는 차단 목록을 내장했습니다.
- REST API: REST API 엔드포인트를 통해 어디서나 데이터에 액세스할 수 있습니다.
- 캐시됨: 어떤 유형의 캐시에서 제공하는 페이지와도 완전히 호환합니다.
- Open-Source: 이 플러그인 코드는 GPL-3.0 이상의 라이선스를 따르는 오픈소스로 배포됩니다.
- 테스트 완료: PHP 8.4를 지원하지만 PHP 7.3까지 호환됩니다.
- AMP: 공식 AMP 플러그인을 쓴다면 AMP 기반 페이지도 추적합니다.
- 다른 플러그인에서 데이터 가져오기: 젯팩 통계 또는 버스트 통계에서 기록 데이터를 가져올 수 있습니다.
코코 애널리틱스 프로로 업그레이드
위에 나열된 모든 기능은 무료로 이용할 수 있습니다. 일부 추가 기능은 Koko Analytics Pro를 통해 이용할 수 있습니다:
- 이벤트 추적: 아웃바운드 링크 클릭, 양식 제출 또는 기타 유형의 사용자 지정 이벤트를 추적합니다.
- 이메일 보고서: 웹사이트의 가장 중요한 통계에 대한 일별, 주별 또는 월별 이메일 요약을 받아보세요.
- CSV 내보내기: 고급 분석을 위해 대시보드 데이터를 CSV로 내보낼 수 있는 기능입니다.
- 페이지뷰 열: WP 관리자 글 및 페이지 개요에서 바로 구성 가능한 기간 동안의 페이지뷰 수를 표시합니다.
- 관리자 표시줄: 워드프레스 관리자 표시줄에서 특정 페이지의 일일 페이지뷰를 표시합니다.
- 트래픽 급증 알림: 웹사이트에 트래픽이 급증하면 이메일 알림을 받습니다.
스크린샷
설치
코코 애널리틱스를 여러 방법으로 설치할 수 있습니다:
- 워드프레스 관리자 영역에서 플러그인 > 새 플러그인으로 가서, 코코 애널리틱스를 검색하고 지금 설치를 클릭하세요.
- WordPress.org에서 최신 버전을 내려받아 파일 압축을
/wp-content/plugins/
디렉토리에 푸십시오. - 깃허브에서 최신 배포판을 내려받아 파일 압축을
/wp-content/plugins/
디렉토리에 푸십시오.
플러그인을 설치하고 활성화하면 즉시 통계를 수집합니다.
대시보드를 보려면 WP 관리자 > 대시보드 > 애널리틱스로 이동하면 됩니다.
FAQ
-
방문자 프라이버시를 존중하나요?
-
네, 확실합니다. 코코 애널리틱스는 조회수만 집계해 저장합니다. 방문자를 특정할 정보를 추적하지 않습니다.
-
외부 서비스를 사용하나요?
-
아니오.
-
기본적으로 예로 설정되어 있지만 플러그인 설정 페이지에서 다른 추적 방법을 선택하여 쿠키 사용을 완전히 비활성화할 수 있습니다.
쿠키 기반 추적을 사용하는 경우, 쿠키 분석은 최대
24 hours
의 수명을 가진_koko_analytics_pages_viewed
이라는 이름의 단일 쿠키를 설정합니다. 이 쿠키는 서버에 개인 정보를 저장하지 않고도 고유한 페이지뷰와 재방문자를 정확하게 감지하는 데 사용됩니다.https://www.kokoanalytics.com/kb/does-koko-analytics-use-cookies/
-
코코 애널리틱스가 웹사이트 속도를 저하시키나요?
-
아니오, 이런 방식으로 탑재되는 플러그인은 방문자에게 표시되는 웹사이트를 느리게 만들지 않습니다.
- 페이지에 500바이트 미만의 단일 스크립트만 추가합니다.
- 모든 데이터 처리는 별도의 백그라운드 프로세스에서 이루어집니다.
- 모든 것이 서버에 있기 때문에, 이 플러그인은 아무런 DNS 조회 동작을 보태지 않으며 서버의 캐시 정책으로 효율을 높입니다.
https://www.kokoanalytics.com/kb/will-koko-analytics-slow-down-my-website/
-
이 플러그인의 코드는 깃허브에 있나요?
-
네, github.com/ibericode/koko-analytics를 살펴 보세요.
-
어디에서 추가로 문서를 찾을 수 있나요?
-
코코 애널리틱스 지식 베이스를 살펴 보세요.
-
페이지 방문자 수를 어떻게 나타낼까요?
-
현재 페이지에 방문자 수를 나타내는 쇼트코드로
[koko_analytics_counter]
를 사용할 수 있습니다.선택적 선언문 세 개를 취합니다:
days
: 일간 누적 조회수를 나타낼 과거 기간을 지정합니다. 기본값은 “3650”일입니다.global
: 사이트 전체 조회수를 나타낼지 또는 현재 페이지 조회수만 나타낼지 지정합니다. 기본값은 “false”입니다.metric
: “방문자” 또는 “페이지뷰” 중 하나입니다. 기본값은 “방문자”입니다.
선언문 사용 예시:
[koko_analytics_counter days="30" metric="pageviews" global="true"]
-
카테고리 및 태그 아카이브가 추적되지 않는 이유는 무엇인가요?
-
코코 애널리틱스는 현재 글, 페이지 및 기타 글 유형만 추적할 수 있습니다. 이는 코코 애널리틱스가 많은 저장 공간을 차지하는 URL이나 글 제목을 저장할 필요가 없도록 하기 위한 것입니다.
후기
기여자 & 개발자
“코코 애널리틱스 – 워드프레스를 위한 개인정보 보호 통계”(은)는 오픈 소스 소프트웨어입니다. 다음의 사람들이 이 플러그인에 기여하였습니다.
기여자변경이력
1.8.4 – Jun 18, 2025
- Backwards compatibility with older versions of the tracking script. This is a special update for sites refusing to serve the latest version of the Koko Analytics script because of very stubborn caching plugins…
1.8.2 – Jun 13, 2025
- PHP 8.0 이하에서 쿠키 없는 추적 수정.
1.8.1 – Jun 13, 2025
- 버전 1.8.0에서 도입된 최적화된 엔드포인트가 작동하지 않는 문제 수정
1.8.0 – Jun 12, 2025
- 새로운 추적 방법을 추가했습니다: 쿠키리스 추적.
- 쿠키 기반 추적을 사용하는 경우 쿠키 수명이 자정에 만료되도록 변경되었습니다(따라서 최대 24시간).
- 클라이언트 측 추적 스크립트를 간소화하여 이제 500바이트보다 작아졌습니다.
- 제외된 IP 주소는 이제 최적화된 엔드포인트에서 정상적으로 작동합니다.
- ‘모든 시간’에 대한 새로운 대시보드 날짜 사전 설정이 추가되었습니다.
- 작은 화면에서 많은 양의 데이터를 볼 때 막대가 보이지 않던 차트 문제를 수정했습니다.
1.7.4 – May 14, 2025
- 인라인 스크립트 태그를 인쇄하려면
wp_print_inline_script
함수를 사용합니다. - 최적화된 엔드포인트 파일의 존재 여부를 확인하려면
file_exists
대신is_file
를 사용하세요. - 최적화된 엔드포인트 파일이 플러그인 자체에서 생성된 경우 확인에 실패한 경우에만 제거합니다.
1.7.3 – Apr 15, 2025
- 설정 페이지 양식에 리퍼러를 명시적으로 추가합니다.
- 이전 메소드를 호출하는 WP CLI 명령 수정. 감사합니다 오스카 아르졸라!
1.7.2 – Mar 24, 2025
- 대시보드 위젯 차트에서 차트 그룹 옵션을 숨깁니다.
- Href 정규화 프로그램을 통해 대시보드 위젯에서 리퍼러 URL을 실행합니다.
- 차트 HTML 생성을 위한 아주 사소한 성능 최적화.
1.7.1 – Mar 10, 2025
- 일부 데이터베이스에서 데이터에 공백이 있는 경우 차트 막대가 제대로 정렬되지 않는 문제를 수정했습니다.
- 플러그인 패키지에
manifest.json
파일을 포함합니다. - 업로드 디렉터리가 있는지 확인한 후
scandir
를 호출하세요. - 통계가 없는 경우 쿼리 루프 블록이 모든 게시물을 표시하지 않도록 수정했습니다.
- 대시보드 HTML에 대한 일부 W3C 유효성 검사 경고를 해결합니다.
- Reddit 하위 도메인을 단일 리퍼러 항목으로 통합합니다.
1.7.0 – Feb 25, 2025
- WP 엔진에서 호스팅되는 사이트와의 호환성(PHP 확장자를 가진 파일을 WP 업로드 디렉터리에 쓸 수 없음).
- 최적화된 엔드포인트 파일에서 상대 경로를 사용하여 사이트 자체를 파일 시스템에서 자유롭게 이동할 수 있습니다.
- 데이터 손실 없이 집계 로직을 변경할 수 있도록
upgrader_process_complete
후크에서 애그리게이터를 실행합니다. - 파일이 여전히 존재하고 작동하는 것으로 확인된 경우에만 최적화된 엔드포인트를 사용하세요. 이렇게 하면 파일을 제거하면 즉시 기본 AJAX 엔드포인트로 전환할 수 있습니다.
- 가장 많이 본 글 위젯/쇼트코드에서 빈 결과 집합 대신 모든 글이 표시되는 버그가 수정되었습니다.
- 차트에 옵션별로 그룹을 추가합니다.
- 비교를 위해 기간을 더 잘 정렬합니다.
1.6.6 – Feb 18, 2025
- 쿠키를 사용하지 않을 때 동일 페이지 리퍼러 감지 수정.
- 날짜 선택기를 사용하여 날짜 기간을 변경할 때 페이지 필터를 유지합니다.
- 대시보드 위젯의 실시간 페이지뷰는 자정 직후에 조회한 경우 오늘의 페이지뷰로 제한합니다.
1.6.5 – Feb 10, 2025
- 버스트 통계의 데이터 가져오기 기능을 추가합니다.
- REST 엔드포인트에서
monthly
쿼리 매개변수에 “false” 및 “no”를 전달할 수 있도록 허용합니다. - 매우 특정한 요청에서만 실행되는 코드를 적극적으로 지연 로딩하여 플러그인 부트스트랩 코드의 PHP 실행 시간을 최적화합니다. 일반 요청의 경우 OPcache를 사용하면 0.05ms에서 0.03ms(!)로, OPcache를 사용하지 않으면 1.44ms에서 0.54ms로 단축됩니다.
- 버퍼 파일에서 영구 저장소로 데이터를 집계하는 클래스에 대한 사소한 코드 개선.
1.6.4 – Jan 25, 2025
- 대시보드 데이터가 항상 REST API 엔드포인트를 통해 공개적으로 액세스할 수 있도록 수정합니다.
1.6.3 – Jan 21, 2025
- 누락된
koko_analytics_aggregate_stats
이벤트를 예약합니다. - 페이지뷰 수가 항상 올바른 날짜에 추가되도록 하려면 WP Cron이 24시간 이상 중단되더라도 페이지뷰 수가 항상 올바른 날짜에 추가되도록 하세요.
- WP 크론 스톨의 경우 실시간 방문자 수 정확도가 개선되었습니다.
- 임시 버퍼 파일을 업로드 디렉터리 내의 자체 디렉터리로 이동합니다.
- 버전 1.6.2에 도입된 PHP 7.4의 구문 오류 수정
- 젯팩 가져오기: 하루 분량의 데이터를 가져올 때 0으로 나누기 수정
- 젯팩 가져오기: 젯팩 가져오기의 HTTP 요청 시간 제한을 5초에서 90초로 늘렸습니다.
- 젯팩 가져오기: 사용자 정의 청크 크기를 선택할 수 있어 글이나 페이지가 많은 사이트에 유용할 수 있습니다.
- 기본적으로 플러그인 제거 시 데이터베이스 테이블을 삭제하지 않습니다.
1.6.1 – Jan 20, 2025
- API가 오류 응답을 반환할 때 오류 로그에만 기록하는 대신 젯팩 가져오기에서 오류 세부 정보를 표시합니다.
- 플러그인 활성화에 대한 가지치기 데이터에 대한 예약 이벤트를 직접 등록하세요.
null
매개변수를 사용하여get_realtime_pageview_count()
함수를 호출할 수 있습니다.
1.6.0 – Jan 17, 2025
- 최소 요구되는 PHP 버전을 7.4 이상으로 상향 조정합니다.
- “this_week” 및 “last_week” 사전 설정의 날짜 생성 관련 문제를 수정했습니다.
- 차트 도구 설명 위치를 수정하여 가로로 넘치지 않도록 합니다.
- 스크롤 시 차트 도구 설명을 숨깁니다.
- 충분한 공간이 있는 대형 화면에서 페이지뷰 및 방문자 열의 열 너비를 확장합니다.
- 버전 1.5.5에 도입된 정의되지 않은 배열 키 알림을 수정합니다.
- 젯팩 임포터 기능의 모든 문자열을 번역할 수 있도록 설정하세요. Alex Lion에게 감사드립니다.
start_date
매개변수 없이 호출할 경우 HTTP 500 오류를 반환하는 REST API 경로를 수정했습니다.
PS. 워드프레스 이외의 사이트를 추적할 수 있는 독립형 버전의 코코 애널리틱스를 개발하기 시작했습니다.
자세한 내용은 대니의 개인 블로그(https://www.dannyvankooten.com/blog/2025/building-privacy-friendly-website-analytics/)에서 확인할 수 있습니다.
1.5.5 – Jan 10, 2025
보류 중인 데이터베이스 마이그레이션을 확인하는 데 upgrader_process_complete
를 사용하지 마세요. 이 특정 훅은 이전 버전의 플러그인을 사용하여 실행되므로 사용할 수 없습니다…
버전 1.5.2에서 이 변경 사항을 되돌리면 최적화 엔드포인트 파일이 기존 함수를 참조하는 문제를 해결할 수 있습니다.
1.5.4 – Jan 10, 2025
- 일부 설치에서 더 이상 기존 파일을 참조하지 않는 최적화된 엔드포인트 파일 수정.
1.5.3 – Jan 09, 2025
- 쿼리 루프 블록과의 통합을 추가합니다.
- 일요일에 ‘이번 주’ 또는 ‘지난 주’를 볼 때 날짜 범위를 수정합니다.
- 설정 페이지에서 코코 애널리틱스 프로의 비기능 설정 예시를 제거합니다.
- 최소 30일 이상 사용한 후 기부금을 요청하는 일회성 알림을 추가합니다.
1.5.2 – Dec 17, 2024
- 보류 중인 데이터베이스 마이그레이션을 실행하는 로직을 개선합니다.
1.5.1 – Dec 10, 2024
- 기본 PHP 표준 시간대를 사용하는 차트 도구 설명의 날짜를 수정하고 대신 사이트 표준 시간대를 명시적으로 사용하세요.
- 최적화되지 않은 엔드포인트에서 제외된 요청(IP 주소 또는 사용자 역할별)이 있는지 확인합니다.
- 페이지 URL에 쿼리 구성 요소가 없는 경우 대시보드에 PHP 알림이 표시되지 않도록 합니다.
1.5.0 – Nov 27, 2024
- 데이터 수집에 최대 리퍼러 URL 길이를 적용합니다.
- 방문자 및 페이지뷰 열 헤더를 작은 화면의 아이콘으로 바꿉니다.
Stats::get_total
이 이전 기간을 자동으로 가져오지 않도록 하여koko_analytics_counter
쇼트코드의 속도를 높입니다.- 이제 마이그레이션 러너는 각 개별 단계 후에 로컬 데이터베이스 버전을 업데이트합니다.
- 이제 마이그레이션 러너에는 원자적으로 실행되도록 하는 간단한 잠금 메커니즘이 있습니다.
- 현지화된 형식으로 데이터베이스 크기를 출력합니다.
wp_date()
를 통해 현지화된 형식으로 날짜를 출력합니다. 도미니크 실링에게 감사드립니다.- 설정 페이지에서 누락된 텍스트 도메인을 추가합니다. 도미니크 실링(Dominik Schilling)에게 감사드립니다.
1.4.5 – Nov 14, 2024
- 대시보드의 모든 숫자에 현지화된 숫자 서식을 사용합니다.
- 데이터 내보내기 및 가져오기 기능을 추가합니다. 글 ID가 일치하는 사이트에만 사용할 수 있습니다.
- 막대의 방문자 부분에 약간 더 어두운 색상을 사용하여 차트에서 주말을 강조 표시합니다.
1.4.4 – Nov 4, 2024
- 젯팩 통계 가져오기 기능을 추가하여 기록 분석 데이터를 Koko 애널리틱스로 가져옵니다. 설정 페이지로 이동하여(Jetpack이 활성화된 상태에서) 액세스합니다.
- 역방향 프록시를 사용하는 경우 설정 페이지에 클라이언트 IP 대신 프록시 IP가 표시되도록 수정했습니다.
- 소스 코드에서 천 단위 구분 기호로만 PHP 7.4 기능을 사용하는 문제를 수정했습니다.
- 브라우저 탭이 활성화된 경우 1분마다 대시보드가 자동으로 새로고침됩니다.
- 단 하루의 데이터에 대한 차트는 표시하지 않습니다.
- 대신 URL 경로를 표시하여 제목이 없는 게시물을 좀 더 효과적으로 처리할 수 있습니다.
1.4.3 – Oct 29, 2024
- 하위 도메인 부분이 없는 특정 리퍼러 URL에 대해 ‘백트랙 한도 소진’ 트리거가 발생하는 문제를 수정했습니다.
- 누락된 리퍼러 차단 목록 파일을 정상적으로 처리합니다. 이렇게 하면 서버의 보안 소프트웨어가 차단 목록 파일에 알려진 멀웨어 도메인 목록이 포함되어 있어 의심스러운 것으로 플래그를 지정하고 삭제하는 문제가 해결됩니다.
- 순위가 줄임표로 표시되지 않도록 첫 번째 테이블 열의 너비를 늘립니다.
- 표 머리글 행의 밝은 회색 테두리를 제거합니다.
- 대시보드 위젯에서 숫자를 오른쪽으로 정렬합니다. Terence Eden이 제트팩에서 웹사이트 통계 해방하기에 대한 멋진 포스팅을 작성해 주셔서 감사합니다!
- 데이터 수집 엔드포인트에서 리퍼러 URL 및 요청 매개변수의 유효성 검사가 개선되었습니다.
1.4.2 – Oct 25, 2024
- 리퍼러 URL에
t.co
쇼트링크가 포함된 경우 치명적인 오류 “잘못된 문자열 피연산자”를 수정했습니다. preg_match
함수에서 잘못된 유형을 반환하는get_referrer_url_label
잠재적 문제 수정
1.4.1 – Oct 25, 2024
- 표에서 방문자 및 페이지뷰 열의 너비를 제한합니다.
- 오류 발생 시 잘못된 유형을 반환하지 않고 실제 발생한 오류를 로그에 기록하는
preg_replace
를 수정합니다.
1.4.0 – Oct 24, 2024
- 이제 대시보드의 모든 HTML이 서버 측에서 생성되므로 JavaScript의 양이 크게 줄어들고 일반적으로 코드 기반을 유지 관리 및/또는 확장하기가 더 쉬워집니다.
- 이제 모든 대시보드 상태를 URL 쿼리 매개변수를 통해 관리할 수 있으므로 즐겨찾는 뷰를 북마크하거나 공유할 수 있습니다.
- 대시보드 표에 실제
<table<
요소를 사용하면 화면 리더 지원이 향상됩니다. - 대시보드에서 리퍼러 URL의 링크
href
속성을 수정하기 위해 필터 후크koko_analytics_referrer_url_href
를 추가합니다. - 대시보드에서 리퍼러 URL의 링크 레이블을 수정하려면 필터 후크
koko_analytics_referrer_url_label
를 추가하세요. - 플러그인 활성화 시 관리자 사용자에게
view_koko_analytics
기능이 제공되지 않는 문제 수정. - 빈 리퍼러 URL이 저장되지 않도록 합니다.
- 다양한 Yandex 리퍼러 URL을 단일 항목으로 그룹화합니다.
- 자동 로더 구현에서 메모리 사용량이 약간 개선되었습니다.
1.3.15 – Oct 15, 2024
- 가장 많이 본 글 위젯/숏코드/함수 템플릿의 하이퍼링크에 있는
href
속성을 수정합니다.
1.3.14 – Sep 23, 2024
- 글로벌 네임스페이스에서
sprintf
를 명시적으로 호출하면 PHP 8.4에서 예정된 sprintf 관련 성능 개선의 이점을 누릴 수 있습니다. - 플러그인 설정 페이지의 코코 애널리틱스 프로에서 데모 설정을 합니다.
1.3.13 – Sep 17, 2024
Stats::get_totals
가 항상 유효한 개체를 반환하는지 확인합니다.- 반사된 XSS 공격을 방지하기 위해
add_query_arg
에서 반환값을 이스케이프 처리합니다. - 클라이언트가 프록시 뒤에 있는 경우에도 올바른 IP 주소를 사용하세요.
- 다양한 사소한 템플릿 성능 개선.
1.3.12 – Aug 18, 2024
- 버전 1.3.11에 도입된 이중 페이지뷰 카운트 수정.
- 동일한 사이트가 리퍼러로 표시되는 문제 수정
1.3.11 – Aug 16, 2024
- 쿠키가 비활성화된 경우에만 재방문자 확인을 위해 리퍼러 감지를 사용합니다.
- 브레보 이메일 캠페인 링크에 대한 리퍼러 집계 규칙을 추가합니다.
- Reddit 링크에 대한 리퍼러 집계 규칙을 추가합니다.
- 코코 애널리틱스 설정을 쉽게 추가하거나 수정할 수 있는 필터 후크를 추가합니다.
- 코코 애널리틱스에 설정을 추가하기 위한 액션 훅을 추가합니다.
- 추적 스크립트에서 모든 ES6 코드를 명시적으로 제거합니다.
1.3.10 – Jun 20, 2024
- 코코 애널리틱스 프로 등록이 다시 시작되었습니다. 사용자 지정 이벤트 추적이 필요하거나 플러그인만 지원하려면 라이선스를 구매하세요.
- Facebook 링크 미리보기 요청 및
User-Agent
HTTP 헤더가 없는 요청은 무시합니다. - 참조자 차단 목록을 갱신했습니다.
1.3.9 – May 31, 2024
- 추적 스크립트 관련 웹팩 문제 수정.
1.3.8 – May 29, 2024
- IP 주소에서 보기를 제외하는 설정 추가.
- 마우스오버 시 정확한 페이지뷰 및 방문자 수를 표시합니다.
- 최적화된 사용자 정의 오토로더를 사용합니다.
[koko_analytics_counter]
쇼트코드에 대한 쇼트코드 인수를 확인합니다.- 모호한 열 이름에 대한 SQLite 사용 시 오류 수정.
- 잘못된 기간을 사용한 실시간 페이지뷰 수 수정.
1.3.7 – Feb 26, 2024
- 쇼트코드
[koko_analytics_counter]
를 추가했습니다. Anil Kulkarni 고맙습니다! - 설정 페이지에서 최종 집계 이후 경과한 시간을 보여 줍니다.
- 버퍼 파일에 쓰기 전에 더 적극적으로 데이터 수집 요청을 검증합니다.
- 참조자 차단 목록을 갱신했습니다.
1.3.6 – Jan 29, 2024
- 참조자 차단 목록을 갱신했습니다.
- 제삼자 자바스크립트 의존성을 업데이트했습니다.
1.3.5 – Jan 8, 2024
- 쿠키를 활성화한 AMP를 이용할 때
HOUR_IN_SECONDS
상수가 정의되지 않는 점을 수정했습니다. - 데이터가 없는 날짜가 차트에 표시되지 않는 점을 수정했습니다.
- 차트 y축 숫자를 10만 이상으로 높였습니다.
1.3.4 – Nov 21, 2023
- 페이지 단위로 필터를 거는 신기능입니다. “최고 인기 페이지” 목록에서 아무 페이지나 클릭하면 전체 방문자수와 페이지뷰를 나타내는 차트 구성요소가 특정 페이지에 맞게 갱신됩니다.
- Cron 이벤트가 작동하지 않는다는 경고가 표시되지 않는 점을 수정했습니다.
- 기본 날짜 기간이 제거된 날짜에서 멈추는 오류를 수정했습니다.
- 미려한 퍼머링크를 사용하지 않는 사이트를 위해 API url을 수정했습니다.
- 차트와 툴팁을 표시하는 성능을 개선했습니다.
1.3.3 – Nov 6, 2023
- 앞으로 가는 빠른 이동 기능을 수정했습니다.
- 프로그레시브 웹앱인 (독립형) 알림판으로 설치할 수 있는
manifest.json
파일을 추가했습니다.
1.3.2 – Nov 2, 2023
- 터치 입력 기기에서 알림판 위젯을 볼 때 차트 툴팁이 즉각 사라지는 문제를 수정했습니다.
- MySQL 정보 테이블에서 데이터베이스 크기를 읽을 권한이 없을 때 생기는 치명적 오류를 수정했습니다.
- 글 제목에 있는 특수문자의 이중 인코딩을 수정했습니다.
- 하루치 데이터를 볼 때의 화살표 키 또는 화살표 아이콘 내비게이션 기능을 수정했습니다.
- 60초마다 알림판 데이터를 자동 갱신합니다.
- 오늘 하루 요약 정보를 나타내는 알림판 위젯을 개선했습니다.
- 알림판 위젯에 인기 페이지와 참조자를 수정하거나 비활성화하는
koko_analytics_dashboard_widget_number_of_top_items
필터 훅을 추가했습니다. [koko_analytics_most_viewed_posts]
쇼트코드가 아무 결괏값을 내놓지 않으면 이제 해당 선언문은 디버그 메시지를 나타냅니다.
1.3.1 – Nov 1, 2023
- 새 방문자 수를 세지 못하는 문제를 수정했습니다.
- 협정 세계시(UTC)와 시간 격차(timezone offset)가 큰 이용자들에게 나타나는 알림판 문제를 수정했습니다.
- 월별 보기일 때 차트 구성요소의 날짜 형식을 수정했습니다.
- 차트 색상을 파랑으로 되돌렸습니다. 차트에 다른 색상을 적용하고 싶다면 이 색상 변경 코드 스니펫 예시를 보세요.
- 오늘자 데이터 요약을 빠르게 나타내도록 알림판 위젯을 변경했습니다.
- “최적화한 엔드포인트 생성” 버튼을 써 본 다음 의견을 남겨 주세요.
1.3.0 – Oct 31, 2023
- 리액트 의존성을 제거하고 추가로 최적화해 대대적으로 알림판 성능을 개선했습니다.
- 워드프레스 관리자 화면의 외부에서 (독립형) 알림판을 불러오는 링크를 추가했습니다.
- 분석 알림판을 외부에 보이게 만드는 설정을 추가했습니다.
- 쓰기 작업이 가능한 위치에 있을 때만 ‘최적화한 엔드포인트 파일 생성’ 버튼을 표시합니다.
- 플러그인을 지울 때
wp_koko_analytics_dates
를 제거합니다. - 가장 많이 읽힌 글 정보와 그 결괏값 캐시를 가져오는 데이터베이스 쿼리를 최적화했습니다.
- 실시간 페이지뷰와 가장 많이 읽힌 글 목록을 포함해 알림판 위젯을 확장했습니다.
navigator.sendBeacon
을 사용해 데이터 수집을 요청하세요.
1.2.2 – Oct 18, 2023
- 플러그인 훑어보기 페이지에서 설정 페이지로 넘어가는 링크를 수정했습니다.
wp_localize_script
가 모든 값을 문자열로 바꿔 페이지 분할 기능이 작동하지 않는 문제를 수정했습니다.- 표시 방식을 한 번 이상 전환할 때 알림판 위젯에 리액트 기능 경고가 뜨는 문제를 수정했습니다.
- 터치 입력 기기에 차트 툴팁이 표시되지 않는 문제를 수정했습니다.
- 설정 페이지에 소소한 스타일 개선을 적용했습니다.
- 플러그인이 활성화 상태일 때만 사용자 정의 엔드포인트를 설치합니다.
- 사용자 정의 엔드포인트 설치를 재시도하는 버튼을 설정 페이지에 추가했습니다.
- 테이블 페이지 분할 기능을 구성요소의 바닥으로 옮기고 텍스트 라벨을 추가했습니다.
<fieldset>
태그로input[type="radio"]
을 감쌌습니다.- Remove support for honouring “Do Not Track” header as per MDN 표준 권고에 따라 “추적방지” 헤더 이행을 지원하는 기능을 제거했습니다.
1.2.1 – Oct 11, 2023
- 엄격한 데이터 타입과 시간 단위가 아닌 협정 세계시 시간 격차(non-hourly UTC offsets) 관련 문제를 수정했습니다.
1.2.0 – Oct 11, 2023
- 워드프레스 6.0 호환성 문제를 수정했습니다.
- 어떤 식으로든 이전에 실행에 실패했을 때 5분 동안 집계 프로세스가 작동하지 않는 문제를 수정했습니다.
- 워드프레스 알림판에서 차트 툴팁이 나타나지 않는 점을 수정했습니다.
- 집계 프로세스 성능을 소소하게 개선했습니다.
- 코어 플러그인에서 기초(샘플 데이터) 함수를 내보냈습니다.
- 알림판이 작동하지 않을 때 브라우저 콘솔 오류 메시지 점검에 대한 메시지를 추가했습니다.
- 가능하다면 브라우저에서
Intl.DateTimeFormat
를 사용해 알림판 날짜 서식을 지정합니다. - 네이티브
<input type="date">
요소를 위해 Pikaday 날짜 선택기를 제거했습니다. - 날짜 선택기 드롭다운의 모바일 보기를 개선했습니다.
- 가장 많이 읽힌 글 위젯, 쇼트코드, 함수 결과에서 (고정 페이지) 홈페이지를 제외합니다.
- 알림판 구성요소의 페이지 당 표시 항목 수를 덮어 쓰는
koko_analytics_items_per_page
필터 훅을 추가했습니다. - 필요한 PHP 버전을 7.3으로 높였습니다.
1.1.2 – Oct 3, 2023
- 사용자 정의 데이터베이스 테이블 접두어를 사용하는 사이트에서 전체 및 차트 구성요소 오류 문제를 수정했습니다.
1.1.1 – Oct 3, 2023
- 1.1.0 버전에서 날짜 테이블을 생성하지 않아 빈 차트를 표시하게 만든 문제를 수정했습니다.
Koko Analytics v1.1.0 – Oct 3, 2023
- 프리액트를 워드프레스에 포함된 리액트 버전으로 변경해 관리자 알림판의 번들 크기를 40kB (또는 30%) 줄였습니다.
- 로컬 또는 개발자 환경에서 워드프레스 Cron 이벤트가 작동하지 않는다는 경고를 표시하지 않습니다.
- 워드프레스 코어와 동일한 브라우저 목록 설정을 사용합니다.
- 차트 데이터를 가져오고 해석하는 성능을 최적화했습니다.
- 최적화한 엔드포인트를 생성할 때 전체 구성요소 데이터를 가져옵니다.
- 설정 페이지는 이제 리액트 구성요소 대신 서버에서 렌더링한 페이지로 대체됐습니다.
- CSS 선택자 성능을 높였습니다.
- Add public PHP API. You can now call the following functions:
koko_analytics_get_most_viewed_posts()
는 가장 많이 읽힌 글의 목록을 가져옵니다.- 지난 1시간동안의 총 페이지뷰 수를
koko_analytics_get_realtime_pageview_count('-1 hour')
로 가져옵니다. $post_id
ID로 지정한 글의 페이지뷰를koko_analytics_track_pageview($post_id)
로 추적합니다.
1.0.40 – Sep 14, 2023
- 글 제목이 없다면 포스트 슬러그로 대체합니다.
- 참조자 URL을 검증하고 유효하지 않다면 무시합니다.
- 만일 버퍼 파일명이 바뀌면 최적화한 추적 엔드포인트를 삭제하고 더 이상 그것을 표시하지 않습니다. 이는 서버 간 이전으로 발생하는 문제를 해결합니다.
- 현재 이용자 역할과 무관하게 필요하다면 항상 데이터베이스 이전을 실행합니다.
KokoAnalytics\get_most_viewed_posts()
와[koko_analytics_most_viewed_posts]
쇼트코드에 다중 글 유형을 지정할 수 있습니다. 예시:[koko_analytics_most_viewed_posts post_type="page,post"]
- 최적화한 추적 엔드포인트 설치 시도를 시간당 한 번으로 제한합니다.
- 분석 알림판에서 워드프레스 설정의 날짜 서식을 사용합니다.
- (날짜 서식 문자열에서 M, F, I, D를 이용하는 것이 적절하다면) 날짜와 달 이름을 번역합니다.
- 워드프레스 명령줄인터페이스로 집계 작업을 수동 실행할 때 선택적
--force
플래그를 수용합니다. 예시:wp koko-analytics aggregate --force
- 로컬호스트 기반 사이트,
.local
로 끝나는 사이트, 그리고 포트 번호를 포함하는사이트에서 워드프레스 Cron이 적절하게 작동하지 않는다는 경고문을 나타내지 않습니다. - 마지막으로 이벤트를 추적하는 준비 작업 몇 가지를 진행하고 있습니다… 곧 나옵니다!
1.0.39 – Aug 29, 2023
- 참조자 차단 목록을 갱신함
- 제삼자 자바스크립트 의존성을 갱신함
- 테스트한 워드프레스 버전을 높임
1.0.38 – Apr 25, 2023
- 알림판 위젯이 최초에 숨김 상태일 때 올바르지 않게 표시되는 문제를 수정했습니다.
- 표시할 수 있을 때만 알림판 위젯에 차트를 표시합니다.
1.0.37 – Dec 07, 2022
- 부정확한 통계 수집을 야기하는 추적 스크립트의 잠재적 문제를 수정했습니다.
1.0.36 – Dec 06, 2022
- 추적 스크립트 크기를 (gzip 압축 사용 시) 985바이트까지 줄였습니다.
1.0.35 – Oct 21, 2022
- 이제
koko_analytics.trackPageview( postId )
를 호출해 수동으로 페이지뷰를 추적할 수 있습니다. 이것은 싱글 페이지 애플리케이션에 특히 유용합니다. - 참조자 차단 목록을 갱신했습니다.
- 참조자 URL이 참조자 차단 목록에 있다면 그 전체 요청을 무시합니다.
- 자바스크립트 의존성을 개선했습니다.
1.0.34 – Sep 19, 2022
- (정적 페이지가 아니라면) 첫 페이지에서도 방문자를 추적합니다.
- 캐시 헤더를 보낼지 여부를 결정하기 위해 gmdate() 를 사용합니다.
- 자바스크립트 의존성을 개선했습니다.
1.0.33 – Aug 17, 2022
- 페이지뷰를 기록한 날이라면 항상 최소한 방문자 1명을 표시합니다.
- REST API의 캐시 제어 헤더 응답시간을 60초로 줄였습니다.
- 모든 통계치를 초기화하는 버튼을 추가했습니다.
- 참조자 URL의 URL 집계를 변경하거나 추가하는
koko_analytics_url_aggregations
필터를 추가했습니다. - 다른 사람들이 코코 애널리틱스 개발 기금과 지원 비용을 후원하자는 제안을 OpenCollective에 작성했습니다. 자세한 내용은 https://opencollective.com/koko-analytics 에 방문해 확인해 보세요.
1.0.32 – Jun 2, 2022
- Endpoint_Installer 클래스가 필요할 때 항상 로드될 수 있도록 최신 릴리즈 오류를 수정했습니다.
1.0.30 – Jun 1, 2022
- 플러그인을 지울 때
koko_analytics_use_custom_endpoint
옵션을 삭제했습니다. - 이용자가 통계 보기 기능을 요구할 때에만 dashboard-widget.js를 로드합니다.
- 완전히 사용자 정의 엔드포인트를 비활성화하는
KOKO_ANALYTICS_CUSTOM_ENDPOINT
상수를 추가했습니다. 이 필터는 다른 파일 위치에 엔드포인트 파일을 수동으로 설치하기 위해 사용될 수도 있습니다. - 1시간마다 사용자 정의 엔드포인트 파일 설치를 재시도합니다. 이는 또한 사용자 정의 엔드포인트가 예측한대로 작동하고 있는지 여부를 자동으로 다시 테스트합니다. 알림판 페이지에 방문할 때 이미 수행했던 플러그인 동작인데, 이제 워드프레스 관리자 로그인을 하지 않더라도 더 자주 실행합니다.
1.0.29 – Jan 25, 2022
- 특정 에지 케이스에서 PHP 알림을 피하기 위해 버퍼 파일에서 빈 줄 건너뛰기.
- 날짜 사전 설정에 JS 라이브러리 사용.
- 미리보기가 포함된 사용자 에이전트를 필터링합니다.
- 야후 검색 결과에 대한 리퍼러 URL을 정상화합니다.
- 크론 경고에 클래스 속성을 추가하여
.koko-analytics-cron-warning
를 타겟팅하여 CSS를 사용하여 숨길 수 있도록 합니다.
1.0.28 – Sep 27, 2021
- 예를 들어 테마가
wp_head()
를 제대로 호출하지 않는 경우와 같이 누락된 구성 개체를 설명합니다. - 데이터베이스 결과를 정수형으로 캐스팅하여 클라이언트 측에서 처리할 필요가 없도록 합니다.
- 대시보드 요청을 REST API에 5분 동안 캐시합니다(브라우저 캐시 사용).
- 뷰박스 좌표에 정수를 사용(성능 향상을 위해).
- 아직 사용 중인 이전 실행을 감지하기 위한 집계 작업의 간단한 잠금 메커니즘.
- WP Cron을 거치지 않고도 통계를 집계할 수 있는 WP CLI 명령을 추가하세요:
wp koko-analytics aggregate
1.0.27 – May 4, 2021
- 구문 분석을 전혀 차단하지 않으려면 스크립트에
defer
속성을 사용하세요. - Www 하위 도메인이 있는 경우와 없는 경우의 Pinterest URL 정규화.
- 일부 누락된 번역을 수정합니다.
1.0.26 – Feb 17, 2021
- 인기 요청에 따라 지난 28일에 다시 도입되었습니다.
- WebKit 기반 브라우저에서 날짜 사전 설정 드롭다운이 작동하지 않는 문제 수정.
- 기본 제공 리퍼러 차단 목록을 업데이트합니다.
1.0.25 – Feb 16, 2021
- 어제 또는 지난주와 같은 새로운 날짜 사전 설정을 여러 개 추가합니다.
- 키보드 입력을 통한 사용자 지정 날짜 범위 입력 지원 추가.
- 차트 Y축의 알고리즘을 개선하여 큰 점프를 방지합니다.
- 추적 스크립트를 수동으로 인쇄하는 기능을 추가합니다:
<?php koko_analyics_tracking_script(); ?>
- JS 종속성을 업데이트합니다.
1.0.24 – Jan 20, 2021
- 플러그인이 사용자 정의 추적 엔드포인트를 사용 중이므로 캐시되지 않도록 추적 요청에 임의 쿼리 매개변수를 추가합니다.
- JS 종속성을 업데이트합니다.
1.0.23 – Jan 15, 2021
워드프레스 디렉토리 구조 설정에 관계없이 올바른 파일 경로를 포함하는 최적화된 엔드포인트 파일을 작성하여 성능이 크게 향상됩니다.
워드프레스 루트 디렉터리에 쓰기 불가능한 경우, 이 최적화된 엔드포인트 파일을 수동으로 생성하는 방법에 대한 지침은 코코 애널리틱스 설정 페이지에서 확인하세요.
1.0.22 – Nov 18, 2020
- 마이그레이션 스크립트에서 기존 파일의 연결을 해제하려고 할 때(예: 새 플러그인 설치 시) PHP 경고가 수정되었습니다.
- 사용자 정의 엔드포인트 파일에 대한 URL을 올바르게 생성합니다. 일부 다국어 플러그인에서 페이지뷰가 제대로 기록되지 않던 문제를 수정했습니다.
1.0.21 – Nov 5, 2020
- 연결 해제 후 사용자 정의 엔드포인트 사용 여부를 저장하는 옵션을 업데이트하여 존재하지 않는 파일로 요청이 전송되는 것을 방지합니다.
1.0.20 – Nov 3, 20202
- 사용자 정의 업로드 디렉터리를 사용하는 경우 사용자 정의 엔드포인트 파일을 사용하지 마세요.
- 정의되어 있는 경우
KOKO_ANALYTICS_USE_CUSTOM_ENDPOINT
의 값을 사용합니다. - 관리자 역할이 있는 경우에만 관리자 역할에 add_cap을 호출합니다.
- JS 종속성을 업데이트합니다.
- 기본 제공 리퍼러 차단 목록을 업데이트합니다.
1.0.19 – Sep 2, 2020
- 버퍼 파일 디렉터리가 아직 없는 경우(예: 새로 WP를 설치한 경우) 버퍼 파일 디렉터리를 만듭니다.
- Preact 및 date-fns를 최신 버전으로 업데이트합니다.
- 기본 제공 리퍼러 차단 목록을 업데이트합니다.
1.0.18 – Aug 25, 2020
- AMP 기반 페이지에서 추적이 작동하지 않거나 cdn.ampproject.org에 존재하지 않는 파일에 요청을 발행하는 문제를 수정합니다.
1.0.17 – Aug 19, 2020
- 워드프레스 5.5에 도입된 모던 색 구성표를 사용할 때 발생하는 문제를 수정했습니다.
- 정확한 응답 본문 확인을 통해 사용자 지정 엔드포인트 파일에 대한 테스트 개선.
- 화면 가장자리 근처에서 차트를 가리킬 때 가로 스크롤바가 표시되지 않도록 수정.
1.0.16 – Jul 21, 2020
- 워드프레스 5.0 미만 버전에서 빈 화면 수정.
- 사용자에게 필요한 기능이 없는데도 설정 링크가 표시되는 문제를 수정했습니다.
- 필터를 사용하여 사용자 지정 리퍼러 차단 목록의 코드 수정
koko_analytics_referrer_blocklist
. - 사이트 URL이 워드프레스 URL과 다른 경우 사용자 정의 엔드포인트 파일을 사용하지 마세요.
- 사용자 지정 엔드포인트 파일에 대한 테스트 개선.
1.0.15 – Jun 22, 2020
- 이번 주 사전 설정의 이상한 날짜 수정.
- 날짜 선택기의 주 이름 수정.
- 번역 파일이 로드되지 않는 문제 수정. 바라건대…
1.0.14 – Jun 22, 2020
- 멀티사이트 설치에서는 사이트별 데이터베이스 접두사를 무시하므로 사용자 지정 추적 엔드포인트를 사용하지 마세요.
WP_DEBUG
가 활성화된 경우 집계 프로세스의 오류를 표시합니다.- 참조자 차단 목록을 갱신했습니다.
- JavaScript 파일에서 번역을 관리하려면
wp.i18n
를 사용하세요. - 테이블 행 수를 페이지당 최대 25개까지 늘릴 수 있습니다.
- 필터 후크를 추가합니다:
koko_analytics_referrer_blocklist
(example) - 필터 후크를 추가합니다:
koko_analytics_ignore_referrer_url
(example)
1.0.13 – May 28, 2020
- 참조자 차단 목록을 갱신했습니다.
- 음수 UTC 오프셋을 고려하도록 URL 매개변수에서 날짜 구문 분석을 개선했습니다. 날짜가 하루 뒤로 건너뛰는 문제를 수정했습니다.
- 사용자 지정 엔드포인트를 수동으로 설치한 경우에는 설치하지 마세요(
KOKO_ANALYTICS_USE_CUSTOM_ENDPOINT
상수 사용). - 트래커 엔드포인트 URL에
home_url()
를 사용하도록 되돌립니다.
1.0.12 – May 14, 2020
- DoNotTrack을 무시할 수 있도록
koko_analytics_honor_dnt
필터를 추가합니다. - 루트 디렉터리에 쓰기 가능한 표준 워드프레스를 설치한 경우 추적 요청의 성능이 크게 개선되었습니다.
- 변수 이름 충돌을 방지하기 위해 추적 스크립트의 범위를 제한합니다.
1.0.11 – Apr 17, 2020
- 분석 대시보드를 열 때 기본 날짜 기간을 지정하는 설정이 추가되었습니다.
- 무시된 HTTP 사용자 에이전트 목록에 크롬-라이트하우스를 추가합니다.
- 버퍼 파일을 쓸 수 없는 경우 애널리틱스 대시보드 페이지에 알림을 표시합니다.
- 도메인 루트에 있지 않은 워드프레스 설치에서 제대로 작동하도록 홈 URL에서 쿠키 경로를 도출합니다.
- 구성 개체를 쉽게 덮어쓸 수 있도록
window.DOMContentLoaded
대신window.load
에서 페이지뷰를 추적합니다. - 추적 스크립트에 대한 사소한 최적화.
1.0.10 – Mar 23, 2020
- 쿠키 동의 플러그인을 사용하여 쉽게 재정의할 수 있도록 페이지 HTML의 앞부분에 구성 개체를 인쇄합니다.
- 다중 선택 요소의 사용법을 설명하는 도움말 텍스트를 추가합니다.
1.0.9 – Mar 9, 2020
- 날짜 범위를 빠르게 순환하려면 화살표 키(Ctrl-키 없이)를 사용합니다.
- 2(전체) 개월 이상의 데이터를 표시하는 경우 차트를 월별로 그룹화합니다.
- JS 번들 크기를 절반으로 줄이기 위해 React를 Preact로 대체.
- 프로토콜 없이 리퍼러 URL을 정규화합니다.
- 이전 기간과의 총 비교를 개선했습니다.
1.0.8 – Feb 14, 2020
- 지난 28일 동안의 날짜 사전 설정 추가
- Add keyboard navigation …