---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.4
alternate:
  - https://yandex.com/dev/games/doc/en/sdk/sdk-example.md
  - https://yandex.com/dev/games/doc/hi/sdk/sdk-example.md
  - https://yandex.com/dev/games/doc/ko/sdk/sdk-example.md
  - https://yandex.com/dev/games/doc/ru/sdk/sdk-example.md
  - https://yandex.com/dev/games/doc/tr/sdk/sdk-example.md
  - https://yandex.com/dev/games/doc/vi/sdk/sdk-example.md
  - https://yandex.com/dev/games/doc/zh/sdk/sdk-example.md
  - href: ko/sdk/sdk-example.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

# 예시

다음은 동기식 또는 비동기식 메서드를 사용하여 Yandex Games SDK를 구성하는 방법의 예입니다.

{% list tabs %}

* 동기 메서드

   예시 세부 사항:

   1. 첫 번째 광고 호출에는 [콜백 함수](*key_callback)가 설정되어 있지 않습니다.
   2. 두 번째 호출과 그 이후의 모든 호출에 대해 가능한 모든 콜백이 지정됩니다.
   3. **광고 표시** 버튼에는 `'click'` 이벤트 핸들러가 할당됩니다(버튼이 클릭될 때마다 광고를 호출).

   ```html
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
        <meta name="mobile-web-app-capable" content="yes">
        <meta name="apple-mobile-web-app-capable" content="yes">
        <title>SDK가 동기식으로 구성된 페이지 예시</title>
        
        
    </head>
    <body>
        <button id="button">광고 표시</button>
    </body>
    </html>
    ```

* 비동기 메서드

   예시 세부 사항:

   1. 첫 번째 광고 호출에 대해 [onClose](*key_onClose) 콜백 함수가 설정됩니다.

   2. 두 번째 호출과 이후의 각 호출에 대해 가능한 모든 [콜백 함수](*key_callback)가 지정됩니다.

   3. 광고 블록이 닫힌 후 실행되는 코드는 `onClose` 콜백 함수에 추가됩니다.

   4. SDK 또는 콜백 함수로 인해 발생한 모든 오류는 [onError](*key_onError) 함수에 전달됩니다.

   5. **광고 표시** 버튼에는 `'click'` 이벤트 핸들러가 할당됩니다(버튼이 클릭될 때마다 광고를 호출).

   ```html
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1" />
        <meta name="mobile-web-app-capable" content="yes">
        <meta name="apple-mobile-web-app-capable" content="yes">
        <title>SDK가 비동기적으로 구성된 페이지 예시</title>
        
    </head>
    <body>
    <!-- Yandex Games SDK -->
    
    <button id="button">광고 표시</button>
    </body>
    </html>
    ```

{% endlist %}

[*key_callback]: - `onClose`: 광고가 닫히거나, 오류가 발생하거나, 너무 자주 호출되어 광고가 열리지 않을 때 호출됩니다. 광고가 표시되었는지 여부를 나타내는 값인 `wasShown` 인자(`부울` 유형)와 함께 사용됩니다.
- `onOpen`: 광고가 성공적으로 열렸을 때 호출됩니다.
- `onError`: 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.

[*key_onClose]: `onClose`: 광고가 닫히거나, 오류가 발생하거나, 너무 자주 호출되어 광고가 열리지 않을 때 호출됩니다. 광고가 표시되었는지 여부를 나타내는 값인 `wasShown` 인자(`부울` 유형)와 함께 사용됩니다.
[*key_onError]: `onError`: 오류가 발생하면 호출됩니다. 오류 객체는 콜백 함수에 전달됩니다.
[*key_onOpen]: `onOpen`: 광고가 성공적으로 열렸을 때 호출됩니다.
