> ## 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.

# 외부 광고 소스

> 외부 광고 네트워크를 연동하여 지면의 광고 수익을 최적화하는 방법을 안내합니다.

## 이 가이드는 누구를 위한 것인가요?

**리테일러(매체사)** 또는 **관리자** 계정으로 외부 광고 연동을 설정하는 분들을 위한 가이드입니다.

* 내부 광고만으로 지면을 채우지 못할 때 외부 광고를 활용하고 싶은 분
* SSP, Ad Exchange 등 외부 광고 네트워크를 연결하고 싶은 분
* 지면 수익을 최대화하기 위한 전략을 세우고 싶은 분

***

## 시작하기 전에

<Note>
  다음 조건이 충족되어야 합니다:

  * A2 관리 콘솔 접속 권한 (Ad Source 읽기/쓰기 권한)
  * 외부 광고 네트워크(SSP, Ad Exchange 등)의 **계정 및 연동 정보**가 준비(가입)되어 있어야 함
  * 연동할 광고 네트워크에서 발급받은 **API 키 또는 인증 정보**
</Note>

***

## 외부 광고 소스란?

외부 광고 소스(Ad Source)는 **A2 내부 광고가 없을 때 대신 보여줄 외부 광고**를 연결하는 기능입니다.

예를 들어:

* 내부 캠페인이 없거나 예산이 소진된 경우
* 특정 시간대에 내부 광고가 부족한 경우
* 더 높은 단가의 외부 광고가 있는 경우

```mermaid theme={null}
flowchart LR
    A[광고 요청] --> B{내부 광고?}
    B -->|있음| C[내부 광고 노출]
    B -->|없음| D[외부 광고 소스 호출]
    D --> E{외부 광고?}
    E -->|있음| F[외부 광고 노출]
    E -->|없음| G[빈 화면 또는 Passback]
```

이를 통해 **지면이 비어있는 시간을 최소화**하고 **수익을 극대화**할 수 있습니다.

***

## 1단계: 외부 광고 소스 만들기

### 기본 정보 입력

1. **외부 광고 소스** 메뉴에서 **새 소스 만들기**를 클릭합니다.
2. 다음 정보를 입력합니다:

| 항목            | 영어           | 설명             | 예시                            |
| ------------- | ------------ | -------------- | ----------------------------- |
| **이름**        | Name         | 구분하기 쉬운 이름     | "메인 SSP", "보조 네트워크"           |
| **연동 유형**     | Type         | 광고 네트워크 프로토콜   | OpenRTB, VAST, 커스텀            |
| **엔드포인트 URL** | Endpoint URL | 외부 광고 서버 주소    | `https://adx.example.com/bid` |
| **판매자 ID**    | Publisher ID | 매체 식별용 ID (선택) | "pub-12345678"                |

### 연동 유형 선택하기

| 유형          | 설명          | 사용 상황                 |
| ----------- | ----------- | --------------------- |
| **OpenRTB** | 실시간 입찰 프로토콜 | Ad Exchange, 대부분의 SSP |
| **VAST**    | 비디오 광고 표준   | 비디오 광고 네트워크           |
| **커스텀**     | 자체 API 연동   | 특수한 광고 네트워크           |

<Tip>
  대부분의 광고 네트워크는 **OpenRTB** 유형을 사용합니다. 비디오 광고만 제공하는 네트워크는 **VAST**를 선택하세요.
</Tip>

***

## 2단계: 인증 설정하기

외부 광고 네트워크에 접속하기 위한 인증 정보를 설정합니다.

### 헤더 파라미터

HTTP 요청 헤더에 포함할 정보입니다. API 키나 인증 토큰 등을 설정합니다.

| 키             | 값 예시                |
| ------------- | ------------------- |
| Authorization | Bearer your-api-key |
| Content-Type  | application/json    |

### 쿼리 파라미터

URL에 추가할 파라미터입니다. 매체 ID나 포맷 정보 등을 설정합니다.

| 키             | 값 예시      |
| ------------- | --------- |
| publisher\_id | pub-12345 |
| format        | json      |

<Note>
  인증 정보는 외부 광고 네트워크에서 발급받습니다. 해당 네트워크의 가이드를 참고하세요.
</Note>

***

## 3단계: 응답 시간 설정하기

외부 광고 서버의 응답을 얼마나 기다릴지 설정합니다.

| 설정       | 영어      | 설명       | 권장 값       |
| -------- | ------- | -------- | ---------- |
| **타임아웃** | Timeout | 응답 대기 시간 | 100\~200ms |

### 타임아웃 설정 가이드

| 값          | 장점        | 단점           |
| ---------- | --------- | ------------ |
| **100ms**  | 빠른 페이지 로딩 | 응답 실패 가능성 증가 |
| **200ms**  | 적절한 균형점   | -            |
| **300ms+** | 응답 성공률 높음 | 페이지 로딩 지연    |

