Atoms
Integrations

Google Search Console 연동

Marketing에서 프로젝트의 게시된 웹사이트에 대한 검색 성과 및 색인 생성 정보를 확인하려면 Google Search Console을 Atoms 프로젝트에 연동하세요.

Marketing에서 프로젝트의 게시된 웹사이트에 대한 검색 성과 및 색인 생성 정보를 확인하려면 Google Search Console을 Atoms 프로젝트에 연동하세요.

이 가이드는 올바른 Google 계정을 인증하고, 라이브 사용자 지정 도메인의 속성을 연동하거나 추가하고, 해당 속성 유형에 맞는 올바른 확인 방법을 선택하고, 연동이 정상적으로 작동했는지 확인하고, 사이트맵을 제출하는 방법을 설명합니다.

연동 작동 방식

Google Search Console은 웹사이트 데이터를 속성 으로 구성합니다. Search Console을 연동하면 Atoms는 먼저 Google 계정을 인증한 다음, 현재 Atoms 프로젝트에서 사용하는 사용자 지정 도메인과 일치하는 속성을 찾습니다.

연동은 2단계로 진행됩니다.

  1. Google 계정을 인증합니다. 라이브 사이트의 Search Console 속성에 액세스하거나 이를 확인할 수 있는 계정을 사용하세요.
  2. 속성을 일치시키고 확인합니다. Atoms는 라이브 사용자 지정 도메인과 일치하는 기존의 확인된 속성이 있으면 자동으로 연동합니다. 사이트가 없거나 확인되지 않은 경우, 연동을 완료하기 전에 추가하거나 확인하세요.

속성이 연동되면 PerformanceOperations 에 Search Console에서 반환된 데이터가 표시될 수 있습니다. 이러한 보기는 Sarah가 생성한 내용을 설명하지 않으며, Sarah가 SEO 콘텐츠를 계획하거나 생성하는 데 이 연동이 필수는 아닙니다.

시작하기 전에

Google Search Console을 연동하기 전에 다음 사항을 확인하세요.

  • 웹사이트가 라이브 사용자 지정 도메인에 게시되어 있어야 합니다. 기본 Atoms 주소는 이 Search Console 워크플로에 사용할 수 없습니다.
  • 로그인하지 않고도 라이브 홈페이지를 열 수 있어야 합니다.
  • 기존의 일치하는 Search Console 속성에 액세스할 수 있거나 새 속성을 확인할 수 있는 Google 계정이 있어야 합니다.
  • 브라우저에서 Atoms의 Google 인증 팝업을 허용해야 합니다.
  • 프로젝트 연동을 관리할 권한이 있어야 합니다. 연동 제어를 사용할 수 없는 경우, 이 권한이 있는 워크스페이스 소유자 또는 관리자에게 연동 완료를 요청하세요.

가장 짧은 자동 확인 경로를 사용하려면 URL 접두사 Search Console 속성을 사용하고, 사용자 인증 흐름을 통해 라이브 사이트에서 사용하는 GA4 속성을 연동하세요. 두 서비스 모두에 동일한 Google 계정을 사용하고, 해당 계정에 GA4 속성에 대한 Edit 액세스 권한이 있는지 확인하세요. 이 경로는 Domain 속성이나 Atoms에서 자동으로 관리되는 Analytics 설정에는 사용할 수 없습니다. Google Analytics 4 연동 을 참조하세요.

사용자 지정 도메인이 필요한 경우 도메인 연동 및 관리 를 참조하세요.

Google 비밀번호, 확인 코드, DNS 값, 액세스 토큰 또는 기타 자격 증명을 Chat에 붙여넣지 마세요.

Google Search Console 연동

Search Console 커넥터 열기

  1. 게시된 웹사이트의 Atoms 프로젝트를 엽니다.
  2. 프로젝트 도구 모음에서 Marketing 을 선택한 다음 Operations 을 엽니다. SEO 작업이 이미 완료되었고 Overview → Marketing → SEOOpen Dashboard 가 표시되면, 동일한 보고 영역으로 가는 바로 가기로 이를 선택할 수 있습니다.
  3. Atoms에 Manage Domains 가 표시되면 계속하기 전에 사용자 지정 도메인을 연동하고 확인하세요.
  4. Connect Search Console 을 선택합니다.
Search Console을 연동하기 전에 사용자 지정 도메인 추가

Search Console을 연동하기 전에 사용자 지정 도메인 추가

Marketing에서 Google Search Console 열기

Marketing에서 Google Search Console 열기

Google 계정 인증

  1. Google 인증 창에서 사용자 지정 도메인의 속성에 액세스하거나 이를 확인할 수 있는 Google 계정으로 로그인합니다.
  2. 올바른 Google 계정이 선택되었는지 확인합니다.
  3. Atoms가 요청하는 액세스 권한을 검토합니다. 동의하는 경우에만 계속 진행하세요.
  4. Atoms로 돌아가 인증 단계가 완료될 때까지 기다립니다.

