Cupones

Cómo funciona

Las promociones de cupones son una herramienta de marketing para conseguir nuevos usuarios y aumentar las ventas. El jugador que utiliza un cupón obtiene una recompensa que está asociada a este. La recompensa puede incluir:

• paquete de moneda virtual
• clave del juego
• artículo virtual

Cada cupón tiene un código. Para utilizar un cupón, el usuario introduce su código en el juego, en el sitio web o en la aplicación móvil.

Características principales:

• Defina el número general de canjes de cupones para una campaña.
• Determine el número de canjes de cupones para un usuario en una campaña.
• Genere códigos para cupones varias veces.
• Aplique restricciones regionales de venta para promociones y artículos que estén vinculados a un cupón.

Restricciones:

• Si vincula claves del juego a un cupón, se enviará una de ellas por correo electrónico al jugador que canjee el cupón. Si no quedan claves en la campaña, se rechazará la solicitud del jugador para utilizar un cupón.
• Si el cupón incluye una promoción con restricciones regionales, el usuario de una región restringida no podrá canjearlo.
• Si el cupón incluye un artículo con restricciones regionales de venta, el usuario de una región restringida no podrá obtener los artículos vinculados a este cupón.

Flujo del usuario:

1. Un usuario canjea un cupón.
2. La recompensa que está vinculada a un cupón se entrega al usuario de una de las siguientes maneras:
   • directamente al inventario (artículo virtual o un paquete de moneda virtual)
   • mediante correo electrónico (una clave del juego)
   • directamente al sistema de asignación de derechos (una clave del juego)

Cómo conseguirlo

Requisitos previos

1. Cree su Cuenta del editor de Xsolla.
2. Conecte la Tienda a su proyecto.

Flujo de integración

1. Configure una campaña promocional con cupones.
2. Utilice los métodos de obtención de una recompensa de cupón.
3. Utilice los métodos de canje de cupón mediante código.

Configurar una campaña con cupones

1. Vaya a Store > Promotions and rewards en Cuenta del editor y cree una promoción.
2. Especifique los parámetros necesarios:
   1. Introduzca el título de la promoción.
   2. Elija Coupons como tipo de promoción.
3. Elija el artículo de bonificación que recibe el usuario al canjear un cupón:
   1. Paquete de moneda virtual.
   2. Clave del juego.
   3. Artículo virtual (uno o varios, incluidos los lotes y artículos de duración limitada).
4. Decida el número total de canjes y el número de canjes por usuario.
5. Configure las fechas de inicio y fin de la campaña.
6. Compruebe la configuración y guarde la promoción.
7. Vaya al menú de edición de la promoción.
8. En el menú Codes, elija el método de generación de cupones.
9. Genere el código del cupón o introdúzcalo manualmente.
10. Guarde los cambios.
11. Active la promoción.

Cupón con un paquete de moneda virtual

1. Vaya a los ajustes del módulo Virtual currency y especifique los siguientes parámetros:
   • Imagen
   • SKU
   • Nombre de la moneda
   • Precio de una unidad de moneda virtual
   • Moneda por defecto
2. Cree un número exigido de paquetes de moneda y especifique los siguientes parámetros para cada uno de ellos:
   • Imagen
   • SKU
   • Nombre
   • Descripción
   • Moneda utilizada
   • Cantidad de moneda en un paquete
   • Precio
   • Moneda por defecto
3. Active la visualización de paquetes de moneda en la Tienda.

Cupón con una clave del juego

• Generar cupones para la DRM ya establecida. El parámetro se establece al generar cupones.
• Elija una DRM cuando utilice un cupón.

Cupón con artículos virtuales

Generar cupones

1. Cadena introducida manualmente: adecuada para una campaña con un solo cupón que se puede utilizar muchas veces (el máximo son 128 caracteres).
2. Cadena generada: sucesión de números y caracteres latinos (10 caracteres). Es adecuada para campañas con muchos cupones.

Restricciones regionales

Obtener recompensas en forma de cupones

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.

Canjear un cupón mediante código

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.