--- metadata: - name: generator content: Diplodoc Platform v5.57.3 alternate: - https://yandex.com.tr/dev/games/doc/en/sdk/sdk-environment.md - https://yandex.com.tr/dev/games/doc/hi/sdk/sdk-environment.md - https://yandex.com.tr/dev/games/doc/ko/sdk/sdk-environment.md - https://yandex.com.tr/dev/games/doc/ru/sdk/sdk-environment.md - https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-environment.md - https://yandex.com.tr/dev/games/doc/vi/sdk/sdk-environment.md - https://yandex.com.tr/dev/games/doc/zh/sdk/sdk-environment.md - href: tr/sdk/sdk-environment.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 # Ortam değişkenleri Oyunun çalıştığı ortam hakkında bilgi alabilirsiniz. Bu amaçla `environment` nesnesi kullanılır. ```javascript showLineNumbers { [app](*key_app): { [id](*key_id): string; }; [i18n](*key_i18n): { [lang](*key_lang2): string; }; [payload?](*key_payload): string; [referrer?](*key_referrer): { [type](*key_type): "promo"; [promoId](*key_promo_id): string; [intent?](*key_intent): string; [inappId?](*key_inapp_id): string; } } ``` ## environment nesnesi {#environment-object} Oyunun ortam değişkenlerini içerir. #| || **Parametre** | **Tür** | **Açıklama** || || `app` | `object` | Oyun verileri. || || `i18n` | `object` | Serviste uluslararasılaştırma. || || `payload` | `string` | Oyun adresindeki `payload` parametresinin değeri. İsteğe bağlı parametre. `https://yandex.ru/games/app/123?payload=test` oyunu için `test` değeri şu şekilde alınabilir: `ysdk.environment.payload`. || |# ### app yapısı {#structure-app} #| || **Parametre** | **Tür** | **Açıklama** || || `id` | `string` | Oyun tanımlayıcısı. || |# ### i18n yapısı {#structure-i18n} #| || **Parametre** | **Tür** | **Açıklama** || || `lang` | `string` | [Yandex Games arayüz dili](https://yandex.com.tr/dev/games/doc/tr/concepts/languages-and-domains.md#languages) ISO 639-1 formatında. Örneğin, `"tr"`, oyunun şu anda Yandex Games'in Türkçe arayüzünde çalıştığı anlamına gelir. Bu parametre, oyunda kullanıcının dilini otomatik olarak belirlemek için kullanılmalıdır [(madde 2.14)](https://yandex.com.tr/dev/games/doc/tr/concepts/requirements.md#2-14). || |# #### Örnek {#i18n-example} ```javascript showLineNumbers const ysdk = (await YaGames.init()); const lang = ysdk.environment.i18n.lang; // 'en', 'ru', ... ``` ### referrer yapısı {#structure-referrer} Katalogdaki promosyon banner'larından oyuncuların geçişlerini işlemek için `ysdk.environment.referrer` kullanın. Avantajları: - **Oyuncu için**: promosyon bağlantısına tıkladıktan sonra oyuncu doğrudan ilgili ekrana yönlendirilir — tıklamak istediği teklifi hemen görür. Bu, dönüşümü artırır ve başlangıçtaki kaybı azaltır. - **Sizin için**: her promosyonun etkinliğini takip edebilirsiniz — kaç oyuncunun geçiş yaptığını, kaçının satın alma gerçekleştirdiğini görebilirsiniz. İstatistik toplamak için ayrıca [Yandex Metrica'yı](https://yandex.com.tr/dev/games/doc/tr/concepts/yandex-metrica.md) etkinleştirin. #### Kurulum {#referrer-setup} 1. Geliştirici Konsolu'nda bir [promosyon](https://yandex.com.tr/dev/games/doc/tr/console/promo-and-discounts.md) ekleyin. Platform, katalogdaki promosyon banner'ları için otomatik olarak bir deeplink oluşturur. Promosyon parametreli bağlantı örneği: ```text https://yandex.ru/games/app/{id}?lang=ru&referrer=promo&promo_id={PROMO_ID}&promo_intent={INTENT}&inapp_id={INAPP_ID} ``` #| || **Parametre** | **Açıklama** | **Zorunluluk** | **Kaynak** || || `referrer` | Platforma geçişin bir promosyondan geldiğini bildirir. |::{align="center"} ![SVG](../_images/icons/yes-button.svg) | Her zaman `promo` || || `promo_id` | Yönlendirme ve analitik için promosyon ID'si. |::{align="center"} ![SVG](../_images/icons/yes-button.svg) | **ID** || || `promo_intent` | Oyun içi yönlendirme ve analitik için isteğe bağlı ipucu. | | **Intent** || || `inapp_id` | Oyundaki promosyonla ilişkili uygulama içi satın alım ID'si. | | **In-app ID** || |# 1. Oyuna [geçiş işleme](#referrer-example) ekleyin: SDK, deeplink parametrelerini `ysdk.environment.referrer` nesnesine iletir — oyuncuya doğru ekranı göstermek için bu parametreleri kullanın. #| || **Parametre** | **Tür** | **Açıklama** | **Kaynak** || || `type` | `"promo"` | Geçiş kaynağını gösterir. Promosyon analitiği toplamak için `type: "promo"` değerini takip edin. | `referrer=promo` || || `promoId` | `string` | Konsol'daki **Promos** sekmesinden promosyon ID'si. Belirli bir promosyon için eylem yapılandırmak ve analitik toplamak için kullanın. | `promo_id` || || `intent` | `string` | Örneğin `open_starter_pack` gibi isteğe bağlı bir dize. Promosyon geçişi sonrasında standart bir eylem yapılandırmak ve analitik toplamak için kullanın. İsteğe bağlı parametre. | `promo_intent` || || `inappId` | `string` | Konsol'daki **Inaps** sekmesinden [uygulama içi satın alım ID'si](https://yandex.com.tr/dev/games/doc/tr/console/purchases.md#add-purchases). Platform satın alma iletişim kutusunu açmak için kullanın. İsteğe bağlı parametre (yalnızca indirimli promosyonlar için). | `inapp_id` || |# 1. Geçişleri kontrol edin: **Promos** sekmesinde **Check transition** alanında **In the published version** veya **In the draft** seçeneğine tıklayın. Her şey doğru yapılandırıldıysa promosyon ekranını görürsünüz: teklif, mağaza veya belirli bir uygulama içi satın alım. #### Örnek {#referrer-example} ```javascript showLineNumbers // 1. SDK başlatma const ysdk = await YaGames.init(); // 2. referrer bilgisini alın const { referrer } = ysdk.environment; // 3. Promosyondan gelen yönlendirmeyi işleyin if (referrer?.type === 'promo') { if (referrer.inappId) { showPurchaseScreen(referrer.inappId); } else if (referrer.intent) { openScreen(referrer.intent); } } ``` #### Tipik senaryolar {#referrer-scenarios} #| || **Senaryo** | **Hedef kitle** | **Amaç** | **Örnek** || || Ürün indirimi | Ödeme yapmayan oyuncular | İlk ödeme | `promo_id=SPRING_DISCOUNT`
`promo_intent=open_starter_pack`
`inapp_id=starter_pack_001` → `showPurchaseScreen()` || || VIP teklifi veya mağaza açılışı | Ödeme yapan oyuncular | Ortalama sipariş tutarını artırma | `promo_id=VIP_PROMO`
`promo_intent=open_shop` → `openShop()` || || Sezonluk kampanya | Tüm aktif oyuncular | Elde tutma | `promo_id=SALE_SPRING_2026` → temel akış, banner || |# --- {% 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: Sohbete yaz [*key_app]: Oyun verileri. [*key_id]: Oyun ID'si. [*key_i18n]: Serviste uluslararasılaştırma. [*key_lang2]: ISO 639-1 biçiminde [Yandex Games arayüz dili](https://yandex.com.tr/dev/games/doc/tr/concepts/languages-and-domains.md#languages). Örneğin, `"tr"`, oyunun şu anda Yandex Games'in Türkçe arayüzünde çalıştığı anlamına gelir. Kullanıcının oyundaki dilini tanımlamak için bu parametreyi kullanmanızı öneririz. [*key_payload]: Oyun adresindeki `payload` parametresinin değeri. İsteğe bağlı parametre. `https://yandex.ru/games/app/123?payload=test` oyunu için `test` değeri şu şekilde alınabilir: `ysdk.environment.payload`. [*key_referrer]: Promosyon geçişine ilişkin veriler. Oyun, promosyon bannerındaki derin bağlantıyla açılmışsa mevcuttur. Diğer durumlarda `undefined`. [*key_type]: Geçiş kaynağı. Her zaman `"promo"`. [*key_promo_id]: Konsolun **Promos** sekmesindeki kampanya kimliği. [*key_intent]: `open_starter_pack` gibi isteğe bağlı bir dize. Opsiyonel parametre. [*key_inapp_id]: Konsolun **Inaps** sekmesindeki [uygulama içi satın alım kimliği](https://yandex.com.tr/dev/games/doc/tr/console/purchases.md#add-purchases). Opsiyonel parametre (yalnızca indirimli promosyonlar için).