Integration

For the promo to appear in the catalog:

1. Add it to the game
2. Fill out the form in the Console

All events go through review — follow the requirements so your promo passes on the first try.

After the promo ends, remove it from the game.

Step 1. Add the promo to the game

1. Add to the game:

   • Promo content (for example, new levels, prizes, bundles).
   • Transition handling using ysdk.environment.referrer.

2. Enable the promo using one of the following methods:

   • Via remote configuration — the recommended method, doesn't require re-moderation of the build.

     How to set up

     1. Plan promotions in your game in advance.
     2. In the Developer Console, add flags. You can configure them to activate at specific times or switch between configurations with and without the promo manually.
     3. Update the build: use the ysdk.getFlags() method to configure the promo display logic in the game.
     4. Update the game and pass moderation. A full review is only required once. After that, you can enable and disable promos using flags.
     5. Enable the required flag before the promo starts: moderation will additionally verify that the event has actually been added to the game. If the flag is not enabled at the time of review, the promo will not pass moderation.

   • Via a build update without setting up conditions — suitable for one-time promos: moderation will be required each time.

Step 2. Activate the promo in the Console

1. In the Yandex Games Console, go to the Promos tab and click Create a promo.

2. Fill out the fields:

   Field	Description	Required
   Activated	The option will be enabled if moderators approve the promo.
   Promo start	Specify the date and time for the promo to start. The selected time must be no earlier than 30 days and no later than 72 hours from the current time. The actual promo start time may be delayed until moderation is complete. The system takes the user's timezone into account.
   Promo end	Specify the date and time for the promo to end. The maximum duration of the promo is 10 days. The system takes the user's timezone into account.
   Promo type	Affects how the promo is displayed on the storefront and in analytics. Event — promos focused on gameplay mechanics: tasks, item collection, tournaments, leaderboards, new seasons. No purchase required to participate. Offer — promos with a direct purchase benefit: discount percentage, multiplier, bonus amount, promo code, starter pack. Note If a promo combines mechanics and a discount, choose based on the primary content. "—" — a legacy option for old promos. Promo type comparison
   Intent	A custom hint for routing within the game and analytics. For example: open_shop, open_starter_pack. Passed to the SDK when navigating from the promo.
   In-app ID	The in-app purchase ID linked to the promo in the game. The link allows the game to immediately open the platform's purchase dialog. Available when the Offer type is selected.
   Cover	The event banner. Size — 928 × 540 pixels. Format — PNG. Design requirements
   Title	Promo name. Maximum length — 50 characters (including punctuation). Design requirements
   Description	Promo description. Maximum length — 120 characters (including punctuation). Design requirements

   Note

   By default, promos are set to Russian. For text fields (Title and Description), you can:

   • Add another language — click and select a language from the list.
   • Remove an unused language — click to the right of it. Russian cannot be removed.

3. Click Submit for moderation. Moderators will review the promo against the requirements, which usually takes 1–3 business days.

You will see the review results in the Console:

• Once moderation is complete, the promo will appear in the Discounts and promos section and other curated collections in the Yandex Games catalog.
• If the promo doesn't pass moderation, it won't appear in the catalog. We'll send the rejection reasons to the email address specified in the developer profile.

After the promo ends

• If you enabled it via remote configuration — disable the promo in the Developer Console.
• If you updated the build — repeat the process: upload a new archive with the promo disabled and go through moderation.