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

# Bağlantı ve kullanım

<!-- source: tr/_includes/script-common.md -->
<!-- source: tr/_includes/script/index-js.md -->

<!-- endsource: tr/_includes/script/index-js.md -->

<!-- source: tr/_includes/script/requirements-js.md -->

<!-- endsource: tr/_includes/script/requirements-js.md -->

<!-- source: tr/_includes/script/image-modal-js.md -->

<!-- endsource: tr/_includes/script/image-modal-js.md -->
<!-- endsource: tr/_includes/script-common.md -->

## Bağlantı {#connect}

{% note alert %}

Oyununuzun moderasyondan başarıyla geçmesi için Yandex&nbsp;Games SDK'sını bağlamak üzere güncel yolu belirtin:

- Oyun arşivini [Geliştirici Konsolu](https://games.yandex.com/console){.external} üzerinden Yandex sunucusuna yüklüyorsanız, [göreceli yolu](#yandex-server) belirtin. Bu önerilen seçenektir.
- Kendi alan adınız üzerinden entegrasyon kullanıyorsanız, [mutlak yolu](#iframe) belirtin.

{% endnote %}

Yandex Games SDK'sını iki eşdeğer yöntemle bağlayabilirsiniz:

- `
    ```

    Şu nitelikleri kullanın:

    - `async` — engellemesiz yükleme için.
    - `onload` — betik yüklendikten sonra kod çalıştırmak için.

    Betik yüklendikten sonra `initSDK`'yı başlatmak için kod örneği. `initSDK`, [SDK başlatmayı](#use) ifade eder:

    ```html showLineNumbers
    <!-- Yandex Games SDK -->
    
    ```

- Dinamik yükleme

    Kendi `
```

## Kullanım {#use}

Betiği yükledikten sonra `YaGames` nesnesinin `init()` yöntemini kullanarak SDK'yı başlatın.

{% note tip %}

`YaGames.init()` ve [ysdk.getPayments()](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-purchases.md#install) metodlarına isteğe bağlı `signed: boolean` parametresi geçilebilir. Bu parametre, [dolandırıcılığa karşı koruma](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-purchases.md#signature) için kullanılır. Parametrenin değeri, ödemelerin nerede işlendiğine bağlıdır:

- İstemci tarafında işleniyorsa — metotları `signed: boolean` parametresi olmadan çağırın veya `signed: false` geçin. Satın alma metotları verileri açık şekilde döndürür.
- Sunucu tarafında işleniyorsa — `signed: true` geçin. Bu durumda [payments.getPurchases()](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-purchases.md#getpurchases) ve [payments.purchase()](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-purchases.md#payments-purchase) metotlarının yanıtlarında tüm veriler yalnızca şifrelenmiş şekilde `signature` parametresinde döner.

{% endnote %}

{% list tabs %}

- İstemci tarafında işleme

    Varsayılan parametreyle (`signed: false`) başlatma:

    ```javascript
    const ysdk = await YaGames.init();
    ```

- Sunucu tarafında işleme

    `signed: true` parametresiyle başlatma:

    ```javascript
    const ysdk = await YaGames.init({ signed: true });
    ```

{% endlist %}

&nbsp; {.empty}

## Doğrulama {#check}

{% note warning %}

`/sdk.js` betiği [YaGames.init()](#use) çalıştırılmadan önce bağlanmalıdır.

{% endnote %}

Yükleyiciyi kullanarak SDK'nın doğru bağlandığını kontrol edin:

1. Oyunu [debug paneli](https://yandex.com.tr/dev/games/doc/tr/console/debug-panel.md) ile başlatın:

   <!-- source: tr/_includes/requirements/start-debug-panel.md -->
   {% list tabs %}

   - Geliştirici konsolu üzerinden
       1. [Yandex Oyun Konsolunu açın](https://games.yandex.com/console){.external}.
       1. İlgili oyunu seçin.
       1. Sol üst köşede **Open with debug panel**'e tıklayın.

   - URL adres çubuğuyla
       1. İlgili oyunu açın.
       1. Tarayıcıdaki URL adresinin sonuna `&debug-mode=16` ekleyin.

          Bağlantı örneği: `https://yandex.com.tr/games/app/XXXX?debug-mode=16`, burada `XXXX` — oyunun benzersiz tanımlayıcısı.

   {% endlist %}
   <!-- endsource: tr/_includes/requirements/start-debug-panel.md -->

2. Sol alt köşede [yükleyici](https://yandex.com.tr/dev/games/doc/tr/console/debug-panel.md#loader) göstergesinin değerini kontrol edin:

    - `W` — başlatma bekliyor.
    - `IT` — SDK yükleyicisi doğru şekilde başlatıldı.
    - `IF` — eski bir yükleyici kullanılıyor. SDK'yı [belgelere](#connect) göre yükleyin.

## Sorun çözme {#faq}

### Uncaught ReferenceError: YaGames is not defined {#yagames-not-defined}

`sdk` betiğinin bağlanma sırasına dikkat edin: `YaGames.init()` çalıştırılmadan önce bağlanmalıdır.

### Uncaught ReferenceError: ysdk is not defined {#ysdk-not-defined}

SDK başlatılmadan önce SDK yöntemlerini (reklam, satın almalar vb.) kullanmaya çalıştınız. Başlatma anı, hata ayıklama modunda konsolda `Initialized` mesajıyla izlenebilir. Çağrı sırasını kontrol etmek için yöntem çağrısından önce SDK başlatmasını ekleyin:

```javascript showLineNumbers
const ysdk = await YaGames.init();

ysdk.adv.showFullscreenAdv();
```

### SDK bağlantı örneği {#connection-example}

```html showLineNumbers
<!-- Yandex Games SDK -->


```

---

<!-- source: tr/_includes/sdk-support.md -->
{% note info %}

Destek ekibi, hazır oyunu Yandex Oyun platformuna yerleştirmenize yardımcı olur. Geliştirme ve test etme konularındaki uygulamalı sorulara ise diğer geliştiriciler [Discord Topluluğu](https://discord.com/invite/wU4p3whr4T){.external} yanıt verir.

{% endnote %}

Yandex Games SDK kullanırken sorunla karşılaşırsanız veya sorunuz varsa, lütfen destek ekibiyle iletişime geçin:

<!-- source: tr/_includes/button-chat.md -->
<a href="https://yandex.com/chat/#/user/a4fa5c06-75db-9b38-6eea-b1673785f7d5">
  <span class="button">Sohbete yaz</span>
</a>
<!-- endsource: tr/_includes/button-chat.md -->
<!-- endsource: tr/_includes/sdk-support.md -->