奖励促销活动
运行机制
奖励促销活动是通过向购买虚拟物品的用户发放奖励品来激励他们的营销工具。
主要功能：
- 在购买促销品时提供一个或多个奖励品。
- 指定用户可享受促销活动的次数。
- 设置个性化奖励促销活动。
使用示例：
- 提供虚拟货币形式的奖励，用于购买虚拟物品。
- 在项目的重要日期进行奖励促销来回报用户忠诚度，例如项目的周年日。
- 游戏中达到一定等级的用户购买商品后额外赠予其奖励品以奖励其忠诚度。
在一段限定时间内向用户发放奖励品以激励其购买虚拟物品。
使用API方法生成商品目录时，可检索促销活动的信息。在响应中，除了虚拟物品的信息外，还将收到奖励类型促销活动的信息：
- 名称
- 开始和结束日期
- 奖励品
- 用户可享受促销活动的总次数
- 用户可享受促销活动的剩余次数
如用户可享受促销活动的剩余次数为零，则促销活动信息不会在目录中显示。
- json
1{
2 "item_id": 400962,
3 "sku": "test_item",
4 "type": "virtual_good",
5 "name": "name_test_limit",
6 "description": "description_test_limit",
7 "price": {
8 "amount": "1.00",
9 "amount_without_discount": "1.00",
10 "currency": "USD"
11 },
12 "virtual_prices": [
13 {
14 "description": null,
15 "item_id": 322172,
16 "sku": "1234500",
17 "name": "virt currency only",
18 "type": "virtual_currency",
19 "amount": 1,
20 "amount_without_discount": 1,
21 "calculated_price": {
22 "amount": "1.00",
23 "amount_without_discount": "1.00"
24 },
25 "is_default": true
26 }
27 ],
28 "can_be_bought": true,
29 "promotions": [
30 {
31 "name": "New Year Bonus",
32 "date_start": "2022-12-30T22:00:00+03:00",
33 "date_end": "2023-01-02T21:59:59+03:00",
34 "discount": null,
35 "bonus": [
36 {
37 "quantity": 3,
38 "name": "mybonusitem",
39 "sku": "444777",
40 "type": "virtual_good"
41 }
42 ],
43 "limits": {
44 "per_user": {
45 "available": 7,
46 "total": 7
47 }
48 }
49 }
50 ],
51 "limits": null,
52 "attributes": [],
53 "is_free": false,
54 "groups": [
55 {
56 "external_id": "01022023",
57 "name": "Group1"
58 }
59 ],
60 "virtual_item_type": "consumable",
61 "inventory_options": {
62 "consumable": {
63 "usages_count": 1
64 },
65 "expiration_period": null
66 }
67}
如果奖励品设置了购买次数限制，则用户在该限制以内可收到的所有可购商品，促销商品将不可购买。
如果奖励促销活动有使用限制，而用户剩余可用促销活动次数为0，则该促销商品将在目录中显示，但不显示有奖励品。
示例
根据所设置的具体限制，购买有奖励的促销商品有不同的用户场景。
购买奖励品时的限制示例：
在发布商帐户中加速器商品有一个购买限制 — 每个用户最多购买2次。
加速器是购买帝王宝盒的奖励品。
用户购买了加速器一次，然后还购买了帝王宝盒一次，收到了加速器作为奖励。
用户再次购买帝王宝盒时，订单创建方法将指示该用户已超过加速器商品的购买限制。
使用奖励促销活动时的限制示例：
在发布商帐户中，奖励促销活动有一个使用限制 — 每个用户最多一次。
加速器是购买帝王宝盒的奖励品。
用户购买了帝王宝盒一次，收到了加速器作为奖励品。
用户再次购买帝王宝盒时，将不再显示有加速器奖励品，也不会向其发放。
购买奖励品和使用奖励促销活动的限制示例：
在发布商帐户中加速器商品有一个购买限制 — 每个用户最多购买1次。
加速器是购买帝王宝盒的奖励品。
奖励促销活动有一个使用限制 — 每个用户最多2次。
用户购买了帝王宝盒一次，收到了加速器作为奖励品。
用户再次购买帝王宝盒时，订单创建方法将指示该用户已超过加速器商品的购买限制。
如何获取
设置奖励促销活动
可通过以下方式之一设置奖励促销活动：通过发布商帐户进行设置
如通过发布商帐户设置奖励促销活动，您可以：- 设置促销活动的有效期
- 显示用户可使用该促销活动的次数
- 设置促销活动的触发条件
设置可应用于任意商品类型的促销活动：
- 虚拟货币套餐
- 虚拟物品（包括时效性商品）
- 游戏密钥
- 捆绑包
当前不支持在发布商帐户中编辑状态为激活的奖励促销活动。
您可以使用API方法来强化促销活动配置选项。
要通过发布商帐户设置促销活动：
- 在发布商帐户中前往商店 > LiveOps和推广工具。
- 单击创建促销活动。
- 指定以下参数：
- 输入促销活动标题。
- 选择奖励作为促销活动类型。
- 指定促销商品。
- 指定用户购买促销品时向其发放的商品。
要为同一个促销活动选择多个不同类型的促销品，请先选择一种类型的商品，检查其是否在促销品列表字段中显示，然后再返回促销品字段并选择其他类型的商品。
要为同一个促销活动选择多个不同类型的奖励品，请先选择一种类型的商品，检查其是否在奖励品列表字段中显示，然后再返回奖励品字段并选择其他类型的商品。
- 单击下一步。
- 如需要，可设置促销活动的使用次数。方法是，在条件和限制页面，将一位用户可使用促销活动的限制次数开关设置为开，然后指定次数。
- 要设置个性化促销活动，请将仅对特定用户触发促销活动设置为开，然后指定条件。要设置个性化，请按照此说明进行操作。
- 单击下一步。
- 指定促销活动时间段。
- 单击下一步。
- 检查设置，然后单击保存并退出。
- 要激活促销活动：
- 在促销活动目录中找到所需促销活动。
- 单击•••按钮，在下拉列表中选择编辑促销活动，或通过点击操作目录中的操作前往编辑。
- 在右上角打开下拉菜单，然后选择激活促销活动。
删除促销活动
在发布商帐户中删除促销活动：- 在发布商帐户中打开您的项目，前往商店 > LiveOps和推广工具。
- 在目标促销活动所在行中，单击•••并从下拉列表中选择删除促销活动。
- 确认删除促销活动。
通过API方法进行设置
要使用奖励促销活动，可使用促销活动方法组通用和奖励子部分下的方法。
要创建奖励促销活动，请使用创建奖励促销活动方法并指定必需参数。
要激活奖励促销活动，请使用更新奖励促销活动和“is_enabled”:true参数或激活促销活动方法。
要停用促销活动，请使用停用促销活动方法。
要删除促销活动，请使用删除奖励促销活动调用。
要通过API方法编辑促销活动，请用新促销活动的参数调用更新奖励促销活动方法。编辑促销活动还可以用于状态为激活的促销活动。
通过API方法创建或编辑奖励促销活动时，您也可以进行以下操作：
- json
1“condition”: null
- json
1“date_end”: null
发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
