OG 미리보기 FAQ
카톡·네이버·페북·X 미리보기 누락 원인, 캐시 갱신, SPA prerender, 한글 파일명, X 카드 등 자주 묻는 10가지 질문.
자주 묻는 질문 (10)
카카오톡 미리보기가 안 뜨는 가장 흔한 원인은?
og:image 가 HTTPS 가 아닌 HTTP 거나, og:title 또는 og:description 이 누락된 경우가 가장 많습니다. 카카오톡은 카카오 디벨로퍼스 캐시 정책상 한 번 등록된 미리보기를 24~72시간 캐시하므로, 변경 후 즉시 반영하려면 카카오 디버거(developers.kakao.com)에서 강제 갱신해야 합니다. 본 도구는 4대 플랫폼 동시 진단으로 누락 태그를 즉시 보여줍니다.
og:image 권장 크기는 플랫폼별로 다른가요?
네, 카톡은 5:2(800×320), 페북은 1.91:1(1200×630), X는 1200×675, 네이버는 1:1 또는 1.91:1 모두 허용입니다. 하나의 이미지로 모두 만족하려면 1200×630 비율의 중앙 안전영역에 핵심 텍스트를 배치하는 것이 표준입니다. 본 도구는 4대 플랫폼 시뮬레이션으로 실제 렌더링을 미리 보여줍니다.
React SPA·Vue SPA 에서 OG 가 누락되는 이유는?
SPA 는 초기 HTML 에 빈 head 만 있고 클라이언트 JS 가 실행된 뒤에 OG 태그가 주입됩니다. 카카오·네이버·페북 크롤러는 JS 를 실행하지 않으므로 OG 태그를 보지 못합니다. 해결책은 SSR(Next.js·Nuxt) 또는 prerender(Puppeteer 기반 정적 HTML 생성)입니다. 본 도구의 진단 결과에서 "SPA 패턴 감지" 메시지가 나오면 prerender 도입을 권장합니다.
og:image 캐시가 갱신되지 않을 때 강제 갱신 방법은?
카카오: developers.kakao.com/tool/debugger/sharing 에서 URL 입력 후 "디버그" 클릭. 페북: developers.facebook.com/tools/debug 에서 "Scrape Again" 클릭. 네이버: 별도 디버거 없음 — URL 끝에 ?v=2 같은 쿼리 추가하면 새 URL 로 인식. X: 카드 검증기는 없으며 트윗으로 직접 게시해야 확인 가능합니다.
OG 이미지의 텍스트가 모바일에서 잘 안 보이는 이유는?
모바일 카톡·X 미리보기는 가로 360~480px 크기로 표시되어 1200×630 이미지의 글자가 작게 보입니다. 텍스트는 60~80px 굵은 폰트 + 안전 여백 50px 이상이 권장이며, 한 줄 최대 15자·2줄까지가 표준입니다. 본 도구는 모바일·데스크탑 미리보기 두 가지 모두 시뮬레이션해 보여줍니다.
한글 파일명 OG 이미지는 안 되나요?
URL 인코딩이 올바르면 작동하지만 일부 SNS(특히 카카오톡 구버전)에서 깨지는 사례가 보고됩니다. 안전하게는 영문 파일명을 권장하며, 한글 파일명을 쓰더라도 og:image URL 자체는 percent-encoded 형태로 작성하세요. 본 도구는 URL 디코딩 패턴을 검사해 위험 신호를 표시합니다.
X(트위터) 카드는 별도 메타가 필요한가요?
twitter:card·twitter:title·twitter:description·twitter:image 4개가 권장입니다. 누락되면 og:* 로 fallback 되지만 card 종류(summary vs summary_large_image)는 twitter:card 가 있어야만 정확히 제어됩니다. 큰 이미지 카드를 원하면 twitter:card=summary_large_image 필수입니다.
og:url 과 canonical 의 차이는?
og:url 은 SNS 공유 시 표시되는 정규 URL 이며, canonical 은 검색엔진(구글·네이버)이 인식하는 정규 URL 입니다. 두 값은 일반적으로 같아야 하며, 캠페인 파라미터(?utm=)가 붙은 변형 URL 에서도 og:url·canonical 은 원본을 가리켜야 SNS 공유 시 중복 등록을 방지할 수 있습니다.
이미지 없이 텍스트만으로 OG 를 만들 수 있나요?
og:image 가 없어도 미리보기는 동작하지만 글자만 작게 표시됩니다. 정보 밀도가 높은 페이지(블로그 글·뉴스)는 텍스트 중심 OG 가 클릭률이 오히려 더 높습니다. 다만 카카오톡은 이미지 없는 미리보기가 매우 작게 표시되므로, 최소한의 단순 로고·텍스트 이미지라도 추가하는 것이 권장됩니다.
본 도구 진단 결과는 어디에 저장되나요?
URL 입력값·진단 결과 모두 브라우저 안에서만 처리되며 서버로 전송되지 않습니다. 다만 OG 데이터를 가져오기 위해 본 도구의 프록시 서버가 URL 에 접근하는 1회 HTTP 요청은 발생하며, 이는 캐시되지 않고 즉시 폐기됩니다. 본 도구는 카카오·네이버·페북·X 와 무관한 개인 운영 도구입니다.