[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBNYF8BWBRTDAJPR6MRE33":3,"skill-same:01M6CBNYF8BWBRTDAJPR6MRE33":44},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":21,"frontMatter":22,"refName":23,"commitSha":24,"skillDirectory":25,"forksCount":13,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":6,"ownerDescription":28,"updatedAt":29,"install":30,"resources":43},"01M6CBNYF8BWBRTDAJPR6MRE33","03-ssot",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F47-advertise-system\u002F03-ssot\u002FSKILL.md",[],[18],"03 ssot","2026-11-10 10:12:30",false,"# 03-ssot — 47-advertise-system (통합 SSOT)\n\n\nStatus: ACTIVE\nAppliesTo: v10\n\n\n## 이 문서가 정본이다 (SSOT)\n\n광고 관련 규칙의 단일 SSOT는 이 문서다.\n\n- `ADVERTISE` 테이블 스키마\n- `advertise_id` \u002F `reward_group_id` \u002F 포맷 규칙\n- AdsManager의 책임과 provider 분리 규칙\n- Rewarded 광고의 지급 위임 규칙\n\n비정본(이 문서에서 다루지 않음):\n- RewardData 스키마\u002F보상 해석\n  - `49-reward-system`\n- 결제 NoAds entitlement 원장\u002F복구\n  - `30-purchase-system`\n\n\n---\n\n\n## A) Core Terms (정본)\n\n- `advertise_id`: 광고 placement의 논리 키. `ADVERTISE` 테이블 PK.\n- `format`: 광고 포맷. `ADVERTISE_FORMAT`\n- `provider`: 광고 SDK 구현체 키. `ADVERTISE_PROVIDER`\n- `reward_group_id`: Rewarded 광고가 성공적으로 완료됐을 때 RewardManager에 전달하는 보상 그룹 키\n- `show cycle`: 한 번의 show 시도 단위. Rewarded는 show cycle당 최대 1회만 지급한다.\n- `MockAdProvider`: 네트워크 없이 scripted callback으로 동작하는 테스트용 provider\n\n\n---\n\n\n## B) Content Source of Truth (정본)\n\n광고 메타데이터 정본은 Game 도메인 안의 `ADVERTISE` 테이블이다.\n\n- 위치: `input\u002FDomains\u002FGame\u002F*.xlsx` 중 `ADVERTISE` sheet를 포함한 파일\n- 현재 샘플 파일: `input\u002FDomains\u002FGame\u002FMetaTable.xlsx`\n- sheet\u002Ftable 정본 이름: `ADVERTISE`\n- 생성 대상: `TB_ADVERTISE`\n- **도메인 소속**: `com.devian.foundation\u002FSamples~\u002FGamePackage` (기존 `TB_REWARD`와 동일)\n- **빌더 등록**: 추가 등록 불필요. `{buildInputJson}` (예: `input\u002Fbuild_input.json`)의 `domains.Game.tableFiles=[\"*.xlsx\"]`에 이미 포함된다.\n\nAdsManager는 `TB_ADVERTISE`를 직접 참조하여 placement 설정을 읽는다.\n\n\n---\n\n\n## C) `ADVERTISE` 테이블 스키마 (정본)\n\n`ADVERTISE`는 1행=1광고 placement 구조다.\n\n| 필드 | 타입 | Row 3 옵션 | 설명 |\n|------|------|-----------|------|\n| `Advertise_id` | string | pk | 광고 placement 논리 키 |\n| `Format` | enum:ADVERTISE_FORMAT | | `BANNER` \u002F `INTERSTITIAL` \u002F `REWARDED` \u002F `APP_OPEN` |\n| `Provider` | enum:ADVERTISE_PROVIDER | | `GOOGLE_MOBILE_ADS` \u002F `MOCK` |\n| `Reward_group_id` | string | | Rewarded 성공 시 지급할 보상 그룹 키 |\n| `Is_active` | bool | | 활성 여부 |\n| `Auto_load` | bool | | 초기화 후 자동 preload 여부 |\n| `Cooldown_sec` | int | | 동일 placement 재표시 최소 간격(초) |\n| `Android_ad_unit_id` | string | | Android ad unit id |\n| `Ios_ad_unit_id` | string | | iOS ad unit id |\n\n\n### C-1) Format 규칙\n\n- `Format=REWARDED`이면 `Reward_group_id`는 필수다.\n- `Format=BANNER|INTERSTITIAL|APP_OPEN`이면 `Reward_group_id`는 비워둔다.\n- `Provider`는 현재 `GOOGLE_MOBILE_ADS` 또는 `MOCK`만 허용한다.\n- `Is_active=false`면 로드\u002F표시 대상에서 제외한다.\n- `Cooldown_sec \u003C= 0`이면 쿨다운 없음으로 해석할 수 있다.\n\n\n### C-2) 광고 ID 해석 규칙\n\n- 상위 로직은 `advertise_id`만 사용한다.\n- 플랫폼별 ad unit id(`Android_ad_unit_id`, `Ios_ad_unit_id`)는 provider\u002FAdsManager 레이어 내부에서만 해석한다.\n- 상위 로직이 ad unit id를 직접 알거나 분기하지 않는다.\n\n\n---\n\n\n## D) Rewarded 지급 경로 (정본)\n\nRewarded 광고는 아래 순서를 따른다.\n\n1. 상위 로직이 `ShowAsync(advertise_id, skip, ct)`를 호출한다.\n2. AdsManager가 `TB_ADVERTISE.Get(advertise_id)`로 row를 읽는다.\n3. `skip=true`이면 광고 없이 `SkipAndReward`로 Reward만 즉시 지급하고 반환한다.\n4. provider가 rewarded 광고를 표시한다.\n5. provider에서 `reward earned` 콜백이 오면, AdsManager가 해당 show cycle의 중복 여부를 확인한다.\n6. `Reward_group_id`가 유효하면 `RewardManager.ApplyRewardGroup(reward_group_id)`를 호출한다.\n7. show cycle 종료 결과를 반환한다.\n\n정본 규칙:\n- 광고 시스템은 `RewardData[]`를 직접 생성하지 않는다.\n- `reward earned` 이전에 선지급하지 않는다.\n- 동일 show cycle에서 중복 reward 콜백이 와도 1회만 지급한다.\n\n\n연관:\n- [49-reward-system\u002F03-ssot](..\u002F..\u002F49-reward-system\u002F03-ssot\u002FSKILL.md)\n- [10-reward-manager](..\u002F..\u002F49-reward-system\u002F10-reward-manager\u002FSKILL.md)\n\n\n---\n\n\n## E) AdsManager 책임 (정본)\n\n- `TB_ADVERTISE` 조회\n- provider 초기화\u002F선택\n- preload\u002Fshow 상태 관리\n- format별 gating(no-ads, consent, unsupported platform, cooldown)\n- Rewarded 성공 시 RewardManager 호출\n\nAdsManager의 비책임:\n- 보상 내용 해석(`TB_REWARD` 직접 조회 금지)\n- 결제 entitlement 저장\u002F복구\n- 실광고 테스트 자동화\n- 공급자 SDK 타입을 상위 로직으로 노출\n\n\n---\n\n\n## F) Provider 분리 규칙 (정본)\n\n- provider는 `IAdProvider` 류의 공통 인터페이스 뒤로 숨긴다.\n- Google Mobile Ads SDK 의존은 provider 구현 파일에만 둔다.\n- MockAdProvider는 동일 인터페이스를 구현해 Editor\u002FCI 테스트 기본값으로 사용한다.\n\n\n---\n\n\n## G) Non-goals\n\n- 광고 수익 분석\u002FBI 파이프라인\n- mediation waterfall 설정 UI\n- live ops A\u002FB 실험 도구\n\n\n---\n\n\n## H) Rewarded SSV (Server-Side Verification) 참조\n\nAdMob SSV를 통해 Rewarded 광고 완료를 서버에서 검증하고 감사 로그를 기록한다.\n\n- 보상 지급 방식: **클라이언트 즉시 지급** (현재 방식 유지). SSV는 감사\u002F사후 검증 용도.\n- SSV 서버 구현 정본: [40-ad-ssv-firebase](..\u002F40-ad-ssv-firebase\u002FSKILL.md)\n- SSV 고정 결정값: [41-ad-ssv-decisions](..\u002F41-ad-ssv-decisions\u002FSKILL.md)\n\n핵심 흐름:\n1. 클라이언트: Rewarded 로드 후 `ServerSideVerificationOptions`(userId, customData) 설정\n2. 유저 광고 시청 완료 → 클라이언트 즉시 보상 지급 (§D 경로 그대로)\n3. AdMob → Firebase HTTP endpoint로 SSV 콜백 전송\n4. 서버: ECDSA 서명 검증 → Firestore 감사 로그 기록\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F47-advertise-system\u002F03-ssot","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":31,"prompt":41,"zipAvailable":42},[32,35,38],{"tool":33,"command":34},"npx","npx skills add devwinsoft\u002Fdevian --skill 03-ssot",{"tool":36,"command":37},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 03-ssot",{"tool":39,"command":40},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 03-ssot","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F47-advertise-system\u002F03-ssot\u002FSKILL.md",true,[],[45,51,59,67,76,83],{"skillNo":46,"name":47,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":48,"categories":49,"keywords":50,"publishedAt":19},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[47],{"skillNo":52,"name":53,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[57,58],"archive","90 project archive",{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[65,66],"management","30 env management",{"skillNo":68,"name":69,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[73,74,75],"push","page","19 page push send",{"skillNo":77,"name":78,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[74,82],"18 page savedata",{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[74,89],"17 page deobfuscate"]