---
title: 월드 내 광고 추가해서 돈 벌기
slug: world-sdk-guide-kr/e7cBFW8cBGKxi4fRC-RIi
docTags: 
createdAt: 2024-09-02T08:34:13.134Z
---

ZEPETO 월드 내에 광고를 추가할 수 있습니다.

ZEPETO 월드에는 두 가지 유형의 광고를 배치할 수 있습니다: 전면 광고와 몰입형 광고. 몰입형 광고는 월드 내의 디지털 광고판에 나타납니다.

:::hint{type="danger"}
- 광고는 모바일 환경에서만 표시됩니다. 정확한 미리보기를 위해 Unity Editor Scene Play 대신 QR 모바일 테스트를 사용하세요.
- 이 기능은 ZEPETO APP 버전 3.37.000 이상이 필요합니다.
- 광고 키 발급 및 수익 문의는 ZEPETO 직원에게 연락하세요.
:::



## ZEPETO 광고 패키지 설치

1\) Window → Package Manager 버튼을 클릭하여 패키지 관리자를 엽니다.

2\) 패키지 관리자 창의 오른쪽 상단에 있는 고급 버튼을 클릭한 다음 고급 프로젝트 설정을 선택합니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-qBt70gzc7bM2qTpq8MtyT-20240904-102413.png)

3\) 프로젝트 설정의 패키지 관리자 섹션에서 범위의 오른쪽 하단에 있는 (+) 버튼을 클릭합니다.

4\) 새 입력 필드에 'media'를 입력하고 적용을 클릭합니다.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-e72nA5Gg2tWfxBSGZw0EI-20240904-102413.png)

5\) Unity 프로젝트 폴더 > 패키지에서 `manifest.json`을 열고 다음 내용을 추가하세요.

```json
"dependencies": {
  ...
    "media.advertisement": "0.1.1"
  ...
 }
```

6\) 그런 다음 패키지 관리자에서 ZEPETO.Advertisement 패키지를 설치하세요.



## 전면 광고 적용하기

### 스크립트 작성

```typescript
import { Button } from 'UnityEngine.UI';
import { AdShowResult, WorldAdvertisement } from 'ZEPETO.Advertisement.General';
import { ZepetoScriptBehaviour } from 'ZEPETO.Script'

const AD_KEY: string = "Monetize_Template";

export default class AdvertisementSample extends ZepetoScriptBehaviour {
    public button: Button;

    Start() {
        this.button.onClick.AddListener(() => {
            this.ShowAd();
        });
    }

    ShowAd() {
        WorldAdvertisement.Show(
            AD_KEY,
            result => this.OnAdShowResult(result)
        );
    }

    OnAdShowResult(result: AdShowResult) {

        if (result == AdShowResult.Finished) {
            console.log("광고 표시 성공; 완료.");
            return;
        }

        let failMessage: string;
        switch (result) {
            case AdShowResult.Failed:
                failMessage = "실패";
                break;
            case AdShowResult.Skipped:
                failMessage = "건너뜀";
                break;
            case AdShowResult.NotReady:
                failMessage = "준비되지 않음";
                break;
            default:
                failMessage = "알 수 없는 결과";
                break;
        }
        console.log(`광고 표시 실패; ${failMessage}.`);

    }
}
```

| **광고 표시 결과 (열거형)** | **값** | **설명**        |
| ------------------ | ----- | ------------- |
| 실패                 | 0     | 광고 SDK 초기화 실패 |
| 건너뜀                | 1     | 광고 건너뜀        |
| 완료                 | 2     | 광고 시청 완료      |
| 준비되지 않음            | 3     | 광고 준비되지 않음    |



:::hint{type="success"}
**👍 광고 키**

- **기본 광고 키**: **수익화\_템플릿**
:::

:::hint{type="danger"}
**❗️ 주의**
WorldAdvertisement.Show 함수를 호출할 때, iOS에서 충돌을 방지하기 위해 두 번째 인수로 콜백을 클로저로 전달하세요.

- 이렇게 작성하는 대신:

```typescript
ShowAd() {
    WorldAdvertisement.Show(
        AD_KEY,
        this.OnAdShowResult
    );
}
```

- 이렇게 작성하세요:

```typescript
ShowAd() {
    WorldAdvertisement.Show(
        AD_KEY,
        result => this.OnAdShowResult(result)
    );
}
```
:::



QR 모바일 테스트를 실행하여 광고가 올바르게 표시되는지 확인하세요.

::Image[]{src="https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/57dsysgN_i6P3YqL1rwLX_image.png" size="60" width="2258" height="1070" position="center" caption="Android" showCaption="true"}

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-NfngZofmgQl5drxr0U4oS-20240904-102414.png" size="60" width="2436" height="1125" position="center" caption="iOS" showCaption="true"}



## 광고 수익 창출하기

### 월드 광고 수익에 대해 알고 싶어요!

ZEPETO에서는 본인이 제작한 월드에 광고를 삽입하여 수익을 창출할 수 있습니다. 

- 유저들의 광고 시청 수에 비례하여 광고 수익을 지급합니다.
- 광고 수익은 지정된 정산 날짜에 제페토 스튜디오에 출금 가능한 **ZEM** 으로 지급되며, 제페토 스튜디오의 출금하기 메뉴를 통해 현금으로 출금이 가능합니다. (앱 내 재화로는 사용 불가능)



### 월드 광고 수익 정산

광고 수익은 분기별로 지급됩니다.

| **분기** | **날짜**   |
| ------ | -------- |
| 1분기    | 4/15 지급  |
| 2분기    | 7/15 지급  |
| 3분기    | 10/15 지급 |
| 4분기    | 1/15 지급  |

:::hint{type="success"}
**참고**
지급일이 휴일인 경우, 다음 업무일에 지급될 예정입니다.
:::



### 월드 광고 수익을 벌고 싶다면?

**1단계: 아래 기본 조건 중 하나를 충족해주세요.**

- UV 20,000 이상의 월드를 제작한 경우
- 월드 공모전 등의 이벤트에서 수상한 경우 
- 1달에 2개 이상 우수한 퀄리티의 빌드잇 플러그인 월드를 출시한 경우

**2단계: 아래 신청서 작성을 통해 ZEPETO에 내부심사를 요청해주세요.**

:::CtaButton{label="구글폼 제출하기" externalHref="https://docs.google.com/forms/d/e/1FAIpQLSfmwgRJROAbI-RqkRWDj4I_79JovYVxtFRPhlsQOleYfo78CA/viewform" openInNewTab="true"}

:::

**3단계: 내부심사에 통과한 경우, 크리에이터에게 전용 광고키를 발급해드리며 분기별로 광고 수익 정산을 받으실 수 있습니다.**



### 광고 수익을 출금하고 싶어요

아래 영상을 따라해보고, 정산받은 ZEM을 출금해보세요!

::embed[]{url="https://youtu.be/LcjscVm1AeY"}