> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiderx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 광고가 표시되지 않을 때

> 광고 요청부터 화면 표시와 성과 기록까지 단계별로 확인합니다.

광고가 보이지 않는 문제와 광고는 보이지만 성과 지표가 없는 문제는 확인할 위치가 다릅니다. 아래 순서로 실제 요청 한 건을 추적하고, 내 계정으로 볼 수 없는 설정은 운영자에게 확인하세요.

## 먼저 문제를 구분하세요

| 증상 | 우선 확인할 곳 |
| - | - |
| 광고 영역이 비어 있고 광고 응답도 없음 | 광고 항목·배정·대상·요청 조건 |
| API 응답에 광고가 있지만 화면에 보이지 않음 | 응답 형식에 맞게 광고를 화면에 표시하는 앱·웹 연동 |
| 광고는 보이지만 노출·클릭 지표가 없거나 다름 | 이벤트 추적, 로그 연동, 조회 기간과 지표 필터 |

브라우저나 앱에서 문제가 발생한 시각과 시간대, 광고 단위 ID, 웹/앱 구분, 요청 ID(있는 경우), HTTP 상태 코드와 응답의 광고 유무를 기록합니다. 광고주 계정에서는 자사 광고 항목 ID와 배정 상태도 준비하세요. 지원을 요청할 때 쿠키, 인증 토큰, 개인 식별 정보, 서명된 요청 전체나 입찰 파라미터 값은 보내지 말고 가린 뒤 필요한 항목만 공유합니다.

## 광고 응답이 없을 때

### 1. 주문과 광고 항목의 상태·기간

