개발 slecs

네이버 서치어드바이저 사이트 인증 메타 태그 등록

목차

Naver 사이트 인증 메타 태그를 추가했다.

검색 엔진 최적화 작업을 진행하다 보면 Google Search Console 등록은 대부분의 팀이 이미 챙겨두는데, 네이버 서치어드바이저는 우선순위에서 밀리는 경우가 꽤 많다. 특히 글로벌 대상 서비스보다는 국내 사용자를 타깃으로 하는 서비스라면 오히려 네이버 유입 비중이 무시할 수 없는 수준이기 때문에, 이 시점에 빠진 인증을 챙긴 건 의미 있는 작업이었다.

왜 src/consts.ts 에 넣었나

변경이 src/consts.ts 한 파일에만 반영된 걸 보면, 이미 사이트 전반의 메타 태그 혹은 사이트 설정 값들을 상수로 관리하는 구조가 잡혀 있었다는 뜻이다. 네이버 인증 코드 자체는 단순한 문자열이지만, 그걸 인라인으로 직접 HTML에 박거나 컴포넌트 내부에 하드코딩하지 않고 상수 파일로 뽑아 관리하는 게 맞는 방향이다.

// src/consts.ts
export const SEO = {
  naverSiteVerification: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  // ...기타 SEO 관련 상수
};

이런 식으로 SEO 관련 값들을 한 곳에서 관리하면, 나중에 인증 코드가 갱신되거나 다른 검색엔진 인증이 추가될 때 수정 범위가 명확해진다. 코드리뷰할 때도 "이 변경이 어디에 영향을 주는지" 한눈에 보이기 때문에 리뷰어 입장에서도 부담이 적다.

사이트 인증 메타 태그, 어떻게 동작하나

네이버 서치어드바이저 사이트 인증 방식은 보통 두 가지다.

인증 방식 방법 특이사항
HTML 파일 업로드 특정 파일명의 HTML을 루트에 배치 배포 파이프라인에 포함해야 함
메타 태그 삽입 <head> 에 <meta name="naver-site-verification" ...> 추가 코드베이스로 관리 가능, 비교적 간단

메타 태그 방식이 코드베이스 내에서 버전 관리가 되기 때문에, 팀 차원에서는 이쪽이 더 선호된다. 파일 업로드 방식은 배포 구조에 따라 루트 경로 접근이 막혀 있거나, CDN 캐싱 때문에 인증이 지연되는 상황이 생기기도 한다.

<!-- 실제 렌더링된 <head> -->
<meta name="naver-site-verification" content="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" />

이 메타 태그가 <head> 에 포함된 채로 배포되면 서치어드바이저에서 소유권 확인을 통과하고, 이후 사이트맵 제출 및 색인 요청이 가능해진다.

작은 변경, 큰 의존성

stat이 따로 지정되지 않았지만 파일 하나, 코드 한두 줄 수준의 변경이었을 것이다. 이런 핀포인트 수정은 코드 자체의 복잡도는 낮지만, 그 값이 외부 시스템(네이버 서치어드바이저)과 연동된다는 점에서 영향 범위가 단순하지 않다.

팀장 입장에서 이런 작업을 리뷰할 때 주로 확인하는 것들:

  • 인증 코드가 올바른 환경(운영)에서 발급된 값인지
  • 해당 메타 태그가 실제로 <head> 에 렌더링되는 위치를 확인했는지
  • 배포 후 서치어드바이저에서 소유권 확인을 직접 눌러봤는지
  • robots.txt, sitemap.xml 제출 등 후속 작업 계획이 있는지

마지막 항목이 실제로 중요하다. 인증을 마쳤는데 사이트맵을 제출하지 않으면 색인이 기대만큼 빠르게 이뤄지지 않는다. 인증 등록 자체는 끝이 아니라 SEO 작업의 시작점이다.

회고

consts.ts 하나 건드리는 작업이라 자칫 "그냥 상수 추가" 커밋으로 묻힐 수 있는데, feat(seo): 스코프를 명확히 달아서 검색 최적화 작업의 일환임을 커밋 히스토리에 남긴 게 좋았다. 나중에 SEO 관련 작업 이력을 추적할 때 이런 커밋 컨벤션이 실제로 도움이 된다.

사이트 인증 작업 하나가 허술하게 처리되면 서치어드바이저에서 색인 데이터를 보지 못하고 수개월을 보내는 경우도 실제로 있다. 작은 설정이지만 챙길 타이밍에 제대로 챙기는 게 맞다.

다음

🛒 이 글과 어울리는 추천 상품

*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.

이어보기

댓글 0

첫 댓글 달아줘.