Promoções de desconto
Como funciona
As promoções de desconto são uma ferramenta de marketing para conseguir novos jogadores e aumentar as vendas.
Principais características:
- Configure um desconto para um ou vários itens.
- Aplique um número ilimitado de promoções de desconto a um item.
- Crie um catálogo de itens com cálculos automáticos de preços para os itens. Os métodos para criar um catálogo retornam o objeto
price
para cada item. Este objeto contém preços para itens com desconto atual e sem eles.
- json
"price": {
"amount": "2.3900000000000000",
"amount_without_discount": "2.9900000000000000",
"currency": "USD"
}
Restrições:
- Você pode definir o desconto apenas no valor percentual no intervalo de 1 a 99.
- Você não pode aplicar restrições regionais a promoções de desconto.
Você pode configurar promoções para qualquer quantidade de itens. Aplique um número ilimitado de promoções de desconto a um item.
Você pode configurar diferentes tipos de promoções para um jogo ou lista de jogos: descontos, cupons, códigos promocionais e bônus.
Se várias promoções forem válidas para um jogo ou lista de jogos no momento da compra, os descontos serão aplicados ao item um a um. A ordem em que os descontos são aplicados não importa.
Por exemplo:
O preço de uma chave de jogo é de $10 USD. Na Conta de Distribuidor, as seguintes promoções foram criadas para as chaves de jogo:
- Black Friday — promoção de desconto com um desconto de 10% de 4 a 30 de novembro.
- Oferta — promoção de desconto com um desconto de 20% de 15 de novembro a 15 de dezembro.
- Promoção com um código promocional para um desconto de 5% de 4 a 30 de novembro.
Se a chave de jogo for comprada em 20 de novembro, tanto as promoções de desconto quanto as promoções com códigos promocionais são válidas.
O custo total da chave é então calculado como (($10 - 10%) - 20%) - 5%, e será de $6,84 USD.
O usuário pode ver informações sobre promoções:
- ao visualizar o catálogo de jogos
- ao fazer um pedido
Se você usar o Site Builder para criar sua loja, o catálogo de jogos exibirá o valor do desconto, o preço riscado sem desconto e o preço com desconto.
Se você criar sua própria versão da loja, implemente a exibição de promoções no catálogo com base nos dados recebidos no método Get games list. Na resposta, você obtém as seguintes informações sobre promoções, além de informações sobre o jogo:
- título
- data de início e término
- tamanho do desconto para uma promoção com o tipo Discount
- preço do item com e sem desconto para uma promoção com o tipo Discount
- item bônus para uma promoção com o tipo Bonus
- json
{
"items": [
{
"sku": "game_1",
"name": "Game name",
"groups": [
{
"external_id": "all",
"name": "All games"
},
{
"external_id": "Xsolla",
"name": "Xsolla games"
}
],
"type": "unit",
"unit_type": "game",
"description": "Game description",
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"attributes": {
"$ref": "../examples/client-attribute-game.yaml#/value"
},
"promotions": [],
"unit_items": [
{
"sku": "game_key_01",
"type": "game_key",
"is_free": false,
"price": {
"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"virtual_prices": [],
"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": true,
"is_pre_order": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
{
"sku": "game_key_02",
"type": "game_key",
"is_free": false,
"price": {
"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"virtual_prices": [],
"can_be_bought": true,
"drm_name": "Origin",
"drm_sku": "origin",
"has_keys": false,
"is_pre_order": false,
"release_date": null
}
]
},
{
"sku": "game_2",
"name": "Game name",
"groups": [
{
"external_id": "all",
"name": "All games"
}
],
"type": "unit",
"unit_type": "game",
"description": "Game description",
"image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
"attributes": [
{
"external_id": "OS",
"name": "OS",
"values": [
{
"external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
"value": "Windows"
}
]
}
],
"promotions": [],
"unit_items": [
{
"sku": "game_key_01",
"type": "game_key",
"is_free": false,
"price": {
"amount": "30.5",
"amount_without_discount": "30.5",
"currency": "USD"
},
"virtual_prices": [],
"can_be_bought": true,
"drm_name": "Steam",
"drm_sku": "steam",
"has_keys": false,
"is_pre_order": false,
"release_date": null
}
]
}
]
}
Ao fazer um pedido, as seguintes informações são mostradas sobre as promoções aplicadas:
- o resultado da aplicação de uma promoção de desconto:
- valor do desconto para a promoção
- preço riscado sem desconto
- preço com desconto
- o resultado da aplicação da promoção de bônus:
- itens bônus
- Valor grátis na linha de preço para itens bônus
- o resultado da aplicação do código promocional
- valor de desconto para o código promocional
- preço riscado sem desconto
- preço com desconto
- itens bônus
- Valor grátis na linha de preço para itens bônus
Como obtê-lo
Configuração da campanha de descontos
Você pode configurar campanhas de desconto de uma das seguintes maneiras:- via a Conta de Distribuidor
- via métodos de API
Configuração através da Conta de Distribuidor
Se você configurar promoções de desconto por meio da Conta de Distribuidor, terá as seguintes opções:- Configurar um desconto com o valor da porcentagem inteira.
- Configure promoções de desconto que estão disponíveis por tempo limitado.
- Configure descontos que se aplicam a um ou mais pacotes de chaves de jogo para plataformas específicas.
- Configuração de descontos com valores fracionários.
- Configuração de descontos de período ilimitado.
- Edição das promoções de desconto no status Active.
Você pode usar métodos de API para aprimorar suas opções de configuração das promoções de desconto.
- Vá para Store > Promotions and rewards e clique em Create promotion na Conta de Distribuidor.
- Especifique os parâmetros necessários:
- Insira o título da promoção.
- Escolha Discount como promotion type.
- Escolha o valor do desconto.
- Escolha o tipo de produto.
- Escolha um ou vários itens que terão desconto.
- Clique em Next.
- Você pode limitar o número de vezes que um usuário pode usar a promoção. Para fazer a configuração, na página Condition and limit, defina Limit number of times one user can use promotion como On e especifique o limite.
- Para configurar promoções personalizadas, defina Promotion for only specific users como On e siga esta instrução.
- Clique em Next.
- Defina as datas de início e término da campanha.
- Clique em Next.
- Verifique as configurações e clique em Save and exit.
- Para ativar uma promoção:
- Encontre a promoção no seu catálogo de promoções.
- Clique no botão do menu ••• e selecione Edit promotion.
- No canto superior direito, abra o menu suspenso e escolha Activate promotion.
Configuração por meio de métodos de API
Para trabalhar com promoções de desconto, você pode usar os métodos da subseção
Para criar a promoção por meio dos métodos de API:
- Chame o método
Create discount promotion for item com os parâmetros necessários. - Chame o método
Update item promotion com o parâmetro“is_enabled”:true
para ativar a promoção.
Para editar a promoção por meio de um API, chame o método
Ao criar ou editar uma promoção de desconto por meio de métodos de API, você também pode:
- Configurar um desconto para todos os itens do projeto. Passe o parâmetro
“items”:null
para os métodosCreate discount promotion for item ouUpdate item promotion .
- json
"items": null
- Configure um desconto para bens físicos. Passe uma matriz com SKUs de bens físicos para os métodos
Create discount promotion for item ouUpdate item promotion .
- json
"items": [{
“sku”: “strw2030”
}, {
“sku”: “strw4060”
}, {
“sku”: “cupred200”
}
]
- Configure um desconto com o valor percentual da fração. Passe o parâmetro
discount.percent
com um desconto de fração para os métodosCreate discount promotion for item ouUpdate item promotion .
- json
"discount": {
“percent”: ”49.9”
}
- Configure um desconto para itens de tipos diferentes. Passe uma matriz com SKUs dos itens necessários para os métodos
Create discount promotion for item ouUpdate item promotion .
- json
"items": [{
“sku”: “storm_shield”
}, {
“sku”: “heaven_crystals_pack_x500”
},{
“sku”: “strw2030”
}
]
- Configure um desconto para DRMs definitivos do jogo. Passe uma matriz com SKUs dos DRMs necessários para os métodos
Create discount promotion for item ouUpdate item promotion .
- json
"items": [{
“sku”: “brilliant_game_sku_steam”
}
]
- Configure uma promoção de desconto que não tem um período especificado. Passe o parâmetro
“date_end”:null
para os métodosCreate discount promotion for item ouUpdate item promotion .
- json
“date_end”: null
- Configure uma promoção para primeiros compradores. Para isso, passe na API de item Create discount promotion for item ou na API de objeto Update item promotion na matriz
attribute_conditions
:
- json
"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}
Personalização das condições de uma promoção de desconto
Você pode configurar um desconto que será aplicado somente se algumas condições forem atendidas. Por exemplo:- desconto que é aplicado a uma quantia definida do carrinho
- desconto que é aplicado somente se o carrinho tiver itens suficientes
- desconto em um item se os usuários comprarem outro item
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.