일하는 ai

05. 배포 5분 체크

12 min read

-

배포 품질은 거창한 최적화보다, 배포 직전 5분에 무엇을 확인하느냐에서 갈린다. 특히 Quartz처럼 정적 사이트를 운영할 때는 한 번의 누락이 곧바로 인덱싱 지연, 유입 감소, 광고 노출 누락으로 이어질 수 있다. 이 문서는 실제로 사고가 자주 나는 항목만 남겨, 배포 직전에 바로 따라 할 수 있게 정리한 실전 점검표다.

안내: 본문에는 생성형 AI를 활용해 정리한 운영 체크리스트가 포함되어 있습니다.

flowchart TD
A[배포 직전 5분] --> B[정적 파일 3종 확인]
A --> C[SEO 신호 확인]
A --> D[상위 유입 문서 클릭 테스트]
A --> E[광고/정책 페이지 확인]
A --> F[모바일·데스크톱 최종 품질 점검]
B --> Z[배포]
C --> Z
D --> Z
E --> Z
F --> Z

먼저 기억할 1가지

배포 전 점검은 “모든 페이지를 다 보는 일”이 아니다. 유입이 끊기면 바로 티 나는 신호부터 빠르게 확인하는 일이다. 그래서 이 문서도 파일 3종 → SEO → 상위 문서 클릭 → 광고 → 최종 가독성 순서로 잡았다. 이 순서는 문제가 생겼을 때 피해가 큰 순서이기도 하다.

1) 60초: 파일 3종부터 확인한다

가장 먼저 볼 것은 ads.txt, robots.txt, sitemap.xml이다. 이 셋은 겉보기에 사소해 보여도, 빠지면 검색과 광고 쪽에서 조용히 손실이 난다.

  • https://aiee.app/ads.txt → 200 응답 + 퍼블리셔 ID 확인
  • https://aiee.app/robots.txt → 200 응답 + sitemap 라인 포함 확인
  • https://aiee.app/sitemap.xml → 200 응답 + 최근 배포 URL 반영 확인

실무에서는 새 글을 잘 배포해 놓고도 quartz/static 누락 때문에 robots.txt나 ads.txt가 빠지는 경우가 있다. 이때 사이트는 열리기 때문에 한동안 아무도 못 알아차리다가, 며칠 뒤 검색 반영이 이상하거나 광고 인증 경고가 떠서 뒤늦게 발견한다.

예를 들어:

  • 실패 사례: 새 테마 정리 후 robots.txt가 빠져서 크롤러가 기준 파일을 읽지 못함
  • 복구 흐름: 정적 파일 경로 확인 → 다시 빌드/배포 → 200 응답 재확인

검증은 브라우저에서 직접 열어도 되고, 서버에서 curl -I로 상태코드만 먼저 봐도 된다.

공식 참고:

2) 60초: canonical과 noindex를 같이 본다

검색 유입이 갑자기 흔들릴 때는 콘텐츠 품질보다 SEO 신호가 엇갈린 경우가 더 많다. 특히 canonical과 noindex는 한 줄만 잘못 들어가도 영향이 크다.

배포 직전에는 대표 페이지 1개만 열어서 아래를 본다.

  • canonical이 aiee.app 기준으로 잡혀 있는가
  • noindex가 실수로 들어가지 않았는가
  • wk.aiee.app 같은 보조 도메인 접속 시 aiee.app로 301 리다이렉트되는가

여기서 자주 나오는 사고는 두 가지다.

  1. canonical 오설정
    미리보기 도메인이나 옛 주소가 canonical로 남아 있으면, 검색엔진은 “대표 주소가 이쪽이구나”라고 오해한다.
  2. noindex 잔존
    테스트용 설정을 빼지 않고 배포하면, 페이지는 정상인데 검색 결과에서는 안 보인다.

간단한 미니 사례로 보면:

  • before: 프리뷰 환경에서 테스트하다가 canonical이 임시 도메인으로 남음
  • after: 본 도메인으로 수정 후 재배포, 대표 URL 신호 정상화

검증은 페이지 소스 보기에서 canonical, noindex 문자열만 검색해도 충분하다.

공식 참고:

3) 60초: 상위 유입 가능성이 높은 문서 5개만 클릭한다

배포 전 링크 점검은 전체 링크 검사보다 상위 유입 가능성이 높은 문서 몇 개를 직접 눌러 보는 방식이 더 빠르고 실용적이다. 보통 아래 5개만 확인해도 큰 사고는 대부분 걸린다.

  • 홈
  • 메인 허브(예: Agent / Tip / Trend)
  • 최신 QuickView 또는 WeeklyView
  • 최근 실전 가이드 1개
  • 검색 유입이 꾸준한 대표 문서 1개

체크할 때는 “열리느냐”만 보지 말고 다음 순서로 본다.

  1. 클릭 즉시 열리는가
  2. 한글 경로 인코딩이 깨지지 않는가
  3. 문서 안의 관련글/다음글 링크가 비어 있지 않은가
  4. 이미지나 임베드가 첫 화면에서 깨지지 않는가