<Warning>
  타임아웃이 너무 길면 사용자가 광고 영역이 비어 있는 것을 볼 수 있습니다. 일반적으로 **200ms 이하**를 권장합니다.
</Warning>

***

## 수익 최적화 전략

여러 외부 광고 소스를 등록한 경우, 호출 방식을 선택할 수 있습니다.

### 워터폴 방식

사전 설정한 외부 광고 소스 우선순위대로 하나씩 호출합니다.

```mermaid theme={null}
flowchart TD
    A[광고 요청] --> B[1순위: SSP A]
    B -->|응답 없음| C[2순위: SSP B]
    C -->|응답 없음| D[3순위: SSP C]
    B -->|응답 있음| E[광고 노출]
    C -->|응답 있음| E
    D -->|응답 있음| E
```

**장점:** 설정이 간단하고 예측 가능함   **단점:** 응답 시간이 누적될 수 있음

### 헤더 비딩 방식

모든 외부 광고 소스에 동시에 요청하고 가장 높은 가격을 제시한 광고를 노출합니다.

```mermaid theme={null}
flowchart TD
    A[광고 요청] --> B[동시 요청]
    B --> C[SSP A: 1,000원]
    B --> D[SSP B: 1,200원]
    B --> E[SSP C: 800원]
    C --> F[최고가 선택]
    D --> F
    E --> F
    F --> G[SSP B 광고 노출]
```

**장점:** 최고 수익 확보 가능 **단점:** 설정이 복잡하고 서버 부하 증가

<Tip>
  처음에는 **워터폴 방식**으로 시작하고, 트래픽이 많아지면 **헤더 비딩 방식**으로 전환하는 것을 권장합니다.
</Tip>

***

## 외부 광고 소스 관리하기

### 우선순위 변경

여러 소스가 있을 때 호출 순서를 조정할 수 있습니다.

1. **외부 광고 소스** 목록으로 이동합니다.
2. 드래그 앤 드롭으로 순서를 변경합니다.
3. **저장**을 클릭합니다.

### 비활성화/삭제

특정 소스를 일시적으로 중단하거나 삭제할 수 있습니다.

* **비활성화**: 설정은 유지하되 호출하지 않음 (나중에 다시 활성화 가능)
* **삭제**: 완전히 제거

***

## 문제 해결

<AccordionGroup>
  <Accordion title="외부 광고가 노출되지 않아요">
    다음을 확인하세요:

    1. 외부 광고 소스가 **활성화** 상태인지
    2. 엔드포인트 URL이 정확한지
    3. 인증 정보(API 키 등)가 올바른지
    4. 타임아웃이 너무 짧지 않은지
  </Accordion>

  <Accordion title="응답 시간이 너무 오래 걸려요">
    타임아웃 값을 줄이거나, 해당 광고 네트워크에 응답 속도 개선을 요청하세요. 응답이 지속적으로 느린 소스는 우선순위를 낮추는 것이 좋습니다.
  </Accordion>

  <Accordion title="여러 소스 중 하나만 호출되나요?">
    워터폴 방식에서는 1순위 소스가 응답하면 그대로 노출됩니다. 모든 소스에서 최고가를 선택하려면 헤더 비딩 방식을 사용하세요.
  </Accordion>

  <Accordion title="내부 광고와 외부 광고 중 어떤 것이 우선인가요?">
    기본적으로 **내부 광고(매체사가 직접 확보한 광고주의 광고)가 우선**입니다. 내부 캠페인이 없을 때만 외부 광고 소스가 호출됩니다. 수익 최적화 설정에서 이 순서를 조정할 수도 있습니다.
  </Accordion>
</AccordionGroup>

***

## 운영 체크리스트

외부 광고 소스를 효율적으로 운영하기 위해 주기적으로 확인해야 할 추천 사항입니다.

### 일일 점검

| 확인 항목         | 내용                     |
| ------------- | ---------------------- |
| **응답률**       | 각 소스의 응답 성공률 확인        |
| **Fill Rate** | 외부 광고로 채워진 노출 비율 확인    |
| **오류 로그**     | 타임아웃, 인증 실패 등 오류 발생 여부 |

### 주간 점검

| 확인 항목       | 내용                      |
| ----------- | ----------------------- |
| **소스별 수익**  | 각 외부 소스가 기여한 수익 비교      |
| **eCPM 비교** | 내부 광고 vs 외부 광고 수익성 비교   |
| **우선순위 검토** | 성과에 따른 소스 우선순위 조정 필요 여부 |

### 월간 점검

| 확인 항목         | 내용                   |
| ------------- | -------------------- |
| **연동 상태**     | API 키 만료, 계정 상태 등 확인 |
| **새 네트워크 검토** | 추가할 만한 새 광고 네트워크 탐색  |
| **전략 최적화**    | 워터폴 vs 헤더 비딩 전략 재검토  |