구글 사이트킷(Google Site Kit) 플러그인은 워드프레스 사이트를 구글 서치 콘솔, 구글 애널리틱스, 애드센스에 간편하게 연결할 수 있는 공식 플러그인입니다. 그런데 사이트 이전 후 실행하거나, 오래 전에 삭제했다가 다시 설치하면 'Unable to retrieve site connection' 오류가 발생하는 경우가 있습니다.
먼저 "플러그인 설정 재실행"을 시도해 보고, 이 방법으로 문제가 해결되지 않으면 Site Kit 초기화를 실행하면 오류가 해결될 것입니다.
구글 사이트킷 사이트 연결 오류 해결 방법
오래 전에 구글 사이트킷 플러그인을 설치했다가 삭제한 사이트에 최근 다시 이 플러그인을 설치하니 "Analytics에서 데이터 오류가 있습니다. Unable to retrieve site connection. You may need to perform a plugin reset" 오류 메시지가 표시되면서 구글 계정에 연결되지 않은 오류가 발생하는 상황을 경험했습니다.
"최근 28일 동안의 검색 트래픽" 섹션에는 "Search Console에서 데이터 오류가 있습니다" 오류가 표시되네요.
Site Kit » 설정에는 "Site Kit 연결 오류. 알 수 없는 오류입니다" 오류 메시지가 표시되었습니다.
구글 사이트킷(Site Kit by Google) 연결 오류 원인 및 해결 방향
구글 사이트킷 플러그인에서 사이트 연결 오류 문구가 나타나는 것은 워드프레스 웹사이트와 구글 API 서버 간의 연결 및 인증 토큰이 정상적으로 연동되지 않을 때 발생합니다.
이러한 오류가 발생하는 가장 대표적인 이유는 도메인(사이트 주소) 변경 및 데이터 불일치입니다.
- 구글 사이트킷이 설치된 워드프레스 사이트의 사이트 주소를 변경하거나
- 이 플러그인이 설치된 사이트를 다른 도메인의 사이트로 이전(마이그레이션)하거나
- Site Kit이 설치된 스테이징 사이트를 실서버로 전환할 때
위의 상황에서 구글 서버에 등록된 기존 연결 키와 현재 사이트 주소가 달라지면서 인증이 차단됩니다.
또한, 과거에 이 플러그인을 삭제했다가 오랜 시간이 지난 후 재설치하는 경우에도 데이터베이스의 wp_options 테이블에 남아있던 만료된 인증 토큰이나 설정 잔여 데이터가 새 연결을 방해하여 동일한 오류를 일으킬 수 있습니다.
이외에도 웹호스팅 서버와 구글 API 간의 통신 과정에서 발생하는 보안 및 환경적 요인도 원인이 될 수 있다고 합니다. 클라우드플레어(Cloudflare) 같은 방화벽이나 보안 플러그인이 구글의 사이트 확인 요청(REST API 또는 cURL 통신)을 봇 공격으로 오인해 차단할 때 발생할 수 있으며, 캐시 플러그인의 과도한 최적화나 Object Cache 프로토콜 충돌로 인해 연결 데이터가 정상적으로 전달되지 않을 때도 나타납니다.
문제 해결 방법
먼저 Site Kit » 대시보드에서 플러그인 설정 재실행 버튼을 클릭하여 플러그인을 설정을 다시 실행해볼 수 있습니다.
플러그인 설정 재설정 버튼을 눌러도 오류가 해결되지 않는다면 도구 » 사용 가능한 도구에서 Site Kit 초기화 버튼을 눌러 사이트킷 초기화를 시도해볼 수 있습니다.
그러면 "Google Site Kit을 성공적으로 초기화했습니다" 메시지가 표시되면서 초기화가 될 것입니다.
사이트킷을 초기화하면 구글 서치 콘솔, 애널리틱스, 애드센스 연동이 모두 해제되므로, 처음부터 다시 연결 작업을 진행해야 합니다.
Q&A (자주 묻는 질문)
Q. 플러그인 설정 재실행과 Site Kit 초기화는 어떻게 다른가요?
A. 플러그인 설정 재실행은 현재 연결 상태를 유지한 채 설정 과정만 다시 실행하는 가벼운 복구 방법입니다. 반면 Site Kit 초기화는 데이터베이스에 저장된 모든 연결 정보와 인증 토큰을 완전히 삭제하는 강력한 초기화 방법입니다.
초기화 후에는 서치 콘솔, 애널리틱스, 애드센스 연동이 모두 해제되어 처음부터 다시 연결 작업을 진행해야 합니다. 플러그인 설정 재실행으로 오류가 해결되지 않을 때 Site Kit 초기화를 시도하면 문제가 해결될 것입니다.
Q. Site Kit을 초기화하면 서치 콘솔이나 애널리틱스에 수집된 데이터가 삭제되나요?
A. 아닙니다. 초기화는 워드프레스 데이터베이스에 저장된 플러그인 연결 정보만 삭제합니다. 구글 서버에 누적된 서치 콘솔 및 애널리틱스 데이터는 그대로 보존됩니다. 재연결 후 기존 데이터를 이어서 확인할 수 있습니다.
Q. 초기화 후 재연결했는데도 같은 오류가 반복됩니다. 어떻게 해야 하나요?
A. 클라우드플레어(Cloudflare) 또는 보안 플러그인(Wordfence 등)이 구글의 REST API 요청을 차단하고 있을 가능성이 있습니다. 방화벽 규칙을 일시적으로 비활성화한 상태에서 재연결을 시도해보세요. 또한, 캐시 플러그인을 비활성화한 후 연결을 시도해볼 수도 있습니다.
Q. 사이트를 이전한 후 Site Kit 오류가 발생했습니다. 바로 초기화해야 하나요?
A. 초기화 전에 먼저 Site Kit » 대시보드에서 플러그인 설정 재실행 버튼을 눌러보세요. 이 방법으로 해결되는 경우도 있으므로, 단계적으로 시도하는 것이 좋습니다. 재실행으로도 해결되지 않을 때 초기화를 진행하세요.
Q. Site Kit 대신 구글 서비스를 연결하는 다른 방법이 있나요?
A. 다양한 방법이 있습니다. 워드프레스의 경우 WPCode와 같은 코드 삽입 플러그인을 사용해 서치 콘솔 사이트 소유 확인 코드나 애널리틱스(GA4) 태그를 헤더에 직접 추가할 수 있습니다. 또는, 차일드 테마를 설치하고 차일드 테마의 함수 파일(functions.php)에 코드를 추가하는 방법도 가능합니다.
Site Kit이 사이트 속도에 영향을 준다고 느껴지거나 연결 오류가 반복된다면 이 방법을 고려해볼 수 있습니다.
마치며
이상으로 구글 사이트 킷 플러그인 연결 오류 메시지가 표시되는 경우 초기화하여 해결하는 방법에 대해 살펴보았습니다.
Site Kit을 사용하면 편리하게 구글 서비스(서치 콘솔, 애널리틱스, 애드센스 등)에 연결할 수 있지만, 사이트 속도에 영향을 미칠 수 있습니다. 구글에서는 관리자 페이지 속도에만 영향을 미치고 사이트 자체 속도에는 영향을 미치지 않는다고 안내하고 있지만 사이트 속도가 느려진다고 호소하는 분들이 계십니다.
이 플러그인이 사이트 속도에 영향을 미친다면 구글 서치 콘솔, 애널리틱스 등의 코드를 다른 방법으로 추가하는 것으로 고려할 수 있습니다. 쉬운 방법으로는 WPCode와 같은 플러그인을 사용하여 헤더 섹션에 코드를 추가할 수 있습니다.
댓글 남기기