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. Pulse en Store en el menú lateral y vaya a Promotions and rewards.

3. Haz clic en Create promotion.

4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Coupons como el 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 los lotes y los artículos de duración limitada).
6. Agregue:
   1. identificador promocional en el ID externo.
   2. Artículos de bonificación que el usuario recibe cuando canjea un cupón.
   3. Tipo y cantidad del artículo.
7. Pulse 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 fin de la campaña.
10. Haga clic en Next.

11. Haga clic en Save and Exit.

12. Haga clic en Store en el menú lateral y vaya a Promotions and rewards.
13. Seleccione la promoción, haga clic en el botón de menú "•••" para abrir un menú y haga clic en Edit promotion.

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 Canjear código del cupón para utilizar un cupón. Dependiendo del valor del parámetro is_selectable presente en la respuesta del método Obtener recompensas en forma de cupones, hay 2 flujos posibles:

1. Si es is_selectable=true, debe transmitir el objeto selected_unit_items en el siguiente formato al llamar al método Canjear código del cupón:

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 Obtener recompensas en forma de cupones 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 solamente 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. Pulse en Store en el menú lateral y vaya a Promotions and rewards.

3. Haz clic en Create promotion.

4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Promo code como el 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 de los anteriores.
6. Establezca el importe del descuento.
7. Haga clic en Next.

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 fin de la campaña.
11. Haga clic en Next.

12. Haga clic en Save and Exit.

13. Haga clic en Store en el menú lateral y vaya a Promotions and rewards.
14. Seleccione la promoción, haga clic en el botón de menú "•••" para abrir un menú y haga clic en Edit promotion.

15. Vaya a la pestaña Codes.
16. Especifique cómo se generan los cupones.
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 Canjear código promocional para utilizar un cupón. En función del valor del parámetro is_selectable presente en la respuesta del método Obtener recompensa de código promocional, hay 2 flujos posibles:

1. Si es is_selectable=true, debe transmitir el objeto selected_unit_items en el siguiente formato al llamar al método Canjear código promocional:

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 Obtener recompensa de código promocional 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 es 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 solamente 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 en el menú lateral y vaya a Promotions and rewards.

3. Haz clic en Create promotion.

4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Bonus como el tipo de promoción.
5. Elija los artículos promocionales.

6. Elija los artículos que se conceden a los usuarios cuando compran artículos promocionales.
7. Haga clic en Next.

8. Si quiere que la promoción se aplique únicamente a los usuarios que realicen su primera compra, establezca el conmutador 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 activarán automáticamente, y se generará un conjunto de condiciones para que se active la promoción. Agregue condiciones adicionales si es necesario.
9. Haga clic en Next.

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

12. Haga clic en Save and Exit.

13. Haga clic en Store en el menú lateral y vaya a Promotions and rewards.
14. Seleccione la promoción, haga clic en el botón de menú "•••" para abrir un menú y haga clic en Edit promotion.

15. 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 and rewards > Create promotion.

4. Especifique los siguientes parámetros:
   1. Introduzca el título de la promoción.
   2. Elija Discount como el tipo de promoción.
5. Establezca descuentos que puedan aplicarse uno o varios artículos.
6. Establezca el importe del descuento.
7. Haga clic en Next.

8. Si quiere que la promoción se aplique únicamente a los usuarios que realicen su primera compra, establezca el conmutador 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 activarán automáticamente, y se generará un conjunto de condiciones para que se active la promoción. Agregue condiciones adicionales si es necesario.
9. Haga clic en Next.

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

12. Haga clic en Save and Exit.

13. Haga clic en Store en el menú lateral y vaya a Promotions and rewards.
14. Seleccione la promoción, haga clic en el botón de menú ••• para abrir un menú y haga clic en Edit promotion.

15. Active la promoción.

Configuración mediante métodos API

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

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

1. Llame al método Crear promoción de descuento para un artículo con los parámetros requeridos.
2. Llame al método Actualizar la promoción del artículo 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 Actualizar la promoción del artículo 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 Crear promoción de descuento para un artículo o Actualizar la promoción del artículo.

"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 Crear promoción de descuento para un artículo o Actualizar la promoción del artículo.

"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 Crear promoción de descuento para un artículo o Actualizar la promoción del artículo.

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

• Configure un descuento para artículos de diferentes tipos. Transmita una matriz con códigos de artículo (SKU) de los artículos requeridos a los métodos Crear promoción de descuento para un artículo o Actualizar la promoción del artículo.

"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 Crear promoción de descuento para un artículo o Actualizar la promoción del artículo.

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

• Configure una promoción de descuento que no tenga un periodo especificado. Transmita el parámetro “date_end”:null al método Crear promoción de descuento para un artículo o Actualizar la promoción del artículo.

“date_end”: null

• Establezca una promoción para los primeros compradores. Para ello, transmita en el método Crear promoción de descuento para un artículo para la API del artículo o en la API Actualizar la promoción del artículo un objeto en la matriz attribute_conditions:

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