设置促销活动

将商店集成到游戏后,您可以设置优惠券、促销码、奖励或折扣促销活动以吸引新用户,提升销量。

您也可以开展个性化促销活动,即针对指定用户设置活动。您可以设置促销活动中可用于指定用户的商品数。此功能仅适用于折扣促销活动奖励促销活动

注意
仅可对登录管理器产品使用个性化目录。

如已集成登录管理器产品,设置针对用户的个性化促销活动前请进行以下操作:

  1. 为项目设置用户属性。
  2. 在登录管理器部分设置用户属性机制。

属性是以键值对形式存储的用户特征。通过属性可以:

  • 细分用户
  • 在Web商店中为不同用户群体准备个性化店面。

为确保传输数据的完整性,可在登录管理器中以JSON机制格式设置属性验证规则,并使用Login API方法Webhook管理用户属性。您还可以在发布商帐户中编辑属性值。详细信息请参阅如何设置用户属性

优惠券提供在无需购买或使用购物车的情况下发放免费商品的代码。要使用优惠券,用户需在游戏、网站或移动应用中输入券码。之后关联的奖励会发放到用户的物品库。奖励包括:

关于优惠券的详细信息,请参阅优惠券部分。

促销码在结算时对购物车价格应用折扣或向购物车添加免费商品。激活促销码并完成购物车商品的支付后,用户可收到以下奖励之一:

关于促销码的详细信息,请参阅促销码部分。

用户购买促销商品时也可以收到奖励。奖励包括:

通过折扣促销活动可对一个或多个商品设置折扣。可对一个产品应用不限数量的促销活动。折扣不可累加,可以应用于单个商品的价格。可对以下一种或多种商品应用折扣:

关于折扣的详细信息,请参阅折扣促销活动部分。

优惠券促销活动

要启动一个优惠券促销活动:

  1. 设置优惠券促销活动
  2. 使用按券码兑换优惠券的方法
  3. 使用获取优惠券奖励的方法

注:
区域限制应用于整个促销活动。您可以发送邮件给艾克索拉来应用区域限制。

设置优惠券促销活动

  1. 发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店,然后前往促销活动
  3. 单击创建促销活动
  4. 指定以下参数:
    1. 输入促销活动标题。
    2. 选择优惠券促销活动类型。
  5. 选择用户兑换优惠券时收到的奖励。可用选项:
  6. 添加以下内容:
    1. External ID中的促销活动ID。
    2. 用户兑换优惠券时收到的奖励品。
    3. 物品类型和数量。
  7. 单击下一步
  8. 指定总兑换次数和单个用户的兑换次数。
  9. 设置活动的开始和结束时间。
  10. 单击下一步
  11. 检查设置,然后单击保存并退出

注:
促销活动一旦上线即不可更改促销奖励和条款。

  1. 在侧边栏中单击商店,然后前往促销活动
  2. 选择促销活动,单击•••菜单按钮打开菜单,然后单击编辑计划
  3. 前往活动码选项卡。
  4. 指定优惠券生成方式
  5. 生成优惠券码或手动输入券码。
  6. 激活促销活动。

按券码兑换优惠券

注:
要调用艾克索拉API,您可以使用针对各游戏引擎和平台的现成SDK:

实现Redeem coupon code方法调用以使用优惠券。根据Get coupon rewards方法相应中的is_selectable参数值,有两种可能的流程:

  1. 如果is_selectable=true,调用Redeem coupon code方法时应用以下格式传入selected_unit_items对象:

Copy
Full screen
Small screen

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

响应示例:

Copy
Full screen
Small screen

{
  {
    "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
  }
  ]
}

  1. 如果is_selectable=false,则不应在请求中传入额外参数。

获取优惠券奖励

注:
要调用艾克索拉API,您可以使用针对各游戏引擎和平台的现成SDK:

请实现Get coupon rewards方法调用以获取用户兑换优惠券后收到的商品的列表。根据响应中的is_selectable参数值,有两种可能的流程:

  1. 如果值为is_selectable=true,则应对于每个具有type=unit元素的item显示从unit_items对象中选择元素的表单。在该表单中,用户对于每种unit类型只能选择一个元素。
响应示例:

Copy
Full screen
Small screen