브라우저가 Google 인증 창을 차단하는 경우 Open authorization page 를 선택하고 새 탭에서 계속 진행하세요. Atoms에 대한 팝업을 허용한 다음 연동을 다시 시도할 수도 있습니다.

사용자 지정 도메인의 속성 연동

인증 후 Atoms는 프로젝트의 라이브 사용자 지정 도메인과 일치하는 Search Console 속성을 찾습니다.

  • 일치하는 확인된 속성이 있는 경우: Atoms가 자동으로 연동합니다. 연동이 정상적으로 작동했는지 확인 으로 계속 진행하세요.
  • 도메인을 찾을 수 없는 경우: Add site in Atoms 를 선택하세요. 그러면 현재 사용자 지정 도메인에 대한 URL 접두사 Search Console 속성이 생성되며, 다른 Atoms 웹사이트가 생성되는 것은 아닙니다.
  • 사이트를 찾았지만 확인되지 않은 경우: 아래의 확인 방법 중 하나를 사용하세요.

확인 방법을 선택하기 전에 속성 유형을 식별하세요. URL 접두사 속성은 httphttps 를 구분하고, example.comwww.example.com 같은 호스트 이름도 구분합니다. Domain 속성은 해당 프로토콜과 하위 도메인을 포함하며 DNS를 통해 확인해야 합니다.

사이트 확인

Atoms가 사이트를 찾았지만 확인되지 않았다고 표시하는 경우, 속성 유형에 맞는 방법을 선택하세요. URL 접두사 속성의 경우 아래 자격 조건을 충족할 때만 Google Analytics를 사용하고, 그렇지 않으면 수동 방법을 사용하세요. Domain 속성의 경우 Google DNS 확인을 완료하세요.

Google Analytics를 통한 확인

이 경로는 라이브 사이트가 이미 GA4를 사용하고, GA4 속성이 Atoms에서 사용자가 직접 연동했으며, 동일한 Google 계정에 해당 Analytics 속성에 대한 Edit 액세스 권한이 있는 경우에만 URL 접두사 속성에 사용할 수 있습니다. Domain 속성이나 Atoms에서 자동으로 관리되는 Analytics 설정에는 사용할 수 없습니다.

  1. Atoms에서 Analytics 탭을 선택합니다.
  2. 라이브 사이트의 GA4 속성을 사용하여 Google Analytics 4 연동 의 단계를 완료합니다.
  3. Search Console 설정 화면으로 돌아갑니다.
  4. Refresh 를 선택합니다.
  5. 사용 가능해지면 Auto Verify via Google Analytics 를 선택합니다.
  6. Atoms가 확인 결과를 확인할 때까지 기다립니다.

Google Analytics 확인을 사용하려면 지원되는 Analytics 태그가 있는 공개 홈페이지도 필요합니다. 조건 중 하나라도 충족되지 않으면 관련 수동 방법을 사용하세요. Google의 사이트 소유권 확인 가이드 를 참조하세요.

스크린샷에는 Analytics 링크, Refresh, Auto Verify via Google Analytics, 그리고 수동 확인 링크가 표시됩니다. Auto Verify via Google Analytics 는 위의 URL 접두사 및 Analytics 자격 조건이 충족되기 전까지는 사용할 수 없습니다.

자동 확인을 위해 먼저 GA4를 연동하거나 사이트를 수동으로 확인

자동 확인을 위해 먼저 GA4를 연동하거나 사이트를 수동으로 확인

Google Search Console에서 수동으로 확인

  1. Verify manually in Google Search Console 을 선택합니다.
  2. Google Search Console에서 속성 유형에 맞는 확인 방법을 선택합니다. Domain 속성의 경우 Google에서 표시하는 DNS 방법을 사용하세요. URL 접두사 속성의 경우 Google이 제공하는 방법 중 완료할 수 있는 아무 방법이나 사용하세요.
  3. Google의 안내를 완료합니다. 사용 가능한 방법은 속성 유형과 웹사이트 또는 도메인에 대해 보유한 액세스 권한에 따라 달라집니다.
  4. Atoms로 돌아가 Refresh 를 선택합니다.
  5. 도메인에 Verified in Google Search Console 이 표시되는지 확인합니다.

연동이 성공한 후에는 확인 파일, 태그, DNS 레코드 또는 기타 확인 토큰을 제거하지 마세요. Google이 나중에 토큰을 다시 확인할 수 있습니다.

