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.

  1. Se recalcula el coste de los artículos y se añaden artículos de bonificación.
  2. El usuario realiza un pago, tras lo cual el código promocional se considera canjeado.
  3. 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)
Aviso

Puede establecer diferentes tipos de promociones para un juego o lista de juegos: descuentos, cupones, códigos promocionales y bonificaciones.

Si se admiten varias promociones para un juego o lista de juegos en el momento de la compra, los descuentos se aplican al artículo de uno en uno. El orden de aplicación de los descuentos no importa.

Por ejemplo:

El precio de una clave del juego es de 10 $. En Cuenta del editor, se han creado las siguientes promociones para las claves del juego: promoción de descuento de

  • Black Friday con un descuento del 10 % del 4 al 30 de noviembre
  • Oferta promoción con descuento del 20 % del 15 de noviembre al 15 de diciembre
  • Promoción con un código promocional para un descuento del 5 % del 4 al 30 de noviembre

Si la clave del juego se compra el 20 de noviembre, se admiten tanto las promociones con descuento como las promociones con código promocional.

El coste total de la clave del juego se calcula entonces como ((10 $ - 10 %) - 20 %) - 5 % y el coste final será de 6,84 $.

Al crear un pedido, el usuario puede canjear un código promocional y ver la 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

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

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 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 y redeeming promo code.
  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:
  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.
Nota
Tras crear un artículo virtual, una moneda virtual o un paquete de moneda virtual, puede establecer los estados para determinar si el artículo está disponible, no disponible o parcialmente disponible.

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.
Nota
Tras crear un artículo virtual, una moneda virtual o un paquete de moneda virtual, puede establecer los estados para determinar si el artículo está disponible, no disponible o parcialmente disponible.
Puede elegir uno o varios artículos con diferentes códigos de artículo (SKU) para un código promocional, incluidos los lotes y los artículos de duración limitada.

Código promocional con una clave del juego

Para crear un 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.

Puede elegir varias claves con diferentes códigos de artículo (SKU) para un mismo código promocional.

Generación de códigos promocionales

Una campaña puede incluir uno o varios códigos promocionales. El formato del código promocional tiene 2 opciones:
  • 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.
Puede generar códigos promocionales en el editor de promociones después de crear una promoción de códigos promocionales. Puede generar códigos promocionales varias veces. La carga de los códigos introducidos manualmente se realiza previa solicitud enviando un correo electrónico a Xsolla.
Nota
El código del código promocional distingue entre mayúsculas y minúsculas. Por ejemplo, winter2021 y WINTER2021 son 2 códigos promocionales diferentes.

Restricciones regionales

Las restricciones regionales se aplican a toda la campaña de promoción. Las restricciones regionales se aplican previa solicitud por correo electrónico a Xsolla.

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.
Ejemplo de la respuesta:
Copy
Full screen
Small screen
{
	"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
  1. Si is_selectable=false, no debe introducir parámetros adicionales en la solicitud.

Canjear un código promocional

Implemente la llamada del método Redeem promo code para utilizar un código promocional. En función del valor del parámetro is_selectable hay 2 flujos posibles en la respuesta del método Get promo code rewards:
  1. Si is_selectable=true, debe transmitir el objeto selected_unit_items en el siguiente formato al llamar al método Redeem promo code:
Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Ejemplo de la respuesta:

Copy
Full screen
Small screen
{
  {
    "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
    }
    ]
}
  1. Si is_selectable=false, no debe introducir parámetros adicionales en la solicitud.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Valore esta página
Valore esta página
¿Hay algo en lo que podamos mejorar?

Prefiero no responder

¡Gracias por tu mensaje!
Última actualización: 22 de Enero de 2024

¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!