[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBNWKXJCK5WYDQF82HMTXP":3,"skill-same:01M6CBNWKXJCK5WYDQF82HMTXP":45},{"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":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBNWKXJCK5WYDQF82HMTXP","01-policy",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\u002F01-policy\u002FSKILL.md",[],[18,19],"policy","01 policy","2026-11-10 10:12:30",false,"# 47-advertise-system — Policy\n\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Policy \u002F Entry Point\n\n\n## Purpose\n\n\nDevian의 인앱 광고 모듈(클라이언트) 설계\u002F코딩 규약을 정의한다.\n\n- 현재 기본 공급자 SDK는 Google Mobile Ads를 기준으로 한다.\n- 광고 설정 정본은 Game 도메인의 `ADVERTISE` 테이블로 둔다.\n- Rewarded Ad의 실제 보상 지급은 RewardManager로 위임한다.\n\n\n---\n\n\n## Hard Rules\n\n\n### 1) 광고 설정 정본은 `ADVERTISE` 테이블이다\n\n- placement, format, reward_group_id, ad unit id를 코드에 하드코딩하지 않는다.\n- AdsManager가 `TB_ADVERTISE`를 직접 참조하여 `advertise_id` 기준으로 설정을 해석한다.\n- 포맷별 분기(`BANNER`, `INTERSTITIAL`, `REWARDED`, `APP_OPEN`)와 provider 선택은 테이블 값 기준으로만 수행한다.\n\n\n정본 규칙: [03-ssot](..\u002F03-ssot\u002FSKILL.md)\n\n\n### 2) Rewarded 보상 지급은 RewardManager 단일 경로를 따른다\n\n- Rewarded에서 실제 보상 적용은 `RewardManager.ApplyRewardGroup(reward_group_id)`만 사용한다.\n- RewardManager가 `TB_REWARD`를 통해 보상 그룹을 해석하며, 광고 시스템은 보상 내용(`RewardData[]`)을 직접 계산하지 않는다.\n- `reward earned` 콜백이 없는 종료\u002F실패 경로에서는 지급하지 않는다.\n- 동일 show cycle에서 보상은 최대 1회만 지급한다.\n\n\n연관: [49-reward-system](..\u002F..\u002F49-reward-system\u002F00-overview\u002FSKILL.md)\n\n\n### 3) Reward_group_id 규칙은 포맷에 따라 고정한다\n\n- `REWARDED` 포맷은 `reward_group_id`가 필수다.\n- `BANNER`, `INTERSTITIAL`, `APP_OPEN`은 `reward_group_id`를 비워둔다.\n- 리워드 지급 여부를 런타임 분기\u002F문자열 비교로 임의 추론하지 않는다. 포맷 + 테이블 설정으로만 판정한다.\n\n\n### 4) 공급자 SDK 종속성은 provider 레이어에만 둔다\n\n- 상위 로직(UI, gameplay, Mission, Reward, Purchase)은 `GoogleMobileAds.*` 타입을 직접 참조하지 않는다.\n- SDK 초기화\u002F로드\u002F표시\u002F콜백 해석은 provider adapter가 담당한다.\n- AdsManager는 provider의 공통 인터페이스만 사용한다.\n\n\n### 5) 광고 실패는 non-fatal이다\n\n- 광고 초기화 실패, load fail, no fill, show fail은 게임 진행을 막지 않는다.\n- 미지원 플랫폼\u002FEditor\u002F설정 누락에서는 안전 실패(safe fail)로 종료한다.\n- 예외 전파\u002F로그 폭발로 앱 흐름을 깨뜨리지 않는다.\n\n\n### 6) NoAds\u002F정책 게이트를 우회하지 않는다\n\n- Banner \u002F Interstitial \u002F App Open은 NoAds 활성 상태에서 표시하지 않는다.\n- Rewarded는 사용자가 명시적으로 진입한 보상형 광고이므로 NoAds와 별도 정책으로 취급할 수 있다.\n- consent, platform support, test-mode 여부를 통과하지 못하면 show 경로를 차단한다.\n\n\n### 7) 실광고 반복 테스트를 기본 경로로 쓰지 않는다\n\n- Editor\u002FCI\u002F로컬 개발 기본값은 MockAdProvider다.\n- 실 SDK 테스트는 test ad unit 또는 test device 기반 수동 smoke test로만 수행한다.\n- 라이브 ad unit 반복 호출\u002F클릭\u002F자동화 테스트는 금지한다.\n\n\n정본 규칙: [09-ssot-operations](..\u002F09-ssot-operations\u002FSKILL.md)\n\n\n### 8) SSV 콜백은 ECDSA 서명 검증 필수\n\n- AdMob SSV 콜백을 수신하는 Firebase HTTP endpoint는 반드시 ECDSA 서명을 검증해야 한다.\n- 서명 검증 없이 보상을 기록하지 않는다.\n- custom_data는 서버에서 파싱하여 uid\u002Fadvertise_id\u002FrewardGroupId를 추출한다.\n- SSV는 감사\u002F사후 검증 용도이며, 클라이언트 보상 지급 흐름을 차단하지 않는다.\n\n\n정본 규칙: [40-ad-ssv-firebase](..\u002F40-ad-ssv-firebase\u002FSKILL.md), [41-ad-ssv-decisions](..\u002F41-ad-ssv-decisions\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F47-advertise-system\u002F01-policy","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":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 01-policy",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 01-policy",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 01-policy","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F47-advertise-system\u002F01-policy\u002FSKILL.md",true,[],[46,52,60,68,77,84],{"skillNo":47,"name":48,"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":49,"categories":50,"keywords":51,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[48],{"skillNo":53,"name":54,"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":55,"categories":56,"keywords":57,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[58,59],"archive","90 project archive",{"skillNo":61,"name":62,"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":63,"categories":64,"keywords":65,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[66,67],"management","30 env management",{"skillNo":69,"name":70,"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":71,"categories":72,"keywords":73,"publishedAt":20},"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",[],[74,75,76],"push","page","19 page push send",{"skillNo":78,"name":79,"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":80,"categories":81,"keywords":82,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[75,83],"18 page savedata",{"skillNo":85,"name":86,"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":87,"categories":88,"keywords":89,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[75,90],"17 page deobfuscate"]