---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/games/doc/en/console/promo-add.md
  - https://yandex.com/dev/games/doc/hi/console/promo-add.md
  - https://yandex.com/dev/games/doc/ko/console/promo-add.md
  - https://yandex.com/dev/games/doc/ru/console/promo-add.md
  - https://yandex.com/dev/games/doc/tr/console/promo-add.md
  - https://yandex.com/dev/games/doc/vi/console/promo-add.md
  - https://yandex.com/dev/games/doc/zh/console/promo-add.md
  - href: en/console/promo-add.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/dev/games/doc/en/llms.txt

# Integration

<!-- source: en/_includes/script-common.md -->
<!-- source: en/_includes/script/index-js.md -->

<!-- endsource: en/_includes/script/index-js.md -->

<!-- source: en/_includes/script/requirements-js.md -->

<!-- endsource: en/_includes/script/requirements-js.md -->

<!-- source: en/_includes/script/image-modal-js.md -->

<!-- endsource: en/_includes/script/image-modal-js.md -->
<!-- endsource: en/_includes/script-common.md -->

Add to the game:

- Promo content (for example, new levels, prizes, bundles).
- Handling transitions using [ysdk.environment.referrer](https://yandex.com/dev/games/doc/en/sdk/sdk-environment.md#structure-referrer).

You can integrate a promo through:
- [Automatic activation](#promo-auto) — a universal method for all games.
- [Build update](#promo-build) — suitable for games uploaded as an archive.
- [Code](#promo-code) — suitable for games uploaded via a link.

After that, you need to [fill out the promo card](https://yandex.com/dev/games/doc/en/console/promo-activate.md) in the Console and submit it for moderation.

## Automatic activation {#promo-auto}

{% note info %}

A universal method for all games.

{% endnote %}

To avoid going through moderation every time you want to run an event in your game, set up automatic promo activation:

1. Plan promotions in your game.
1. [Add](https://yandex.com/dev/games/doc/en/config.md) the ability to automatically enable and disable promos at specific times to your game.
1. Upload your game to the Console in advance and pass moderation.
1. Fill out the promo card on the **Promos** tab in the Console and submit it for moderation.

## Build update {#promo-build}

{% note info %}

This method is suitable for games uploaded as an archive.

{% endnote %}

1. Create a new game build with the promo.
1. [Submit](https://yandex.com/dev/games/doc/en/console/update-game.md) the build for moderation. While moderation is checking the game (usually it takes 3−5 business days, see [Moderation](https://yandex.com/dev/games/doc/en/concepts/moderation.md) for more details), you won't be able to make any changes to it. This applies to all items related to moderation.
1. If everything is fine, the promo will be activated after the game update.
1. After the promo ends, create a new game build (with the promo disabled) and also submit it for moderation.

## Code {#promo-code}

{% note info %}

This method is suitable for games uploaded via a link.

{% endnote %}

1. Update your game code adding the promo logic.
1. Submit the game for moderation. While moderation is checking the game (usually it takes 3−5 business days, see more in the [Moderation](https://yandex.com/dev/games/doc/en/concepts/moderation.md) section), you won't be able to make any changes to it. This applies to all items related to moderation.
1. If everything is fine, the promo will be activated after the game update.
1. After the promo ends, make new changes to the code (with the promo disabled) and also submit it for moderation.