PURPLEOCEAN 개발 노트

앱에 애드몹(AdMob)을 붙여서 출시 준비를 하다 보면 가장 먼저 정해야 하는 게 바로 광고 ID 관리 기준입니다. 개발 환경에서 테스트하다가 실수로 실제 운영 광고를 클릭하기라도 하면 '무효 활동'으로 찍혀서 계정이 정지되는 불상사가 생길 수 있거든요. 반대로 운영 빌드에 테스트 ID를 그대로 남겨두면 출시 후에 수익이 전혀 나지 않는 문제가 생깁니다. 매번 프로젝트 세팅할 때마다 설정이 헷갈리는 부분이라, 아예 깔끔하게 정리해서 기록해 둡니다. 자주 발생하는 문제 상황 운영하다 보면 보통 아래와 같은 지점에서 실수가 나옵니다. 개발 중에 실제 운영 광고 단위 ID가 뜨는 줄 모르고 직접 클릭함 (계정 정지 리스크) 릴리즈(Release) 빌드에 테스트용 광고 ID를 그대로 넣어서 배포함 (수익 0원) 테스트 디바이스 해시값이나 실제 운영 ID를 GitHub 같은 공개 저장소에 그대로 push함 배너, 전면 광고 ID 문자열을 여러 화면 코드에 하드코딩해서 나중에 수정하기 힘들어짐 빌드 타입(Build Type)별 ID 분리 설정 가장 확실한 방법은 Gradle의 buildTypes 를 활용해서 디버그(Debug)와 릴리즈(Release) 환경의 ID를 빌드 시점에 분리해 주입하는 것입니다. 1. Gradle 설정 (build.gradle) Groovy android { buildTypes { debug { // Google 공식 데모 배너 및 전면 광고 ID buildConfigField( "String" , "ADMOB_BANNER_AD_UNIT_ID" , '"ca-app-pub-3940256099942544/9214589741"' ) buildConfigField( "String" , "ADMOB_INTERSTITIAL_AD_UNIT_ID" , ...

수익화를 위해 앱에 AdMob 전면광고를 붙이다 보면 생각보다 신경 쓸 게 많습니다. 저의 경우에도 전면광고를 처음 적용할 때 화면이 툭툭 끊기거나 정책 위반 경고를 받지 않을까 조마조마했던 기억이 있습니다. 전면광고는 배너 광고와 달라서 사용자 화면 전체를 덮어버리기 때문에, 잘못 배치하면 사용자 이탈이 심해지고 오인 클릭으로 인해 구글 정책 위반 딱지를 받기 딱 좋습니다. 자꾸 까먹기도 하고, 나중에 프로젝트 할 때 바로 카피해서 쓰려고 실무 기준 올바른 구현 방법과 주의점을 정리해 둡니다. 전면광고 적용할 때 자주 하는 실수 (원인) 이래저래 앱을 운영하다 보면 아래와 같은 상황에서 문제가 터집니다. 보통 초보 시절에 많이 하는 실수들입니다. 앱 시작 직후나 종료 직전에 광고 노출: 사용자가 앱 콘텐츠를 보기도 전에 광고부터 띄우거나, 나가려고 하는데 뒤로가기 버튼 누를 때마다 광고가 뜨면 종료를 방해해서 오인 클릭 유도 정책에 걸립니다. 광고 로딩될 때까지 화면 막기: 광고가 아직 안 불려왔다고 다음 화면으로 안 넘어가고 빙글빙글 로딩만 돌리고 있으면 사용자 경험(UX)에 치명적입니다. 빈도 조절 실패: 화면 전환할 때마다 무조건 전면광고를 때려 박으면 사용자는 바로 앱을 삭제합니다. 실제 광고 ID로 테스트: 개발 중에 실제 광고 ID를 그대로 넣고 테스트하다가 실수로 클릭이라도 하면 AdMob 계정이 정지될 수 있습니다. 핵심은 "광고를 보여줄 수 있는가"가 아니라 "사용자가 납득할 수 있는 자연스러운 흐름인가"를 먼저 생각해야 합니다. 퀴즈가 한 회차 끝났을 때나, 상세 페이지를 몇 개 보고 목록으로 복귀할 때처럼 흐름이 자연스럽게 멈추는 지점(Natural Break)에만 노출해야 안전합니다. AdMob 전면광고 컨트롤러 구현 코드 실무에서 바로 사용할 수 있도록 빈도 제한(최소 간격 설정), Preload(미리 로드), Callback 처리를 한 번에 관리하는 코드를 만들어 썼습니다. Kotlin 기준...