Documentation Change History

2024

Modified requirement section 8.2.3.6: added information and examples when game text translation is not necessary.
Expanded the wording for requirement 1.10.2: in games and WebApp, swipe to refresh must not trigger.
Added clarification to requirement 4.4.1: advertisements can be shown after the game launches on the platform (after gameReadyAPI is triggered).
Expanded requirement 1.19 on the initialization of Yandex Games SDK and the use of its methods.
Updated information on connecting to Yandex Games SDK: changed the path from https://yandex.ru/games/sdk/v2 to /sdk.js, added connection methods on your own domain. The SDK must be initialized exactly as indicated on the page Installing and Using SDK (section 1.19.1).
Expanded the Game Start page and renamed it to Game Loading and Gameplay Markup:
- Updated examples in the Game Loading section. Calling the ready() method from gameReadyAPI at the moment when the user can start playing the game is now mandatory (section 1.19.2).
- Added a Gameplay section with new SDK methods that allow reporting to the platform whether the gameplay is active or not. If GameplayAPI is used, then calling its methods must comply with the documentation (section 1.19.3).

Updated information on conversion metrics: Icon CTR split into Icon CTR in recommendations and Icon CTR in "My games" to remove the influence of returns on CTR. The new metrics can be relied upon when working with results of A/B testing for icons and covers.

In response to active feedback from the game developer community, shortened requirements section 4.4.1 and clarified the wording in its explanation.

Changed the calibration list for fullscreen ads (section 4.4.1). Provided examples of when ads can be shown.
Abolished item 2.11 in favor of 1.8 in the Game Requirements section. For mobile devices, focus on adapting sizes of internal elements, buttons, graphics (section 1.8), rather than on the size of the active field.

Removed the section about init function options. Configure screen orientation in the developer console under the Draft tab.
Added the --tld parameter to the description of the @yandex-games/sdk-dev-proxy package, which is used to launch and test the game from a local server.
Added a list of requirements that games most often fail to meet for publication.
Added an example of acceptable content to the calibration list for erotica, changed the comment on the example of permissible content (requirement 8.3.5).
Added an example of acceptable content to the calibration list for unpleasant characters (requirement 8.3.6).