折扣促销活动
运行机制
折扣促销活动是获得新玩家及增加销量的营销工具。
主要功能：
- 为一个或多个商品配置折扣。
- 对一件商品应用不限数量折扣促销活动。
- 创建自动计算商品价格的商品目录。生成目录的方法为每个商品返回
price对象。该对象包含应用及不应用当前折扣的商品价格。
Copy
- json
"price": {
"amount": "2.3900000000000000",
"amount_without_discount": "2.9900000000000000",
"currency": "USD"
}
限制：
- 只能以1-99范围的百分数形式设置折扣值。
- 不能对折扣促销活动应用区域限制。
您可以对任意数量的商品设置促销活动。也可以对一个商品应用不限数量的折扣促销活动。
注意
您可为一个游戏或一组游戏设置不同类型的促销活动：折扣、优惠券、促销码及奖励。
如果购买时一个游戏或一组游戏存在多个有效的促销活动，则将逐个应用这些折扣，折扣的应用顺序对结果没有影响。
例如：
一个游戏密钥的价格是$10。在发布商帐户中，为游戏密钥设置了以下促销活动：
- 黑色星期五折扣促销，11月4日-30日享受10%的折扣
- 特价折扣促销，11月15日-12月15日享受20%的折扣
- 促销码活动，11月4日-30日使用促销码享受5%的折扣
如果在11月20日购买游戏密钥，则两个折扣促销活动和一个促销码活动都有效。
游戏密钥的总价按照(($10 - 10%) - 20%) - 5%计算，最终为$6.84。
用户在以下场景可以看到促销活动的信息：
- 查看游戏目录时
- 下单时
如使用建站器创建商店，游戏目录会显示折扣数、不应用折扣的价格（显示为划掉）和应用折扣后的价格。
如自行创建商店，请实现根据获取游戏列表方法中收到的数据在目录中显示促销活动。在响应中，除游戏信息外，您还将收到促销活动的以下信息：
- 标题
- 开始和结束日期
- 折扣类型促销活动的折扣大小
- 折扣类型促销活动应用和未应用折扣的商品价格
- 奖励类型促销活动的奖励品
Copy
- json
{
"items": [
{
"sku": "game_1",
"name": "Game name",
"groups": [
{
"external_id": "all",
"name": "All games"
},
{
"external_id": "Xsolla",
"name": "Xsolla games"
}
],
"type": "unit",
"unit_type": "game",
"description": "Game description",
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"attributes": {
"$ref": "../examples/client-attribute-game.yaml#/value"
},
"promotions": [],
"unit_items": [
{
"sku": "game_key_01",
"type": "game_key",
"is_free": false,
"price": {
"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"virtual_prices": [],
"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": true,
"is_pre_order": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
{
"sku": "game_key_02",
"type": "game_key",
"is_free": false,
"price": {
"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"virtual_prices": [],
"can_be_bought": true,
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": false,
"release_date": null
}
]
},
{
"sku": "game_2",
"name": "Game name",
"groups": [
{
"external_id": "all",
"name": "All games"
}
],
"type": "unit",
"unit_type": "game",
"description": "Game description",
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"attributes": [
{
"external_id": "OS",
"name": "OS",
"values": [
{
"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
}
],
"promotions": [],
"unit_items": [
{
"sku": "game_key_01",
"type": "game_key",
"is_free": false,
"price": {
"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"virtual_prices": [],
"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": false,
"release_date": null
}
]
}
]
}
下单时，会显示应用的促销活动的以下信息：
- 应用折扣促销活动的结果：
- 促销活动的折扣数
- 未应用折扣的价格（显示为划掉）
- 折扣价格
- 应用奖励促销活动的结果：
- 奖励品
- 在奖励品所在价格行显示免费值
- 应用促销码的结果
- 促销码的折扣数
- 未应用折扣的价格（显示为划掉）
- 折扣价格
- 奖励品
- 在奖励品所在价格行显示免费值
注：
如使用建站器，购物车或下单窗口将显示应用的促销活动信息以及兑换促销码的字段。
如何获取
设置折扣活动
可通过以下方式之一设置折扣活动：通过发布商帐户进行设置
如果通过发布商帐户设置折扣促销活动，可使用以下选项：- 设置整数百分比的折扣值。
- 设置具有时间期限的折扣促销活动。
- 设置应用于指定平台一个或多个游戏密钥套餐的折扣。
以下操作当前在发布商帐户中不支持：
- 设置具有小数值的折扣。
- 设置有效期无限的折扣。
- 编辑已激活的折扣促销活动。
您可以使用API方法来强化您的折扣促销活动配置选择。
注：
新促销活动默认为未激活状态。要激活折扣，请在创建后前往折扣编辑。
- 在发布商帐户中前往商店 > 促销活动和奖励，然后单击创建促销活动。
- 指定需要的参数：
- 输入促销活动标题。
- 选择折扣作为促销活动类型。
- 指定折扣数。
- 选择产品类型。
- 选择一个或多个有折扣的商品。
注：
要为同一个促销活动选择不同商品类型，请先选择一种类型的商品，然后检查其是否在涉及商品的列表字段中显示。然后再返回产品类型字段并选择其他商品类型。
- 单击下一步。
- 您可以限制一个用户可使用促销活动的次数。要进行设置，请在条件和限制页面上将一位用户可使用促销活动的限制次数设置为开，并指定限制次数。
- 要设置个性化促销活动，请将仅对特定用户触发促销活动设置为开，然后按照说明进行操作。
- 单击下一步。
- 设置活动开始和结束日期。
- 单击下一步。
- 检查设置，然后单击保存并退出。
注：
促销活动为激活状态时无法对其进行更改。
- 要激活促销活动：
- 在您的促销活动目录中找到需要的促销活动。
- 单击•••菜单按钮，然后选择编辑促销活动。
- 在右上角，打开下拉菜单，然后选择激活促销活动。
通过API方法进行设置
要使用折扣促销活动，可使用Promotions方法组
要通过API方法创建促销活动：
- 用要求的参数调用
Create discount promotion for item 方法。 - 用
“is_enabled”:true参数调用Update item promotion 方法以激活促销活动。
要通过API编辑促销活动，请使用新促销活动参数调用
通过API方法创建或编辑折扣促销活动时，您还可以：
- 配置一个适用于项目中所有商品的折扣。请将
“items”:null参数传入Create discount promotion for item 或Update item promotion 方法。
Copy
- json
"items": null
- 配置一个适用于实体商品的折扣。请将包含实体商品SKU的数组传入
Create discount promotion for item 或Update item promotion 方法。
Copy
- json
"items": [{
“sku”: “strw2030”
}, {
“sku”: “strw4060”
}, {
“sku”: “cupred200”
}
]
- 配置一个带小数的百分比折扣值。请将包含小数折扣的
discount.percent参数传入Create discount promotion for item 或Update item promotion 方法。
Copy
- json
"discount": {
“percent”: ”49.9”
}
- 配置一个适用于不同类型商品的折扣。请将包含所需商品SKU的数组传入
Create discount promotion for item 或Update item promotion 方法。
Copy
- json
"items": [{
“sku”: “storm_shield”
}, {
“sku”: “heaven_crystals_pack_x500”
},{
“sku”: “strw2030”
}
]
- 配置一个适用于游戏指定DRM的折扣。请将包含所需DRM的SKU的数组传入
Create discount promotion for item 或Update item promotion 方法。
Copy
- json
"items": [{
“sku”: “brilliant_game_sku_steam”
}
]
- 配置没有期限的折扣促销活动。请将
“date_end”:null参数传入Create discount promotion for item 或Update item promotion 方法。
Copy
- json
“date_end”: null
- 为首购用户设置促销活动。为此，请在商品API中传入为商品创建折扣促销活动或在更新商品促销活动API中的数组
attribute_conditions传入对象：
Copy
- json
"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}
自定义折扣促销活动条件
您可以设置仅当符合某些条件时才应用的折扣。例如：- 购物车商品总金额达到一定条件时应用的折扣
- 购物车中的商品数量达到一定条件时应用的折扣
- 当用户搭配购买了另一件商品时对这件商品应用的折扣
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
