일기 slecs

애드센스 계정 소유권 인증 설정

목차

포트폴리오/블로그 사이트를 구글 애드센스와 연동하기 위해 소유권 인증을 위한 메타 태그를 추가했다. 단순해 보이는 chore 작업이지만, 여러 템플릿과 다국어 페이지를 어떻게 체계적으로 관리하는지 생각해보게 된 작업이었다.

왜 메타 태그 인증이 필요한가

구글 애드센스나 기타 서비스(Google Search Console, 페이스북 도메인 인증 등)를 사이트에 연동할 때, 서비스 제공자는 당신이 정말 그 도메인의 소유자인지 확인해야 한다. 이를 위해 몇 가지 검증 방식이 있는데:

  • HTML 메타 태그 추가: <head> 에 특정 content 값을 가진 meta tag 삽입
  • DNS 레코드 추가: TXT 레코드 등으로 도메인 DNS에 검증값 기록
  • 파일 업로드: 특정 검증 파일을 사이트 루트에 배치

메타 태그 방식은 제일 간단하고 빠르다. 코드를 배포하면 바로 반영되고, DNS 전파를 기다릴 필요가 없으니까.

구조화된 템플릿에서의 메타 태그 관리

이 프로젝트는 다중 페이지 + 다국어(영어/로컬) 구조를 가지고 있었다:

  • app/templates/base.html: 공통 기본 템플릿 (아마도 서버 렌더링 또는 정적 생성의 기초)
  • portfolio/en/index.html, portfolio/en/privacy.html: 영어 버전 페이지들
  • portfolio/index.html, portfolio/privacy.html: 기본 버전 페이지들

처음 생각해볼 수 있는 방식은 "각 HTML 파일마다 메타 태그를 넣기"인데, 이럴 경우 문제가 발생한다:

❌ 각 파일에 개별 추가 시
- 유지보수: 인증값이 바뀌면 5군데 모두 수정해야 함
- 휴먼 에러: 한 파일을 빠뜨릴 수 있음
- 새 페이지 추가 시: 메타 태그 추가를 항상 기억해야 함

더 나은 방식은 공통 템플릿에 넣는 것이다:

<!-- app/templates/base.html -->
<head>
  <!-- 다른 메타 태그들... -->
  <meta name="google-site-verification" content="[verification-code]">
  <!-- 또는 다른 서비스들 -->
  <meta name="[service]-verification" content="...">
</head>

이렇게 하면:
- 중앙 집중식: 한 곳에서만 관리
- 일관성: 모든 파일이 자동으로 동일한 메타 태그를 포함
- 확장성: 새로운 서비스 인증이 필요할 때 템플릿만 수정

하지만 독립적인 페이지들도 함께 수정한 이유

그런데 왜 base.html 외에도 portfolio/en/index.html 같은 정적 HTML 파일들도 함께 수정했을까? 몇 가지 가능성이 있다:

  1. 정적 페이지와 템플릿 페이지의 혼재 운영
  2. 일부는 Jinja2/Django 템플릿으로 동적 생성
  3. 일부는 완전 정적 HTML로 배포

  4. 둘 다 존재하는 구조라면, 메타 태그를 양쪽에 모두 넣어야 함

  5. 검색 엔진 크롤링 보장

  6. portfolio/index.html 같은 경로가 직접 제공되는 경우, 템플릿 변환을 거치지 않음

  7. 구글이 이 페이지를 크롤하기 전에 즉시 인증이 필요하면 직접 수정

  8. 빌드/배포 프로세스의 특성

  9. 정적 HTML도 별도로 빌드되거나 관리되는 구조일 수 있음
  10. 템플릿 변경만으로는 반영 안 되는 경우가 있을 수 있음

일반적인 베스트 프랙티스

이런 상황에서 배울 점:

시나리오 접근 방식
모든 페이지가 템플릿 기반 base.html 한 곳만 수정
템플릿 + 정적 HTML 혼재 둘 다 수정 (또는 빌드 자동화)
페이지별 다른 인증값 필요 각 페이지 개별 메타 태그 필수
같은 인증값이 모든 도메인에 필요 CDN/WAF 레벨에서 주입 고려

회고: Chore 작업의 의미

"메타 태그 추가 하나" 정도로 볼 수도 있지만, 이건 단순한 코드 작업이 아니었다:

  • 마케팅/수익화 작업을 개발자가 처리: 애드센스 연동은 비즈니스 요구사항인데, 우리가 직접 구현해야 함
  • 정확성이 중요: 태그 하나 빠지면 인증 실패 → 몇 시간 낭비
  • 일관성 관리: 다국어·다중 페이지 구조에서 누락되지 않도록 신경 써야 함

비슷한 작업(Google Search Console 인증, 메시저 앱 인증, 이메일 인증 도메인 설정 등)들도 같은 원칙으로 접근하면 된다. 공통 템플릿이 있으면 거기에, 없으면 빌드 과정에서 자동으로 주입하는 식으로.

다음엔 이런 chore 작업들을 한데 묶어서 처리하거나, 설정 파일로 관리하는 구조를 고려해 봐야겠다.

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

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

이어보기

댓글 0

첫 댓글 달아줘.