본문으로 건너뛰기
NFC 성경키링 메이커노트 · 3/7시리즈 보기 →

(웹서비스 배포) 출고 후 URL 변경을 줄이려면: 말씀 카드 웹앱을 Cloudflare Pages로 옮기고 카카오 로그인·공유를 붙인 기록

· 약 6분
Datapopcorn CEO / AI automation educator
이 글과 연결된 글 보기
11편 · 35개 연결
100%
카페 원가·마진 계산기: 우유값 오르면 어떤 메뉴부터 남는 게 줄어들까교회들은 성경의 어디를 설교할까? 유튜브 설교 14편을 성경 3만 1천 절 위에 찍어본 MVP 기록(기획) 스마트폰을 대면 말씀이 뜨는 키링, 왜 3D 프린팅 + NFC로 만들었나(디자인·3D 출력) 25mm NFC 스티커를 미니 성경책 안에 숨기기: Blender 스크립트 설계와 Bambu Lab A1 출력(웹서비스 배포) 출고 후 URL 변경을 줄이려면: 말씀 카드 웹앱을 Cloudflare Pages로 옮기고 카카오 로그인·공유를 붙인 기록(패키징·물류) NFC 스티커 100개 소싱부터 풀필먼트 취소까지: 6,900원짜리 키링의 물류 계산(상세페이지 제작·입점·가격) 6,900원에서 13,900원 무료배송까지: 스마트스토어·쿠팡 입점 후 한 달간 가격을 세 번 바꾼 이유(세일즈·마케팅) 쿠팡 광고 116클릭 주문 0건, 반려된 릴스, 그리고 교회 단체 주문: 성경키링 세일즈 한 달(운영 자동화·회고) 주문 알림은 Slack으로, 원가는 아직 모른다: NFC 성경키링 운영 자동화와 7부작 회고RevenueCat은 누가, 언제, 왜 써야 할까: 앱 구독 결제 도입 판단부터 연동까지설교 말씀 찾기: 유튜브 자동 자막 3,101편으로 '그 말씀, 어느 설교였지?'를 찾는 서비스를 만든 과정

드래그로 이동 · 휠/두 손가락으로 확대 · 방향키로 글 선택 · 0으로 맞춤. 실선: 본문 링크, 점선: 시리즈·주제의 대표 연결.

표시된 글 11편 목록
전체 글 연결 탐색

(웹서비스 배포) NFC 성경키링 메이커노트 3/7

NFC 성경키링에 연결되는 말씀 웹서비스를 만들고 배포한 기록입니다. Cloudflare Pages 배포, 카카오 로그인·공유, 방문과 사용 행동 측정을 다룹니다. 실물 키링 구매 없이도 아래 서비스 링크로 화면을 볼 수 있습니다.

네이버 제품 · 쿠팡 제품 · 인스타그램 @3d_polypop · 말씀 웹서비스

말씀 웹서비스의 실제 화면과 복사·이미지·카카오톡·저장·다음 말씀 버튼

말씀 웹서비스의 2026년 9월 27일 화면입니다. 3D 모델 미리보기와는 별개의 페이지입니다.

배경: 서버가 없어야 빠르고, 빠르지 않으면 폰을 뗀다​

NFC 태깅은 사용자가 폰을 키링에 대고 있는 1~2초 동안 일어납니다. 그 사이에 페이지가 안 뜨면 "안 되네" 하고 폰을 떼고, 그 키링은 다시 안 씁니다. 그래서 웹앱은 처음부터 서버 없는 정적 HTML·JavaScript를 바탕으로 만들었습니다. 첫 버전의 말씀 데이터는 페이지 안에 들어 있었고, 셔플과 북마크는 브라우저의 localStorage에서 처리했습니다. 이후 버전에는 선택형 로그인과 서버 동기화가 추가됐습니다. 2026년 2월에 Claude Code로 만든 첫 버전이 이 구조였고, 랜덤 말씀, 복사, 카카오톡 공유, 닉네임 기반 북마크까지 하루 안에 나왔습니다.

