环境变量

您可以获取游戏运行环境的信息。为此，请使用对象 ysdk.environment。

 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 对象

包含游戏环境变量。

app 结构

i18n 结构

示例

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

referrer 结构

使用 ysdk.environment.referrer 处理玩家从目录中促销横幅跳转的情况。优点：

• 对于玩家：点击活动链接后，玩家会直接进入目标页面——看到的就是他点击的那个活动内容。这能提高转化率，并减少初始阶段的用户流失。
• 对于您：您可以追踪每个活动的效果——有多少玩家点击进入，有多少人完成了购买。如需收集统计数据，请额外启用 Yandex Metrica。

配置

1. 在开发人员控制台中添加促销活动。平台会自动为目录中的活动横幅生成深度链接（deeplink）。

   带有促销参数的链接示例：

   https://yandex.ru/games/app/{id}?lang=ru&referrer=promo&promo_id={PROMO_ID}&promo_intent={INTENT}&inapp_id={INAPP_ID}
   

   参数	说明	是否必填	来源
   referrer	告知平台该跳转来自促销活动。		始终为 promo
   promo_id	用于路由和分析的促销活动 ID。		ID
   promo_intent	用于游戏内路由和分析的自定义提示。		Intent
   inapp_id	与游戏中该促销活动关联的应用内购买 ID。		In-app ID

2. 在游戏中添加跳转处理：SDK 会将深层链接的参数传入 ysdk.environment.referrer 对象——使用这些参数向玩家显示目标页面。

   参数	类型	说明	来源
   type	"promo"	显示跳转来源。跟踪 type: "promo" 可收集促销活动的分析数据。	referrer=promo
   promoId	string	开发人员控制台中 Promos 标签页上的活动 ID。使用它来为特定活动配置操作，并收集该活动的分析数据。	promo_id
   intent	string	任意字符串，例如 open_starter_pack。用于配置点击促销活动后的标准操作并收集相关分析数据。可选参数。	promo_intent
   inappId	string	开发人员控制台 Inaps 标签页中的应用内购买 ID。用于打开平台购买对话框。可选参数（仅适用于折扣促销活动）。	inapp_id

3. 检查跳转：在 Promos 选项卡的 Check transition 字段中，点击 In the published version 或 In the draft。如果一切配置正确，您将看到活动页面：优惠、商店或具体的应用内购买。

示例

 1// 1. 初始化 SDK。
 2const ysdk = await YaGames.init();
 3
 4// 2. 获取 referrer。
 5const { referrer } = ysdk.environment;
 6
 7// 3. 处理来自促销活动的跳转。
 8if (referrer?.type === 'promo') {
 9    if (referrer.inappId) {
10        showPurchaseScreen(referrer.inappId);
11    } else if (referrer.intent) {
12        openScreen(referrer.intent);
13    }
14}

典型场景

如果在使用 Yandex Games SDK 时遇到问题或有疑问，请联系技术支持：