![Featured image of post [애드센스 #1] Hugo 블로그 애드센스 연동 가이드](/ko/hugo-adsense-configuration/cover_hu_fe2fa490f44b55f3.webp)
TL;DR
- 스크립트 삽입:
layouts/partials/head/custom.html에 애드센스 코드를 추가한다. - 소유권 확인:
static/ads.txt파일을 만들어 퍼블리셔 ID를 입력한다. - 검토 대기: 설정을 마치면 구글의 최종 검토와 승인을 기다리면 된다.
구글 애드센스, Hugo에서는 어떻게 시작할까
Hugo로 블로그를 만들고 나면 운영을 지속하기 위해 구글 애드센스 연동을 고려하게 된다. 하지만 Hugo는 정적 사이트 생성기(SSG)라서 티스토리나 워드프레스처럼 버튼 클릭 한 번으로 끝나지 않는다. 처음 접하면 설정 방식이 낯설게 느껴질 수 있다.
나 역시 처음 Hugo를 시작했을 때 테마의 레이아웃 구조 속에서 애드센스 스크립트를 어디에 넣어야 하는지 찾는 데 애를 먹었다.
이 글에서는 실제로 블로그를 운영하며 정리한 Hugo(특히 hugo-theme-stack) 환경의 애드센스 설정 방법을 다룬다. 애드센스 시리즈의 첫 번째 글로, 실제 설정 절차 위주로 설명한다.
Hugo 블로그에 애드센스 광고를 붙이는 작업
애드센스 코드 스니펫 삽입하기
애드센스 승인을 받으려면 가장 먼저 구글이 제공하는 코드 스니펫을 블로그에 심어야 한다.
애드센스에서 제공하는 이 코드를 복사해서 블로그에 심어야 한다.
Hugo는 정적 사이트 생성기(SSG)다. 워드프레스처럼 플러그인 버튼 하나로 해결되지 않는다. 하지만 원리만 알면 오히려 더 깔끔하게 관리할 수 있다.
커스텀 파셜(Partial) 활용하기
hugo-theme-stack 테마를 사용 중이라면, 테마 원본 파일을 수정하는 대신 오버라이드(Override) 방식을 써야 한다.
- 프로젝트 루트 폴더에
layouts/partials/head/디렉토리를 만든다. (이미 있다면 통과) - 그 안에
custom.html파일을 생성한다. - 애드센스에서 복사한 코드를 그대로 붙여넣는다.
<!-- layouts/partials/head/custom.html -->
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-XXXXXXXXXXXXXXXX"
crossorigin="anonymous"></script>
이렇게 하면 빌드될 때 hugo-theme-stack이 자동으로 이 코드를 <head> 섹션에 포함시킨다. 테마를 업데이트해도 설정이 사라지지 않는 방식이다.
ads.txt로 내 소유권 증명하기
애드센스 대시보드에서 “수익 손실 위험 - ads.txt 파일을 찾을 수 없습니다"라는 경고를 본 적이 있을 것이다. 이 파일은 구글 광고 시스템에 “이 사이트는 내 소유니 수익을 나한테 달라"고 알려주는 필수 문서다.
Hugo에서 static 폴더는 특별하다. 여기 넣는 파일은 빌드 후 웹사이트의 **루트 주소(/)**에 그대로 배치된다.
설정 방법:
- 프로젝트 루트의
static/폴더로 이동한다. ads.txt라는 이름의 텍스트 파일을 만든다.- 구글에서 제공하는 한 줄의 파트너 정보를 입력한다.
google.com, pub-XXXXXXXXXXXXXXXX, DIRECT, xxxxxxxxxxxxxxxx
소유권 확인 파일까지 올렸다면 설정은 끝났다. 이제 구글의 답을 기다릴 차례다.
사이트 검토 및 승인 대기 과정 이해하기
설정을 마쳤다고 바로 광고가 나오지는 않는다. 구글의 검토 과정을 거쳐야 한다. 보통 며칠에서 길면 2주 정도 걸린다.
- 사이트 검토 중: 구글 봇이 사이트를 방문해 정책 준수 여부와 콘텐츠 양을 확인한다.
- 검토 중엔 그대로 두기: 애드센스 코드를 삭제하거나 테마 설정을 크게 바꾸지 않는 게 좋다. 봇이 방문했을 때 설정이 바뀌어 있으면 검토가 지연될 수 있다.
- 꾸준함이 핵심: 검토 대기 중에도 포스팅을 멈추지 않는 게 좋다. 살아있는 블로그라는 인상을 주는 것이 승인 확률을 높인다. (
물론 나도 기다리는 동안 메일함을 몇 번이나 새로고침했다)
설정을 마쳤다면
기술적인 설정은 여기까지다. 남은 건 꾸준한 포스팅이다. 테마마다 경로가 조금씩 다를 수 있으니 막히는 부분이 있으면 댓글로 물어봐도 된다.