연동이 정상적으로 작동했는지 확인

  1. Marketing → Performance 를 엽니다.
  2. 페이지에 연동된 사용자 지정 도메인과 Search Console 보고 레이아웃이 표시되는지 확인합니다.
  3. Operations 를 열고 사이트맵 및 색인된 페이지 영역을 사용할 수 있는지 확인합니다.
  4. 속성이 새로 생성된 경우 나중에 다시 돌아와 데이터를 확인하세요.

Atoms의 Search Console 성과 데이터는 일반적으로 2~3일 지연됩니다. 따라서 Google이 데이터를 수집하거나 반환하기 시작하는 동안 연동된 대시보드에 값이 0으로 표시되거나 No data available 이 표시될 수 있습니다.

Search Console 성과 데이터 검토

Search Console 성과 데이터 검토

이 가이드의 Analytics 및 Performance 스크린샷은 개인정보 보호를 위해 가상의 도메인, 쿼리 및 지표를 사용하거나 일부를 가렸습니다. Operations 스크린샷은 승인된 예외에 따라 개인정보 보호를 위해 사이트맵 세부 정보를 의도적으로 잘라냈습니다. 실제 값은 다를 수 있습니다.

사이트맵 및 색인된 페이지 상태 검토

사이트맵 및 색인된 페이지 상태 검토

사이트맵 제출

Atoms 대시보드는 Search Console에서 사이트맵 정보를 읽을 수 있지만, 사이트맵을 대신 제출하지는 않습니다. Google의 Sitemaps 보고서를 통해 제출하려면 Google 계정에 Search Console 속성에 대한 소유자 권한이 있어야 합니다.

  1. https://your-domain.com/sitemap.xml 이 로그인 없이 열리고, 공개적으로 가져올 수 있으며, 새 라이브 페이지 주소를 포함하고, 사용자 지정 도메인을 사용하는지 확인합니다.
  2. 연동된 속성에 대해 Google Search Console을 엽니다.
  3. Sitemaps 를 열고 Google에 표시된 입력 필드에 따라 라이브 사이트맵 주소 또는 /sitemap.xml 을 제출합니다.
  4. 나중에 다시 돌아와 제출 결과를 확인합니다.

사이트맵이 없거나, 새 페이지가 제외되어 있거나, 플레이스홀더 도메인을 사용하는 경우 Alex에게 수정하고 수정된 빌드를 게시한 후 제출해 달라고 요청하세요. Google의 안내는 Sitemaps 보고서 가이드 를 참조하세요.

일반적인 문제

문제

조치 방법

Google 인증 창이 열리지 않음

Open authorization page 를 선택하고 Atoms에 대한 팝업을 허용한 다음 다시 시도하세요.

잘못된 Google 계정이 연동되었거나 액세스가 취소됨

프로젝트의 커넥터 설정을 열고 Search Console 연동을 해제한 다음 올바른 Google 계정으로 다시 연동하세요.

속성이 없거나 일치하지 않음

라이브 사이트의 정확한 프로토콜과 호스트 이름을 확인하세요. Refresh 를 선택하고, 일치하는 속성이 없으면 Add site in Atoms 를 선택하여 URL 접두사 속성을 생성하세요.

연동 제어를 사용할 수 없음

프로젝트 연동을 관리할 수 있는지 확인하세요. 그렇지 않으면 해당 권한이 있는 워크스페이스 소유자 또는 관리자에게 연동 완료를 요청하세요.

확인 실패

속성 유형을 확인하세요. Google Analytics는 자격을 충족하는 URL 접두사 속성에만 사용하고, Domain 속성에는 DNS 방법을 사용하세요. Google에서 해당 방법을 완료한 다음 Atoms로 돌아와 Refresh 를 선택하세요.

대시보드에 데이터가 없음

연동된 속성이 라이브 사용자 지정 도메인과 일치하는지 확인하세요. Search Console 데이터는 일반적으로 표시되기까지 2~3일이 걸리지만, 새로 추가된 웹사이트는 데이터 생성에 최대 1주일이 걸릴 수 있습니다.

Google에서 사이트맵 오류를 보고함

Search Console에서 오류 세부 정보를 여세요. 사이트맵이 공개되어 있고, 라이브 사용자 지정 도메인을 사용하며, 의도한 라이브 페이지 주소를 포함하는지 확인하세요.

문제가 계속되면 프로젝트, 라이브 도메인, 실패한 단계, 표시된 오류, 대략적인 시간, 그리고 민감한 정보를 가린 스크린샷과 함께 Atoms Support에 문의하세요. 비밀번호, 확인 코드, DNS 값, 액세스 토큰 또는 기타 자격 증명은 포함하지 마세요.

SEO 워크플로와 Performance, Operations, URL Inspection 및 Page Speed 해석에 대한 안내는 SEO 에이전트 를 참조하세요.

이 페이지가 도움이 되었나요?

관련 문서