---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/games/doc/en/sdk/sdk-adv.md
  - https://yandex.com/dev/games/doc/hi/sdk/sdk-adv.md
  - https://yandex.com/dev/games/doc/ko/sdk/sdk-adv.md
  - https://yandex.com/dev/games/doc/ru/sdk/sdk-adv.md
  - https://yandex.com/dev/games/doc/tr/sdk/sdk-adv.md
  - https://yandex.com/dev/games/doc/vi/sdk/sdk-adv.md
  - https://yandex.com/dev/games/doc/zh/sdk/sdk-adv.md
  - href: ko/sdk/sdk-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는 이를 광고 사기의 징후로 간주하고 게임 내 광고 수익을 감소시킵니다.

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

잘못된 호출의 예:

```javascript
setInterval(() => ysdk.adv.showFullscreenAdv(), 180000)
```

{% endnote %}



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

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

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

광고를 호출하려면 `ysdk.adv.showFullscreenAdv({callbacks:{}})` 메서드를 사용합니다.

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

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

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

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


#### 예시

```javascript
ysdk.adv.showFullscreenAdv({
    [callbacks](*key_callbacks): {
        [onOpen](*key_onOpen): function() {
          // 광고가 열린 후의 동작.
        },
        [onClose](*key_onClose): function(wasShown) {
          // 닫기 후 일부 작업.
        },
        [onError](*key_onError): function(error) {
          // 오류 시 일부 작업.
        },
    }
})
```


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

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

광고를 호출하려면 `ysdk.adv.showRewardedVideo({callbacks:{}})` 메서드를 사용합니다.

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

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

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

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

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


#### 예시

```javascript
ysdk.adv.showRewardedVideo({
    [callbacks](*key_callbacks): {
        [onOpen](*key_onOpen): () => {
          console.log('Video ad open.');
        },
        [onRewarded](*key_onRewarded): () => {
          console.log('Rewarded!');
        },
        [onClose](*key_onClose2): () => {
          console.log('Video ad closed.');
        },
        [onError](*key_onError): (e) => {
          console.log('Error while open video ad:', e);
        },
    }
})
```


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


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

1. 개발자 콘솔을 열고 **초안**으로 이동합니다.
2. **고정 배너**로 이동하여 배너 표시를 설정합니다.
   - 모바일 기기의 경우:
      - **세로 방향의 고정 배너**: **하단에** 또는 **상단에**를 선택합니다.
      - **앨범 방향의 고정 배너**: **하단에**, **상단에** 또는 **오른쪽에**를 선택합니다.

   - 컴퓨터의 경우: **데스크톱의 고정 배너** 옵션을 활성화합니다. 배너가 오른쪽에 표시됩니다.


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

1. **고정 배너** 섹션에서 **시작 시 고정 배너 표시 안 함**을 활성화합니다.
2. 다음 메서드를 사용하여 배너 표시를 설정합니다.
   - `ysdk.adv.getBannerAdvStatus()`: 배너의 상태를 표시합니다.
   - `ysdk.adv.showBannerAdv()`: 배너를 호출합니다.
   - `ysdk.adv.hideBannerAdv()`: 배너를 제거합니다.


이 메서드들은 `stickyAdvIsShowing: boolean` 값을 반환합니다. `stickyAdvIsShowing = false`인 경우, `ysdk.adv.getBannerAdvStatus()` 및 `ysdk.adv.showBannerAdv()` 메서드는 다음과 같은 가능한 이유와 함께 선택적 `reason` 필드를 반환할 수 있습니다.

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

#### 예시

```javascript
ysdk.adv.getBannerAdvStatus().then(({ stickyAdvIsShowing , reason }) => {
    if (stickyAdvIsShowing) {
        // 광고가 표시됨.
    } else if(reason) {
        // 광고가 표시되지 않음.
        console.log(reason)
    } else {
        ysdk.adv.showBannerAdv()
    }
})
```


---

<!-- source: ko/_includes/concepts/troubleshooting/id-troubleshooting/support.md -->
{% note info "참고" %}

지원팀은 완성된 게임을 Yandex Games에 게시하는 데 도움을 드릴 수 있습니다. 개발이나 테스트에 대해 궁금한 점이 있다면, [Discord 채널](https://discord.com/invite/wU4p3whr4T)에서 질문해 주세요.

{% endnote %}


지원 서비스는 얀덱스 게임에서 완성 된 게임을 게시 할 수 있습니다. 개발 또는 테스트에 대한 질문이 있는 경우
<!-- endsource: ko/_includes/concepts/troubleshooting/id-troubleshooting/support.md -->

<!-- source: ko/_includes/button-fos.md -->
Yandex Games SDK 사용과 관련하여 문제가 발생하거나 질문이 있는 경우 다음 방법으로 지원팀에 문의하세요.


<a href="https://yandex.com/chat/#/user/a4fa5c06-75db-9b38-6eea-b1673785f7d5">
  <span class="button">채팅 상담</span>
</a>
<!-- endsource: ko/_includes/button-fos.md -->

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

[*key_onOpen]: `onOpen`: 동영상 광고가 화면에 표시될 때 호출됩니다.

[*key_onRewarded]: `onRewarded`: 동영상 광고 노출이 카운트될 때 호출되는 함수입니다. 이 함수를 사용하여 동영상 광고 시청에 대한 보상을 지정할 수 있습니다.

[*key_onClose]: `onClose`: 광고가 닫히거나, 오류가 발생하거나, 너무 자주 호출되어 광고가 열리지 않을 때 호출됩니다. 광고가 표시되었는지 여부를 나타내는 값인 `wasShown` 인자(`부울` 유형)와 함께 사용됩니다.

[*key_onClose2]: `onClose`: 사용자가 동영상 광고를 닫을 때 호출됩니다.

[*key_onError]: `onError`: 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.

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