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.

"item_id": 193166,
"sku": "helmet",
"type": "virtual_good",
"name": "{
Helmet",
"description": "---",
"image_url": "https://static.xsolla.com/misc/publisher_account/virtual_item_default_image.png",
"price": {
    "amount": "31.50",
    "amount_without_discount": "34.99",
    "currency": "TRY"
},
"virtual_prices": [],
"can_be_bought": true,
"promotions": [
    {
        "name": "store_promotion_164901_b5ef62b0551711edaedb22484f053720_name",
        "date_start": "2022-10-25T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": {
            "percent": "10.00",
            "value": null
        },
        "bonus": [],
        "limits": {
            "per_user": {
                "available": 3,
                "total": 3
            }
        }
    },
    {
        "name": "store_promotion_164901_dc1fd2b2551711ed82b722484f053720_name",
        "date_start": "2022-10-24T00:00:00+03:00",
        "date_end": "2022-11-30T23:59:59+03:00",
        "discount": null,
        "bonus": [
            {
                "sku": "22",
                "quantity": 1
            },
            {
                "sku": "sword",
                "quantity": 2
            }
        ],
        "limits": {
            "per_user": {
                "available": 1,
                "total": 1
            }
        }
    }
],
"limits": null,
"attributes": [
    {
        "external_id": "sh4",
        "name": "sh4",
        "values": [
            {
                "external_id": "hd",
                "value": "20"
            }
        ]
    }
],
"is_free": false,
"groups": [
    {
        "external_id": "imported",
        "name": "Imported"
    }
],
"virtual_item_type": "consumable",
"inventory_options": {
    "consumable": {
        "usages_count": 1
    },
    "expiration_period": null
}
}

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 um valor percentual.
• Configurar promoções de desconto disponíveis por tempo limitado.
• Configurar descontos que se aplicam a qualquer tipo de item:
  • pacotes de moedas virtuais
  • itens virtuais (incluindo itens de tempo limitado)
  • chaves do jogo
  • pacotes

As seguintes ações não estão disponíveis no momento na Conta de Distribuidor:

• 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