Establecer campañas de promoción

Después de integrar la tienda en el juego, puede establecer cupones, códigos promocionales, bonificaciones o promociones con descuento para atraer a nuevos usuarios y aumentar las ventas.

También puede lanzar promociones personalizadas; es decir, establecer campañas para usuarios concretos. Puede establecer el número de artículos disponibles para el usuario en la promoción. Esto solo es posible para campañas promocionales con descuentos y campañas promocionales con bonificaciones.

Si ya se ha integrado con el producto Login, haga lo siguiente antes de configurar promociones personalizadas para los usuarios:

1. Establezca los atributos de usuario para su proyecto.
2. Establezca el esquema de atributos de usuario en la sección de Login.

Los atributos son características del usuario que se almacenan como pares clave-valor. Con la ayuda de los atributos puede:

• segmentar a los usuarios
• preparar escaparates personalizados para cada grupo de usuarios en su Web Shop.

Para garantizar la integridad de los datos transmitidos, puede establecer reglas de validación de atributos en formato esquema JSON en Cuenta del editor y gestionar los atributos de usuario mediante los métodos de Login API o con webhooks. También puede editar los valores de los atributos en su Cuenta del editor. Para obtener más información, consulte Cómo configurar los atributos de usuario.

Los cupones tienen códigos que otorgan artículos gratuitos sin necesidad de realizar ninguna compra o crear una cesta de la compra. Para utilizar un cupón, el usuario debe introducir el código en el juego, el sitio web o la aplicación móvil. La recompensa vinculada se entrega entonces al inventario del usuario. Las recompensas pueden incluir:

• paquete de moneda virtual
• artículo virtual

Los códigos promocionales aplican un descuento a la cesta de la compra o añaden artículos gratuitos a la misma durante el proceso de pago. Tras activar el código promocional y pagar los artículos de la cesta, el usuario puede recibir una de las siguientes recompensas:

• un descuento que se aplica a la cesta del usuario
• artículos de bonificación:
• paquete de moneda virtual
• artículo virtual incluido un lote o artículos de duración limitada

Los usuarios también pueden recibir una bonificación al comprar artículos promocionales. Las bonificaciones pueden incluir:

• paquete de moneda virtual
• artículo virtual incluyendo un lote o artículos de duración limitada.

Una promoción de descuento le permite establecer un descuento en uno o más productos. Se puede aplicar un número ilimitado de promociones a un producto. Los descuentos no son acumulativos, sino que se aplican al precio de cada artículo. Los descuentos pueden aplicarse a uno o varios de los siguientes artículos:

• paquete de moneda virtual
• artículo virtual incluidos los artículos de duración limitada

Campaña promocional con cupones

Para iniciar una campaña promocional con cupones:

1. Establecer una campaña promocional con cupones.
2. Utilizar los métodos de canje de cupones mediante código.
3. Utilizar los métodos de obtención de una recompensa en forma de cupones.

Establezca una campaña promocional con cupones

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Store en el menú lateral y vaya a Promotions.
3. Haga clic en Create promotion.
4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Coupons como tipo de promoción.
5. Elija la recompensa que recibe el usuario cuando canjea un cupón. Opciones disponibles:
   • Paquete de moneda virtual
   • Artículo virtual (uno o varios, incluidos lotes y artículos de duración limitada).
6. Añada:
   1. Identificador de la promoción en ID externo.
   2. Artículos de bonificación que el usuario recibe cuando canjea un cupón.
   3. Tipo e importe del artículo.
7. Haga clic en Next.
8. Especifique el número total de canjes y el número de canjes por usuario.
9. Establezca las fechas de inicio y finalización de la campaña.
10. Haga clic en Next.
11. Compruebe la configuración y haga clic en Save and exit.

12. Haga clic en Store en el menú lateral y vaya a Promotions.
13. Seleccione la promoción, haga clic en el botón de menú ••• para abrir un menú y haga clic en Edit plan.
14. Vaya a la pestaña Codes.
15. Especifique cómo se generan los cupones.
16. Genere el código del cupón o introdúzcalo manualmente.
17. Active la promoción.

Canjear un cupón mediante código

Implemente la llamada del método Redeem coupon code para utilizar un cupón. Dependiendo del valor del parámetro is_selectable presente en la respuesta del método Get coupon rewards, hay 2 flujos posibles:

1. Si is_selectable=true, debe transmitir el objeto selected_unit_items en el siguiente formato al llamar al método Redeem coupon code:

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

Ejemplo de la respuesta:

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

2. Si is_selectable=false, no debe introducir parámetros adicionales en la solicitud.

Obtener recompensas en forma de cupones

Implemente la llamada al método Get coupon rewards para obtener la lista de artículos que recibe el usuario tras canjear un cupón. Dependiendo del valor del parámetro is_selectable en la respuesta, existen 2 posibles flujos:

1. Si el valor is_selectable=true, se debe mostrar el formulario para elegir elementos del objeto unit_items por cada item con un elemento type=unit. En este formulario, el usuario elige sólo un elemento por cada tipo de unit.

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

2. Si is_selectable=false, no debe introducir parámetros adicionales en la solicitud.

Campaña promocional con códigos promocionales

Para iniciar una campaña promocional con códigos promocionales:

