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 배너 광고를 붙여야 할 때가 많습니다. 저의 경우도 하단에 배너를 달아두고 운영 중인데, 최근 나오는 Android 기기들은 화면 크기나 비율이 워낙 제각각이라(폴더블, 태블릿, 가로 모드 등) 고정 크기 배너만 고집하면 레이아웃이 붕 뜨거나 어색하게 깨지는 문제가 발생하더군요. 자꾸 까먹기도 하고 실무에서 매번 찾아보기 귀찮아서, 안정적으로 배너 광고를 올리는 레이아웃 구조와 가변 배너(Anchored Adaptive Banner) 적용 방법을 정리해 둡니다. 1. 배너 광고 적용 시 자주 겪는 문제와 원인 단순히 "화면 아래에 View 하나 얹으면 되겠지" 하고 접근하면 운영하다가 꼭 아래와 같은 안 좋은 상황을 마주하게 됩니다. 레이아웃 튐 현상: 광고가 로딩되기 전에는 높이가 0이었다가, 광고가 로드되는 순간 갑자기 화면이 툭 밀려 내려가면서 사용자가 버튼을 잘못 누르는 오인 클릭이 발생합니다. 화면 크기 미대응: XML에 320x50 같은 고정 크기만 넣어두면 태블릿이나 가로 모드에서 양옆이 훤히 비어 보입니다. 메모리 누수: Fragment나 Activity가 종료될 때 리소스를 제대로 해제하지 않으면 메모리를 계속 잡아먹습니다. 정책 위반 위험: UMP(개인정보 동의) 흐름이 끝나기도 전에 광고를 요청하거나, 개발 중에 실제 광고 ID를 그대로 박아서 테스트하면 계정이 정지될 수 있습니다. 따라서 배너는 광고 컨테이너 높이, 화면 회전, 라이프사이클 관리를 처음부터 세트로 묶어서 설계해야 안전합니다. 2. 해결 방법: XML 레이아웃 구조 잡기 광고를 콘텐츠 위에 겹쳐 올리면 100% 버튼 오인 클릭으로 구글 경고를 받거나 사용자 원성을 삽니다. 아예 콘텐츠 영역과 광고 영역을 아래처럼 확실하게 분리해 주는 것이 좋습니다. XML < androidx.constraintlayout.widget.ConstraintLayout xmlns:android = "http://sc...

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