In-Game Store / Establecer campañas de promoción

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.

Aviso
Solamente puede utilizar un catálogo personalizado con el producto Login.

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:

Consulte la sección Cupones para obtener más información sobre los cupones.

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:

Consulte la sección de Códigos promocionales para obtener más información sobre los códigos promocionales.

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

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:

Consulte la sección Promociones con descuento para obtener más información sobre los descuentos.

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.

Nota
Las restricciones regionales se aplican a toda la campaña de promoción. Puede enviar un correo electrónico a Xsolla para aplicar las restricciones regionales.

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.
  1. Haz clic en Crear promoción.
  1. Especifique los siguientes parámetros:
    1. Introduzca el título de la promoción.
    2. Elija Coupons como el tipo de promoción.
  2. Elija la recompensa que recibe el usuario cuando canjea un cupón. Opciones disponibles:
  3. 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.
  4. Pulse en Next.
  1. Especifique el número total de canjes y el número de canjes por usuario.
  1. Establezca las fechas de inicio y fin de la campaña.
  2. Haga clic en Next.

  1. Haga clic en Save and Exit.

Nota
Mientras una promoción esté activa, no podrá modificarla.

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

  1. Vaya a la pestaña Codes.
  2. Especifique cómo se generan los cupones.
  1. Genere el código del cupón o introdúzcalo manualmente.
  2. Active la promoción.

Canjear un cupón mediante código

Nota
Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:

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:

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.

Obtener recompensas en forma de cupones

Nota
Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:

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.
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_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
  1. 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.

  1. Haz clic en Crear promoción.

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

  1. Especifique el número total de canjes y el número de canjes por usuario.
  2. Haga clic en Next.

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

  1. Haga clic en Save and Exit.

Nota
Mientras una promoción esté activa, no podrá modificarla.
  1. Haga clic en Store en el menú lateral y vaya a Promotions and rewards.
  2. Seleccione la promoción, haga clic en el botón de menú "•••" para abrir un menú y haga clic en Edit promotion.
  1. Vaya a la pestaña Codes.
  2. Especifique cómo se generan los cupones.
  3. Genere el código promocional o introdúzcalo manualmente.
  1. Active la promoción.

Canjear un código promocional

Nota
Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:

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:

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.

Obtener recompensas de códigos promocionales

Nota
Para llamar a la API de Xsolla, puede utilizar los métodos del SDK prediseñados para motores y plataformas de juegos:

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.

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.

  1. Haz clic en Crear promoción.

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

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

  1. 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.
  2. Haga clic en Next.

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

  1. Haga clic en Save and Exit.

Nota
Mientras una promoción esté activa, no podrá modificarla.

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

  1. Active la promoción.

Campaña promocional con descuentos

Nota
No se pueden aplicar restricciones regionales a las promociones con descuento.

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

Para iniciar una campaña promocional:
  1. Abra su proyecto en Cuenta del editor.
  2. En la barra lateral, haga clic en Store.

  1. Haga clic en Promotions and rewards > Create promotion.

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

  1. 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.
  2. Haga clic en Next.

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

  1. Haga clic en Save and Exit.

Nota
Mientras una promoción esté activa, no podrá modificarla.

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

  1. 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:

Tu progreso
¡Gracias por tu mensaje!
Última actualización: 3 de Junio 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!