[맘스맘 개발기] 260118 Admob 달아보기

AdMob(Android) 구현 계획
목표
Android에 하단 배너 AdMob을 안정적으로 노출
테스트/프로덕션 ID를 빌드별로 분리(dev/prod는 --dart-define-from-file)
스토어/SDK 요구사항(권한, App ID 메타데이터) 충족
현 상태 확인(이미 되어 있음)
패키지: google_mobile_ads: ^5.2.0가 이미 추가됨: momsmom/pubspec.yaml
배너 위젯 구현 존재: momsmom/lib/ads/ad_banner.dart
배너는 채팅 화면 하단에 붙어 있음: momsmom/lib/features/chat/chat_screen.dart
Android App ID(테스트)가 AndroidManifest.xml에 들어가 있음: momsmom/android/app/src/main/AndroidManifest.xml
구현/정리 작업
1) AdMob 콘솔 준비
AdMob에서 Android 앱 등록(패키지명 com.momsmom.momsmom)
배너 광고 단위(Ad Unit) 생성
결과로 아래 2개 확보
Android App ID: ca-app-pub-...~...
Android Banner Ad Unit ID: ca-app-pub-.../...
2) Android App ID를 매니페스트에 “릴리즈용”으로 설정
릴리즈 빌드는 android/app/src/main/AndroidManifest.xml이 기준이므로:
momsmom/android/app/src/main/AndroidManifest.xml의 com.google.android.gms.ads.APPLICATION_ID 값을 프로덕션 App ID로 교체
개발/테스트 편의를 위해(선택이지만 강력 추천):
momsmom/android/app/src/debug/AndroidManifest.xml에 <application> + 동일 meta-data를 추가해 디버그는 테스트 App ID로 오버라이드
3) Android 권한/요구사항 추가
momsmom/android/app/src/main/AndroidManifest.xml에 필요 권한을 점검/추가
android.permission.INTERNET (이미 있음)
android.permission.ACCESS_NETWORK_STATE (권장)
com.google.android.gms.permission.AD_ID (targetSdk가 33+일 때 권장/사실상 필요)
4) 배너 Ad Unit ID를 dart-define로 분리(Dev/Prod)
Env 확장: momsmom/lib/config/env.dart
ADMOB_BANNER_AD_UNIT_ID_ANDROID 같은 상수를 String.fromEnvironment(...)로 추가
Dev/Prod 주입 파일 확장
momsmom/tool/dart_defines_dev.json
배너는 테스트 Ad Unit ID를 넣기
momsmom/tool/dart_defines_prod.json
배너는 프로덕션 Ad Unit ID를 넣기
5) 광고 SDK 초기화 위치 정리(중복 초기화 방지)
현재 AdBanner가 initState()에서 MobileAds.instance.initialize()를 호출하고 있어, 화면이 여러 번 생성되면 초기화 호출이 반복될 수 있습니다.

권장 구조:
momsmom/lib/main.dart에서 앱 시작 시 1회 초기화
또는 lib/ads/ad_service.dart 같은 싱글턴 서비스를 만들어 1회만 초기화(필요 시 lazy-init)
디버그에서만 테스트 디바이스 설정도 함께 적용(선택):
`RequestConfiguration(testDeviceIds: [...])`
6) AdBanner를 “환경 기반”으로 동작하도록 조정
momsmom/lib/ads/ad_banner.dart
_bannerAdUnitId()가 현재 하드코딩 테스트 ID → Env.ADMOB_BANNER_AD_UNIT_ID_ANDROID를 사용
값이 비어 있으면(설정 누락) placeholder만 보여주고 광고 로딩 스킵하도록 가드
(옵션) AdSize.banner 대신 기기 폭에 맞는 AnchoredAdaptiveBannerAdSize 적용 검토
7) 빌드/검증 체크리스트
디버그 실행(테스트 광고 확인)
flutter run --dart-define-from-file=tool/dart_defines_dev.json
릴리즈 빌드(프로덕션 ID 확인)
flutter build apk --release --dart-define-from-file=tool/dart_defines_prod.json
검증 포인트
배너가 로드될 때 placeholder → 실제 배너로 전환
onAdImpression에서 기존 AnalyticsService.instance.logAdImpression() 호출이 유지되는지 확인
Play Console 사전 런/기기에서 크래시/ANR 없음
변경 예정 주요 파일
momsmom/lib/main.dart
momsmom/lib/config/env.dart
momsmom/lib/ads/ad_banner.dart
momsmom/tool/dart_defines_dev.json
momsmom/tool/dart_defines_prod.json
momsmom/android/app/src/main/AndroidManifest.xml
(선택) momsmom/android/app/src/debug/AndroidManifest.xml
구현 Todos
admob-ids: AdMob 콘솔에서 Android App ID + Banner Ad Unit ID 발급
android-manifest: main/debug 매니페스트에 App ID 및 권한 반영
env-defines: Env/dart_defines_*.json에 배너 Ad Unit ID 주입 구조 추가
init-once: 광고 SDK 1회 초기화 구조로 정리
banner-wireup: AdBanner가 Env 기반으로 로드/실패/미설정 처리를 하도록 수정
verify-build: dev/prod 빌드 커맨드로 실기기에서 노출 확인

나 아무것도 모르니까 따라하게 스텝바이스텝 알려줘.