> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/guide/zh/marketing/promotion.md).
# 促销
试着通过促销，让轻量点击自然延续到转化。无论是引导回访，还是实现自然传播，都能在漏斗各环节取得成效。
### 什么是促销活动
Apps in Toss 的促销活动是根据用户的特定行为发放 Toss 积分的活动。例如，可以根据注册、完成首次使用等行为给予优惠。
促销活动使用预先充值到 Biz Wallet 的预算来运营。是否在福利 Tab 中展示，也可以在控制台中直接设置。
促销活动允许类型
* 会员注册·接入奖励（例如：新注册时发放 2,000 积分）
* 引导交易·购买型（条件和说明必须明确。例如：消费满 5,000 韩元时发放 500 积分）
* 不过，已经发放的 Toss 积分无法回收。请在充分审查促销条件和发放标准后谨慎运营。
* 活动参与型（问卷·测验·简单任务。但不能要求大量时间或劳动。）
* 好友邀请型（邀请者和被邀请者都可获得奖励。必须有防刷单逻辑）
* 非游戏应用的概率型·随机奖励
* 促销活动期限只能在 1 周以内运营。
* 只能用于吸引新用户的宣传目的。
* 即使注册为非游戏应用，如果被归类为游戏内容，也不能开展概率型促销活动。
促销活动 不可 类型
* 游戏应用的概率型·随机奖励（转盘、抽奖等）
* 基于游戏结果的奖励（分数、胜负、名次）
* 虚拟商品兑换型奖励（将礼品卡·商品券转换为 Toss 积分）
* 保本型·类存款行为（带投资性·博彩性特征）
* 每人发放超过 5,000 积分（抽选型需单独审查）
{% hint style="info" %}
**请参考**
促销活动功能即使没有单独服务器也可以使用。
非游戏 Mini App 也可以使用通过服务器发放促销积分的方式（Server-to-Server）。如果请求篡改防护等完整性很重要，请使用通过服务器发放的方式。
促销活动功能即使没有单独服务器也可以使用。
若要通过服务器发放促销，需要实现 Toss 登录。 [Toss 登录指南](/guide/zh/authentication/intro.md)请参考。
{% endhint %}
当通过促销活动发放 Toss 积分时，用户界面上方会弹出 toast 通知。
* **在（Mini App 名称）发放了（金额）元** 的形式短暂显示后自动消失。
* 也可以在 Toss App 的通知菜单（首页的铃铛按钮）中查看。
* 不过，根据用户的通知设置，可能不会显示在通知菜单中。
* 也可以在福利 Tab 的 Toss 积分菜单中查看累计记录。
* 在 Toss App 中按 福利 → Toss 积分 → 积分金额 → Mini App 名称 的顺序点击，即可查看累计记录。
***
### 促销活动的优点
* 提前充值 Business Wallet 并设置预算和结束日期，就可以不用担心超支来运营。
* 如果展示在 Toss 福利 Tab 上，就能伴随更多流量吸引更多用户。
* 可以像注册、开始第一次游戏那样，简单引导用户行为。
* 可以通过日常·每周任务，让用户有再次访问的理由，提高留存。
* 可以通过 API 处理积分发放和结果查询。
* 测试用代码 `TEST_{promotionCode}`可以使用，以便在不扣除实际积分的情况下进行验证。
{% hint style="info" %}
**请参考**
* 汇集展示 Apps in Toss 多个促销活动的“试试新服务”标签，可能会根据内部展示逻辑仅对部分用户可见。
* 博彩性内容、引导安装自家应用、可能违反法律法规的内容，不能用于促销活动。
* 请务必应用单人 1 次限制、每日限制、冷却时间、重复发放防止逻辑。
* 如果发放延迟，请提供 PENDING 状态说明以及可以查看结果的路径。
* 要开始促销活动，需要事先审核。审核大约需要 2\~3 个工作日。
{% endhint %}
***
### 在控制台注册促销活动
要开始促销活动，请先准备以下项目。如果已经准备完成，也可以直接进入促销活动注册。
* 注册商户信息并审核结算信息（商户审核需 1\~2 个工作日，结算审核需 2\~3 个工作日）
* 代表管理员的促销活动功能条款同意和 Business Wallet 条款同意
* 将促销预算充值到 Business Wallet（最低 5 万韩元，最高 3 亿韩元）
#### 1. 注册商户信息
促销活动只能在商户（个人或法人）账户中使用。如果尚未完成商户注册，控制台会显示“请先注册商户信息”页面。请点击“注册”来登记商户信息。
* 商户信息审核大约需要 **1\~2 个工作日** 。
* 详细流程请查看 [商户注册指南](https://developers-apps-in-toss.toss.im/guide/operation/register-business)。
#### 2. 注册结算信息
完成商户注册后，页面会变为“请接下来注册结算信息”。点击“注册”按钮，在 Partner 信息菜单中登记结算信息，并申请审核。
* 结算信息审核 **平均需要 2\~3 个工作日** 。
* 在注册结算信息之前，无法提交审核申请。请先确认商户注册状态。
{% hint style="info" %}
**注册结算信息时的注意事项**
* 存折持有人姓名请与存折复印件 **完全一致** 输入。
* 业态·行业请不要输入数字代码，而是用 **文本**进行搜索。例如）“软件开发业”请搜索“软件”
{% endhint %}
#### 3. 充值 Business Wallet
结算信息审核完成后，请同意促销活动条款。
그 이후 **促销菜单右上角小组件**或 Workspace 的“Business Wallet”菜单中可以充值预算。
* 可充值金额： **最低 50,000 韩元 \~ 最高 300,000,000 韩元**
* 当前可用支付方式：信用卡（认证支付、非认证支付）
* 认证支付：各卡公司无支付限制
* 非认证支付：Hana Card 每日限制 100 万韩元，其他卡公司无限制（非认证支付是直接输入卡号的方式。）
充值完成后，状态会变为“充值”，并反映充值金额。
也可以一起设置自动充值。（例如：剩 10 万元时，每次充值 50 万元）
**结算及运营原则**
* 促销预算在 Business Wallet 中充值后再设置。预算用完后，促销活动就结束。
* 停止促销活动后，剩余预算会返还到 Biz Wallet。（如有余额）
* 必须应用防重复参与·防刷单逻辑。
* 如果出现投诉，请在确认参与记录后由合作方处理。
#### 4. 注册促销活动
**逛 Mini App 拿积分**
这是一个用户只要浏览 Mini App 10 秒就能获得积分的促销活动。无需单独开发，仅通过控制台设置即可立即运营，游戏/非游戏 Mini App 均可参与。
自 9 月 21 日起，福利 Tab 的“多样福利任务”中会出现该促销活动的固定入口“选择我喜欢的 Mini App”。点击入口后会跳转到全部标签，引导用户从 2 个 Mini App 中选择 1 个；用户只要浏览 Mini App 10 秒即可获得积分。\
不过，只有已上线的 Mini App 才能使用此促销活动。
* 路径：Apps in Toss 控制台 → 代表管理员登录 → 选择 Workspace → 选择 Mini App → 左侧菜单 促销活动 → ‘逛 Mini App 拿积分’ 按钮
.png?alt=media&token=f9c5cfdb-9379-42ce-a5d9-95023d44e867)
1. **发放积分** — 浏览 Mini App 10 秒即可发放 10 元。浏览时间（10 秒）是固定值。
2. **参与次数** — 可以设置为每人最多参与 N 次（例如：2 次）。再次参与的等待时间固定为 1 小时。
3. **活动期间** — 可以直接设置促销活动进行期间。
4. **预算** — 仅在合作方预算上限内发放，超过上限后将停止发放并同时停止展示。
输入促销活动信息后，请点击“申请”。申请后到审核通过大约需要 2 天（D+2）个工作日。
{% hint style="info" %}
请务必确认
* 如果预算不足，活动中途可能会突然停止展示。建议结合目标运营周期和预估参与人数，充足设置预算。
* 即使用户已满足发放条件但未收到发放，Toss 也可以先行发放，之后再进行事后结算。
{% endhint %}
**进行任务并领取积分**
**展示在福利 Tab 时**
**不展示在福利 Tab 时**
* **促销活动名称：** 请具体填写用户满足什么条件后可以获得积分。例如：服务登录时发放 10 积分，完成教程时发放 20 积分
* **促销活动结束日期：** 请设置希望的结束日期。若预算用完，可能会早于预定日期结束。
* **福利 Tab 展示与否**
* 展示：会在 Toss App 的 福利 → 试试新服务 菜单中一并展示。
* 不展示：仅向直接访问 Mini App 的用户提供促销活动。
* 注意：如果先注册为不展示，之后想要展示， **必须注册新的促销活动**。（不能通过修改来变更。）
* **任务名称** (展示在福利 Tab 时必填)：任务名称必须以“\~하기”结尾。例如）完成教程、登录、留下评论
* **发放方式** (展示在福利 Tab 时必填)
* 固定金额：发放固定金额。
* 最大金额：每人可发放的最高金额。在此范围内随机发放。例如）最高 100 韩元 → 每次参与发放 0～100 韩元
* **跳转 URL** (展示在福利 Tab 时必填)
* 格式： `intoss://{{appName}}/ScreenName`
* 会从福利 Tab 进入此 URL。
* **预算信息**
* 预算不能设置得比 Biz Wallet 余额更高。
* 如果在进行中想增加预算，可以先充值 Biz Wallet，然后在修改促销活动中增加。
* **单人每日最高发放金额** (必填)：请直接设置每人一天可获得的最高金额。
* 不会向同一用户发放超过该金额。
* 这有助于防止刷量并稳定管理预算。
* 尤其担心刷量时请务必设置。推荐即使是客户端请求发放积分的情况也适用。
#### 什么是自有积分？
发行自有积分的促销活动在注册时会适用单独的管理政策。
自有积分是指，在 Mini App 内自主发行并记入用户的积分或资产（蜂蜜、爱心、钻石、金币等），并将其转换为 Toss 积分的促销活动中使用的积分。
{% hint style="info" %}
**请务必确认**
自有积分在转换为 Toss 积分的瞬间，可被视为具有可用于向第三方购买商品或服务并支付对价的金钱价值。
Apps in Toss 为遵守电子金融交易法并确保自有积分促销活动的安全性与可信性，拟采取以下措施。
{% endhint %}
**自有积分注册方法**
创建促销活动时可以注册是否为自有积分。
* 系统会首先根据促销活动内容自动识别是否为自有积分。
* 若系统未识别，也可以手动设置是否为自有积分。
* 如果被识别为自有积分促销活动，我们会通过邮件通知，也可以在各促销活动的详细信息中查看。
**遵守事项**
运营自有积分促销活动时，必须遵守以下事项。
**月度预算上限**
* 包含自有积分促销活动在内的全部促销预算月累计不得超过 1 亿韩元。
**月度报告义务**
* 每月月底需在控制台输入自有积分发行总额、单位、Toss 积分转换比例。
%2014%20(1).png?alt=media&token=b78bf6b7-aaa0-4a2f-a99f-d0580c542ca5)
**促销活动代码使用限制**
* 促销活动批准后生成的促销活动代码，只能用于申请表中填写的内容。将该代码用于其他促销活动是严格禁止的。
**如果不遵守管理义务会怎样？**
Apps in Toss 正在检测未经事先批准运营的自有积分。
* 运营未经批准的自有积分时
* 未遵守发行量输入义务并予以拖延时
* 将促销活动代码用于与批准内容不同的促销活动时
一旦确认上述事项，促销活动可能会在不预告的情况下结束。
输入促销活动信息后，请点击 \[请求审核]。审核需要 **2\~3 个工作日** 。
促销活动事前检查清单
必须满足以下所有项目，才能开展促销活动。
□ 发放的积分是否 **每人 5,000 积分以下**？\
□ 是否已明确说明发放条件、发放时点、发放限制？\
□ 参与方式是否简单，不需要大量时间或劳动？\
□（游戏情况下）是否未与转盘·抽奖等概率型要素结合？\
□ 发放的积分是否不是根据游戏结果或名次决定的？\
□ 是否不是将用户持有的资产兑换·转换为 Toss 积分的形式？\
□ 是否已提前说明促销活动可能会提前结束或中止？\
□ 是否已应用防止重复参与的逻辑？\
□ 是否不是带有博彩性或夸大的促销活动？
***
### 开发对接
可以查看在游戏·非游戏 Mini App 中发放 Toss 积分的 [SDK 函数和服务器 API 对接方法](https://developers-apps-in-toss.toss.im/documentation/common/growth/promotion#undefined-5)。
在说明促销活动时，请务必告知以下信息。
* 发放时点（例如：立即发放、次日 18 点发放等）
* 发放条件（例如：首次支付、消费满 5,000 韩元等）
* 发放限制（退会·退款·异常参与时不可发放）
* 包含“本促销活动可能会在未提前告知的情况下中止”文案
* 不可随机发放（仅允许固定发放）
***
### 进行测试
审核结束后，请通过“测试”来进行测试。测试时不会扣除实际积分。
* 测试促销活动代码会在实际代码前面加上 `TEST_`。
* 测试时不会扣除积分，也不会实际发放。
* 调用积分发放 API 时 `resultType`为 `SUCCESS`时，请确认是否有响应。
* 审核结束后，必须至少完成 1 次积分发放 API 测试，才能开始促销活动。
.png?alt=media&token=d2b5347a-10fb-42d6-bb1a-b073a818b1e6)
***
### 开始并运营促销活动
请点击“开始”按钮启动促销活动。
* 预算列 `实际消耗金额 / 总预算` 以该形式显示，可以确认预算消耗了多少。
* 修改促销活动主要用于增加预算。
* 促销活动结束后，剩余预算会退回到 Biz Wallet。
* 预算一旦用尽，便不会再显示在福利 Tab 中。请定期管理预算。
.png?alt=media&token=9dab8b56-60f0-4c40-8e35-a89bf13ea01a)
点击活动名称后，可以查看促销活动详细信息，并进行修改·结束·暂停。
* **修改：** 主要用于增加预算。要增加预算，请按 活动详情 → 促销活动修改按钮 → 输入要增加的金额 → 保存 的顺序进行。若要修改预算以外的设置，可能会因内部政策受到限制，请先查看审核指南。
* **结束：** 促销活动结束后，剩余预算会自动退回到 Biz Wallet。退款金额通常会在结束后立即反映，但也可能因系统处理而稍有延迟。请经常确认预算，以免因预算用尽导致促销活动自动结束。
***
### 查看成果
启动促销活动后，可以在仪表盘中查看该促销活动的成果。仪表盘能一眼展示促销活动的效果，并有助于改进下一次活动策略。
**未展示在福利 Tab 的促销活动不会显示在成果仪表盘中。**
#### **周期设置与查询条件**
成果数据可以按多种标准查询。建议根据分析目的变换条件来查看。
* **按日·周·月** 可以按单位查询数据。
* **按操作系统（OS）**可以分开查看成果。
* 可以区分当前在 Mini App 中运营的全部促销活动和单个促销活动进行查询。
在促销活动成果仪表盘中，可以按步骤查看用户参与促销活动的流程。通过该流程可以 **最终转化率**，并且能掌握用户在哪个步骤流失最多。
1. **进入福利 Tab：** Toss App 的福利 Tab 中展示了该促销活动，这里指看到该活动的用户数。
2. **点击促销活动：** 在福利 Tab 中实际点击促销活动并进入详情页的用户数。将该数与福利 Tab 进入人数相比，可以了解促销活动标题或缩略图吸引用户的程度。
3. **获得积分：** 满足促销条件并实际获得 Toss 积分的用户数。如果条件过难或流程复杂，这一步可能会流失很多用户。
可以按流入促销活动的用户类型区分来查看成果。
* **新用户：** 因促销活动而首次进入 Mini App 的用户。
* **老用户：** 以前使用过 Mini App 的用户。
也可以查看促销活动对实际营收的贡献。不过，贡献营收只能按 Workspace（商户编号）维度查询，不能按 Mini App 单独查询。
* **总贡献营收：** 是因促销活动流入的用户所产生的全部营收。
* **按付费用户计算的人均平均营收：** 在因促销活动流入的用户中 **仅以实际付费的用户**为基准计算的平均营收。
* **按全部用户计算的人均平均营收：** 不论是否付费， **以因促销活动流入的全部用户**为基准计算的平均营收。
***
### 常见问题
所有促销活动都有每人 5,000 积分限制吗？
是的。注册/交易/活动/好友邀请等 **所有促销活动类型原则上每人最多只能发放低于 5,000 积分的金额** 。
可以举办抽奖或随机发放活动吗？
（游戏应用的情况下）不可以。概率型·转盘·随机抽取方式 **有可能被解释为博彩行为**，因此不允许。
**仅允许固定发放**。（例如：“首次注册时发放 500 积分”）
可以根据游戏内得分/胜负/名次发放积分吗？
不可以。根据相关法律法规，将游戏结果与现金性奖励直接挂钩 **属于诱导博彩行为**，因此被禁止。
对于游戏应用 **只能以与游戏结果无关的条件**（注册、登录、完成教程等）来运营促销活动。
可以将礼品卡·商品券兑换为 Toss 积分吗？
不可以。为用户持有的资产进行兑换的奖励因存在洗钱等担忧，无法开展。
Toss 积分发放必须基于 App 内特定行为（注册、支付、参与活动等）来运营。
积分发放时点应如何设定？
实际发放时点由您自行判断，但必须 **在用户参与促销活动前事先告知**。
例如：“活动参与后立即发放” / “次日 18 点前发放”等
可以中途停止促销活动吗？
除预算超出等原因外，不建议中止。尤其在必须完成特定行为才能获得积分的情况下，用户可能没有意识到活动已结束。
在开展促销活动时 **“本促销活动可能会在未提前告知的情况下中止”** 文案必须包含。
好友邀请奖励应如何设计？
必须能够向邀请者和被邀请者都提供相同的奖励。**防重复参与·防刷单逻辑**必须应用。奖励上限对每人同样适用，最高 5,000 积分。
可以用现金代替积分发放吗？
不可以。现金发放或“入金即+N%保底”形式 **存在类存款行为·博彩性行为**的违法风险。
必须 **Toss 积分** 形式发放。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://developers-apps-in-toss.toss.im/guide/zh/marketing/promotion.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.