1. Esatblezca una campaña promocional con códigos promocionales.
2. Implemente los métodos de canje de códigos promocionales.
3. Implemente el método de obtención de una recompensa en forma de código promocional.

Establecer una campaña promocional con códigos promocionales

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Store en el menú lateral y vaya a Promotions.
3. Haga clic en Create promotion.
4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Promo code como tipo de promoción.
5. Elija qué recibe el usuario cuando canjea un código promocional: ninguna recompensa, descuento en todos los artículos de la cesta, descuento en artículos específicos, artículos de bonificación o una combinación.
6. Establezca el importe del descuento.
7. Haga clic en Siguiente.
8. Especifique el número total de canjes y el número de canjes por usuario.
9. Haga clic en Next.
10. Establezca las fechas de inicio y finalización de la campaña.
11. Haga clic en Next.
12. Compruebe la configuración y haga clic en Save and exit.

13. Haga clic en Store en el menú lateral y vaya a Promotions.
14. Seleccione la promoción, haga clic en el botón de menú ••• para abrir un menú y haga clic en Edit plan.
15. Vaya a la pestaña Codes.
16. Especifique cómo se generan los códigos promocionales.
17. Genere el código promocional o introdúzcalo manualmente.
18. Active la promoción.

Canjear un código promocional

Implemente la llamada del método Redeem promo code para utilizar un cupón. En función del valor del parámetro is_selectable presente en la respuesta del método Get promo code rewards, hay 2 flujos posibles:

1. Si is_selectable=true, debe transmitir el objeto selected_unit_items en el siguiente formato al llamar al método Redeem promo code:

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

Ejemplo de la respuesta:

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

2. Si is_selectable=false, no debe introducir parámetros adicionales en la solicitud.

Obtener recompensas de códigos promocionales

Implemente la llamada al método Get promo code rewards para obtener la lista de artículos que recibe el usuario tras canjear un código promocional. Dependiendo del valor del parámetro is_selectable en la respuesta, existen 2 posibles flujos:

1. Si el valor is_selectable=true, se debe mostrar el formulario para elegir elementos del objeto unit_items por cada item con un elemento type=unit. En este formulario, el usuario elige sólo un elemento por cada tipo de unit.

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

2. Si is_selectable=false, no debe introducir parámetros adicionales en la solicitud.

Campaña promocional con bonificaciones

Para iniciar una campaña promocional con una bonificación:

1. Abra su proyecto en Cuenta del editor.
2. Haga clic en Store (Tienda) en el menú lateral y vaya a Promotions.
3. Haga clic en Create promotion.
4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Bonus como tipo de promoción.
5. Elija los artículos promocionales.
6. Elija los artículos que se ofrecen a los usuarios cuando compran artículos promocionales.
7. Haga clic en Next.
8. Si desea que la promoción se aplique solo a los usuarios que realizan su primera compra, establezca la opción Trigger promotion only for first-time buyers en la posición On. Los conmutadores Limit number of times one user can use promotion y Promotion for only specific users se habilitarán automáticamente, y se creará un conjunto de condiciones para activar la promoción. Añada condiciones adicionales si es necesario.
9. Si desea establecer la disponibilidad de una promoción para usuarios específicos,establezca el conmutador Limit number of times one user can use promotion como On y especifique el número.
10. Haga clic en Next.
11. Establezca las fechas de inicio y finalización de la campaña.
12. Haga clic en Next.
13. Compruebe la configuración y haga clic en Save and exit.

15. Haga clic en Store en el menú lateral y vaya a Promotions.
16. Seleccione la promoción, haga clic en el botón de menú "•••" para abrir un menú y haga clic en Edit plan.
17. Active la promoción.

Campaña promocional con descuentos

Establezca una campaña promocional con descuentos mediante Cuenta del editor

1. Abra su proyecto en Cuenta del editor.
2. En la barra lateral, haga clic en Store.
3. Haga clic en Promotions > Create promotion.
4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Discount como tipo de promoción.
5. Establezca descuentos que se apliquen a uno o varios artículos.
6. Establezca el importe del descuento.
7. Haga clic en Next.
8. Si desea que la promoción se aplique solamente a los usuarios que hagan su primera compra, establezca la opción Trigger promotion only for first-time buyers en On. Los conmutadores Limit number of times one user can use promotion y Promotion for only specific users se activarán automáticamente, y se creará un conjunto de condiciones para activar la promoción. Agregue condiciones adicionales si es necesario.
9. Si desea establecer la promoción para usuarios específicos, cambie la opción Trigger promotion only for specific users a On y especifique la(s) condición(es).
10. Si desea limitar la disponibilidad de una promoción a usuarios específicos, cambie la opción Limit number of times one user can use promotion a On y especifique el número.
11. Haga clic en Next.
12. Establezca las fechas de inicio y finalización de la campaña.
13. Haga clic en Next.
14. Compruebe la configuración y haga clic en Save and exit.

15. Haga clic en Store en el menú lateral y vaya a Promotions.
16. Seleccione la promoción, haga clic en el botón de menú ••• para abrir un menú y haga clic en Edit plan.
17. Active la promoción.

Establecer una campaña promocional con descuentos vía 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.

• 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.

• 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.

• 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.

• 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.

• 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.