일기 slecs

네이버 서치어드바이저 인증을 레이아웃에 일찍 심어야 하는 이유

목차

네이버 서치어드바이저 인증 메타 태그를 Base.astro 레이아웃에 심었다.

작업 자체는 한 줄 추가지만, "이걸 왜 지금 하냐"는 질문을 팀 안에서 종종 받게 되는 종류의 작업이다. 커밋 하나짜리 chore인데 이 뒤에 꽤 긴 맥락이 붙어 있어서 짧게나마 정리해 두려 한다.

왜 지금이었나

사이트가 어느 정도 뼈대를 갖추고 콘텐츠가 쌓이기 시작하면, 검색엔진 쪽 설정을 더 이상 미룰 수 없는 타이밍이 온다. Google Search Console은 워낙 디폴트처럼 챙기는 편인데, 네이버는 의외로 후순위로 밀리는 경우가 많다. 국내 트래픽이 유의미한 서비스라면 네이버 검색 유입을 아예 포기하는 게 아닌 이상, 서치어드바이저 연동은 조기에 해 두는 게 맞다.

인증 방식 자체는 크게 두 가지다.

방식 파일 업로드 메타 태그
방법 HTML 파일을 루트에 배포 <head>에 <meta> 한 줄
장점 <head> 오염 없음 배포 파이프라인 단순, 파일 관리 불필요
단점 정적 파일 라우팅 확인 필요, 파일 삭제 시 인증 해제 가능성 레이아웃 수정 필요
적합 상황 멀티 레이아웃 or 레이아웃 접근 제한 단일 베이스 레이아웃 구조

이 프로젝트는 Base.astro 하나가 모든 페이지의 <head>를 관리하는 구조라서 메타 태그 방식이 훨씬 깔끔했다. 파일 올리고 라우팅 확인하고 배포 확인하는 번거로움 없이, 레이아웃 한 곳만 수정하면 전 페이지에 일괄 적용된다.

Base.astro에서 이 작업이 갖는 의미

Base.astro는 사실상 이 프로젝트의 <head> 단일 진실 공급원(single source of truth)이다. 여기에 뭔가를 추가한다는 건 전체 페이지에 영향을 준다는 뜻이고, 그만큼 이 파일에 대한 변경은 신중하게 다뤄야 한다.

---
// Base.astro (예시 패턴)
const { title, description } = Astro.props;
---
<html lang="ko">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <!-- SEO / 검색엔진 인증 -->
    <meta name="naver-site-verification" content="인증코드" />
    <title>{title}</title>
    <meta name="description" content={description} />
  </head>
  <body>
    <slot />
  </body>
</html>

코드 자체는 단순하다. naver-site-verification 메타 태그 하나. 그런데 이걸 어디에 놓느냐도 조금은 신경 쓰이는 부분이었다. <title> 앞에 검색엔진 관련 태그들을 모아두는 쪽이 나중에 관리할 때 한눈에 보인다. SEO 관련 메타들이 파일 여기저기 흩어져 있으면 코드리뷰할 때도, 나중에 같은 파일 건드릴 때도 맥락 파악이 느려진다.

chore인데 왜 꼼꼼히 챙기나

솔직히 이런 작업은 팀 내에서 우선순위 논의에서 자주 밀린다. 기능 개발, 버그 픽스, 성능 개선에 비하면 "검색엔진 인증 메타 태그 하나"는 티가 잘 안 난다. 그런데 막상 나중에 "왜 네이버 유입이 없냐"는 얘기가 나오면 그때 가서 이걸 설정하는 게 훨씬 비효율적이다. 색인이 쌓이는 데는 시간이 걸리고, 그 시간을 뒤로 미루는 셈이 된다.

총괄 입장에서 이런 chore 작업들을 어떻게 다루느냐는 팀 문화와도 연결된다. 작다고 미루지 않고, 적절한 타이밍에 조용히 처리하고 커밋 메시지에 의도를 남겨두는 것. 그게 나중에 히스토리를 보는 사람한테, 혹은 미래의 내가 "이게 언제 추가됐더라"를 찾을 때 도움이 된다.

  • 인증 후 서치어드바이저에서 사이트맵 제출까지 이어지는 게 자연스러운 다음 스텝
  • robots.txt 상태도 같이 점검하는 게 좋음
  • Google Search Console과 네이버 서치어드바이저를 같이 보는 습관을 들이면 유입 채널별 색인 상태 파악이 편해짐

끝.

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

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

이어보기

댓글 0

첫 댓글 달아줘.