{
   "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

  1. 如果is_selectable=false,则不应在请求中传入额外参数。

促销码促销活动

要启动一个促销码活动:

  1. 设置促销码活动
  2. 实现促销码的兑换方法
  3. 实现获取促销码奖励的方法

设置促销码促销活动

  1. 发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店,然后前往促销活动
  3. 单击创建促销活动
  4. 指定以下参数:
    1. 输入促销活动标题。
    2. 选择促销码促销活动类型。
  5. 选择用户兑换促销码时收到的东西:无奖励、对购物车全部商品的折扣、对指定商品的折扣、奖励品或以上的组合。
  6. 选择折扣量。
  7. 单击下一步
  8. 指定总兑换次数和单个用户的兑换次数。
  9. 单击下一步
  10. 设置活动的开始和结束日期。
  11. 单击下一步
  12. 检查设置,然后单击保存并退出

注:
促销活动一旦上线即不可更改促销奖励和条款。

  1. 在侧边栏中单击商店,然后前往促销活动
  2. 选择促销活动,单击•••菜单按钮打开菜单,然后单击编辑计划
  3. 前往活动码选项卡。
  4. 指定促销码生成方式
  5. 生成促销码或手动输入券码。
  6. 激活促销活动。

兑换促销码

注:
要调用艾克索拉API,您可以使用针对各游戏引擎和平台的现成SDK:

实现Redeem promo code方法调用以使用促销码。根据is_selectable参数值,Get promo code rewards方法响应中有两种可能的流程:

  1. 如果is_selectable=true,调用Redeem promo code方法时应用以下格式传入selected_unit_items对象:

Copy
Full screen
Small screen

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

响应示例:

Copy
Full screen
Small screen

{
  {
    "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
    }
    ]
}

  1. 如果is_selectable=false,则不应在请求中传入额外参数。

获取促销码奖励

注:
要调用艾克索拉API,您可以使用针对各游戏引擎和平台的现成SDK:

请实现Get promo code rewards方法调用以获取用户兑换促销码后收到的商品的列表。根据响应中的is_selectable参数值,有两种可能的流程:

  1. 如果值为is_selectable=true,则应对于每个具有type=unit元素的item显示从unit_items对象中选择元素的表单。在该表单中,用户对于每种unit类型只能选择一个元素。
响应示例:

Copy
Full screen
Small screen

{
   "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

  1. 如果is_selectable=false,则不应在请求中传入额外参数。

奖励促销活动

要启动一个奖励促销活动:

  1. 发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店,然后前往促销活动
  3. 单击创建促销活动
  4. 指定以下参数:
    1. 输入促销活动标题。
    2. 选择奖励促销活动类型。
  5. 选择促销商品。
  6. 选择购买促销商品时发放给用户的奖励品。
  7. 单击下一步
  8. 如要针对特定用户设置促销活动,请将仅对特定用户触发促销活动开关设置为并指定相关条件。
  9. 如要限制促销活动对指定用户的适用次数,请将一位用户可使用促销活动的限制次数开关切换为并指定次数。
  10. 单击下一步
  11. 设置活动的开始和结束日期。
  12. 单击下一步
  13. 检查设置,然后单击保存并退出

注:
促销活动一旦上线即不可更改促销奖励和条款。

  1. 在侧边栏中单击商店,然后前往促销活动
  2. 选择促销活动,单击•••菜单按钮打开菜单并单击编辑计划
  3. 激活促销活动。

折扣奖励促销活动

注:
不能对折扣促销活动应用区域限制。

通过发布商帐户设置折扣促销活动

要启动一个折扣促销活动:

  1. 发布商帐户中打开您的项目。
  2. 在侧边栏中单击商店,然后前往促销活动
  3. 单击创建促销活动
  4. 指定以下参数:
    1. 输入促销活动标题。
    2. 选择折扣促销活动类型。
  5. 设置适用于一个或多个商品的折扣。
  6. 设置折扣数。
  7. 单击下一步
  8. 如要针对特定用户设置促销活动,请将仅对特定用户触发促销活动开关设置为并指定相关条件。
  9. 如要限制促销活动对指定用户的适用次数,请将一位用户可使用促销活动的限制次数开关切换为并指定次数。
  10. 单击下一步
  11. 设置活动的开始和结束日期。
  12. 单击下一步
  13. 检查设置,然后单击保存并退出

注:
促销活动一旦上线即不可更改促销奖励和条款。

  1. 在侧边栏中单击商店,然后前往促销活动
  2. 选择促销活动,单击•••菜单按钮打开菜单并单击编辑计划
  3. 激活促销活动。

通过API设置折扣促销活动

要使用折扣促销活动,可使用Promotions方法组Discount子部分下的方法。

要通过API方法创建促销活动:

  1. 用要求的参数调用Create discount promotion for item方法。
  2. “is_enabled”:true参数调用Update item promotion方法以激活促销活动。

要通过API编辑促销活动,请使用新促销活动参数调用Update item promotion方法。您也可以编辑状态为Active的促销活动。

通过API方法创建或编辑折扣促销活动时,您还可以:

您的进度
感谢您的反馈!
上次更新时间: 2022年12月30日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!