① 승리창 — 광고보고 골드 2배
- 보상량: 이번 판에서 실제로 번 재화(
lastEarned) 그대로 한 번 더 지급 — 즉 최종 표시가 N → 2N으로 두 배.
- 노출 시점: 카운트업+"쿠웅" 연출이 끝난 직후(약 0.3초 뒤) — 길건너친구들의 "신기록 직후 감정적 순간에 노출"을 참고.
- 제약: 판당 1회만(재사용 방지 플래그),
lastEarned=0이면(예: god모드 즉시승리처럼 실제 획득이 없는 경우) 버튼 자체를 안 보여줌.
② 게임오버 — 광고보고 이어하기
- 메커니즘: 완전한 "부활"이 아니라 최근 수를 최대 3번 되돌리기(기존 undo 스택 재사용) → 다른 수를 시도할 기회.
- 판단 근거: 스파이더 솔리테어는 "그 자리에서 계속하기"가 없는 게임(막힌 상태 = 이동 불가능한 상태 그 자체) — 완전 부활 대신 "몇 수 전으로 → 다른 선택"이 가장 자연스러운 근사치라고 판단.
- 제약: 되돌릴 기록(
history)이 있을 때만 버튼 노출.
③ 가챠 화면 — 광고보고 무료 뽑기 1회
- 기존
gachaDraw()에 free 파라미터 추가 — 비용 차감만 건너뛰고 나머지 뽑기 로직(연출·확률)은 100% 동일.
- 컬렉션 다 모았으면(더 뽑을 캐릭터 없음) 버튼 자체 숨김.
- 참고사항 발견: 가챠 비용이 실제로는 150G였습니다(앞서 대화에서 "100G로 이미 일치"라고 말씀드린 건 확인 결과 오류였습니다 — 정정합니다). 길건너친구들 Prize Machine은 100코인. 수정 완료 사용자 확인 지시로 100G로 변경 완료(현재 상태).
- 노출 빈도 수정(2026-07-05, 2차): 최초 구현 땐 컬렉션이 남아있으면 버튼이 항상 떠 있었는데, 사용자가 "cr도 그래?"라고 재확인 → 리서치 원문("광고 재고 소진 방지 위해 의도적으로 항상 뜨진 않음", 확신도 확실)이 반영 안 돼 있었음을 발견 → 1차로 50% 확률 도입.
- 추가 정정(2차): 사용자가 "CR이 그렇게 자주 뽑게 하진 않았던 것 같다"고 기억 기반 피드백 → 웹 재검색까지 했지만 정확한 수치(%, 몇 분/몇 판마다 등)는 어디에도 공개돼 있지 않음(PocketGamer.biz·mobiledevmemo 케이스 스터디 등 전부 "무작위로만 노출"이라고만 서술). 정확한 수치가 없어 임시로 Ads.ready.rewarded + 20% 확률로 낮춰서 임시 확정.
- 최종 재설계(3차) — CR 대신 업계 일반 사례로 확장 조사: 사용자가 "결제 전환에 가장 유리한 방식이 뭐냐"고 재질문 → CR 한 게임이 아니라 업계 전반을 재조사. 결과: 캐주얼게임 보상형광고는 세션당 6~10회/일일 15~20회 상한, 쿨다운 60~90초가 일반 가이드라인이고, opt-in(클릭)률은 40~70%가 건강한 범위(너무 자주 뜨면 opt-in률이 떨어져 역효과). 결정적으로 코인마스터 사례: "스핀 수가 적을 때" TV 광고 아이콘이 뜬다는 게 확인됨 — 순수 랜덤보다 "상황 맥락상 필요한 순간"에 노출하는 게 전환율이 높다는 원칙. → 랜덤 20%를 폐기하고 골드가 뽑기비용의 2배(200G) 미만일 때만 + 실제 광고 로드됐을 때만 노출로 최종 확정. 이 조건 자체가 자연히 간헐적(골드 넉넉하면 자동으로 안 뜸)이라 별도 확률 불필요.
④ 평점 요청 팝업
- 트리거: 캐릭터 3종 수집 시점(길건너친구들 참고자료의 "3~4종 수집+가챠 당첨 즈음" 추정치 채택), 평생 1회만(localStorage 플래그).
- 스토어 URL:
play.google.com/store/apps/details?id=com.magpiesstudio.ssolytown — 패키지명 기준 실제 예측 가능한 주소. 주의 앱이 아직 미출시라 지금은 404지만, 출시 후 그대로 작동하는 진짜 URL입니다(가짜 placeholder 아님).
⑤ 무료선물 타이머
- 쿨다운 단계: 즉시 → 3분 → 6분 → 30분 → 1시간 → 2시간 → 3시간(이후 고정) — 길건너친구들의 점증 구조 그대로 채택.
- 보상량: 처음엔 우리 경제규모(세트 8×1 + 포인트카드)에 맞춰 3~15로 축소해서 채택했었으나, 수정 완료 사용자 지시로 길건너친구들 원본 그대로 복원 — 평소 40~520(더 상세한 원 출처 기준), 희귀 잭팟(약 2% 확률) 1,000~10,000. "판당 수입·리듬은 나중에 별도로 맞출 예정이니 지금은 축소하지 말라"는 지시에 따름.
- 아이콘: 가챠(컬렉션) 버튼이 이미 선물상자 픽셀아트를 쓰고 있어서, 구분을 위해 이모지 🎁 그대로 사용(둘 다 픽셀아트로 만들면 헷갈림). 프레임(테두리)만 다른 상단 버튼들과 통일.
⑥ 일일 미션
- 후보 3종(날짜 기반 해시로 매일 결정론적 자동 선택 — 서버 없이도 기기마다/날마다 안정적):
| 미션 | 목표 | 보상 |
|---|
| 세트 완성 | 3개 | +5 |
| 카드 공개 | 30장(스톡 배분+뒤집기 합산) | +5 |
| 승리 | 1판 | +8 |
- 노출 위치: 별도 화면 대신 가챠/컬렉션 화면 안에 진행바 형태로 배치 — 새 오버레이를 늘리지 않기 위한 선택.
⑦ 승리창·게임오버창 — "Get a Prize!" 가챠 진입 배너 추가 감사에서 발견
어떻게 놓쳤나: 갭분석 보고서 §2 "사망/종료 화면" 행에 길건너친구들의 화면 구성요소로 가챠진입 배너가 분명히 나열돼 있었지만, §7 우선순위 목록(실제 작업 항목 6개)에는 별도 항목으로 승격되지 않아 최초 구현 때 빠졌습니다. "빠짐없이 다 했는지 검수" 지시로 다시 표와 목록을 대조하다 발견 → 바로 구현.
- 동작: 소지 골드가 뽑기비용(
DRAW_COST=100G) 이상일 때만 승리창·게임오버창에 보라색 🎁 Get a Prize! 배너 노출. 탭하면 해당 창을 닫고 바로 가챠/컬렉션 화면으로 이동.
- 위치: 승리창은 "광고보고 골드 2배" 버튼 바로 아래, "다시 하기" 버튼 바로 위. 게임오버창은 "광고보고 이어하기" 버튼 바로 아래, "다시 하기" 버튼 바로 위 — 길건너친구들 사망화면에서 골드 CTA 다음에 배치되는 순서를 참고.
- 검증: 로컬 브라우저에서 골드 500+ 상태로 승리창 노출 확인(스크린샷), 배너 탭 → 가챠 화면 정상 진입 확인, 골드 부족(100 미만) 상태에서 배너 숨김 확인, 콘솔 에러 0.
⑧ 실제 IAP + 리더보드/업적 — "인프라 필요"로 남겨뒀던 3개 항목 재작업 사용자 지시로 추가 구현
"인프라 필요하면 다 구현해" 지시에 따라, 코드로 만들 수 있는 부분은 전부 실제로 구현했습니다. 단, Play Console 계정 로그인·결제 정보 입력·상품 등록은 Claude가 대신 할 수 없는 영역(계정 생성·금융정보 입력은 안전 정책상 금지)이라, 그 부분만 아래 체크리스트로 정리했습니다. 나머지(네이티브 플러그인 코드·구매 플로우·UI·게임 훅)는 전부 실제 동작하는 코드로 이번에 작성했습니다.
⑧-1. 실제 IAP(인앱결제)
- 방식: 3rd-party 결제 SDK(RevenueCat 등, 별도 계정 필요) 대신 Google Play Billing Library 8을 직접 통합하는 커스텀 네이티브 플러그인(
BillingPlugin.java) 작성 — 기존 Ringer/PlayGames 플러그인과 같은 방식(자체 계정·외부 서비스 의존 최소화 원칙 유지).
- 상품 3종 구현:
| 상품ID | 유형 | 효과 |
|---|
ad_remove | 비소모성(평생 1회) | 배너+전면광고 영구 제거(보상형 광고는 계속 이용 가능 — 유저가 원하면 여전히 볼 수 있게) |
piggy_bank | 비소모성(평생 1회) | 모든 재화 획득량(세트완성·포인트카드·무료선물·일일미션·캐릭터겹침보너스) 영구 2배 |
unlock_character | 소모성(재구매 가능) | 컬렉션 화면에서 원하는 잠긴 캐릭터 카드를 골라 그 1종만 즉시 해금 |
- 판단(캐릭터 개별구매 방식 변경): 리서치엔 캐릭터마다 별도 $0.99 상품이라 나와 있었지만, 캐릭터가 20종 이상이라 Play Console에 20개 넘는 상품을 일일이 만들어야 함 — 대신 상품 1개(
unlock_character, 소모성)로 통일해 "원하는 잠긴 캐릭터를 그 자리에서 바로 해금"하는 동일한 플레이어 경험을 훨씬 적은 콘솔 작업으로 구현. 구매마다 소모되므로 여러 캐릭터를 원하면 여러 번 구매(각각 정가) 가능.
- 구매 복원: 설정 화면 "구매 복원" 버튼 — 기기 변경/재설치 시
ad_remove/piggy_bank 소유 상태를 Play Console 구매내역에서 다시 불러와 복원.
- 범위 축소: IAP 카탈로그의 4번째 항목인 "체험판(로테이션)"은 구현하지 않았습니다 — 실제 결제 흐름 없이 클라이언트 로직만으로 만들 수 있는 마케팅성 기능이라 이번 핵심 3종보다 우선순위가 낮다고 판단.
⑧-2. 리더보드·업적(Google Play Games Services v2)
- 방식: 기존에 클라우드 세이브용으로만 계획돼 있던
PlayGames 네이티브 플러그인(그동안 JS 래퍼pgs.js만 있고 실제 안드로이드 코드는 없었음)을 이번에 처음으로 실제 구현 — 로그인·스냅샷 저장/불러오기(클라우드 세이브)에 더해 리더보드 점수 제출·업적 잠금해제 메서드까지 함께 작성.
- 리더보드: "판당 획득 골드"를 점수로 제출(
lastEarned) — 엔드리스 러너인 길건너친구들의 "판당 거리 기록"과 성격이 비슷한 지표로 판단해 채택.
- 업적 3종: 캐릭터 5종 수집 / 컬렉션 올클리어 / 10판 승리 — 길건너친구들 리서치의 "캐릭터 N개 수집" 예시를 참고해 우리 게임에 자연스러운 마일스톤으로 선정.
⑧-3. 상시 배너광고 재검토 — 판단 및 결론
"인프라 필요"보다는 사실 판단이 필요한 항목이었습니다. 리서치 결과 길건너친구들에 상시 배너가 있는지는 근거가 약했고(불확실, 부재 쪽에 무게), 우리 배너는 이미 검증된 실제 수익원입니다. 그래서 배너를 빼는 대신, 이번에 만든 "광고 제거" IAP로 선택권을 플레이어에게 넘기는 쪽으로 결론지었습니다 — 광고가 싫은 유저는 유료로 없앨 수 있고, 나머지 유저에겐 수익원이 그대로 유지됩니다. 구조적 논쟁을 없애는 더 나은 해결책이라고 판단했습니다.
⑧-4. 지금 코드로 안 되는 것 — Play Console에서 사용자가 직접 해야 하는 일
아래 전부
Claude가 대신 할 수 없는 영역(계정 로그인·금융정보 입력은 안전 정책상 금지)입니다. 지금은 전부 미설정 상태라
새 코드 전체가 자동으로 꺼져 있고(no-op), 기존 게임 동작엔 영향이 전혀 없습니다. 아래 순서대로 하면 됩니다:
- Play Console에 앱 업로드(최소 내부테스트 트랙) — IAP/리더보드/업적 심사·활성화의 전제조건.
- 인앱 상품 3개 생성(수익창출 > 제품 > 인앱 상품), ID는 정확히:
ad_remove, piggy_bank, unlock_character(소모성으로 지정) — 가격은 리서치 참고가(광고제거 $2.99~7.99, 피기뱅크 $2.99, 캐릭터해금 $0.99) 또는 원하는 값으로.
- 다 만들면
www/billing-config.js의 enabled: false를 true로 변경.
- Play Games Services 프로젝트 연결(플레이 콘솔 > Play Games Services > 설정) → Application ID 발급받아
www/pgs-config.js의 appId, android/app/src/main/res/values/strings.xml의 game_services_project_id, OAuth 클라이언트에 패키지명+서명 SHA-1 등록.
- 리더보드 1개 + 업적 3개 생성, ID를
www/pgs-config.js의 leaderboardId/achievements.collect5/achievements.collectAll/achievements.win10에 각각 붙여넣기.
테스트 한계: 실제 결제 승인·리더보드 표시는 Play Console에 상품/리더보드가 등록되고 앱이 최소 테스트 트랙에 있어야 진짜로 동작합니다. 이번엔 코드가 컴파일·빌드되고, 미설정 상태에서 기존 기능에 아무 영향이 없다는 것까지만 로컬 브라우저+실제 APK 빌드로 검증했습니다. 실제 결제창이 뜨는지는 위 체크리스트 완료 후 별도로 확인이 필요합니다.
⑨ UI 다듬기 — 아이콘 중복 해소·무료선물 배치 변경·동전카드 이펙트 사용자 피드백으로 추가 수정
- 아이콘 중복 발견 → 잘못된 수정 → 롤백: 상단 컬렉션 버튼이 선물상자 픽셀아트를 쓰고 있어서 바로 옆 무료선물 아이콘과 똑같아 보인다는 지적 → 최초엔 컬렉션 버튼을 트로피 아이콘(신규 픽셀아트)으로 교체했으나, 사용자 미승인 변경 사용자가 그런 변경은 요청한 적 없다고 정정 → 즉시 선물상자 아이콘으로 롤백(
ICON_TROPHY/trophySrc/trophyImg 코드도 삭제). 아이콘 중복 문제는 아래 "무료선물 배치 변경"만으로 해소된 것으로 최종 정리.
- 무료선물 배치 변경(승인됨): "cr도 선물 게임 전후에 주잖아"라는 지적에 따라, 상단 상시 아이콘을 완전히 없애고 승리창·게임오버창에 배너로만 노출(준비 안 됐으면 숨김) — 상단엔 컬렉션 버튼(선물상자 아이콘, 원래대로)만 남아 중복 문제가 자연히 해소됨.
- 동전(포인트)카드 이펙트 강화: 조용히 +1만 뜨던 걸, 다른 카드 착지 이펙트(스쿼시 바운스+충격파동 링+스냅사운드)와 파편 버스트·화면 플래시·컨페티·재화 튐을 전부 겹쳐서 화려하게 재구성("다른 카드들처럼 모든 이펙트 최대한 적용" 요청 반영).
공통 사항
번역 커버리지: 이번에 추가한 새 UI 문구(광고 버튼 3종·평점 팝업 4종)는 한국어·영어만 완전히 번역했습니다. 나머지 13개 언어는 t() 함수의 자동 영어 폴백으로 깨지지 않고 영어로 표시됩니다(에러 없음, 다만 그 언어 사용자에겐 이 부분만 영어로 보임). 완전한 다국어 번역은 별도 작업으로 필요합니다.
추가 감사 결론(빠짐없이 다 했는지 검수): 갭분석 보고서 §2~③(화면 인벤토리·광고 배치)를 §⑦ 우선순위 목록과 항목별로 재대조. 인프라 불필요로 분류된 6개 항목 중 5개는 이미 구현 확인, 가챠 진입 배너 1개는 누락 발견 → 구현·테스트 완료(위 ⑦ 참고). "인프라 필요"로 남겨뒀던 나머지 3개(IAP·리더보드/업적·배너광고 재검토)도 "인프라 필요하면 다 구현해" 지시에 따라 코드로 만들 수 있는 부분은 전부 실제로 구현(위 ⑧ 참고) — Play Console 계정/상품 등록 등 사용자만 할 수 있는 부분만 체크리스트로 남겨둠.
wwssolitaire · Magpies Studio · 로컬 브라우저 전체 기능 테스트 완료(콘솔 에러 0) · 내부 의사결정 자료 · noindex