path
Jin's Lab
코드로 실험하고 기록하는 개발 일지 · J.Lab

Jin's Lab

코드로 실험하고 기록하는 개발 일지. 커리어와 삶의 방향을 탐색하며 기록하는 공간입니다

Blogger

Blogger Open Graph 메타 태그로 빈 링크 해결하기

J.Lab ·
목차

    최근에 나는 스레드, 링크드인, 핀터레스트 등에 글을 자동으로 발행하는 파이프라인을 구축했다. 자동으로 글이 척척 배포되는 모습을 보며 뿌듯함에 차 있었는데, 우연히 공유된 링크를 클릭해 보고 충격을 받았다. 카카오톡이나 소셜 채널에 올라간 내 글들이 썸네일도 없고 설명도 없는 삭막한 빈 상자처럼 노출되고 있었기 때문이다.

    원인을 찾아 헤맨 끝에 내가 운영하는 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으로 설정했다. 이렇게 하면 글마다 최적화된 소셜 공유 미리보기가 완성된다.

    소셜 미디어 공유 미리보기와 HTML 메타 태그가 화면에 깔끔하게 나타나는 아이소메트릭 일러스트

    반면 홈 화면이나 목록 페이지에서는 개별 글의 정보가 필요 없으므로, 블로그 전체를 대표하는 설명을 보여주어야 한다. 이 영역에는 블로그 관리자 설정에서 입력해 둔 data:blog.metaDescription 값을 og:description으로 활용하도록 동적 설계를 적용했다.

    링크허브의 예외 상황과 꼼꼼한 메타 태그 빌드

    동일한 규칙을 5개 테마 모두에 일률적으로 적용할 수는 없었다. 특히 링크들을 모아두는 jins-links 테마의 경우, 본문 내에 이렇다 할 대표 이미지 자산이 존재하지 않았다. 이미지가 없는데 억지로 og:image를 넣으려다가는 빈 엑스박스나 오류가 날 것이 뻔했다.

    고민 끝에 jins-links 테마에는 og:image 태그를 아예 제외하고, 대신 정적인 타이틀과 설명만을 깔끔하게 추가하는 방향으로 예외 처리를 진행했다. 굳이 무리해서 이미지를 넣는 것보다 텍스트 정보라도 정확하게 전달하는 것이 소셜 공유 미리보기 품질을 높이는 길이라 판단했기 때문이다.

    XML 스킨 파일과 유효성 검증 도구를 도식화한 깔끔한 일러스트

    나머지 테마들에는 og:title, og:url, og:site_name, og:locale, og:type을 기본적으로 포함시켰다. 이 작업들은 화면에 렌더링되는 시각적 요소를 수정하는 것이 아니라, HTML의 head 영역 안에 메타 태그 정보만 주입하는 작업이라 다행히 기존 스킨의 레이아웃에는 전혀 영향을 주지 않았다.

    xmllint 유효성 검증과 든든해진 파이프라인

    Blogger 스킨 XML을 직접 수정하다 보면 사소한 태그 닫기 누락이나 문법 오류로 블로그 전체가 먹통이 되는 일이 잦다. 그래서 나는 수정한 5개 테마의 XML 코드들을 적용하기 전에 xmllint 도구를 사용하여 유효성 검증을 꼼꼼하게 진행했다.

    다행히 5개 테마 모두 에러 없이 유효성 검사를 통과했고, 실제 블로그에 적용한 뒤 소셜 채널에 링크를 올려 테스트해 보았다. 드디어 삭막했던 링크 카드 대신, 글의 대표 이미지와 핵심 요약문이 예쁘게 담긴 소셜 공유 미리보기가 활성화되는 모습을 확인할 수 있었다.

    스마트폰 화면에 썸네일과 설명이 예쁘게 표시된 소셜 공유 카드 일러스트

    이번 삽질을 통해 아무리 튼튼한 자동 발행 파이프라인을 구축해 두었더라도, 사용자가 마주하는 마지막 단계인 소셜 공유 미리보기가 부실하면 결국 반쪽짜리 시스템에 불과하다는 점을 뼈저리게 느꼈다. 숨어 있던 마지막 1%의 구멍을 메운 덕분에, 이제는 내가 쓴 글들이 어디서나 제 가치를 온전히 뽐낼 수 있게 되어 매우 뿌듯하다.

    Blogger MetaTags OpenGraph SEO SocialSharing WebDevelopment
    ← 이전 글
    최근 게시물
    다음 글 →
    이전 게시물
    ≡ 글 목록으로
    소개
    path
    J.Lab

    커리어와 삶의 방향을 탐색하며
    기록하는 공간입니다

    카테고리
    403 Forbidden Error 1 429 Error 1 Ad Exchange 1 Ad Layout Guide 1 ad-slot 1 adsense 2 AdSense 2 AdSense Bot Detection 1 AdSense CTR 1 AdSense Display Issue 1 adsense-optimization 1 AI Automation 1 AI Image Generation 1 ai-automation 2 ai-book-writing 1 ai-image-generation 1 AI-Prompting 1 ai-side-hustle 1 ai-workflow 1 ai-writing 1 AIAutomation 1 AIBlogAutomation 1 AICodeLog 1 AIContentGeneration 1 AIImageGeneration 1 AIWritingErrors 1 API Automation 2 API Retry Design 1 api-automation 1 API-Deprecation 1 api-error 1 api-fallback 1 api-integration 2 api-pagination 1 api-retry-strategy 1 api-troubleshooting 1 APIDebugging 1 APIError 1 APIErrorHandling 1 APIIntegration 3 APIQuotaOptimization 1 APITokenRenewal 1 apps-script-trigger 1 AppsScript 1 appsScriptAutomation 1 AutomatedBlogging 1 automation 5 Automation 4 Automation Queue 1 Automation Scheduler 1 Automation Troubleshooting 1 automation-error 1 automation-script 1 AutomationBug 1 AutomationTroubleshooting 1 Backoff Algorithm 1 Base64 Image 1 Base64Encoding 1 batch-processing 1 BatchProcessing 1 Blog Optimization 2 blog-automation 4 blog-customization 2 blog-migration 4 blog-monetization 1 Blog-Sorting 1 blog-strategy 1 blog-theme-customization 1 blog-workflow 1 blogautomation 1 BlogAutomation 4 Blogger 13 Blogger API 2 Blogger Automation 2 Blogger SEO 1 blogger-api 4 blogger-automation 1 blogger-customization 1 blogger-error-400 1 blogger-labels 1 blogger-seo 1 blogger-theme 1 blogger-theme-debug 1 blogger-tips 1 Blogger-Tips 1 blogger-xml 1 BloggerAPI 7 BloggerAutomation 1 BloggerBypath 1 BloggerCustomization 2 BloggerFavicon 1 BloggerPermalink 1 BloggerTemplate 1 BloggerTemplateEditing 1 BloggerTheme 3 BloggerThemeCustomization 1 BloggerXMLStructure 1 Blogging-Automation 1 BloggingTools 1 BlogQuality 1 BlogSpot 1 Bug Fix 1 bug-fix 1 bug-hunting 1 BWidgetBIncludable 1 card-overlay-css 1 CardClickHandler 1 career-advice 1 CDATA 1 checklist-template 1 clamping-text 1 Claude 1 claude-ai 3 claude-code 2 ClaudeChat 1 ClaudeCode 1 CLIPTokenLimit 1 CloudflareWorkersAI 1 CNAME 1 Code Cleanup 1 Code Integration 1 code-refactoring 1 codelog 1 CodeLog 1 codeRefactoring 1 CodeStack 1 coding-log 2 comment-classification 1 config-pattern 1 Content Strategy 1 Content-Marketing 1 content-monetization 1 content-strategy 1 content-writing 1 contentsequencing 1 ContentStrategy 1 context-management 1 cost-reduction 1 CSS 1 css-axis-rotation 1 css-bug-fix 1 CSS-Debugging 1 css-fix 1 css-flexbox 1 css-layout 3 css-logo 1 css-print 1 css-troubleshooting 1 CSSLayout 1 CSSOverlay 1 Custom Domain 1 custom-theme 1 data-backfill 1 data-parsing 1 data-synchronization 1 data-validation 1 DatabaseDesign 1 DataMigration 1 DataRecovery 1 DataValidation 1 DateInjection 1 debugging 2 Debugging 5 Debugging Log 1 DebuggingLog 1 derived-state 1 detail-page-design 1 dev-journey 2 dev-log 1 Developer-Blog 1 developer-career 1 DeveloperJourney 2 DevJourney 1 DevLog 1 digital-creator 1 digital-products 2 display-none-seo 1 DOM-Inspection 1 dom-manipulation 1 Domain Migration 1 DomainMigration 1 DOMAutomation 1 duplicate-content 1 dynamic-menu 1 ebook-marketing 2 ebook-planning 1 ebook-publishing 5 editing-tips 1 Error Handling 2 error-handling 1 Error-Handling 1 ErrorHandling 2 EventDispatch 1 Execution Timeout 1 ExecutionLimit 1 exponential-backoff 1 FactChecking 1 FallbackSystem 1 FaviconEmbedding 1 Feed-API 1 filesystem 1 Flat Illustration 1 flux-model 1 FluxModel 1 FreeAIImage 1 frontend 1 Frontend 1 frontend-developer 1 frontend-layout 1 frontend-tips 1 FrontEndDev 1 FrontendTips 1 GAS 1 GAS Blogger API 1 GAS Refactoring 1 GAS Trigger 1 gas-automation 2 gas-optimization 1 gas-trigger 1 GASTimeout 1 gasTriggerManagement 1 GCP Project Linkage 1 Gemini 1 Gemini API 2 gemini-api 1 GeminiAPI 3 GeminiPrompt 1 GeminiPromptEngineering 1 getBoundingClientRect 1 github-raw-url 1 GmailRestrictions 1 Google AdSense 1 Google Apps Script 12 Google Discover 1 google-apps-script 8 Google-Apps-Script 1 google-blogger 1 googleAppsScript 1 GoogleAppsScript 12 googlesapps-script 1 GoogleSearchConsole 1 grep 1 hero-image 1 hero-image-validation 1 HTML Fix 1 HTMLCSS 1 HTMLWidgetBlogger 1 http-429 1 HuggingFace 1 HuggingFaceAPI 1 ico-generator 1 Image Optimization 1 image-automation 2 image-generation 1 image-hosting 1 image-optimization 1 image-processing 1 image-upload 1 ImageGeneration 2 ImageIntegrity 1 ImageOptimization 1 In-App Browser 1 invalid-argument 1 javascript 4 JavaScript 4 javascript-automation 1 javascript-toc 1 JavaScriptDevLog 1 JavaScriptInjection 1 jlab-codelog 1 JLabDevLog 1 json-schema 1 label-length-limit 1 lead-magnet 1 legacy-code 1 LinkedIn-API 2 LinkedIn-OAuth 1 LinkHub 1 linux 1 markdown 1 meta-description 1 MetaTags 1 Migration 1 Migration Script 1 mobile-friendly 1 Mobile-Web 1 monetization 1 Monitoring Automation 1 MultilingualSEO 1 NakedDomain 1 Negative Prompt 1 node-js 1 nodejs-automation 1 noindex-tag 1 Notion API 1 notion-api 3 notion-database 2 notion-gas-integration 1 notion-setup 1 notion-template 1 NotionAPI 3 NotionAutomation 1 notionintegration 1 NotionIntegration 1 OAuth Scope 1 OpenGraph 1 padding-overlap 1 pagination 1 payload-validation 1 pdf-generation 1 pdf-publishing 1 pdf-selling 1 permalink-management 1 PersonaDesign 1 pil-image-processing 1 Pinterest 2 PinterestAutomation 1 PipelineFix 1 playwright 1 Pollinations 1 Pollinations Flux 1 pollinations-ai 1 pollinations-api 2 PollinationsAI 1 PositionAbsolute 1 post-queue 1 productivity-tools 1 Prompt Design 1 Prompt Engineering 1 prompt-engineering 3 Prompt-Engineering 1 prompt-validation 1 PromptEngineering 3 Publishing Flow 1 publishorder 1 python-favicon 1 python-markdown 1 python-pil 2 python-scripting 1 Queue Design 1 queue-pattern 1 queue-stuck 1 RandomDelay 1 rate-limiting 1 react 1 React 1 Refactoring 1 Resource Exhausted 1 responsive-ads 1 responsive-design 4 ResponsiveCSS 1 ResponsiveDesign 1 retrospective 1 rfc3339 2 Robots Meta Tag 1 RSS Feed 1 rss-feed 1 RSSProxy 2 SAXParseException 1 Script Authorization 1 scriptNotFound 1 SDXL 1 Search Engine Optimization 2 Search-Engine-Optimization 1 SearchConsole 1 Self Rescheduling Trigger 1 SEO 2 SEO Tips 1 seo-optimization 5 SEO-Optimization 1 SEOOptimization 2 seriesmanagement 1 serverless-automation 1 sessionstart-hook 1 shell-script 1 Side Ad Duplication 1 side-income 1 side-project 1 SidebarLinks 1 SNSMarketing 1 Social-Media-Automation 2 SocialSharing 1 state-management 1 StaticWebPage 1 sub-agent 1 SVG Icon 1 svg-mask 1 SVGIcon 1 Synchronization 1 table-of-contents 1 tech-blogging 1 TechJournal 1 TechVibe 1 Template 1 TextSanitization 1 threads-api 2 Threads-API-Comparison 1 ThreadsAPI 3 time-driven-trigger 1 Tistory 2 tistory-customization 1 tistory-migration 1 tistory-skin 1 tistory-theming 1 tistory-tips 1 TOC Ad Placement 1 token-optimization 1 TranslationAPI 1 transparent-favicon 1 triggerCleanup 1 troubleshooting 2 Troubleshooting 2 typesetting 1 ui-optimization 1 unzip 1 URL Slug 1 UrlFetchApp 1 usememo 1 UTF8Encoding 1 vanilla-js 1 Web Development 2 Web Publishing 2 Web Security 1 web-development 7 Web-Development 2 web-development-log 1 web-development-tips 1 web-layout 1 Web-Layout 1 web-performance 1 web-publisher 1 web-scraping 1 WebAccessibility 1 WebAutomation 1 WebDebugging 1 WebDesign 2 WebDevelopment 10 WebDevelopmentTips 1 WebDevJourney 1 WebMigration 1 windows 1 windows-task-scheduler 2 WorkAutomation 1 workflow-automation 1 WorkflowAutomation 1 writing-process 1 XHTML 1 XMLCustomization 1 XMLParser 1 XMLSpecialCharacters 1 XMLTheme 1 z-index-issue 1 zip 1
    인기 글
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS에서 Blogger API 403 오류 완전 정복 — appsscript.json 스코프와 GCP 프로젝트 연결
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    GAS 트리거 방치했다가 오류 폭탄 맞은 이야기 — 함수명 바꿀 때 트리거도 꼭 같이 정리하세요
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    Notion API page_size 함정 — 우선순위 항목이 조회에서 빠지는 이유와 해결법
    다른 블로그
    IssueLog
    IssueLog
    issuelog.jinbytes.com
    KidStory
    KidStory
    kidstory.jinbytes.com
    IT Story
    IT Story
    jinbytes.com
    이야기하는 밤
    이야기하는 밤
    story.jinbytes.com
    [eBook] 개발자로 살아간다는 것
    [eBook] 개발자로 살아간다는 것
    유료 전자책
    [eBook] FE 실무 디테일
    [eBook] FE 실무 디테일
    유료 전자책
    [미니북] FE 실무 디테일
    [미니북] FE 실무 디테일
    무료 미니북
    © Jin's Lab · J.Lab · All Rights Reserved
    jinbytes.com · Powered by Blogger