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.

"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.

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 Obter lista de jogos. 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

{
  "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

• via a Conta de Distribuidor
• via métodos de API

Configuração através da Conta de Distribuidor

• 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.

1. Vá para Store > Promotions and rewards e clique em Create promotion na Conta de Distribuidor.

2. Especifique os parâmetros necessários:
   1. Insira o título da promoção.
   2. Escolha Discount como promotion type.
   3. Escolha o valor do desconto.
   4. Escolha o tipo de produto.

• 5. Escolha um ou vários itens que terão desconto.

3. Clique em Next.
4. 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.
5. Para configurar promoções personalizadas, defina Promotion for only specific users como On e siga esta instrução.
6. Clique em Next.

7. Defina as datas de início e término da campanha.
8. Clique em Next.

9. Verifique as configurações e clique em Save and exit.

10. Para ativar uma promoção:
    1. Encontre a promoção no seu catálogo de promoções.
    2. Clique no botão do menu ••• e selecione Edit promotion.

• 3. 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 Desconto do grupo de métodos Promoções.

Para criar a promoção por meio dos métodos de API:

1. Chame o método Criar promoção de desconto para o item com os parâmetros necessários.
2. Chame o método Atualizar promoção do item 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 Atualizar promoção do item com novos parâmetros de promoção. Você também pode editar promoções que tenham o status Active.

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étodos Criar promoção de desconto para o item ou Atualizar promoção do item.

"items": null

• Configure um desconto para bens físicos. Passe uma matriz com SKUs de bens físicos para os métodos Criar promoção de desconto para o item ou Atualizar promoção de item.

"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étodos Criar promoção de desconto para o item ou Atualizar promoção de item.

"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 Criar promoção de desconto para o item ou Atualizar a promoção do item.

"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 Criar promoção de desconto para o item ou Atualizar promoção do item.

"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étodos Criar promoção de desconto para o item ou Atualizar promoção do item.

“date_end”: null

• Configure uma promoção para primeiros compradores. Para isso, passe na API de item Criar promoção de desconto para item ou na API de objeto Atualizar promoção de item na matriz attribute_conditions:

"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

• 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