최근 내가 운영하는 블로그인 KidStory, IssueLog, Jin's Lab 세 곳에 새로운 본문 상하단 광고를 추가했다. 반응형 광고를 사용했기 때문에 디바이스 크기에 맞춰 당연히 본문 영역 안에 예쁘게 안착할 줄 알았다. 하지만 실제 모바일 화면이나 특정 화면에서 확인해 보니 광고가 본문 영역보다 넓게 렌더링되면서 전체 레이아웃이 흉하게 깨지는 치명적인 버그가 발생했다.
반응형 광고가 본문을 뚫고 나오는 황당한 버그
처음에는 단순히 일시적인 렌더링 지연 오류이거나 일시적인 문제인 줄 알았다. 하지만 세 블로그 모두에서 동일하게 본문 영역 바깥으로 광고 영역이 툭 튀어나오며 우측 레이아웃이 보기 싫게 밀리는 상태가 반복됐다. 모바일 브라우저로 접속할 때 불필요한 가로 스크롤까지 생겨 버리니 방문자 경험 측면에서도 최악의 버그였다.
이상하게도 기존에 배치해 두었던 사이드바 광고는 화면 크기에 맞춰서 아주 깔끔하게 폭이 조절되고 있었다. 유독 이번에 새로 추가한 본문 영역 광고인 .jp-ad-post 영역과 인피드 광고 영역인 .jp-ad-infeed 영역에서만 레이아웃 터짐 현상이 심하게 일어났다. 왜 똑같은 반응형 애드센스 광고 코드인데 위치에 따라 다르게 작동하는지 머리를 싸매며 CSS 코드를 파고들기 시작했다.
원인은 숨겨진 ins 태그 스타일과 인라인 width
개발자 도구를 열고 세 블로그의 레이아웃을 찬찬히 뜯어보니 범인은 구글 애드센스가 동적으로 주입하는 ins 태그였다. 애드센스는 반응형 광고를 렌더링할 때 자신들이 자체적으로 계산한 고정 가로폭 스타일을 태그 내부 인라인 속성으로 강제 주입해 버린다.
이렇게 인라인 스타일로 주입되는 고정 width 값이 부모 컨테이너가 허용하는 너비보다 크게 잡히면 레이아웃이 우측으로 사정없이 탈출하게 된다. 내가 아무리 부모 영역의 반응형 광고 CSS 설정을 감각적으로 해놓았더라도, 스타일 우선순위 최상위에 위치한 인라인 스타일 앞에서는 무용지물이었다.
알고 보니 기존에 멀쩡히 작동하던 사이드바 광고(.jp-ad-sidebar ins)에는 이미 max-width:100% !important 설정이 꼼꼼하게 적용되어 있었다. 반면 새로 만든 본문 및 인피드 광고 영역에는 이 핵심 ins 태그 스타일 규칙을 통째로 누락한 채 껍데기 컨테이너만 새로 짰던 것이 뼈아픈 삽질의 시작이었다.
해결책은 복붙과 max-width important 설정
원인을 알았으니 해결은 간단했다. 문제가 발생한 세 블로그의 스킨 편집 창을 모두 열고, 누락되었던 반응형 광고 CSS 코드를 완벽하게 보강해 주기로 했다. 새로 추가했던 .jp-ad-post ins 셀렉터와 .jp-ad-infeed ins 셀렉터를 각각 잡아 스타일을 입력했다.
여기에 max-width:100% !important 규칙을 명확하게 선언해 주었다. 이 설정은 애드센스 스크립트가 실시간으로 주입하는 무지막지한 인라인 가로폭 스타일보다 우리 쪽 CSS가 더 높은 우선순위를 갖도록 강제하는 역할을 한다.
추가로 본문 광고를 감싸는 바깥 컨테이너인 .jp-ad-post 자체에도 max-width:100%; box-sizing:border-box 속성을 추가하여 패딩값 때문에 미세하게 밀리는 현상까지 완벽하게 잡아냈다. 수정을 마치고 세 블로그에 접속해 보니 가로 스크롤이 말끔하게 사라지고 광고가 본문 안에 예쁘게 정렬된 모습을 확인할 수 있었다.
뼈아픈 교훈과 앞으로의 작업 방향
이번 수정을 거치며 기존에 정상 작동하던 코드 블록의 구조를 고스란히 답습하는 것이 얼마나 중요한지 뼈저리게 느꼈다. 새롭게 광고 레이아웃을 생성할 때는 무작정 컨테이너만 새로 만드는 버릇을 버려야 한다. 기존 블록에서 애드센스 ins 태그 스타일을 제어하던 !important 규칙을 꼭 그대로 복사해 와야 뒤탈이 없다.
다행히 세 블로그 모두에서 광고 영역이 정상 범주 내에 안착했으니 당분간 이와 관련된 레이아웃 깨짐 현상은 없을 것 같다. 혹시 반응형 애드센스 광고를 도입한 뒤 본문 폭이 넓어져 모바일 화면이 가로로 흔들리거나 깨진다면, 헤매지 말고 가장 먼저 ins 태그의 max-width 설정을 확인해 보길 바란다.