---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.4
alternate:
  - https://yandex.com/dev/games/doc/en/sdk/defold/adv.md
  - https://yandex.com/dev/games/doc/hi/sdk/defold/adv.md
  - https://yandex.com/dev/games/doc/ko/sdk/defold/adv.md
  - https://yandex.com/dev/games/doc/ru/sdk/defold/adv.md
  - https://yandex.com/dev/games/doc/tr/sdk/defold/adv.md
  - https://yandex.com/dev/games/doc/vi/sdk/defold/adv.md
  - https://yandex.com/dev/games/doc/zh/sdk/defold/adv.md
  - href: ko/sdk/defold/adv.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/ko/llms.txt

# 광고 관리

게임에 광고 블록을 배치하여 수익을 창출할 수 있습니다. 이렇게 하려면 다음과 같이 하세요.
1. 광고 배치를 위한 [팁 및 권장 사항](#recommendations)을 검토하세요.
2. SDK를 사용하여 광고 호출을 구성합니다.
3. Yandex Games 개발자 대시보드를 사용하여 [수익 창출을 활성화](https://yandex.com/dev/games/doc/ko/console/adv-monetization.md) 합니다.


## 광고 배치를 위한 팁 및 권장 사항 {#recommendations}

- 사용자가 이것이 게임의 일부가 아닌 광고 유닛임을 인식할 수 있도록 광고 호출을 배치하세요.
- 게임 내 광고 삽입 권장 위치: 게임 시작 전, 다음 레벨로 진행하기 전, 게임 패배 후.
- [보상형 동영상](#rewarded-video)을 원하는 만큼 자주 호출할 수 있습니다.
- 중간 광고 유닛을 호출하는 빈도는 [Yandex Games](https://yandex.com/games/)에서 제어합니다.


{% note alert "알림" %}

사용자가 무작위로 광고 유닛을 클릭하면 Yandex Advertising Network는 이를 광고 사기의 징후로 간주하고 게임 내 광고 수익을 감소시킵니다.

이를 방지하려면 사용자가 실수로 광고 차단을 클릭할 수 있는 게임 플레이 중에는 광고를 호출하지 마세요.

{% endnote %}

## 광고 호출 구성 {#settings}

### 중간 광고 {#full-screen-block}

중간 광고는 앱 배경을 완전히 가리고 사용자가 요청한 데이터(예: 다음 게임 레벨에 액세스)를 얻기 전에 표시되는 광고 단위입니다.

광고를 호출하려면 `ysdk.adv.show_fullscreen_adv()` 메서드를 사용합니다.

```lua
ysdk.adv.show_fullscreen_adv(callbacks: table)
```

`callbacks: table` — 선택적 콜백 함수. 각 광고 유닛마다 개별적으로 구성됩니다.

- `on_close` — 광고가 닫혔거나 오류가 발생했거나 너무 자주 호출되어 광고가 열리지 않을 때 호출됩니다. 광고가 표시되었는지 여부를 나타내는 값인 `wasShown` 인자(`부울` 유형)와 함께 사용됩니다.

- `on_open` — 광고가 성공적으로 열렸을 때 호출됩니다.

- `on_error` — 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.

- `on_offline` — 네트워크 연결이 끊겼을 때(오프라인 모드로 전환될 때) 호출됩니다.

#### 예시

```lua
ysdk.adv.show_fullscreen_adv({
  on_close = function (self, was_shown)
    -- 닫기 후 일부 작업
  end,
  on_error = function (self, error)
    -- 오류 시 일부 작업
  end
})
```

### 보상형 동영상 {#rewarded-video}

보상형 동영상은 게임 수익 창출에 사용되는 동영상 광고 블록입니다. 사용자는 보상형 동영상을 시청하면 보상 또는 게임 내 화폐를 받을 수 있습니다.

광고를 호출하려면 `ysdk.adv.show_rewarded_video()` 메서드를 사용합니다.

```lua
ysdk.adv.show_rewarded_video(callbacks: table)
```

`callbacks: table` — 선택적 콜백 함수. 각 광고 유닛마다 개별적으로 구성됩니다.

- `on_close` — 사용자가 동영상 광고를 닫을 때 호출됩니다.

- `on_open` — 동영상 광고가 화면에 표시될 때 호출됩니다.

- `on_error` — 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.

- `on_rewarded` — 동영상 광고 노출 수가 카운트될 때 호출됩니다. 이 함수를 사용하여 동영상 광고 시청에 대한 보상을 지정할 수 있습니다.

#### 예시

```lua
ysdk.adv.show_rewarded_video({
  on_open = function (self)
    print("Video ad open")
  end,
  on_close = function (self)
    print("Rewarded!")
  end,
  on_rewarded = function (self)
    print("Video ad closed.")
  end,
  on_error = function (self, error)
    print("Error while open video ad: " .. error)
  end
})
```

### 고정 배너 {#sticky-banner}


[고정 배너](*key_sticky) 표시를 활성화하려면 다음과 같이 하세요.

1. 개발자 콘솔을 열고 **Advertising**으로 이동합니다.
2. **Sticky banners**로 이동하여 배너 표시를 설정합니다.
   - 모바일 기기의 경우:
      - **Sticky banner in portrait orientation**: **At the bottom** 또는  **At the top**를 선택합니다.
      - **Sticky banner in landscape orientation**: **At the bottom**, **At the top** 또는 **On the right**를 선택합니다.

   - 컴퓨터의 경우: **Sticky banner on the desktop** 옵션을 활성화합니다. 배너가 오른쪽에 표시됩니다.


기본적으로 고정 배너는 게임이 시작될 때 표시되며 전체 세션 동안 표시됩니다. 배너를 표시할 순간을 설정하려면 다음과 같이 하세요.

1. **Sticky banners** 섹션에서 **Use the API to display a sticky-banner**을 활성화합니다.
2. 다음 메서드를 사용하여 배너 표시를 설정합니다:
    - `ysdk.adv.get_banner_adv_status()` — 배너의 상태를 표시합니다.
    - `ysdk.adv.show_banner_adv()` — 배너를 호출합니다.
    - `ysdk.adv.hide_banner_adv()` — 배너를 제거합니다.


`ysdk.adv.get_banner_adv_status()` 메서드는 `sticky_adv_is_showing: boolean` 값을 반환합니다. 만약 `sticky_adv_is_showing = false`라면,
`ysdk.adv.get_banner_adv_status()` 메서드는 선택적으로 가능한 이유를 담은 `reason` 필드를 반환할 수 있습니다:

- `ADV_IS_NOT_CONNECTED` — 배너가 연결되지 않았습니다.
- `UNKNOWN` — Yandex 측에서 광고를 표시하는 동안 오류가 발생했습니다.

#### 예시

```lua
ysdk.adv.get_banner_adv_status(
  function (self, sticky_adv_is_showing, reason)
    if sticky_adv_is_showing then
      -- 광고가 표시됨
    elseif reason then
      -- 광고가 표시되지 않음
      print(reason)
    else
      ysdk.adv.show_banner_adv()
    end
  end
)
```

---



<!-- source: ko/_includes/button-git-defold.md -->
<a href="https://github.com/yandex-games-plugins/defold">
  <span class="button">저장소</span>
</a>
<!-- endsource: ko/_includes/button-git-defold.md -->

[*key_sticky]: 게임 중에 표시되는 광고 유닛입니다.