Promociones con descuento

Cómo funciona

Las promociones de descuento son una herramienta de marketing para captar nuevos jugadores y aumentar las ventas.

Características principales:

• Configurar un descuento para uno o varios artículos.
• Aplicar un número ilimitado de promociones con descuento a un artículo.
• Crear un catálogo de artículos con cálculo automático de precios para los artículos. Los métodos para crear un catálogo devuelven el objeto price para cada artículo. Este objeto contiene los precios de los artículos con el descuento vigente y sin descuento.

"price": {
  "amount": "2.3900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}

Restricciones:

• Sólo puede establecer el descuento en un valor porcentual comprendido entre 1 y 99.
• No puede aplicar restricciones regionales a las promociones con descuento.

Puede establecer promociones para cualquier número de artículos. Aplique un número ilimitado de promociones con descuento a un artículo.

El usuario puede ver información sobre las promociones:

• al ver el catálogo de juegos
• al hacer un pedido

Si utiliza Site Builder para crear su tienda, el catálogo de juegos muestra el importe del descuento, el precio tachado sin descuento y el precio con descuento.

Si crea su propia versión de la tienda, implemente la visualización de promociones en el catálogo basándose en los datos recibidos en el método Get games list. En la respuesta, obtendrá la siguiente información sobre las promociones además de la información sobre el juego:

• título
• fecha de inicio y fin
• volumen del descuento para una promoción con el tipo de Descuento tipo
• precio del artículo con y sin descuento para una promoción con el tipo de Descuento tipo
• artículo de bonificación para una promoción con el tipo de Bonificación tipo

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

Al realizar un pedido, se muestra la siguiente información sobre las promociones aplicadas:

• el resultado de aplicar una promoción con descuento:
  • importe del descuento para la promoción
  • precio tachado sin descuento
  • precio con descuento
• el resultado de aplicar una promoción con bonificación:
  • artículos de bonificación
  • Valor Gratis en la línea de precios de los artículos con bonificación
• el resultado de aplicar el código promocional:
  • importe del descuento para el código promocional
  • precio tachado sin descuento
  • precio con descuento
  • artículos de bonificación
  • Valor Gratis en la línea de precios de los artículos con bonificación

Cómo conseguirlo

Establecer campaña de descuentos

• a través de Cuenta del editor
• o a través de Métodos API

Configurar a través de la Cuenta del editor

• Establecer un descuento con el valor porcentual entero.
• Configurar promociones de descuento que estén disponibles durante un tiempo limitado.
• Establecer descuentos que se apliquen a uno o varios paquetes de claves del juego para plataformas específicas.

Las siguientes acciones no están disponibles actualmente en Cuenta del editor:

• Establezca descuentos con valores fraccionarios.
• Establezca descuentos con un periodo de tiempo ilimitado.
• Edite promociones de descuento con un estado Active.

1. Vaya a Store > Promotions and rewards y haga clic en Create promotion (Crear promoción) en Cuenta del editor.

2. Especifique los parámetros necesarios:
   1. Introduzca el título de la promoción.
   2. Elija Discount como promotion type.
   3. Decida el importe del descuento.
   4. Elija el tipo de producto.

• 5. Elija uno o varios artículos que tendrán descuento.

3. Haga clic en Next.
4. Puede limitar el número de veces que un usuario puede utilizar la promoción. Para establecerlo, en la página Condition and limit, establezca Limit number of times one user can use promotion en On y especifique el límite.
5. Para configurar promociones personalizadas, establezca Promotion for only specific users en On y siga estas instrucciones.
6. Haga clic en Next.

7. Establezca las fechas de inicio y fin de la campaña.
8. Haga clic en Next.

9. Haga clic en Save and Exit.

12. Para activar una promoción:
    1. Encuentre la promoción en su catálogo de promociones.
    2. Haga clic en el botón ••• del menú y seleccione Edit promotion.

• 3. En la esquina superior derecha, abra el menú desplegable y elija Activate promotion.

Configuración mediante métodos API

Para trabajar con promociones con descuento, puede utilizar los métodos de la subsección Discount del grupo de métodos Promociones.

Para crear la promoción a través de los métodos API:

1. Llame al método Create discount promotion for item con los parámetros requeridos.
2. Llame al método Update item promotion con el parámetro “is_enabled”:true para activar la promoción.

Para editar la promoción a través de una API, llame al método Update item promotion con nuevos parámetros de promoción. También puede editar la promoción que tiene el estado Active.

Al crear o editar una promoción de descuento a través de los métodos API, también puede:

• Configurar un descuento a todos los artículos del proyecto. Transmita el parámetro “items”:null a los métodos Create discount promotion for item o Update item promotion.

"items": null

• Configure un descuento para bienes físicos. Transmita una matriz con códigos de artículo (SKU) de bienes físicos a los métodos Create discount promotion for item o Update item promotion.

"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]

• Configure un descuento con la fracción del valor porcentual. Transmita el parámetro discount.percent con una fracción de descuento a los métodos Create discount promotion for item o Update item promotion.

"discount": {
    “percent”: ”49.9”
}

• Configure un descuento para artículos de diferentes tipos. Transmita una matriz con códigos de artículo (SKU) de bienes físicos a los métodos Create discount promotion for item o Update item promotion.

"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]

• Configure un descuento para determinados DRM. Transmita una matriz con códigos de artículo (SKU) de los DRM requeridos a los métodos Create discount promotion for item o Update item promotion.

"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]

• Configure una promoción de descuento que no tenga un periodo de tiempo especificado. Transmita el parámetro “date_end”:null a los métodos Create discount promotion for item o Update item promotion.

“date_end”: null

• Establezca una promoción para los primeros compradores. Para ello, transmita en el método Create discount promotion for item para la API del artículo o en la API Update item promotion un objeto en la matriz attribute_conditions:

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}

Personalizar las condiciones de una promoción con descuento

• un descuento que se aplica a un importe total definido de una cesta
• un descuento que se aplica solo si la cesta tiene suficientes artículos
• un descuento en un artículo si se compra también otro artículo