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

# ads.txt 설정

> 백필 광고를 운영하기 위한 인벤토리 인증 설정입니다.

## Authorized Digital Sellers

**Authorized Digital Sellers**는 광고 인벤토리 사기를 방지하기 위한 IAB 표준입니다. 웹사이트용 `ads.txt`와 앱용 `app-ads.txt` 파일을 통해 "이 인벤토리는 에이드랍을 통해 판매할 수 있다"는 것을 광고주에게 증명합니다.

파일이 올바르게 설정되어 있지 않으면 광고주(DSP)가 광고 요청을 신뢰하지 않아 **광고가 노출되지 않거나 수익이 크게 감소**할 수 있습니다.

***

## 내 환경에 맞는 파일 선택

광고가 **어디에서 렌더링되는지**에 따라 설정해야 하는 파일이 다릅니다.

<CardGroup cols={2}>
  <Card title="app-ads.txt" icon="mobile">
    **네이티브 앱**

    Android/iOS 네이티브 UI에서 광고가 노출되는 경우
  </Card>

  <Card title="ads.txt" icon="globe">
    **웹뷰 기반 앱 / 웹사이트**

    웹뷰 또는 브라우저에서 광고가 노출되는 경우
  </Card>
</CardGroup>

<Warning>
  모바일 앱이더라도 내부가 웹뷰로 구현되어 있고, 광고가 웹뷰 영역에 노출된다면 **ads.txt**를 설정해야 합니다. 앱스토어에 등록된 앱인지 여부가 아니라, **광고가 실제로 어디에서 렌더링되는지**가 기준입니다.
</Warning>

***

## 설정 방법

<Tabs>
  <Tab title="app-ads.txt (네이티브 앱)">
    ### 처음 설정하는 경우

    기존에 `app-ads.txt`를 사용하지 않았다면, 리다이렉트 설정이 가장 간단합니다.

    ```
    Redirect 301 /app-ads.txt https://adrop.io/app-ads.txt
    ```

    ### 이미 app-ads.txt를 사용 중인 경우

    다른 광고 네트워크의 내용이 이미 있다면, 리다이렉트를 사용할 수 없습니다. 아래 URL에 접속해서 내용을 복사한 후 기존 파일에 추가해주세요.

    ```
    https://adrop.io/app-ads.txt
    ```

    <Warning>
      기존 내용을 삭제하면 다른 광고 네트워크가 작동하지 않습니다. 반드시 기존 내용을 유지하고 에이드랍 내용을 **추가**해주세요.
    </Warning>

    ### 업로드 위치

    앱스토어/플레이스토어에 등록된 웹사이트 도메인의 루트 경로에 업로드합니다.

    ```
    https://your-domain.com/app-ads.txt
    ```
  </Tab>

  <Tab title="ads.txt (웹)">
    ### 처음 설정하는 경우

    기존에 `ads.txt`를 사용하지 않았다면, 리다이렉트 설정이 가장 간단합니다.

    ```
    Redirect 301 /ads.txt https://adrop.io/ads.txt
    ```

    ### 이미 ads.txt를 사용 중인 경우

    다른 광고 네트워크의 내용이 이미 있다면, 리다이렉트를 사용할 수 없습니다. 아래 URL에 접속해서 내용을 복사한 후 기존 파일에 추가해주세요.

    ```
    https://adrop.io/ads.txt
    ```

    <Warning>
      기존 내용을 삭제하면 다른 광고 네트워크가 작동하지 않습니다. 반드시 기존 내용을 유지하고 에이드랍 내용을 **추가**해주세요.
    </Warning>

    ### 업로드 위치

    웹사이트 도메인의 루트 경로에 업로드합니다.

    ```
    https://your-domain.com/ads.txt
    ```
  </Tab>
</Tabs>

***

## 설정 확인

### 파일 접근 확인

설정한 URL에 접속하여 파일이 올바르게 적용되었는지 확인하세요.

```
https://your-domain.com/ads.txt
https://your-domain.com/app-ads.txt
```

### robots.txt 크롤링 허용 확인

`robots.txt`에서 크롤러가 `ads.txt` 또는 `app-ads.txt` 파일에 접근하는 것을 차단하면, 광고 네트워크가 파일을 검증할 수 없어 **광고가 노출되지 않습니다**.

다음과 같이 `robots.txt`에서 해당 경로의 크롤링을 허용해야 합니다:

```txt robots.txt theme={null}
User-agent: *
Allow: /ads.txt
Allow: /app-ads.txt
```

### Google 크롤러 접근 검증

브라우저에서는 파일이 정상적으로 보이더라도, 서버나 CDN이 Googlebot을 차단하면 광고가 노출되지 않습니다. 다음 명령어로 검증할 수 있습니다:

```bash theme={null}
# 1. 파일 접근 가능 여부 확인
curl -iL https://your-domain.com/ads.txt

# 2. Google 크롤러로 접근 가능 여부 확인
curl -iL -A "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)" https://your-domain.com/ads.txt
```

두 명령어 모두 동일한 내용이 반환되어야 합니다. 두 번째 명령어에서 다른 응답이 나오면 서버/CDN 설정을 확인하세요.

<Warning>
  환경에 맞는 txt 파일 설정이 올바르게 되어 있어야 백필 광고가 정상적으로 게재됩니다. 설정이 없거나 크롤링이 차단되면 광고 요청이 거부될 수 있습니다.
</Warning>

***

## 다음 단계

플랫폼에 맞는 SDK를 연동하세요:

<CardGroup cols={2}>
  <Card title="Android" icon="android" href="/ko/sdk/android/overview">
    Android SDK 연동 가이드
  </Card>

  <Card title="iOS" icon="apple" href="/ko/sdk/ios/overview">
    iOS SDK 연동 가이드
  </Card>

  <Card title="React Native" icon="react" href="/ko/sdk/react-native/overview">
    React Native SDK 연동 가이드
  </Card>

  <Card title="Flutter" icon="flutter" href="/ko/sdk/flutter/overview">
    Flutter SDK 연동 가이드
  </Card>

  <Card title="Web" icon="globe" href="/ko/sdk/web/react">
    Web SDK 연동 가이드
  </Card>
</CardGroup>