* 광고 주문이 **진행중** 상태인지 확인합니다. 광고 항목은 **게재 중** 상태여야 실제 요청 후보가 됩니다. **초안**, **대기**, **준비 중**, **보관됨** 상태라면 상태 흐름과 다음 작업은 [상태 변경과 운영 종료](https://docs.aiderx.io/guides/for-advertisers/ko/lifecycle.md)를 참고하세요.
* 광고 항목의 시작·종료 시각이 현재 시각을 포함하는지 확인합니다. 주문 기간 안에 들어 있는지도 확인합니다.
* 요일·시간대별 **스케줄**을 설정했다면 요청 시각의 요일과 시간을 해당 시간대 기준으로 확인합니다. 시간대가 비어 있으면 UTC 기준으로 적용됩니다.
* 광고 항목이 보관되어 배정이 **취소** 상태가 됐는지, 노출 목표를 달성했거나 예산이 소진되어 배정이 **종료** 상태가 됐는지 확인합니다. 예산과 목표는 [주문과 광고 항목](https://docs.aiderx.io/guides/for-advertisers/ko/campaign-budget.md), 상태는 [상태 변경과 운영 종료](https://docs.aiderx.io/guides/for-advertisers/ko/lifecycle.md)에서 확인할 수 있습니다.

광고 서버는 게재 중이 아닌 광고 항목, 유효 기간 밖의 요청, 설정된 시간 스케줄과 맞지 않는 요청을 후보에서 제외합니다. 목표·예산은 현재 광고 항목과 배정 상태를 확인할 때 운영자와 함께 살펴보세요.

### 2. 배정과 실제 요청 대상

* 해당 광고 항목과 광고 단위 또는 게재 위치의 배정이 **게재 중**인지 확인합니다. **대기**나 **승인 요청** 상태에서는 광고가 게재되지 않습니다. [배정 요청](https://docs.aiderx.io/guides/for-advertisers/ko/allocation-request.md)과 [게재 승인](https://docs.aiderx.io/guides/for-retailers/ko/allocation-review.md)을 참고하세요.
* 광고 단위에 직접 배정했다면 요청에 사용한 광고 단위가 배정 대상 또는 그 아래 광고 단위인지 확인합니다. 상위 광고 단위에 연결된 배정도 하위 광고 단위 요청에 적용될 수 있습니다. 게재 위치에 배정했다면 요청에 사용한 광고 단위가 그 게재 위치에 포함되어 있는지 운영자와 확인합니다.
* 게재 승인을 요청하거나 배정을 게재할 때 광고 단위와 게재 위치의 활성 상태를 확인합니다. 게재 중인 배정은 요청 시점의 활성 상태만으로 제외되지 않습니다. 요청 경로에는 광고 단위 ID가 필요하며, `tagid`에 잘못된 형식이나 존재하지 않는 ID를 넣으면 `204 No Content`가 아니라 `500` 오류가 발생할 수 있습니다. [광고 단위와 게재 위치 관리](https://docs.aiderx.io/guides/for-retailers/ko/placement.md)를 참고하세요.

### 3. 소재와 광고 항목 연결

* 광고 항목에 활성 소재가 연결되어 있는지 확인합니다. 소재 자체의 상태와 광고 항목 연결의 상태는 각각 확인해야 합니다.
* 요청되는 디스플레이 크기와 소재 크기가 맞는지 확인합니다. 네이티브 광고는 광고 단위의 HTML/Asset 렌더링 방식과 포맷·스타일 연결도 확인합니다.
* 네트워크 광고는 배정의 애드소스 설정과 지원 환경을 확인합니다. 네트워크 광고도 게재하려면 활성 소재 연결이 필요하지만, 현재 콘솔에서는 연결 기능이 표시되지 않습니다. 임의로 배정을 게재하지 말고 A2 관리자에게 처리 방법을 확인하세요. 백필 광고는 외부 애드소스가 아니라 광고 항목에 연결한 내부 소재를 사용합니다. 백필 배정의 애드소스 값은 현재 게재에 사용되지 않습니다.

소재 등록·연결·크기 점검은 [소재 등록과 연결](https://docs.aiderx.io/guides/for-advertisers/ko/creative-types.md), 네이티브 설정은 [네이티브 포맷과 스타일](https://docs.aiderx.io/guides/for-retailers/ko/native-formats.md)을 참고하세요. 네트워크 유형에서도 애드소스 설정이 소재 연결을 대신하지 않습니다. 게재 상태를 바꿀 때 하는 검증에서도 활성 소재 연결과 활성 소재가 필요합니다.

### 4. 요청 조건과 노출 제한

* 광고 항목에 맞춤 조건이 있다면 요청이 같은 키와 값을 전달하는지 확인합니다. 요청에 조건이 없거나 값이 다르면 해당 항목이 광고 후보에서 제외될 수 있습니다. [맞춤 조건 설정](https://docs.aiderx.io/guides/for-advertisers/ko/targeting-strategy.md)을 참고하세요.
* 진행 중인 실험이 있으면 요청 사용자가 배정된 버킷과 그 안의 광고 항목을 확인합니다. 다른 버킷에 속한 광고 항목은 해당 요청의 후보가 아닐 수 있습니다.
* 배정의 빈도 제한을 확인합니다. 같은 사용자 ID로 요청을 반복하면 설정된 횟수 제한을 넘은 뒤 광고가 선택되지 않을 수 있습니다.
* 광고 항목의 게재 스케줄을 다시 확인합니다. 현재 요일·시각이 허용 범위 밖이면 다른 조건이 맞아도 광고 응답이 오지 않습니다.
* 노출 목표, 예산, 일 예산과 현재 소진·진행 상태를 비교합니다. 노출 목표를 달성하거나 예산이 소진되어 배정이 종료되었는지 확인합니다. 판단이 어려우면 광고 항목을 임의로 수정하지 말고 운영자에게 현재 상태와 수치를 확인해 달라고 요청하세요.

## 요청·응답·화면 표시를 나눠 확인하세요

1. 서비스가 해당 광고 단위 ID로 광고 요청을 보내는지 앱·웹 로그에서 확인합니다. 요청 경로, 본문, 응답 형식은 [광고 서빙 연동](https://docs.aiderx.io/development/ko/serving-ad.md)을 참고하세요.
2. HTTP 응답을 확인합니다. 조건에 맞는 광고가 없으면 `204 No Content`가 올 수 있으며, 이 경우 본문을 광고 데이터로 파싱하지 않습니다. `tagid`가 잘못된 형식이거나 존재하지 않는 광고 단위 ID라면 `500` 오류가 발생할 수 있습니다. 성공 응답에 광고 객체가 있다면 다음 단계에서 화면에 표시되지 않은 원인을 살펴봅니다.
3. 직접 API를 호출하는 서비스라면 응답의 소재 형식과 표시 코드를 대조합니다. 웹 SDK를 쓰는 경우 등록한 광고 단위 ID가 맞는지, SDK에서 광고 표시와 로그 전송이 연결되어 있는지 확인합니다. 세부 API 확인은 [광고 서빙 연동](https://docs.aiderx.io/development/ko/serving-ad.md)을 참고하세요.
4. 응답에 광고가 있고 화면에도 보인다면 노출 이벤트가 기록되는 경로를 확인합니다. 배정의 추적 방식이 **노출 이벤트 기준**이면 노출 추적 코드가 연동되어 있어야 합니다. API 응답 기준과 화면 노출 이벤트 기준은 노출이 기록되는 시점이 다릅니다. 직접 API 연동은 필요한 이벤트·로그 전송도 별도로 구현해야 합니다. [로그 연동 가이드](https://docs.aiderx.io/development/ko/log-integration-data-migration.md)를 참고하세요.

## 화면에는 광고가 있지만 성과 지표가 없을 때

배정이 **노출 이벤트 기준**이면 화면에 광고가 표시되어도 추적 코드가 노출 이벤트를 보내지 않으면 노출로 기록되지 않습니다. **광고 응답 기준**이면 응답 시점에 기록됩니다. 분석 화면에서 조회 기간과 광고 항목·광고 단위 필터를 확인한 뒤, 선택한 추적 방식에 맞게 로그 연동을 점검하세요. 운영자는 [분석 및 리포트](https://docs.aiderx.io/guides/for-retailers/ko/analytics.md)의 광고 단위 분석에서 미충족 요청과 노출 지표를 비교할 수 있습니다. 광고주는 [성과 분석](https://docs.aiderx.io/guides/for-advertisers/ko/performance-analytics.md)에서 본인 항목의 지표를 확인할 수 있습니다.

화면 표시와 이벤트 기록의 차이를 확인하기 어렵거나 필요한 설정을 볼 권한이 없으면 운영자에게 점검을 요청하세요.

## 운영자에게 문의할 때

아래 정보를 함께 전달하면 문제를 재현하고 범위를 좁히는 데 도움이 됩니다.

* 문제 발생 시각과 시간대, 웹/앱과 테스트 환경
* 광고 단위 ID, 광고 항목 ID, 배정 ID 또는 상태
* HTTP 상태 코드와 광고 객체 반환 여부, 요청 ID(있는 경우)
* 화면에는 표시됐는지, 지표 중 무엇이 누락됐는지와 조회 기간
* 사용자 정보와 토큰을 제거한 요청 조건, 관련 로그의 비밀값을 가린 일부 내용

광고 단위·배정·소재의 상태가 서로 다르거나 계정에서 확인할 수 없는 설정이 있으면 담당 운영자에게 점검을 요청하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.