Códigos promocionales
Cómo funciona
Las promociones con códigos promocionales permiten que los usuarios compren artículos a precios reducidos y reciban artículos de bonificación en función de la configuración de la campaña. El campo de entrada del código promocional puede aparecer en el catálogo o en la cesta.
La principal diferencia es que los códigos promocionales se canjean durante una compra, mientras que los cupones se canjean independientemente, sin necesidad de realizar ninguna compra.
- un descuento que se aplica a toda la compra o a artículos específicos
un artículo de bonificación:
- clave de juego
- paquete de monedas virtuales
- artículo virtual que incluye un paquete o artículos de duración limitada
Funciones principales:
- ofrecer como recompensa por un código promocional un descuento, un artículo de bonificación o ambos
- limitar el número total de canjes del código promocional de la campaña
- limitar el número de canjes de códigos promocionales de la campaña para un usuario
- generar varios códigos promocionales
- establecer restricciones regionales si se solicita
- 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 al utilizar 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 tiene que pagar los artículos de la cesta.
- Si un código promocional incluye un artículo con restricciones de venta regionales, los usuarios de las regiones en las que estos artículos no estén disponibles no podrán recibirlos.
Ejemplo: se ofrecen un escudo y una espada como bonificación con el código promocional. El escudo tiene una restricción regional y solo se puede comprar en EE. UU. Si un usuario de fuera de EE. UU. introduce el código promocional, aparecerá un error en la respuesta a los métodos Verificar código de promoción o Canjear código promocional. El usuario no podrá obtener ninguno de los artículos del código promocional.
Flujo de integración
Los escenarios descritos a continuación corresponden a los usuarios autorizados.
Para los usuarios no autorizados, siempre se muestra el número máximo de veces que se puede utilizar una promoción. Para mostrar al usuario los usos que quedan (sujeto al límite actual), se deben pasar los datos de autorización del usuario al solicitar el catálogo de artículos mediante los métodos del apartado Catálogo en el grupo del método Artículos y monedas virtuales.
Puede configurar diferentes tipos de promociones para un artículo: descuentos, cupones, códigos promocionales y bonificaciones.
Si se admiten varias promociones para un artículo 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 un artículo virtual es de 10 $. En Cuenta del editor, se han creado las siguientes promociones para los artículos virtuales: promoción de descuento de
- Black Friday con un descuento del 10 % del 4 al 30 de noviembre
- Promoción de descuento de Oferta con un 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 el artículo se compra el 20 de noviembre, se admiten tanto las promociones con descuento como las promociones con código promocional.
El coste total del artículo virtual se calcula entonces como ((10 $ - 10 %) - 20 %) - 5 % y el coste final será de 6,84 $.
Cómo conseguirlo
Requisitos previos
- Registrarse en la Cuenta del editor.
- Conectar Store y configurar módulos de Artículos virtuales y Monedas virtuales.
Establecer una promoción con un código promocional
Puedes establecer promociones de códigos promocionales de una de las siguientes formas:
Con cualquier opción, para establecer una promoción, es necesario realizar solicitudes a métodos API para comprobar la validez del código promocional y canjear el código promocional.
Configurar a través de la Cuenta del editor
Si estableces promociones de códigos promocionales a través de la Cuenta del editor, puedes:
- establecer el periodo de validez de la promoción
- limitar las veces que el usuario puede utilizar la promoción
- establecer promociones que valen para cualquier tipo de artículo:
- paquetes de monedas virtuales
- artículos virtuales (incluidos los artículos de duración limitada)
- claves de juego
- paquetes
No es posible editar promociones de código promocional con el estado Activo en la Cuenta del editor.
Puedes utilizar métodos API para mejorar las opciones de configuración de tus promociones de códigos promocionales.
- Abra su proyecto en Cuenta del editor.
- En el menú lateral, haga clic en Store y abra la sección Promotions and rewards.
- Haz clic en Create promotion.
- Especifica los siguientes parámetros:
- Introduce el nombre de la promoción.
- Elige Códigos promocionales como el tipo de promoción.
- Crea un ID externo (un identificador único de la promoción que se utiliza para gestionar promociones a través de métodos API).
- Especifica el porcentaje de descuento del código promocional. El descuento se puede aplicar a toda la compra o a artículos específicos.
- Elige los artículos de bonificación que recibe el usuario al canjear un código promocional:
- sin recompensa
- paquete de monedas virtuales
- artículo virtual (uno o varios, incluidos los paquetes y artículos de duración limitada)
- clave de juego
- Especificar el número total de canjes y el número de canjes por usuario.
- Especificar la duración de la campaña.
- Comprobar la configuración y guardar la promoción.
- Accede al menú de edición de promociones.
- En la pestaña Códigos, elige cómo se generan los códigos promocionales.
- Genera el código promocional o introdúcelo manualmente.
- Guarda los cambios.
- Activa la promoción.
Código promocional con un paquete de moneda virtual
Para crear un código promocional con un paquete de moneda virtual:- Cree un paquete de moneda virtual.
- Especifique un paquete de moneda virtual como artículo de bonificación.
Código promocional con un artículo virtual
Para crear un código promocional con un artículo virtual:
- Cree un artículo virtual.
- Especifique un artículo virtual como artículo de bonificación.
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:- Cree un paquete de claves del juego.
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
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.
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.Configuración mediante métodos API
Para trabajar con promociones de códigos promocionales, puedes utilizar los métodos del apartado Códigos promocionales del grupo del método Promociones.
Configuración de la promoción:
| Tarea | Método API |
|---|---|
| Crear una promoción con un código promocional | Crear promoción de código promocional |
| Activar promoción con código promocional | Activar promoción de código promocional |
| Editar promoción | Actualizar promoción de código promocional con nuevas opciones de promoción. También es posible editar las promociones con el estado Activo |
| Desactivar promoción | Desactivar promoción de código promocional |
| Establecer una promoción indefinida | Crear promoción de código promocional o Actualizar promoción de código promocional. Pasar el parámetro “date_end”:null al método especificado. |
| Tarea | Método API |
|---|---|
| Comprobar la validez del código promocional | Verificar código de promoción |
| Canjear código promocional | Canjear código promocional |
| Obtener una lista de plataformas de distribución de juegos para mostrar al usuario si se proporciona una clave de juego como bonificación por un código promocional | Obtener recompensas por códigos promocionales |
| Tarea | Método API |
|---|---|
| Obtener el número de usos que quedan de un código promocional para un usuario específico | Obtener el límite del código promocional para un usuario específico |
| Aumentar el número de usos que quedan del código promocional para un usuario específico | Aumentar el límite del código promocional para un usuario específico |
| Establecer un nuevo límite de uso de un código promocional para un usuario específico | Establecer el límite del código promocional para un usuario específico |
| Reducir el número de usos que quedan del código promocional para un usuario específico | Reducir el límite del código promocional para un usuario específico |
Si el campo del código promocional se incluye en el catálogo, después de introducir el código promocional, vuelve a solicitar el catálogo de artículos para el usuario pasando el código promocional en el parámetro promo_code en los métodos para crear el catálogo del apartado Catálogo.
Si implementas una compra rápida de un artículo utilizando el método Crear pedido con el método especificado del artículo, pasa información sobre el código promocional en el parámetro promo_code. Esto permite que la compra se realice con el código promocional aplicado.
¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.
