Ortam değişkenleri

Oyunun çalıştığı ortam hakkında bilgi alabilirsiniz. Bu amaçla environment nesnesi kullanılır.

 1{
 2  app: {
 3    id: string;
 4  };
 5  i18n: {
 6    lang: string;
 7  };
 8  payload?: string;
 9  referrer?: {
10    type: "promo";
11    promoId: string;
12    intent?: string;
13    inappId?: string;
14  }
15}

environment nesnesi

Oyunun ortam değişkenlerini içerir.

app yapısı

i18n yapısı

Örnek

1const ysdk = (await YaGames.init());
2const lang = ysdk.environment.i18n.lang; // 'en', 'ru', ...

referrer yapısı

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ı etkinleştirin.

Kurulum

1. Geliştirici Konsolu'nda bir promosyon ekleyin. Platform, katalogdaki promosyon banner'ları için otomatik olarak bir deeplink oluşturur.

   Promosyon parametreli bağlantı örneği:

   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.		Her zaman promo
   promo_id	Yönlendirme ve analitik için promosyon ID'si.		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

2. Oyuna geçiş işleme 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. 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

3. 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

 1// 1. SDK başlatma
 2const ysdk = await YaGames.init();
 3
 4// 2. referrer bilgisini alın
 5const { referrer } = ysdk.environment;
 6
 7// 3. Promosyondan gelen yönlendirmeyi işleyin
 8if (referrer?.type === 'promo') {
 9    if (referrer.inappId) {
10        showPurchaseScreen(referrer.inappId);
11    } else if (referrer.intent) {
12        openScreen(referrer.intent);
13    }
14}

Tipik senaryolar

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