애드몹 하단 배너가 특정 상황에서 통째로 안 뜨고 빈 자리로만 남아 있었습니다. 8월에 배너 요청 폭을 화면 전체 폭에서 실제로 놓이는 자리의 폭으로 바꾸고 실기기에서 실패 0건을 확인했는데, 두 달 뒤 GA4 전수를 보니 고친 뒤의 버전에서 같은 실패가 두 번 더 나 있었습니다. 남은 실패는 전부 가로 방향이었고, 구버전 안드로이드의 광고 SDK가 카메라 구멍(디스플레이 컷아웃) 자리를 화면 폭에서 빼고 보기 때문이었습니다. 세로로만 테스트하면 영영 걸리지 않는 경우라, 숫자로 방향을 알아낸 방법과 에뮬레이터 재현, 고친 코드를 정리합니다.
증상 — 화면에는 빈 자리, 로그에는 code=1
제 앱들은 하단에 적응형 배너(Anchored Adaptive Banner)를 하나씩 둡니다. 배너가 안 뜰 때 사용자 화면에는 그냥 비어 있는 띠만 보이고, 크래시도 경고도 없습니다. 처음에는 배너에 AdListener조차 없어서 왜 안 뜨는지 알 방법이 아예 없었고, 8월에 실패 계측을 붙이고 나서야 이런 기록이 잡혔습니다.
code=1 Error building request URL: Ad size will not fit on screen.
a_w=882, a_h=62, s_w=809
오류 코드 1은 요청 자체가 잘못됐다는 뜻(ERROR_CODE_INVALID_REQUEST)이라, 재고 없음(3)이나 네트워크(2)와 달리 몇 번을 다시 받아도 결과가 같습니다. 앞의 a_w는 요청한 광고 폭, s_w는 SDK가 화면이라고 본 폭(dp)으로, 화면보다 넓은 광고를 달라고 해서 거절당한 것입니다. 이 첫 기록은 칼로리 기록 앱의 갤럭시 노트20 울트라(SM-N986N)에서 나왔습니다.
1차 수정 — 화면 폭 대신 놓일 자리의 폭
당시 배너는 LocalConfiguration.current.screenWidthDp로 폭을 정하고 있었습니다. 이 값은 앱 창 전체의 폭이라 배너가 실제로 놓이는 자리보다 넓게 나올 수 있습니다. 그래서 부모가 준 제약을 쓰도록 바꿨습니다. 아래는 성경 앱의 8월 23일 수정입니다(실제 코드, 일부).
@Composable
fun AdBanner(modifier: Modifier = Modifier) = BoxWithConstraints(modifier) {
// 앱 창 전체 폭(screenWidthDp)을 쓰면 놓일 자리보다 넓게 요청돼
// code=1 Ad size will not fit on screen 으로 거절된다.
val adWidthDp = maxWidth
AndroidView(
factory = { context ->
AdView(context).apply {
setAdSize(
// 제약이 무한이면 폭을 알 수 없으니 고정 크기로 물러선다.
if (adWidthDp.value.isFinite() && adWidthDp > 0.dp)
AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
context, adWidthDp.value.toInt()
)
else AdSize.BANNER
)
// ... adUnitId, adListener, loadAd
}
},
modifier = Modifier.fillMaxWidth()
)
}
Dp에는 isFinite가 없어서 dp.value.isFinite()로 무한을 따로 걸러야 한다는 것도 이때 알았습니다. 릴리스 빌드를 실기기에 깔아 배너가 실제로 채워지고 will not fit이 0건인 것을 확인했고, 그걸로 끝난 줄 알았습니다.
원인 — 남은 실패는 전부 가로 방향이었다
10월 12일, GA4에 쌓인 60일치 배너 실패를 전수로 다시 보다가 1차 수정 이후 버전에서 같은 문구를 두 건 더 찾았습니다.
| 날짜 | 앱 버전 | 기기 | 기록 | 초과분 |
|---|---|---|---|---|
| 8/22 | 칼로리 앱 1.2.3 (수정 전) | SM-N986N | a_w=882 a_h=62 s_w=809 | 73dp |
| 9/20 | 성경 앱 1.0.17 (수정 후) | moto g62 5G | a_w=732 a_h=53 s_w=695 | 37dp |
| 10/11 | 성경 앱 1.0.25 (수정 후) | SM-A315N | a_w=866 a_h=62 s_w=837 | 29dp |
실마리는 a_h, 즉 광고 높이였습니다. 적응형 배너 높이는 대략 화면 높이(dp)의 15% 언저리로 정해진다고 보고 거꾸로 계산하면, a_h=62는 화면 높이 약 413dp, a_h=53은 약 353dp입니다. 폰을 세로로 들면 화면 높이가 800-900dp는 되니, 세 건 모두 가로 방향이었다는 뜻입니다. 8월에 본 "0건"은 세로로 든 기기 한 대에서 확인한 것이었습니다.
그 화면에서 배너를 감싼 Column에는 이미 navigationBarsPadding()이 있어서, 가로 모드에서 옆으로 가는 내비게이션 바 폭은 빠진 상태였습니다. 그런데도 29-37dp가 더 넓었습니다. 남은 후보는 가로에서 옆으로 오는 카메라 구멍이었습니다. enableEdgeToEdge()로 띄운 창은 컷아웃 자리까지 차지하는데, SDK가 보는 화면 폭은 그 자리를 뺀 값이라면 숫자가 맞습니다.
제 테스트 기기는 갤럭시 노트9(SM-N960N)인데, 펀치홀이 없는 기기라 가로로 돌려도 이 경로에 들어가지 않습니다. 실패 기록이 나온 세 기기는 전부 화면에 카메라 구멍이 있는 기종입니다. 그래서 컷아웃이 원인이라는 것은 기기 재현 전까지는 추정이었습니다.
재현 — Android 11 에뮬 + 컷아웃 흉내 + 가로
에뮬레이터(Pixel 4, Android 11)에서 개발자 옵션의 컷아웃 흉내를 켜고 가로로 돌렸습니다. 명령으로는 이렇게 켤 수 있습니다.
adb shell cmd overlay enable-exclusive --category com.android.internal.display.cutout.emulation.tall
수정 전 빌드가 정확히 같은 문구로 거절당했고, 기록은 a_w=781 s_w=719였습니다. 창 폭 829dp에서 navigationBarsPadding()이 내비게이션 바 48dp를 빼서 781dp를 요청했는데, SDK는 내비게이션 바와 컷아웃 62dp를 둘 다 뺀 719dp를 화면으로 봤습니다. 컷아웃 추정이 맞았습니다.
그런데 같은 조건을 Android 16 에뮬레이터에서 다시 해 보니 재현되지 않았습니다. 가로·컷아웃 그대로인데 배너가 창 전체 폭으로 정상 로드됐습니다. 예전 기준의 화면 폭이 남아 있는 구버전 OS에서만 나는 문제였고, 실패 기록이 나온 세 기기와도 맞습니다. 최신 OS 에뮬레이터로만 확인했다면 이번에도 놓쳤을 것입니다.
| 조건 | 결과 |
|---|---|
| 세로 방향 (어느 OS든) | 컷아웃이 위쪽이라 폭에 영향 없음 — 정상 |
| 가로 + 컷아웃 없는 기기 (노트9) | 정상 — 재현 안 됨 |
| 가로 + 컷아웃 + Android 11 에뮬 | a_w=781 s_w=719 거절, 배너 빈 자리 |
| 가로 + 컷아웃 + Android 16 에뮬 | 정상 — 재현 안 됨 |
해결 — 요청 폭을 화면 폭 후보의 최솟값으로 누른다
고칠 자리는 두 갈래였습니다. 앱마다 배너 컨테이너에 displayCutoutPadding()을 붙이는 방법과, 공통 광고 라이브러리의 배너 함수에서 요청 폭을 한 번 누르는 방법입니다. 저는 앱 스무 개 남짓이 같은 라이브러리를 쓰고 있어서, 앱별로 복사해 고치다 일부만 고쳐지는 일을 피하려고 라이브러리 쪽을 골랐습니다. 아래가 그 코드입니다(실제 코드).
internal fun bannerWidthDp(context: Context, slotDp: Int): Int {
val candidates = runCatching {
fun dp(ctx: Context): Int {
val m = ctx.resources.displayMetrics
return if (m.density > 0f) (m.widthPixels / m.density).toInt() else 0
}
listOf(
dp(context),
dp(context.applicationContext),
context.resources.configuration.screenWidthDp,
context.applicationContext.resources.configuration.screenWidthDp,
)
}.getOrDefault(emptyList())
val fit = clampBannerWidth(slotDp, candidates)
if (fit != slotDp) Log.i(LOG_TAG, "banner width: slot=$slotDp -> $fit (screen=$candidates)")
return fit
}
// 0 이하인 후보는 "모른다"라 무시한다.
internal fun clampBannerWidth(slotDp: Int, screenDps: List<Int>): Int =
(screenDps.filter { it > 0 } + slotDp).min()
그리고 loadBanner가 받은 자리 폭을 바로 쓰지 않고 이 값을 거쳐 getCurrentOrientationAnchoredAdaptiveBannerAdSize에 넘깁니다. 앱 쪽 배너 컴포저블은 BoxWithConstraints의 maxWidth를 그대로 넘기기만 합니다.
SDK가 정확히 어느 값을 화면 폭으로 쓰는지는 공개된 자료에서 찾지 못했습니다. 그래서 후보를 다 모아 가장 작은 값을 고르는 쪽을 택했습니다. 넓게 요청하면 광고가 0이 되지만, 좁게 요청하면 양옆에 여백이 조금 생길 뿐이라 틀려도 덜 아픈 방향입니다. 액티비티 컨텍스트와 앱 컨텍스트를 둘 다 보는 것은, 기기에 따라 두 값의 기준이 다를 수 있다고 보고 넣은 안전장치입니다. 0 이하 후보를 거르는 것도 일부러입니다. 못 구한 값 0을 최솟값으로 삼으면 폭이 0이 되어 적응형이 아닌 고정 배너로 떨어집니다.
확인 방법
1. 실측 숫자 그대로 단위 테스트
GA4에서 나온 세 기기의 a_w와 s_w를 그대로 넣어, 자리 폭이 화면보다 넓으면 화면 폭으로 눌리는지 봅니다. 대조군으로 세로 방향처럼 자리 폭이 화면 안일 때는 건드리지 않는지, 후보가 0·음수·빈 목록일 때는 자리 폭을 그대로 두는지도 같이 넣었습니다. 대부분의 배너는 세로 방향에서 뜨니, 여기서 괜히 줄이면 멀쩡한 배너가 작아집니다.
assertEquals(837, BokAds.clampBannerWidth(866, listOf(914, 837, 837, 837))) // SM-A315N
assertEquals(695, BokAds.clampBannerWidth(732, listOf(695))) // moto g62
assertEquals(411, BokAds.clampBannerWidth(411, listOf(411, 411, 411, 411))) // 세로, 그대로
assertEquals(866, BokAds.clampBannerWidth(866, listOf(0, -1))) // 모르는 후보 무시
2. 재현했던 에뮬에서 로그로 확인
같은 Android 11 에뮬, 같은 컷아웃 흉내, 같은 가로 방향에서 수정 빌드를 돌리면 logcat에 banner width: slot=781 -> 718이 찍히고 테스트 광고가 실렸습니다. 세로로 돌리면 이 로그가 아예 안 나오고 배너도 정상이었습니다. 로그가 "눌렀을 때만" 찍히게 해 둔 것은, 이후 배포 전 점검에서 세로 기기의 배너가 건드려지지 않았는지를 바로 보기 위해서입니다.
3. 배포 전 점검에 한 줄 추가
이 뒤로 앱을 올릴 때마다 실기기 점검 기록에 배너가 화면에 실제로 그려진 좌표와 will not fit 0을 같이 적고 있습니다. 다만 제 점검 기기는 컷아웃이 없어서 이 줄은 회귀가 없다는 확인일 뿐이고, 가로·컷아웃 경로는 에뮬레이터로 따로 봐야 합니다.
제 공통 라이브러리는 자동 검사 기기를 걸러 내는 판정이 있어서, 에뮬레이터에 시스템 설정
firebase.test.lab=true가 남아 있거나 x86_64 에뮬에 갓 설치한 상태면 광고를 일부러 막습니다. 재현할 때 배너가 안 나오면 이 문제인지 SDK 거절인지부터 갈라야 합니다. 이건 제 라이브러리 사정이고 애드몹 SDK의 동작은 아닙니다.
자주 묻는 것
얼마나 자주 나는 문제였나요?
60일 전수로 전 앱 합쳐 3건이었습니다. 드뭅니다. 다만 화면 방향을 고정하지 않은 앱이 22개 중 18개였고, 한 번 걸리면 그 기기에서 가로로 보는 내내 배너가 안 뜨는데 사용자 눈에는 빈 자리일 뿐이라 아무도 알려 주지 않습니다. 실패 계측이 없었다면 3건조차 몰랐을 것입니다. 고친 버전이 나간 뒤 이 숫자가 실제로 줄었는지는, 원래 건수가 너무 적어 아직 말할 수 있는 단계가 아닙니다.
displayCutoutPadding()을 붙이면 안 되나요?
그것도 방법입니다. 저는 앱마다 붙여야 하는 수정은 한두 곳을 빠뜨리기 쉬워서 라이브러리 한 곳에서 누르는 쪽을 골랐습니다. 대신 이 방식은 공통 라이브러리 버전을 올리고 앱마다 다시 배포해야 반영됩니다. 저는 이 수정 하나 때문에 따로 배포하지 않고, 각 앱의 다음 배포에 같이 실었습니다.
LocalConfiguration.screenWidthDp를 써도 되는 경우가 있나요?
배너가 창 폭 전체를 쓰고 양옆에 패딩이나 인셋이 하나도 없다면 결과가 같을 수 있습니다. 하지만 edge-to-edge를 켜고 시스템 바 패딩을 넣는 순간 자리 폭과 어긋납니다. 저는 8월 수정 이후로 자리 폭을 넘기고, 그 값을 다시 화면 폭 후보로 누르는 두 단계를 기본으로 씁니다.
오류 코드 1이면 전부 이 문제인가요?
아닙니다. 코드 1은 요청이 잘못됐다는 넓은 분류라 광고 단위 ID 같은 설정 문제도 같은 코드로 옵니다. 메시지에 Ad size will not fit on screen이 있고 a_w가 s_w보다 클 때가 이 경우입니다. 그래서 배너 실패를 남길 때 코드만이 아니라 메시지 원문까지 같이 싣는 것이 중요했습니다.
