> 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 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/share-reward.md?ask=<question>&goal=<endgoal>
```

`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.