모바일 포스트 광고 슬롯 ID 매핑 누락 수정
목차
광고 슬롯 마커 두 개를 레이아웃 파일 한 곳에서 정리했다.
배경: 마커가 "있긴 한데 제대로 안 동작하는" 상태
광고 연동 작업을 하다 보면 흔히 마주치는 상황이 있다. 슬롯 자체는 이미 레이아웃에 박혀 있는데, 어드민 DB 쪽 ID와 정확히 매핑이 안 돼 있어서 실제로는 광고가 노출되지 않거나 의도치 않은 슬롯에 붙는 케이스다. 이번도 딱 그랬다.
mobonslot-content-top-mob과 mobonslot-content-bottom-mob — 모바일 콘텐츠 상단/하단에 각각 붙는 슬롯인데, 어드민 DB에서 관리되는 ID가 각각 104, 105로 지정돼 있었다. 그런데 레이아웃 파일(Post.astro) 안에서 해당 마커가 이 ID를 명확히 참조하지 않고 있었던 것. "마커는 있으나 매핑이 없다" — 사실상 껍데기만 있던 상태였다.
작업 내용
변경 파일은 src/layouts/Post.astro 하나다. 포스트 레이아웃이라는 건 사이트에서 콘텐츠가 렌더링되는 핵심 틀이기 때문에, 여기서 광고 슬롯을 어떻게 선언하느냐가 실제 수익화에 직결된다.
이번 작업의 핵심은 두 가지다.
mobonslot-content-top-mob마커에 admin_db id 104 매핑 명시mobonslot-content-bottom-mob마커에 admin_db id 105 매핑 명시
<!-- before: 마커는 있으나 ID 연결 없음 -->
<div class="mobonslot-content-top-mob"></div>
<!-- after: admin_db id 명시 매핑 -->
<div class="mobonslot-content-top-mob" data-slot-id="104"></div>
<div class="mobonslot-content-bottom-mob" data-slot-id="105"></div>
코드 자체는 diff 규모가 크지 않다. 그런데 이런 "핀포인트 수정"이 오히려 더 신경 쓰인다. 작업량은 적고, 영향은 크고, 잘못 건드리면 전체 포스트 레이아웃에서 광고가 깨지거나 아예 안 뜬다.
이런 매핑 작업이 왜 놓치기 쉬운가
광고 슬롯 연동은 프론트엔드와 어드민/운영 시스템이 동시에 관여하는 영역이다. 보통 다음 흐름으로 진행된다.
| 단계 | 담당 | 체크포인트 |
|---|---|---|
| 슬롯 ID 발급 | 어드민/운영 | admin_db에 ID 생성 |
| 레이아웃 마커 삽입 | 프론트 | HTML/컴포넌트에 클래스/마커 추가 |
| ID 매핑 연결 | 프론트 + 어드민 | 마커 ↔ ID 정확히 바인딩 |
| 노출 검증 | QA / 팀원 | 실제 슬롯에 광고 렌더링 확인 |
이 흐름에서 "슬롯 마커 삽입"과 "ID 매핑 연결"이 서로 다른 태스크로 분리되거나, 타이밍이 어긋날 때 이번 같은 상황이 생긴다. 마커를 먼저 넣고 ID 발급을 기다리다가, ID가 나온 시점에 매핑 연결 작업이 별도 커밋으로 처리되는 것 자체는 자연스럽다. 문제는 이 '보강' 작업이 누락되거나 방치될 때다.
팀 리딩 관점에서 보면, 이런 부분은 태스크 정의 단계에서 "슬롯 마커 삽입 + ID 매핑 확인"을 하나의 완료 조건으로 묶어 두는 게 낫다. "마커 넣었으면 끝"이 아니라 "마커 + ID 연결 + 노출 검증 완료"가 done의 기준이 돼야 한다. 코드리뷰 때도 슬롯 관련 컴포넌트를 볼 때 data attribute나 ID 매핑 여부를 체크리스트에 넣어두면 이런 보강 커밋이 줄어든다.
레이아웃 파일 한 곳에서 관리하는 것의 의미
Post.astro 하나에서 두 슬롯을 모두 처리하는 구조는 유지보수 관점에서 맞는 방향이다. 슬롯이 여러 컴포넌트에 분산돼 있으면 나중에 ID 변경이나 슬롯 off/on 작업을 할 때 여기저기 건드려야 해서 실수 가능성이 올라간다. 레이아웃 레벨에서 한 번에 선언하고 관리하는 구조가 팀원 누가 봐도 "광고 슬롯은 여기서 찾으면 된다"는 컨벤션을 만든다.
모바일 top/bottom 분리도 마찬가지다. 상단 슬롯과 하단 슬롯은 광고 단가, 노출 우선순위, 뷰포트 기준 등이 다르게 운영될 수 있어서 ID를 분리해 관리하는 게 맞다. 104/105로 별도 발급된 것도 그 이유다.
작은 보강 커밋이지만, 이게 붙지 않으면 모바일 포스트 지면 광고가 실질적으로 작동 안 하는 상태다. 규모보다 영향을 보는 게 맞다.
끝.
🛒 이 글과 어울리는 추천 상품
*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.
댓글 0
첫 댓글 달아줘.