최근에 나는 스레드, 링크드인, 핀터레스트 등에 글을 자동으로 발행하는 파이프라인을 구축했다. 자동으로 글이 척척 배포되는 모습을 보며 뿌듯함에 차 있었는데, 우연히 공유된 링크를 클릭해 보고 충격을 받았다. 카카오톡이나 소셜 채널에 올라간 내 글들이 썸네일도 없고 설명도 없는 삭막한 빈 상자처럼 노출되고 있었기 때문이다.
원인을 찾아 헤맨 끝에 내가 운영하는 issuelog, kidstory, jins-lab, jins-itstory, jins-links 등 5개 테마 모두에 Open Graph 메타 태그가 하나도 설정되어 있지 않다는 사실을 발견했다. 자동 발행이라는 껍데기는 돌고 있었지만, 정작 중요한 소셜 공유 미리보기 기능은 완전히 빠져 있었던 것이다. 이를 해결하기 위해 Blogger Open Graph 메타 태그를 직접 심고 수정하는 작업에 착수했다.
소셜 공유 미리보기를 살려내는 동적 분기 설계
가장 먼저 해결해야 할 과제는 게시글 페이지와 메인/목록 페이지의 메타 정보를 다르게 뿌려주는 것이었다. 모든 페이지에 똑같은 썸네일과 설명이 들어가면 공유하는 의미가 퇴색되기 때문이다. 나는 Blogger 스킨의 조건문을 활용하여 이 문제를 해결하기로 했다.
b:if cond='data:view.isPost' 태그를 사용해 게시글 페이지일 때와 아닐 때로 분기를 나눴다. 게시글 페이지에서는 블로그 글에 등록된 대표 이미지를 가져오는 data:post.featuredImage 값을 og:image로 매핑하고, 글의 요약본인 data:post.snippet을 og:description으로 설정했다. 이렇게 하면 글마다 최적화된 소셜 공유 미리보기가 완성된다.
반면 홈 화면이나 목록 페이지에서는 개별 글의 정보가 필요 없으므로, 블로그 전체를 대표하는 설명을 보여주어야 한다. 이 영역에는 블로그 관리자 설정에서 입력해 둔 data:blog.metaDescription 값을 og:description으로 활용하도록 동적 설계를 적용했다.
링크허브의 예외 상황과 꼼꼼한 메타 태그 빌드
동일한 규칙을 5개 테마 모두에 일률적으로 적용할 수는 없었다. 특히 링크들을 모아두는 jins-links 테마의 경우, 본문 내에 이렇다 할 대표 이미지 자산이 존재하지 않았다. 이미지가 없는데 억지로 og:image를 넣으려다가는 빈 엑스박스나 오류가 날 것이 뻔했다.
고민 끝에 jins-links 테마에는 og:image 태그를 아예 제외하고, 대신 정적인 타이틀과 설명만을 깔끔하게 추가하는 방향으로 예외 처리를 진행했다. 굳이 무리해서 이미지를 넣는 것보다 텍스트 정보라도 정확하게 전달하는 것이 소셜 공유 미리보기 품질을 높이는 길이라 판단했기 때문이다.
나머지 테마들에는 og:title, og:url, og:site_name, og:locale, og:type을 기본적으로 포함시켰다. 이 작업들은 화면에 렌더링되는 시각적 요소를 수정하는 것이 아니라, HTML의 head 영역 안에 메타 태그 정보만 주입하는 작업이라 다행히 기존 스킨의 레이아웃에는 전혀 영향을 주지 않았다.
xmllint 유효성 검증과 든든해진 파이프라인
Blogger 스킨 XML을 직접 수정하다 보면 사소한 태그 닫기 누락이나 문법 오류로 블로그 전체가 먹통이 되는 일이 잦다. 그래서 나는 수정한 5개 테마의 XML 코드들을 적용하기 전에 xmllint 도구를 사용하여 유효성 검증을 꼼꼼하게 진행했다.
다행히 5개 테마 모두 에러 없이 유효성 검사를 통과했고, 실제 블로그에 적용한 뒤 소셜 채널에 링크를 올려 테스트해 보았다. 드디어 삭막했던 링크 카드 대신, 글의 대표 이미지와 핵심 요약문이 예쁘게 담긴 소셜 공유 미리보기가 활성화되는 모습을 확인할 수 있었다.
이번 삽질을 통해 아무리 튼튼한 자동 발행 파이프라인을 구축해 두었더라도, 사용자가 마주하는 마지막 단계인 소셜 공유 미리보기가 부실하면 결국 반쪽짜리 시스템에 불과하다는 점을 뼈저리게 느꼈다. 숨어 있던 마지막 1%의 구멍을 메운 덕분에, 이제는 내가 쓴 글들이 어디서나 제 가치를 온전히 뽐낼 수 있게 되어 매우 뿌듯하다.