---
metadata:
  - name: generator
    content: Diplodoc Platform v5.66.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: https://yandex.com/dev/games/doc/zh/console/promo-add.md
    type: text/markdown
    title: Markdown version
  - href: https://yandex.com/dev/games/doc/zh/llms.txt?revision=r21993288
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/zh/llms.txt?revision=r21993288

# 连接

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

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

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

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

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

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

要使促销活动出现在目录中：

1. [将其添加到游戏中](#add-to-game){.arrow}
1. [在控制台中填写表单](#activate){.arrow}

所有活动均需通过审核 —— 请遵守[要求](https://yandex.com/dev/games/doc/zh/console/promo-rules.md)，以便促销活动一次性通过。

促销活动结束后，请[将其从游戏中移除](#finish)。



## 第 1 步。将促销活动添加到游戏中 {#add-to-game}

1. 在游戏中添加：

    - 促销活动内容（例如，新关卡、奖品、套装）。
    - 使用 [ysdk.environment.referrer](https://yandex.com/dev/games/doc/zh/sdk/sdk-environment.md#structure-referrer) 处理跳转。

2. 通过以下方式之一启用促销活动：

    - 通过[远程配置](https://yandex.com/dev/games/doc/zh/config.md) —— 推荐方式，无需重新审核构建版本。

        {% cut "如何设置" %}

        1. 提前在游戏中规划促销活动。
        1. 在[开发人员控制台](https://games.yandex.com/console){.external}中添加[标志](https://yandex.com/dev/games/doc/zh/config.md)。您可以按时间设置激活，或手动切换含促销与不含促销的配置。
        1. 更新构建版本：使用 [ysdk.getFlags()](https://yandex.com/dev/games/doc/zh/sdk/sdk-config.md) 方法配置游戏中促销活动的显示逻辑。
        1. [更新游戏](https://yandex.com/dev/games/doc/zh/console/update-game.md)并通过审核。完整审核只需进行一次，之后即可通过标志启用或禁用促销活动。
        1. 在促销活动开始前提前启用所需标志：审核人员将额外验证活动是否确实已添加到游戏中。如果审核时标志未启用，促销活动将无法通过审核。

        {% endcut %}

    - 通过[更新构建版本](https://yandex.com/dev/games/doc/zh/console/update-game.md)且不设置条件 —— 适用于一次性促销，每次都需要重新审核。



## 第 2 步。在控制台中激活促销活动 {#activate}

1. 在 [Yandex Games 控制台](https://games.yandex.com/console){.external}中，转到 **Promos** 选项卡并点击 **Create a promo**。

1. 填写以下字段：

    #|
    || **字段** | **说明** | **是否必填** ||
    || **Activated** | 如果审核人员批准促销活动，此选项将被启用。 |  ||
    || **Promo start** |

    指定活动开始的日期和时间。所选时间距当前时间不得早于 30 天，也不得晚于 72 小时。活动的实际开始时间可能因审核而延迟。

    系统会考虑用户的时区。

    |::{align="center"}

    ![SVG](../_images/icons/yes-button.svg)

    ||
    || **Promo end** |

    指定活动结束的日期和时间。活动最长持续时间为 10 天。

    系统会考虑用户的时区。

    |::{align="center"}

    ![SVG](../_images/icons/yes-button.svg)

    ||
    || **Promo type** |

    影响活动在商店页面和分析中的展示方式。

    - **Event** —— 以游戏机制为重点的活动：任务、道具收集、锦标赛、排行榜、新赛季。参与无需购买。
    - **Offer** —— 购买可直接获益的活动：折扣比例、倍数、金额加成、优惠码、新手礼包。

    {% note info %}

    如果活动同时包含游戏机制和折扣，请根据主要内容进行选择。

    "—" — 旧版活动的过时选项。

    {% endnote %}

    [活动类型对比](https://yandex.com/dev/games/doc/zh/console/promo-and-discounts.md#promo-types){.arrow}

    <!-- -->

    |::{align="center"}

    ![SVG](../_images/icons/yes-button.svg)

    ||
    || **Intent** | 用于游戏内路由和分析的自定义提示。例如：`open_shop`、`open_starter_pack`。从活动跳转时传递给 [SDK](https://yandex.com/dev/games/doc/zh/sdk/sdk-environment.md#structure-referrer)。 |  ||
    || **In-app ID** | 游戏中与活动关联的[应用内购买 ID](https://yandex.com/dev/games/doc/zh/console/purchases.md#add-purchases)。关联后，游戏可以直接打开平台购买对话框。仅在选择 **Offer** 类型时可用。 |  ||
    || **Cover** |

    活动横幅。

    尺寸 —— 928 × 540 像素。

    格式 —— PNG。

    [设计要求](https://yandex.com/dev/games/doc/zh/console/promo-rules.md#banner){.arrow}

    <!-- -->

    |  ||
    || **Title** |

    促销活动名称。

    最大长度 —— 50 个字符（含标点符号）。

    [设计要求](https://yandex.com/dev/games/doc/zh/console/promo-rules.md#name){.arrow}

    <!-- -->

    |::{align="center"}

    ![SVG](../_images/icons/yes-button.svg)

    ||
    || **Description** |

    促销活动描述。

    最大长度 —— 120 个字符（含标点符号）。

    [设计要求](https://yandex.com/dev/games/doc/zh/console/promo-rules.md#description){.arrow}

    <!-- -->

    |::{align="center"}

    ![SVG](../_images/icons/yes-button.svg)

    ||
    |#

    {% note info %}

    促销活动默认设置为俄语。对于文本字段（**Title** 和 **Description**），您可以：

    - 添加其他语言 —— 点击 ![SVG](../_images/icons/add-purchase.svg) 并从列表中选择语言。
    - 移除未使用的语言 —— 点击其右侧的 ![SVG](../_images/icons/delete-button.svg)。俄语不可移除。

    {% endnote %}

1. 点击 **Submit for moderation**。审核人员将根据[要求](https://yandex.com/dev/games/doc/zh/console/promo-rules.md)审核促销活动，通常需要 1–3 个工作日。

您将在[控制台](https://games.yandex.com/console){.external}中看到审核结果：

- 通过审核后，促销活动将出现在 Yandex Games 目录的[折扣与活动](https://games.yandex.com/promos){.external}版块及其他精选合集中。
- 如果促销活动未通过审核，则不会出现在目录中。拒绝原因将发送至[开发者资料](https://yandex.com/dev/games/doc/zh/console/manage-account.md#profile-manage)中指定的电子邮件地址。



## 促销活动结束后 {#finish}

- 如果通过远程配置启用 —— 请在[开发人员控制台](https://games.yandex.com/console){.external}中禁用促销活动。
- 如果更新了构建版本 —— 请重复该流程：上传禁用促销活动的新存档并通过审核。