웹사이트를 운영하다 보면 SEO 때문에 ‘구조화된 데이터(JSON-LD)’라는 말을 자주 듣게 되죠. 그런데 구글 서치콘솔에서 갑자기 Potential Action 오류가 떴다는 알림을 받으면 당황스러울 수 있어요. 보통 필수 정보가 빠졌거나 오타 때문에 생기는 문제인데요, 이 오류를 어떻게 잡아야 검색 결과에 내 사이트가 예쁘게 잘 나오는지 알기 쉽게 설명해 드릴게요.
구조화된 데이터 오류, 왜 생기는 걸까요?
검색 엔진 최적화(SEO)에 관심 있는 분들이라면 구조화된 데이터가 얼마나 중요한지 아실 거예요. 구글 같은 검색 엔진이 내 사이트의 글을 더 잘 이해하고, 검색 결과 화면(SERP)에서 더 눈에 띄게 만들어주는 역할을 하니까요.
하지만 이 마크업 코드를 작성하다 보면 실수가 생길 수 있어요. 그중 요즘 자주 보이는 게 바로 “Potential Action 오류”예요. 주로 JSON-LD 스크립트 안에 있는 코드 문제인데, 사이트에 검색창 기능이 있거나 사용자가 뭔가 행동을 취해야 하는 요소가 있을 때 더 신경 써야 해요.
코드를 아주 조금만 잘못 적거나 꼭 필요한 속성을 빼먹으면 이런 오류가 생겨요. 이걸 그대로 두면 구글 검색 결과에서 사이트 검색창 기능이 사라지거나 SEO 점수에 안 좋은 영향을 줄 수 있으니 빨리 고치는 게 좋아요.
Potential Action 오류와 query-input 문제
이 오류는 쉽게 말해 웹사이트의 구조화된 데이터가 꼬여서 생기는 문제예요. 데이터 해석이 제대로 안 되니 검색 엔진 최적화(SEO)에도 안 좋은 영향을 미칠 수밖에 없죠.
오류가 발생하는 구체적인 이유
‘Potential Action’은 방문자가 웹페이지에서 할 수 있는 행동을 정의하는 요소예요. 여기서 사용자가 입력해야 하는 값을 ‘query-input’이라고 부르는데요, 사이트 내 검색 기능을 만들 때 이 부분을 제대로 명시하지 않으면 탈이 나요. 구글에게 “여기에 검색어를 입력받을 거야”라고 확실히 알려줘야 하거든요.
보통 이런 메시지를 보게 되실 거예요. “최근 귀하의 사이트에서 1개의 사이트링크 검색창 구조화된 데이터 문제가 발견되었습니다.” 이 경고는 사용자 경험이나 노출 순위에 영향을 줄 수 있다는 뜻이니 주의해야 해요.
오류의 주요 원인 3가지
이런 오류가 뜨는 이유는 생각보다 단순한 곳에 있을 때가 많아요. 주로 아래 3가지를 체크해보세요.
첫째, 오타예요. 코드 내에서 괄호나 따옴표 같은 작은 타이핑 실수 하나가 해석 오류를 만들어요.
둘째, 잘못된 데이터 형식이에요. 구글이 정해놓은 규칙에 맞지 않는 형식을 쓰면 인식을 못 해요.
셋째, 필수 속성 누락이에요. 이게 가장 흔한데, 특히 query-input 속성을 빼먹어서 오류가 나는 경우가 많아요.
그래서 웹페이지의 마크업 코드를 꼼꼼히 다시 살펴봐야 해요. 형식이 맞는지, 내 사이트 내용과 코드가 일치하는지 확인하는 게 중요해요. 데이터 마크업 방법는 계속 업데이트되니까 최신 버전을 참고하는 것도 잊지 마세요.
오류 해결과 정기적인 관리 방법
꾸준한 점검이 SEO의 지름길
구조화된 데이터를 주기적으로 들여다보고 업데이트해 주는 것만으로도 SEO에 긍정적인 영향을 줄 수 있어요. 검색 순위도 지키고, 문제가 터지기 전에 미리미리 고칠 수 있으니까요.
단계별 해결 체크리스트
Potential Action 오류를 잡으려면 아래 순서대로 확인해 보세요.
1. 온라인 서식과 링크 확인: 설정한 링크들이 깨지지 않고 잘 연결되어 있는지 보세요.
2. 코드 다시 보기: 문제가 된 페이지의 소스 코드를 열어서 오타나 빠진 부분이 없는지 천천히 훑어보세요.
3. 서버 상태 점검: 가끔은 내 코드가 아니라 서버나 네트워크 문제일 수도 있으니 연결 상태도 한 번쯤 체크해 주면 좋아요.
특히 “query-input이 누락되었습니다”라는 메시지는 사용자가 입력할 정보가 코드에 없다는 뜻이에요. 구글이 우리 사이트를 똑똑하게 이해할 수 있도록 이 부분을 꼭 채워주세요.
자주 묻는 질문 (Q&A)
Q: 이 오류는 어떤 스키마랑 관련이 있나요?
A: 보통 웹사이트의 검색 기능을 담당하는 WebSite 스키마 안의 potentialAction 속성, 그중에서도 SearchAction 타입과 관련이 깊어요. 구글 검색 결과에 검색창(사이트링크 검색창)을 띄워주는 역할을 하죠.
Q: 수정하고 나면 언제 반영되나요?
A: 코드를 고쳤다면 구글 서치콘솔에 들어가서 해당 페이지의 ‘유효성 재검사’를 꼭 눌러주세요. 구글이 다시 와서(크롤링) 확인하는 데 며칠에서 몇 주 정도 걸릴 수 있는데, 재검사 요청을 하면 좀 더 빨리 봐줘요.
Q: query-input은 어떻게 적어야 하나요?
A: 보통 name="search_term_string" 처럼 적어서 사용자가 입력한 검색어를 받아주는 변수를 지정해요. 이 변수가 나중에 실제 검색 URL을 만드는 데 쓰이거든요. 정확한 코드는 구글의 공식 구조화된 데이터 문서를 보고 복사해서 쓰는 게 제일 안전해요.