목표: 8월에 다시 만들면서 정한 것​

4월에 실험용으로 등록했던 상품을 8월에 제대로 팔기로 하면서, 웹앱도 다시 봤습니다. 정한 목표는 세 가지였습니다.

  1. 로그인 없이 그대로 읽을 수 있어야 한다. 로그인은 "원하면" 하는 선택 기능
  2. 호스팅은 상업 이용에 문제가 없고, 도메인이 바뀔 일이 없는 곳
  3. 어떤 키링에서 유입됐는지, 태깅 후 실제로 말씀을 읽었는지 측정할 수 있어야 한다

구현 1: Vercel에서 Cloudflare Pages로​

첫 버전은 Vercel을 사용했습니다. 그런데 Hobby 플랜은 상업적 사용을 제한합니다. 판매하는 제품의 URL이 약관상 애매한 곳을 가리키고 있으면, 나중에 서비스가 막혔을 때 이미 팔린 키링을 회수할 방법이 없습니다. 그래서 8월 19일에 Cloudflare Pages로 옮겼습니다. GitHub 저장소의 main 브랜치를 연결하고, 빌드 명령 없이 webapp-neo 폴더를 그대로 배포하도록 설정했습니다. 정적 HTML이라 빌드가 필요 없고, 푸시하면 몇 분 안에 반영됩니다.

Cloudflare Pages
- 저장소: team-datapopcorn/vibecoding-nfc-bible (main)
- 빌드 명령: 없음
- 출력 디렉터리: webapp-neo
- 배포 URL: https://nfc-bible.pages.dev/

구현 2: 읽기는 로그인 없이, 저장은 카카오 로그인 후​

첫 버전에는 닉네임과 로컬 북마크가 있었습니다. 이후 로그인 기능이 추가됐고, 현재 고객 안내는 말씀 읽기는 로그인 없이 가능하고 저장은 카카오 로그인 후 이용하는 방식입니다. 저장한 말씀은 기기 보관이 기본이며, 별도 동의 시 구절 ID를 서버(Supabase)에 동기화합니다. 로그인은 Supabase의 카카오 OAuth를 썼고, 카카오 개발자 콘솔에서 닉네임·프로필·이메일을 모두 "선택 동의"로 두었습니다. 필수 동의 항목을 만들면 카카오 비즈니스 앱 전환이 필요해지는데, 이 서비스에는 그럴 이유가 없었습니다.

여기서 상세페이지 카피를 한 번 고쳤습니다. 처음에는 "회원가입·서버 저장 없음"이라고 썼는데, 로그인 기능이 생긴 뒤에는 틀린 말이 됩니다. 현재 고객 화면은 "읽기는 로그인 없이, 저장은 카카오 로그인 후 이용"으로 안내합니다. 실물 제품의 안내 문구는 서비스가 바뀌면 같이 바꿔야 합니다.

구현 3: 카카오톡 공유가 갑자기 안 된 이유​

Cloudflare로 옮긴 다음 날, 카카오톡 공유 버튼이 동작하지 않았습니다. 카카오 개발자 콘솔의 "JavaScript SDK 도메인"에는 새 도메인을 등록해 두었는데도 그랬습니다. 원인은 다른 설정이었습니다. 카카오톡 공유는 "앱 설정 > 제품 링크 관리 > 웹 도메인"에도 도메인이 등록되어 있어야 합니다. JS SDK 도메인과 별개입니다. 여기에 https://nfc-bible.pages.dev를 추가하니 바로 해결됐습니다. 도메인을 옮길 때 카카오 콘솔에서 확인할 곳은 최소 세 군데입니다.

  • 플랫폼 > Web > 사이트 도메인 (JS SDK 초기화)
  • 제품 링크 관리 > 웹 도메인 (카카오톡 공유)
  • 카카오 로그인 > Redirect URI (OAuth 콜백)