이 단계가 중요한 이유는, 배포 실패가 아니라 링크 구조 실패를 잡아내기 때문이다. 실제로 새 글은 잘 올라갔는데 허브 링크를 안 바꿔서 유입이 메인 문서로 못 들어오는 경우가 꽤 많다.

작업 팁:

  • 작성자 1명이 배포했으면, 다른 기기에서 1회 더 눌러 보는 것이 좋다.
  • 직접 작성한 사람은 캐시 때문에 놓치는 경우가 있어서, 모바일 시크릿 창 점검이 특히 유효하다.
  • 바로 직전에 문서를 대량 이동/삭제/리네임했다면, 일반 재시작보다 삭제 뒤 ENOENT 재빌드 해결 루틴을 먼저 확인하는 편이 안전하다.

칠판 치트시트

배포 5분 점검 순서

  1. ads.txt / robots.txt / sitemap.xml 200 확인
  2. canonical / noindex / 301 확인
  3. 상위 유입 문서 5개 클릭
  4. 광고 스크립트 + 정책 페이지 확인
  5. 모바일/데스크톱 첫 화면 가독성 확인

4) 60초: 광고와 정책 페이지는 같이 본다

광고 문제는 “광고가 안 붙는다”로만 나타나는 것이 아니다. 실제로는 정책 페이지 누락, 스크립트 누락, 배포 템플릿 변경 같은 작은 차이에서 시작되는 경우가 많다.

배포 직전에는 아래 두 묶음을 함께 확인하면 된다.

광고 스크립트

  • HTML에 adsbygoogle.js?client=ca-pub-8316723582628925 노출 여부 확인

정책 페이지 4종

  • /about
  • /contact
  • /privacy-policy
  • /terms

이때 좋은 점검 방식은 “광고만 본다”가 아니라, 광고 노출 조건을 설명할 수 있는 페이지가 같이 살아 있는지를 함께 보는 것이다. 사이트 신뢰 신호는 조용히 무너지는 편이라, 이런 기본 페이지가 빠지면 나중에 한꺼번에 손해가 난다.

미니 사례:

  • 실패: 레이아웃 정리 중 공통 스크립트가 빠져 광고 스크립트가 사라짐
  • 성공 복구: 공통 헤드 파일 복구 후 HTML 소스에서 client ID 재확인

공식 참고:

5) 60초: 마지막은 성능보다 가독성부터 본다

배포 직전 1분이 남았을 때는 Lighthouse 점수보다 사용자가 첫 화면에서 읽을 수 있는지가 더 중요하다. 점수는 나중에 고칠 수 있지만, 첫 화면이 깨지면 바로 이탈이 생긴다.

그래서 마지막 점검은 단순하게 간다.

  • 모바일 1회 로딩
  • 데스크톱 1회 로딩
  • 첫 화면 핵심 링크 Top 3가 바로 보이는가
  • 이미지가 과하게 크거나 깨지지 않는가
  • 제목과 요약이 첫 화면에서 읽기 쉬운가

초보 운영자라면 여기서 “빠르냐”보다 “이상하진 않냐”를 먼저 보면 된다. 실제 운영에서는 0.2초 차이보다, 깨진 이미지 1장과 안 보이는 CTA 1개가 더 치명적일 때가 많다.

복붙용 체크리스트

  • ads.txt 200 + 퍼블리셔 ID 확인
  • robots.txt 200 + sitemap 라인 확인
  • sitemap.xml 200 + 최신 URL 반영 확인
  • canonical / noindex 점검
  • 보조 도메인 → 본 도메인 301 확인
  • 상위 유입 문서 5개 클릭 테스트
  • 관련글/다음글 링크 확인
  • AdSense 스크립트 노출 확인
  • 정책 페이지 4종 접근 확인
  • 모바일/데스크톱 1회씩 최종 확인

누가 무엇을 어떤 순서로 하면 좋나

운영이 1인 체제라면:

  1. 작성자 본인이 파일 3종과 SEO 신호를 먼저 확인한다.
  2. 같은 사람이 모바일 시크릿 창으로 상위 문서 5개를 클릭한다.
  3. 마지막으로 광고/정책 페이지와 첫 화면 가독성을 본다.

운영이 2인 이상이라면:

  1. 배포한 사람이 파일 3종 + SEO를 본다.
  2. 다른 사람이 모바일에서 대표 문서 5개를 클릭한다.
  3. 마지막 30초에 둘 중 한 명이 정책 페이지와 광고 스크립트를 다시 본다.

다음 읽기

배포 품질은 결국 습관 싸움이다. 체크리스트가 길어 보이더라도, 실제로 해보면 5분 안에 끝난다. 중요한 건 매번 같은 순서로 확인해서, 조용히 유입을 깎아먹는 실수를 배포 전에 끊어내는 것이다.

그래프 뷰

백링크