Códigos promocionales

Cómo funciona

Los códigos promocionales son una herramienta de marketing para atraer a nuevos usuarios y aumentar las ventas. Tras activar un código promocional, el usuario recibe una de las siguientes opciones de recompensa:

• un descuento que se aplica a la cesta del usuario o a artículos específicos
• uno de los artículos de bonificación:
  • clave del juego
  • paquete de moneda virtual
  • artículo virtual que incluye un lote o artículos de duración limitada.

Características principales:

• elegir solo un descuento, solo un artículo de bonificación, o tanto un descuento como un artículo como recompensa
• establecer el número total de canjes del código promocional durante la campaña
• establecer el número de canjes del código promocional para un usuario durante la campaña
• establecer restricciones regionales en la solicitud
• generación múltiple de códigos promocionales
• añadir un artículo de bonificación a la cesta después de aplicar el código promocional
• aplicar un descuento a los artículos después de usar un código promocional.

Restricciones:

• solo se puede aplicar un código promocional a la cesta
• para obtener un descuento o bonificación, el usuario debe pagar los artículos de la cesta
• si un código promocional incluye un artículo con restricciones regionales de venta, un usuario de una región en la que estos artículos estén limitados no podrá recibir artículos usando este código promocional.

Cómo funciona

Flujo del usuario:

1. El usuario introduce el código promocional en el campo correspondiente de la interfaz de usuario.

2. Se recalcula el coste de los artículos y se añaden artículos de bonificación.
3. El usuario realiza un pago, tras lo cual el código promocional se considera canjeado.
4. Si el código promocional incluía algunos artículos de bonificación, se entregan al usuario de una de las siguientes formas:
• directamente al inventario (artículo virtual o un paquete de moneda virtual)
• por correo electrónico (una clave del juego)
• directamente al sistema de asignación de derechos (una clavel de juego)

• 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

Requisitos previos

1. Cree su Cuenta del editor de Xsolla.
2. Conecte el módulo Game Keys (Claves del juego) y configúrelo.

Flujo de integración

• Establecer una campaña promocional con códigos promocionales.
• Implementar el método de obtención de una recompensa de código promocional.
• Implementar los métodos de canje del código promocional.

Si está implementando una compra rápida de una clave utilizando el método Create order with specified item, el usuario procede al pago sin ir a la cesta.

Al mismo tiempo, se crea una cesta en el lado de Xsolla, la cual no se muestra al usuario. Esto es necesario para aplicar correctamente todos los descuentos existentes a la compra del usuario y para mostrar el importe incluyendo todos los descuentos en el formulario de pago.

Configurar una campaña con códigos promocionales

1. Vaya a Store > Promotions and rewards en Cuenta del editor y cree una promoción.
2. Especifique los siguientes parámetros:
1. Introduzca el nombre de la promoción.
2. Elija Promo codes como tipo de promoción.
3. Cree un ID externo - un identificador de promoción único utilizado para gestionar promociones mediante los métodos receiving rewards (recibir recompensas) y redeeming promo code (canjear código promocional).
4. Especifique el porcentaje de descuento para el código promocional. El descuento puede aplicarse a toda la cesta o a artículos específicos.
5. Elija los artículos de bonificación que recibe el usuario cuando canjea un código promocional:
• sin recompensa
• paquete de moneda virtual
• artículo virtual (uno o más, incluidos lotes y artículos de duración limitada)
• clave del juego
6. Especifique el número total de canjes y el número de canjes por usuario.
7. Especifique la duración de la campaña.
8. Compruebe los ajustes y guarde la promoción.
9. Vaya al menú de edición de la promoción.
10. En la pestaña Codes, elija cómo se generan los códigos promocionales.
11. Genere el código promocional o introdúzcalo manualmente.
12. Guarde los cambios.
13. Active la promoción.

Código promocional con un paquete de moneda virtual

Para crear un código promocional con un paquete de moneda virtual:

1. Cree un paquete de moneda virtual.
2. Especifique un paquete de moneda virtual como artículo de bonificación.

Para crear un paquete de moneda virtual:

1. Vaya a los ajustes del módulo Store > Virtual Currency y cree una moneda virtual. Para ello, haga clic en New virtual currency y añada:
   • imagen del paquete (opcional)
   • código (SKU) de la moneda virtual
   • nombre de la moneda virtual
   • precio de una unidad de moneda virtual
   • moneda por defecto
   • atributo (opcional).
2. Cree los paquetes de moneda virtual. Para ello, haga clic en Nuevo paquete y añada:
   • imagen del paquete (opcional)
   • SKU del paquete
   • nombre para el paquete
   • breve descripción del paquete
   • moneda virtual para un paquete
   • cantidad de moneda en el paquete
   • precios en moneda real o (y) virtual
   • moneda por defecto
   • atributo (opcional).
3. Haga clic en Create package.

Código promocional con un artículo virtual

Para crear un código promocional con un artículo virtual:

1. Cree un artículo virtual.
2. Especifique un artículo virtual como artículo de bonificación.

Para crear artículos virtuales

1. Vaya a los ajustes del módulo Store > Virtual Items y haga clic en Create Item.
2. Para cada artículo añada:
   • imagen (opcional)
   • código de artículo (SKU)
   • uno o varios grupos a los que debería pertenecer el artículo (opcional)
   • nombre del artículo
   • descripción del artículo
   • propiedad del artículo: artículos consumibles, no consumibles o de duración limitada
   • precios en moneda real o/y virtual.
3. Haga clic en Create item.

Código promocional con una clave del juego

1. Cree un paquete de claves del juego.

2. Especifique el código de artículo (SKU) del paquete de claves de juego creado como una bonificación y el método de elección de la plataforma para la que se compra el juego:

   • El código promocional se genera para la plataforma específica ya establecida.
   • El usuario selecciona una plataforma específica cuando utiliza códigos promocionales.

Generación de códigos promocionales

• String (cadena) introducida manualmente: adecuada para una campaña con un solo código promocional que se puede utilizar muchas veces (el máximo son 128 caracteres).
• String generada: sucesión de números y caracteres latinos (10 caracteres). Es adecuada para campañas con muchos códigos promocionales.

Restricciones regionales

Obtener recompensas de códigos promocionales

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.

Canjear un código promocional

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.