设置促销活动
将商店集成到游戏后,您可以设置优惠券、促销码、奖励或折扣促销活动以吸引新用户,提升销量。
您也可以开展个性化促销活动,即针对指定用户设置活动。您可以设置促销活动中可用于指定用户的商品数。此功能仅适用于折扣促销活动和奖励促销活动。
如已集成登录管理器产品,设置针对用户的个性化促销活动前请进行以下操作:
- 为项目设置用户属性。
- 在登录管理器部分设置用户属性机制。
属性是以键值对形式存储的用户特征。通过属性可以:
- 细分用户
- 在网页商城中为不同用户群体准备个性化店面。
为确保传输数据的完整性,可在登录管理器中以JSON机制格式设置属性验证规则,并使用Login API方法或Webhook管理用户属性。您还可以在发布商帐户中编辑属性值。详细信息请参阅如何设置用户属性。
优惠券提供在无需购买或使用购物车的情况下发放免费商品的代码。要使用优惠券,用户需在游戏、网站或移动应用中输入券码。之后关联的奖励会发放到用户的物品库。奖励包括:
关于优惠券的详细信息,请参阅优惠券部分。促销码在结算时对购物车价格应用折扣或向购物车添加免费商品。激活促销码并完成购物车商品的支付后,用户可收到以下奖励之一:
关于促销码的详细信息,请参阅促销码部分。用户购买促销商品时也可以收到奖励。奖励包括:
通过折扣促销活动可对一个或多个商品设置折扣。可对一个产品应用不限数量的促销活动。折扣不可累加,可以应用于单个商品的价格。可对以下一种或多种商品应用折扣:
关于折扣的详细信息,请参阅折扣促销活动部分。优惠券促销活动
要启动一个优惠券促销活动:
设置优惠券促销活动
- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 单击创建促销活动。
- 指定以下参数:
- 输入促销活动标题。
- 选择优惠券促销活动类型。
- 选择用户兑换优惠券时收到的奖励。可用选项:
- 添加以下内容:
- External ID中的促销活动ID。
- 用户兑换优惠券时收到的奖励品。
- 物品类型和数量。
- 单击下一步。
- 指定总兑换次数和每个用户的可兑换次数。
- 设置活动开始和结束日期。
- 单击下一步。
- 检查设置,然后单击保存并退出。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 选择促销活动,单击•••菜单按钮打开菜单并单击编辑促销活动。
- 前往代码选项卡。
- 指定优惠券生成方式。
- 生成优惠券码或手动输入券码。
- 激活促销活动。
按券码兑换优惠券
实现兑换优惠券码方法调用以使用优惠券。根据Get coupon rewards方法相应中的is_selectable
参数值,有两种可能的流程:
- 如果
is_selectable=true
,调用兑换优惠券码方法时应用以下格式传入selected_unit_items
对象:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
响应示例:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
- 如果
is_selectable=false
,则不应在请求中传入额外参数。
获取优惠券奖励
请实现Get coupon rewards方法调用以获取用户兑换优惠券后收到的商品的列表。根据响应中的is_selectable
参数值,有两种可能的流程:
- 如果值为
is_selectable=true
,则应对于每个具有type=unit
元素的item
显示从unit_items
对象中选择元素的表单。在该表单中,用户对于每种unit
类型只能选择一个元素。
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_rockstar",
"name": "Xsollus: Gold Edition (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_playstation",
"name": "Xsollus: Bonus Pack (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_bonus_pack_edition_xbox",
"name": "Xsollus: Bonus Pack (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}]
},
"quantity": 3
}],
"is_selectable": true
- 如果
is_selectable=false
,则不应在请求中传入额外参数。
促销码促销活动
要启动一个促销码活动:
设置促销码促销活动
- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 单击创建促销活动。
- 指定以下参数:
- 输入促销活动标题。
- 选择促销码作为促销活动类型。
- 选择用户兑换促销码时收到的东西:无奖励、对购物车全部商品的折扣、对指定商品的折扣、奖励品或以上的组合。
- 设置折扣量。
- 单击下一步。
- 指定总兑换次数和每个用户的可兑换次数。
- 单击下一步。
- 设置活动开始和结束日期。
- 单击下一步。
- 检查设置,然后单击保存并退出。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 选择促销活动,单击•••菜单按钮打开菜单并单击编辑促销活动。
- 前往代码选项卡。
- 指定促销码生成方式。
- 生成促销码或手动输入促销码。
- 激活促销活动。
兑换促销码
实现兑换促销码方法调用以使用促销码。根据is_selectable
参数值,获取促销码奖励方法响应中有两种可能的流程:
- 如果
is_selectable=true
,调用兑换促销码方法时应用以下格式传入selected_unit_items
对象:
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
响应示例:
- http
{
{
"items": [
{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 1
},
{
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"attributes": [],
"is_free": true,
"groups": [],
"price": null,
"virtual_prices": [],
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": true,
"release_date": null,
"quantity": 3
}
]
}
- 如果
is_selectable=false
,则不应在请求中传入额外参数。
获取促销码奖励
请实现获取促销码奖励方法调用以获取用户兑换促销码后收到的商品的列表。根据响应中的is_selectable
参数值,有两种可能的流程:
- 如果值为
is_selectable=true
,则应对于每个具有type=unit
元素的item
显示从unit_items
对象中选择元素的表单。在该表单中,用户对于每种unit
类型只能选择一个元素。
- http
{
"bonus": [{
"item": {
"sku": "xsollus_gold_edition",
"name": "Xsollus: Gold Edition",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
"unit_items": [{
"sku": "xsollus_gold_edition_steam",
"name": "Xsollus: Gold Edition (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_gold_edition_playstation",
"name": "Xsollus: Gold Edition (playstation)",
"type": "game_key",
"drm_name": "Playstation",
"drm_sku": "playstation"
}, {
"sku": "xsollus_gold_edition_xbox",
"name": "Xsollus: Gold Edition (xbox)",
"type": "game_key",
"drm_name": "XBox",
"drm_sku": "xbox"
}, {
"sku": "xsollus_gold_edition_nintendo_eshop",
"name": "Xsollus: Gold Edition (nintendo_eshop)",
"type": "game_key",
"drm_name": "Nintendo Switch eShop",
"drm_sku": "nintendo_eshop"
}]
},
"quantity": 1
}, {
"item": {
"sku": "xsollus_bonus_pack_edition",
"name": "Xsollus: Bonus Pack",
"type": "unit",
"description": null,
"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
"unit_items": [{
"sku": "xsollus_bonus_pack_edition_steam",
"name": "Xsollus: Bonus Pack (steam)",
"type": "game_key",
"drm_name": "Steam",
"drm_sku": "steam"
}, {
"sku": "xsollus_bonus_pack_edition_origin",
"name": "Xsollus: Bonus Pack (origin)",
"type": "game_key",
"drm_name": "Origin",
"drm_sku": "origin"
}, {
"sku": "xsollus_bonus_pack_edition_drmfree",
"name": "Xsollus: Bonus Pack (drmfree)",
"type": "game_key",
"drm_name": "DRM Free",
"drm_sku": "drmfree"
}, {
"sku": "xsollus_bonus_pack_edition_gog",
"name": "Xsollus: Bonus Pack (gog)",
"type": "game_key",
"drm_name": "GOG",
"drm_sku": "gog"
}, {
"sku": "xsollus_bonus_pack_edition_rockstar",
"name": "Xsollus: Bonus Pack (rockstar)",
"type": "game_key",
"drm_name": "Rockstar Games Launcher",
"drm_sku": "rockstar"
}]
},
"quantity": 3
}],
"discount": {
"percent": null
},
"is_selectable": true
- 如果
is_selectable=false
,则不应在请求中传入额外参数。
奖励促销活动
要开始一个奖励促销活动:
- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 单击创建促销活动。
- 指定需要的参数:
- 输入促销活动标题。
- 选择奖励作为促销活动类型。
- 选择促销商品。
- 选择用户购买促销商品时向其发放的商品。
- 单击下一步。
- 如希望促销活动仅适用于首次购买的用户,请将仅对首购用户触发促销活动开关设置为开。一位用户可使用促销活动的限制次数和仅对特定用户触发促销活动开关将自动启用并将创建一组促销活动触发条件。如有需要,可以添加更多条件。
- 单击下一步。
- 设置活动开始和结束日期。
- 单击下一步。
- 检查设置,然后单击保存并退出。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 选择促销活动,单击•••菜单按钮打开菜单并单击编辑促销活动。
- 激活促销活动。
折扣奖励促销活动
通过发布商帐户设置折扣促销活动
要开始一个折扣促销活动:- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店。
- 单击促销活动和奖励 > 创建促销活动。
- 指定以下参数:
- 输入促销活动标题。
- 选择折扣作为促销活动类型。
- 设置应用于一个或多个商品的折扣。
- 设置折扣量。
- 单击下一步。
- 如希望促销活动仅适用于首次购买的用户,请将仅对首购用户触发促销活动开关设置为开。一位用户可使用促销活动的限制次数和仅对特定用户触发促销活动开关将自动启用并将创建一组促销活动触发条件。如有需要,可以添加更多条件。
- 单击下一步。
- 设置活动开始和结束日期。
- 单击下一步。
- 检查设置,然后单击保存并退出。
- 在侧边栏中单击商店,然后前往促销活动和奖励。
- 选择促销活动,单击•••菜单按钮打开菜单并单击编辑促销活动。
- 激活促销活动。
通过API设置折扣促销活动
要使用折扣促销活动,可使用促销活动方法组折扣子部分下的方法。
要通过API方法创建促销活动:
- 用要求的参数调用为商品创建折扣促销活动方法。
- 用
“is_enabled”:true
参数调用更新商品促销活动方法以激活促销活动。
要通过API编辑促销活动,请使用新促销活动参数调用更新商品促销活动方法。您也可以编辑状态为
通过API方法创建或编辑折扣促销活动时,您还可以:
- 配置一个适用于项目中所有商品的折扣。请将
“items”:null
参数传入为商品创建折扣促销活动或更新商品促销活动方法。
- 配置一个适用于实体商品的折扣。请将包含实体商品SKU的数组传入为商品创建折扣促销活动或更新商品促销活动方法。
- 配置一个带小数的百分比折扣值。请将包含小数折扣的
discount.percent
参数传入为商品创建折扣促销活动或更新商品促销活动方法。
- 配置一个适用于不同类型商品的折扣。请将包含所需商品SKU的数组传入为商品创建折扣促销活动或更新商品促销活动方法。
- 配置一个适用于游戏指定DRM的折扣。请将包含所需DRM的SKU的数组传入为商品创建折扣促销活动或更新商品促销活动方法。
- 配置没有期限的折扣促销活动。请将
“date_end”:null
参数传入为商品创建折扣促销活动或更新商品促销活动方法。
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。