> 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).
# 促销
### 什么是促销
Appintoss 的促销是根据用户的特定行为发放 Toss 积分的活动。例如，可以根据注册、完成首次使用等行为提供福利。
促销使用充值到商务钱包中的预算来运营。是否显示在福利页签中，也可以在控制台直接设置。
促销允许类型
* 注册·访问奖励型（例：新注册时发放2,000积分）
* 交易·购买引导型（条件和说明必须明确。例：消费满5,000韩元时发放500积分）
* 但，已经发放的Toss积分无法回收。请在充分审查促销条件和发放标准后谨慎运营。
* 活动参与型（问卷·问答·简单任务。但不能要求过多时间或劳动。）
* 好友邀请型（邀请人和被邀请人都可获得奖励。必须有防刷逻辑）
* 非游戏应用中的概率型·随机奖励
* 促销期限只能在1周以内运营。
* 只能用于吸引新用户的宣传目的。
* 即使注册为非游戏应用，如果被分类为游戏物，也不能进行概率型促销。
促销 不可 类型
* 游戏应用的概率型·随机奖励（转盘、抽奖等）
* 基于游戏结果的奖励（积分、胜负、排名）
* 财物兑换型奖励（将礼品卡·商品券转换为Toss积分）
* 保底现金型·类募资行为（带有投资性·博彩性质）
* 每人超过5,000积分的发放（抽奖型需单独审查）
{% hint style="info" %}
**请注意**
促销功能即使没有独立服务器也可以使用。
非游戏迷你应用也可以使用通过服务器发放促销积分的方式（Server-to-Server）。如果需要像防止请求篡改这样重视完整性的场景，请使用通过服务器发放的方式。
促销功能即使没有独立服务器也可以使用。
若要通过服务器发放促销，需要实现 Toss 登录。 [Toss 登录指南](/guide/zh/authentication/intro.md)。
{% endhint %}
通过促销发放 Toss 积分时，用户界面上方会弹出 toast 提示。
* **已在{{迷你应用名称}}发放了{{金额}}韩元** 会以这种形式短暂显示后自动消失。
* 也可以在 Toss App 的通知菜单（首页的铃铛按钮）中查看。
* 但根据用户的通知设置，可能不会在通知菜单中显示。
* 也可以在福利页签的 Toss 积分菜单中查看累计记录。
* 在 Toss App 中按 福利 → Toss 积分 → 积分金额 → 迷你应用名称 的顺序点击，即可查看累计记录。
***
### 促销的好处
* 可提前向商务钱包充值并设置预算和结束日期，无需担心超支即可运营。
* 若显示在 Toss 福利页签中，随着大量流量可吸引更多用户进入。
* 可以像注册、开始首次游玩一样，轻松引导用户行为。
* 可通过日常·周常任务创造用户再次访问的理由，从而提升留存。
* 可通过 API 处理积分发放和结果查询。
* 测试用代码 `TEST_{promotionCode}`可用于验证，而不会实际扣除积分。
{% hint style="info" %}
**请注意**
* 汇总展示 Appintoss 多个促销的‘试用新服务’页签，可能会根据内部展示逻辑仅对部分用户可见。
* 不能用于博彩内容、诱导安装自家应用、或可能违反法律法规的内容来开展促销。
* 请务必应用每人限1次、每日限制、冷却时间、防重复发放逻辑。
* 如果发放延迟，请提供 PENDING 状态说明以及可查看结果的路径。
* 要开始促销，需要先进行预审。预审按工作日计算约需2\~3天。
{% endhint %}
***
### 在控制台注册促销
若要开始促销，请先准备以下项目。如果已经准备完毕，也可以直接跳到第5步（注册促销）。
* 注册企业信息并审核结算信息（企业审核按工作日约需1\~2天，结算审核需2\~3天）
* 代表管理员同意促销功能条款与商务钱包条款
* 向商务钱包充值促销预算（最低30万韩元，最高3,000万韩元）
#### 1. 注册企业信息
促销只能在企业（个人或法人）账号中使用。如果尚未完成企业注册，控制台会显示‘请先注册企业信息’页面。请点击‘注册’来填写企业信息。
* 企业信息审核 **按工作日约需1\~2天** 。
* 详细流程请查看 [企业注册指南](https://developers-apps-in-toss.toss.im/guide/operation/register-business)。
#### 2. 注册结算信息
企业注册完成后，会切换到‘请接下来注册结算信息’页面。请点击‘注册’按钮，在合作伙伴信息菜单中注册结算信息，并申请审核。
* 结算信息审核 **平均需要2\~3个工作日** 。
* 在注册结算信息之前，无法提交审核申请。请先确认企业注册状态。
{% hint style="info" %}
**注册结算信息时的注意事项**
* 户名请与存折复印件上的 **完全一致** 填写。
* 业态·行业不要输入数字代码，而要用 **文本**进行搜索输入。例）‘软件开发业’请搜索‘软件’
{% endhint %}
#### 3. 向商务钱包充值
结算信息审核完成后，请同意促销条款。
之后 **促销菜单右上角小组件**或工作区中的‘商务钱包’菜单里可以充值预算。
* 可充值金额： **最低50,000韩元 \~ 最高30,000,000韩元**
* 当前可用支付方式：信用卡（认证支付、非认证支付）
* 认证支付：各卡公司无支付限制
* 非认证支付：Hana 卡每日限100万韩元，其余卡公司无限制（非认证支付是直接输入卡号的方式。）
充值完成后，状态会变为‘已充值’，并会反映充值金额。
也可以同时设置自动充值。（例如：余额剩10万韩元时，每次充值50万韩元）
**结算及运营原则**
* 促销预算是在商务钱包中充值后再设置的。预算用尽后促销就结束。
* 中止促销时，剩余预算会退回到商务钱包。（如有余额）
* 必须应用防重复参与·防刷量逻辑。
* 如发生投诉，需先确认参与记录，再由合作伙伴方处理。
#### 4. 注册促销
**在福利页签展示的情况**
**不在福利页签展示的情况**
* **促销名称：** 请具体填写用户满足什么条件后可获得积分。例）服务登录时发放10积分，完成教程时发放20积分
* **促销结束日期：** 请设置您想要的结束日期。若预算耗尽，可能会比预定日期更早结束。
* **是否在福利页签展示**
* 展示：会在 Toss App 的福利 → 试用新服务菜单中一并展示。
* 不展示：只向直接通过迷你应用访问的用户提供促销。
* 注意：如果先注册为不展示，之后想改为展示， **需要重新注册新的促销**。无法通过修改更改。
* **任务名称** （福利页签展示时必填）：任务名称必须以‘\~하기’结尾。例）完成教程、登录、留下评价
* **发放方式** （福利页签展示时必填）
* 固定金额：发放指定金额。
* 最高金额：每人最多可发放的金额。会在此范围内随机发放。例）最高100韩元 → 每次参与发放0\~100韩元中的金额
* **跳转 URL** （福利页签展示时必填）
* 格式： `intoss://{{appName}}/ScreenName`
* 会通过该 URL 进入福利页签。
* **预算信息**
* 预算不能设置得高于商务钱包余额。
* 若要在进行中增加预算，可先向商务钱包充值，然后在修改促销中增加。
* **每人每日最高发放金额** （必填）：请直接设置一人一天可领取的最高金额。
* 不会向同一用户发放超过此金额。
* 有助于防止刷量并稳定管理预算。
* 如果尤其担心刷量，请务必设置。即使是客户端请求发放积分的情况，也建议应用。
促销预检清单
必须满足以下所有项目，才能开展促销。
□ 发放的积分 **每人不超过5,000积分**吗？\
□ 是否已明确告知发放条件、发放时间、发放限制？\
□ 参与方式是否简单，不会要求太多时间或劳动？\
□（游戏的情况）是否未与轮盘·抽奖等概率型元素结合？\
□ 发放的积分是否不是依据游戏结果或排名决定的？\
□ 是否不是将用户持有的资产兑换·转换为Toss积分的形式？\
□ 是否已提前告知促销可能会提前结束或中止？\
□ 是否已应用防止重复参与的逻辑？\
□ 是否不是带有博彩性质或夸大的促销？
输入促销信息后，请点击\[请求审核]。审核为 **按工作日计算2\~3天** 。
***
### 开发对接
在游戏·非游戏迷你应用中发放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 测试后，才能开始促销。
***
### 开始并运营促销
请点击‘开始’按钮，启动促销。
* 预算栏 `实际消耗金额 / 总预算` 会以这种形式显示，便于确认预算消耗情况。
* 修改促销主要用于增加预算。
* 促销结束后，剩余预算会退回到商务钱包。
* 预算耗尽后，将不再显示在福利页签中。请定期管理预算。
点击活动名称后，可以查看促销详情，并进行修改·结束·暂停。
* **修改：** 主要用于增加预算。要增加预算，请按 活动详情 → 促销修改按钮 → 输入要增加的金额 → 保存 的顺序进行。如果要更改预算以外的设置，可能会受内部政策限制，请先查看审核指南。
* **结束：** 促销结束后，剩余预算会自动退回商务钱包。退款金额通常会在结束后立即反映，但也可能因系统处理而稍有延迟。请经常确认预算，避免因预算耗尽导致促销自动结束。
***
### 查看成效
启动促销后，可以在仪表板中查看该促销的成效。仪表板会一目了然地展示促销效果，并帮助改进下一次活动策略。
**未显示在福利页签中的促销不会显示在成效仪表板中。**
#### **期间设置及查询条件**
成效数据可以按多种条件查询。建议根据分析目的切换条件查看。
* **可按日·周·月** 单位查询数据。
* **可按操作系统（OS）**区分查看成效。
* 可区分查看当前迷你应用中运营的全部促销和单个促销。
在促销成效仪表板中，可以按步骤查看用户参与促销的流程。通过这一流程可以了解 **最终转化率**，并可判断用户主要在哪个步骤流失。
1. **进入福利页签：** 指促销在 Toss App 的福利页签中展示后，看到该促销的用户人数。
2. **点击促销：** 指在福利页签中实际点击促销并进入详情页的用户人数。与进入福利页签的人数相比，可以看出促销标题或缩略图对用户的吸引力有多大。
3. **获得积分：** 指满足促销条件并实际获得 Toss 积分的用户人数。如果条件太难或流程太复杂，很多用户可能会在这一步流失。
可根据流入促销的用户特征分类查看成效。
* **新用户：** 因促销而首次进入迷你应用的用户。
* **老用户：** 以前使用过迷你应用的用户。
还可以查看促销对实际销售额的贡献程度。不过，贡献销售额只能按工作区（企业编号）查询，不能按迷你应用分别查询。
* **总贡献销售额：** 因促销流入的用户所产生的总销售额。
* **按付款用户计算的人均销售额：** 在因促销流入的用户中 **仅以实际付款的用户**为基准计算的人均销售额。
* **按全部用户计算的人均销售额：** 不论是否付款， **以因促销流入的全部用户**为基准计算的人均销售额。
***
### 常见问题
所有促销都有每人5000积分限制吗？
是的。注册/交易/活动/好友邀请等 **所有促销类型原则上都只能发放到每人最多不超过5000积分** 。
可以进行抽奖或随机发放活动吗？
（如果是游戏应用）不可以。概率型·轮盘·随机抽取方式 **有被解释为博彩行为的风险**，因此不被允许。
**仅允许固定发放**。（例如：“首次注册时发放500积分”）
可以根据游戏内分数/胜负/排名发放积分吗？
不可以。根据相关法律，将游戏结果与现金性奖励直接挂钩属于 **诱导博彩行为**，被禁止。
如果是游戏应用 **只能通过与游戏结果无关的条件**（注册、登录、完成教程等）来运营促销。
可以把礼品卡·商品券兑换成Toss积分吗？
不可以。将用户持有的财物兑换成奖励，因存在洗钱等风险，无法进行。
Toss 积分发放必须基于应用内特定行为（注册、支付、参与活动等）来运营。
积分发放时间应如何设定？
实际发放时间请由您自行判断，但必须 **在用户参与促销之前提前告知**。
例如：“参与活动后立即发放” / “次日18点前发放”等
可以中途中止促销吗？
除预算超出等原因外，不建议中止。特别是，需要达成特定行为才能获得积分时，用户可能并未意识到活动已经结束。
在进行促销时 **“本促销可能在未事先通知的情况下中止”** 文案请务必包含。
好友邀请奖励应该如何设计？
应能向邀请人和被邀请人都提供相同奖励。**必须应用防重复参与·防刷量逻辑**。奖励上限同样适用于每人最多5000积分。
可以用现金代替积分发放吗？
不可以。现金发放或“存款即+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.