검색 결과에 페이지 설명이 정상 노출되도록 메타데이터 추가

메타 설명(meta description) 필드를 콘텐츠 스키마에 추가하고, 주요 페이지들의 테스트 데이터를 새 필드로 채웠다. 이 작업은 작아 보이지만 SEO와 사용자 경험에 꽤 직접적인 영향을 미치는 변경이다.

메타 설명이 왜 중요한가

검색 엔진의 검색 결과 페이지(SERP)에서 페이지 제목 아래 회색 텍스트로 보이는 그 한두 줄이 메타 설명이다. 이것은 단순히 검색 엔진을 위한 것이 아니라 사용자가 실제로 클릭 여부를 결정할 때 보는 정보다. 우리 사이트의 경우 "golden-zone pages"라고 부르는 핵심 콘텐츠들(dimension-4d, dream-job, first-love, friend-loyalty 같은 테스트 페이지)이 검색 유입의 큰 부분을 차지하는데, 이 페이지들의 메타 설명이 제대로 없거나 자동 생성된 것이면 CTR 손실이 생긴다.

또한 검색 엔진이 명시적인 메타 설명을 찾지 못하면 페이지 본문 일부를 자의적으로 발췌하는데, 이게 항상 좋은 결과를 주진 않는다. 의도적으로 작성한 설명 한두 줄이 훨씬 전환에 유리하다.

스키마부터 템플릿까지의 변경

이 작업은 하향식(top-down)으로 진행했다. 먼저 스키마에 필드를 정의하고, 테스트 데이터를 채운 후, 페이지 컴포넌트에서 그것을 사용하는 구조다.

<!-- src/pages/t/[slug]/index.astro 예상 패턴 -->
<meta name="description" content={page.data.metaDesc} />

스키마 단계에서 metaDesc를 정의할 때 길이 제약(예: 120-160자)을 두지 않는 선택을 했다. 이유는 검색 엔진마다 표시 길이가 다르고, 우리 팀이 작성할 때 가이드라인으로 충분하다고 판단했기 때문이다. 물론 런타임 검증이나 콘텐츠 에디터 UI에서는 권장 길이를 표시해야 한다.

golden-zone 페이지부터 시작한 이유

모든 페이지에 메타 설명을 한 번에 추가하지 않고, 핵심 테스트 페이지들(dimension-4d, dream-job, first-love, friend-loyalty)부터 시작한 건 의도된 선택이다. 이 페이지들은:
- 검색 유입이 가장 높은 페이지들이다
- 메타 설명의 변경이 가장 빨리 영향을 미칠 곳이다
- 테스트 데이터이므로 안정성과 정확성 검증이 먼저 필요하다

이후 다른 페이지들로 확대할 때도 이 페이지들의 구현을 레퍼런스로 삼을 수 있다.

데이터 구조 설계의 맥락

테스트 파일들(JSON)에 메타 설명을 직접 채운 것도 중요한 의사결정이다. 선택지는 두 가지였다:

1. 스키마만 정의하고 데이터는 비워두기 — 마이그레이션 스크립트를 별도로 실행해야 하고, 배포 후 데이터 검증이 복잡해진다.
2. 테스트 데이터부터 채우기 — 이 커밋만으로 기능이 완성되고, 다른 개발자들이 새 페이지 추가할 때 예시를 볼 수 있다.

우리는 2번을 택했다. 테스트 데이터가 실제 구현의 좋은 문서가 되기 때문이다. 누군가 새 페이지를 추가할 때 이 JSON 파일들을 보고 "아, 이 필드는 필수구나"를 금방 알 수 있다.

회고

처음에는 이 작업을 "그냥 필드 몇 개 추가하는 거"로 가볍게 봤는데, 막상 하다 보니 고민할 지점들이 많았다. 스키마는 선택형인가 필수형인가, 메타 설명이 없으면 자동 생성할 것인가, 언어별로 별도 필드가 필요한가 등. 팀과 빠르게 논의해서 최소한의 변경(필수형, 자동 생성 없음, 단일 언어 우선)으로 진행했다.

이제 이 스키마가 있으므로, 다음 단계(다른 페이지들 추가, 자동 생성 시스템 도입, 메타 설명 에디터 UI 구축)로 자연스럽게 이어갈 수 있는 기반이 생겼다. 가끔 작은 기반 작업이 나중의 큰 기능을 훨씬 수월하게 만든다.

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

• 모니터 쿠팡에서 보기 →
• 기계식키보드 쿠팡에서 보기 →
• 외장SSD 쿠팡에서 보기 →

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