구현 4: 어떤 키링에서 왔는지 측정하기​

NFC 유입을 구분하기 위해 URL 파라미터를 설계했습니다. 다만 판매된 실물 스티커에 어떤 URL과 파라미터가 기록됐는지는 확인하지 못했습니다. 캠페인 bible_keyring과 색상 코드별 콘텐츠 파라미터를 사용할 수 있게 구성했지만, 현재 색상 매핑은 8개 중 4개만 갖춰졌습니다. 웹앱에서는 유입 파라미터의 is_nfc_entry 값으로 NFC 후보 유입을 다른 방문과 나누도록 설계했습니다. 이 값만으로 실물 태깅을 증명할 수는 없습니다.

측정 도구는 두 개를 씁니다. GA4에는 NFC 태그 성과(캠페인·콘텐츠별)와 NFC 여부(is_nfc_entry별) 탐색 보고서를 저장해 두었습니다. PostHog에는 Web Vitals 자동 수집을 켜고, 이벤트를 정리했습니다. 처음에는 "다음 말씀 받기"를 누른 Verse Shuffle을 핵심 지표로 봤는데, 실제로는 태깅 후 첫 말씀이 렌더링된 Verse Initial이 "태깅이 성공했다"는 신호라서 이걸 활성화 이벤트로 삼았습니다. 공유, 복사, 이미지 저장, 북마크, 로그인, 스토어 링크 클릭은 그 뒤에 오는 전환 이벤트입니다.

결과​

지금 서비스는 태깅하면 말씀 카드, 복사·이미지 저장·카카오톡 공유·저장 버튼, "다음 말씀 받기", 테마 변경, 그리고 함께한 날 수와 읽은 횟수를 보여주는 "내 기록"까지 제공합니다. 성경 본문은 개역한글판(1961, 대한성서공회)을 쓰고 출처를 화면 하단에 표기했습니다. PostHog 주간 리포트는 매주 월요일 아침 Slack으로 보내도록 설정했습니다. 실제 수신 여부는 따로 확인해야 합니다.

아직 안 된 것도 있습니다. 색상 코드 매핑은 8개 중 4개만 정리되어 있고, 프로덕션과 스테이징이 PostHog 프로젝트 하나를 같이 쓰고 있어 환경 분리가 필요합니다. Supabase 보안 어드바이저는 대시보드 요약에서 "문제 없음"이라고 보여주지만 상세 항목에는 RLS 정책과 익명 실행 함수 관련 검토 항목이 남아 있습니다.

배운 점​

가장 큰 교훈은 판매된 태그 주소를 일괄 수정하기 어렵다는 점입니다. 태그 재기록 가능 여부와 별개로, 기존 주소를 유지하거나 리디렉션할 수 있는 구조를 준비해야 합니다. 호스팅 이전은 새 페이지 배포뿐 아니라 이미 출고한 태그와 인쇄물 확인까지 포함합니다. 두 번째는 서비스가 바뀌면 실물 제품의 안내 문구도 같이 바뀐다는 점입니다. 소프트웨어는 배포하면 끝이지만, 상세페이지와 인서트 카드는 따로 고쳐야 합니다. 세 번째는 활성화 이벤트를 "사용자가 뭘 눌렀나"가 아니라 "태깅이 성공했나"로 잡아야 한다는 것입니다. 실물 트리거 제품에서는 첫 화면이 뜬 것 자체가 전환입니다.

다음 액션​

다음 편은 물류입니다. 알리익스프레스에서 NFC 스티커 100개를 사면서 걸린 가격 함정, 80×80mm 개별 포장과 합포장 계산, 그리고 네이버 풀필먼트(N배송)를 신청했다가 560개 입고를 취소한 이유를 다룹니다.

제품과 관련 자료​

다음 편: 패키징·물류

전체 연결 보기