검색 관련 자바스크립트 문제 해결하기

이 가이드에서는 Google 검색에 페이지가 표시되거나 자바스크립트 기반 페이지의 특정 콘텐츠가 표시되는 것을 차단할 수 있는 자바스크립트 문제를 식별하고 수정하도록 안내합니다. Googlebot은 자바스크립트를 실행하지만, 크롤러가 콘텐츠에 액세스하고 설계하는 방법을 수용하려면 페이지와 애플리케이션을 디자인할 때 몇 가지 차이점과 제한 사항을 고려해야 합니다.

Googlebot은 웹에서 바람직하게 작동하도록 만들어졌습니다. Googlebot의 주요 우선순위는 크롤링이지만, 동시에 사이트를 방문하는 사용자의 환경에 방해가 되어서는 안 됩니다. Googlebot 및 WRS(Web Rendering Service) 구성요소는 필수 페이지 콘텐츠에 기여하지 않는 리소스를 계속해서 분석하고 식별하며 이러한 리소스를 가져오지 않을 수 있습니다. 예를 들어 필수 페이지 콘텐츠에 기여하지 않는 보고 및 오류 요청, 이와 유사한 유형의 요청은 필수 페이지 콘텐츠를 추출하는 데 사용되지 않거나 불필요합니다.

Google 검색에 페이지가 표시되거나 자바스크립트 기반 페이지의 특정 콘텐츠가 표시되는 것을 차단할 수 있는 자바스크립트 문제가 의심되는 경우 다음 단계를 수행하세요.

  1. Google에서 URL을 크롤링 및 렌더링하는 방식을 테스트하려면 Search Console에서 모바일 친화성 테스트 또는 URL 검사 도구를 사용합니다. 페이지 결정 카드의 추가 정보 링크를 클릭하면 로드된 리소스, 자바스크립트 콘솔 출력 및 예외, 렌더링된 DOM, 추가 정보 등을 볼 수 있습니다.

    또한 선택적으로 Googlebot을 비롯하여 사용자가 사이트에서 경험한 자바스크립트 오류를 수집 및 감사하여 콘텐츠 렌더링 방식에 영향을 줄 수 있는 잠재적 문제를 파악하는 것이 좋습니다.

  2. Googlebot이 사용자 권한 요청을 거부할 것이라고 예상합니다.
  3. 콘텐츠를 제공하기 위해 데이터 지속성에 의존하지 않습니다.
  4. 애플리케이션이 모든 중요한 API에 대해 기능 감지를 사용하는지 확인하고 해당되는 경우 대체 동작 또는 폴리필(polyfill)을 제공해야 합니다.
  5. 웹 구성요소가 검색에 적합한지 확인합니다.
    1. 구현 세부정보를 캡슐화하고 숨기려면 shadow DOM을 사용합니다.
    2. 가능한 경우 언제나 콘텐츠를 light DOM에 넣습니다.
  6. 이 체크리스트에서 항목을 수정한 후, Search Console에서 모바일 친화성 테스트 또는 URL 검사 도구를 사용하여 페이지를 다시 테스트합니다.

    문제를 해결하면 녹색 체크표시가 나타나고 오류가 표시되지 않습니다. 여전히 오류가 표시되면 검색 작업 그룹의 자바스크립트 사이트에 게시하세요.