> 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/share-reward.md).

# 分享奖励

引入 Apps in Toss 的分享奖励功能，打造从邀请现有用户到带来新用户，再到回访与再次分享的自然病毒式正循环。

### 什么是分享奖励

分享奖励是一项利用联系人模块，读取使用 Toss 的用户联系人，并向完成分享的用户提供奖励的功能。分享通过 Toss 通知推送进行。

分享奖励可用于游戏服务和非游戏服务。根据服务类型，向用户展示的推送文案也会不同。

<figure><img src="https://1415110023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FU5fK5nc4qpJQnWixtKuD%2Fimage.png?alt=media&amp;token=884f21e5-b953-4f45-90ea-6fb9955ebad8" alt=""><figcaption></figcaption></figure>

***

### 分享奖励的优点

* 可以将奖励与好友邀请连接起来，自然地带来流量。
* 可以以奖励为基础引导分享，在不增加额外成本的情况下获得营销效果。
* 可以提供仅限于服务内使用的虚拟货币，进而引导用户再次访问。

***

### 发送限制及重置标准

分享奖励的发送限制会按天重置。

* 以一个奖励 ID 为准，同一用户一天只能发送一次分享奖励。
* 例如，如果今天通过某个奖励 ID 向用户 A 发送了分享奖励，那么明天可以用同一个奖励 ID 再次发送。
* 如果使用不同的奖励 ID，发送限制也会按奖励 ID 分别计算。

{% hint style="info" %}
**请务必参考**

* 请避免过度弹窗或强制性分享引导。
* 请准确说明用户能获得奖励的条件，以便用户容易理解。
* 不能注册现金类奖励或具有赌博性质的奖励。
  {% endhint %}

***

### 在控制台中设置

请在 Apps in Toss 控制台左侧菜单中选择“分享奖励”。

<figure><img src="https://1415110023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2FBbY2X9Y0q0eQz6djeYlU%2F%E1%84%80%E1%85%A9%E1%86%BC%E1%84%8C%E1%85%B5%E1%84%89%E1%85%A1%E1%84%92%E1%85%A1%E1%86%BC%2010.png?alt=media&amp;token=37d93893-e954-41c8-bf14-695c3157b468" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1415110023-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8pQgXiR5QAzduV54W8Om%2Fuploads%2Fv8f7Bnz4SaqkBduCt4jH%2F%E1%84%80%E1%85%A9%E1%86%BC%E1%84%8C%E1%85%B5%E1%84%89%E1%85%A1%E1%84%92%E1%85%A1%E1%86%BC%2010%20(1).png?alt=media&amp;token=1ac7828e-63e3-4458-91d6-38c7433a0a46" alt=""><figcaption></figcaption></figure>

**奖励名称**

这是管理员在内部用于区分的奖励名称。请起一个在运营界面或结算过程中容易识别的名称。它可能与向用户展示的文案不同，因此最好根据运营目的具体填写。

* 例如）签到奖励 100 心心 / 好友邀请活动赠送宝石 / 新用户欢迎奖励

**奖励页面**

输入要实际发放给用户的奖励信息。

* 奖励：请输入要发放的奖励单位。请填写用户可识别的奖励名称，例如心心、宝石、积分等。
* 数量和金额：这是要发放给用户的奖励数量。请根据活动或政策输入准确的数量和金额。例如，要发放 100 个心心，则在数量中输入 100。

***

### 进行开发联动

分享奖励 [SDK 联动方法与事件处理代码示例](https://developers-apps-in-toss.toss.im/documentation/common/growth/share/reward)可以查看。


---

# 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 following URL with the `ask` and `goal` query parameters:

```
GET https://developers-apps-in-toss.toss.im/guide/zh/marketing/share-reward.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

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.
