Na VTEX, promoção e cupom são duas coisas diferentes. A promoção é a regra: o que o cliente ganha, em quais produtos, em quais condições e por quanto tempo. O cupom é o código que o cliente informa no checkout para ativá-la. Um cupom sem promoção não faz nada. Este guia mostra o passo a passo no Admin, os seis tipos de promoção, os dois tipos de cupom e o que conferir quando o código não funciona.
Como criar um cupom e uma promoção na VTEX
O caminho mais curto tem quatro passos, todos no Admin da VTEX:
- Crie a promoção. Em Promoções, Promoções, clique em Criar promoção e escolha o tipo; na maioria dos casos, Regular. Preencha nome, status, datas e horários de início e fim (há também recorrência), sellers e políticas comerciais. Em "Na compra de", escolha entre todos os itens da loja ou só os que atendem a restrições: SKUs, produtos, coleções, categorias ou marcas. Defina o benefício e salve.
- Na seção "Quais as condições para a promoção ser válida?", preencha utm_source ou utm_campaign com um valor, por exemplo o próprio código do cupom.
- Crie o cupom. Em Promoções, Cupons, clique em Criar cupom e informe o código (até 300 caracteres, só letras, números e hífens) e o mesmo utm_source ou utm_campaign da promoção. O Admin exige ao menos um UTM. Em Restrições, é possível limitar quantas vezes o cupom pode ser usado. Salve. Um atalho: na própria promoção, depois de preencher o UTM, o botão "Criar cupom a partir dos parâmetros UTM acima" gera o cupom com base neles.
- Teste na loja: adicione um produto elegível ao carrinho e informe o código no checkout.
A ligação entre cupom e promoção é feita por UTM, o parâmetro de origem que acompanha a URL (utm_source, utm_campaign). O cupom só vale com o mesmo valor nos dois lados, em qualquer tipo de promoção, exceto a Promoção de Campanha, que não aceita cupom. A condição de UTM da promoção também vale para quem chega à loja por uma URL com aquele UTM. O exemplo da VTEX é o clique num anúncio do Facebook, com utm_source=fb na URL, que aplica o benefício sem o cliente digitar o código.
Os seis tipos de promoção
Os nomes abaixo são os do Admin, em Promoções.
| Tipo | Quando usar | Exemplo |
|---|---|---|
| Promoção Regular | Na maioria dos casos: combina condições, limites e benefícios (desconto, frete, brinde, valor de fidelidade, tabela de preços) | Desconto em uma categoria; frete grátis por tempo limitado |
| Compre Junto | Quando dois ou mais produtos são adicionados ao carrinho ao mesmo tempo e o desconto, em percentual, vale para um deles ou para os dois | 10% de desconto no cinto na compra da calça |
| Leve Mais por Menos | Quando o cliente leva várias unidades do mesmo produto; o desconto, em percentual ou valor fixo, vale para os itens mais baratos ou para os mais caros | Leve 3 e pague 2 |
| Desconto Progressivo | Quando o desconto cresce com a quantidade no carrinho, em até 10 faixas; pode valer só para itens idênticos | Quanto mais unidades, maior o desconto |
| Compre e Ganhe | Quando o benefício é frete grátis ou brinde, aplicado automaticamente quando os critérios são atendidos | Frete grátis na compra de uma TV; um jogo extra na compra de um videogame |
| Promoção de Campanha | Quando a promoção é para um público específico, definido numa audiência de campanha; não aceita cupom | Quem coloca o produto A no carrinho recebe desconto no produto B |
A Promoção Regular pode conceder desconto (em valor, em percentual ou por fórmula) e frete (em valor, em percentual, grátis ou com valor máximo). Pode fixar um preço máximo para os itens elegíveis, dar um brinde, creditar valor de fidelidade ou aplicar uma tabela de preços promocionais. Quem recebe depende das condições, que se combinam: valor do pedido, preço do item, BIN do cartão, cluster de clientes, país e CEP de entrega, tipo de frete, meio de pagamento, parcelas e UTM. Os limites fecham a regra, e são três: uso total na loja, uso por cliente e quantidade de itens elegíveis.
Cupom único ou grupo de cupons
| Tipo | Como é | Quando usar |
|---|---|---|
| Cupom único | Um só código, que não é obrigatoriamente de uma utilização: o número de usos é configurável | Datas comemorativas, como NATAL22; primeira compra, como BOASVINDAS10, com limite de um uso por cliente |
| Grupo de cupons | Vários códigos com o mesmo efeito, gerados pela plataforma com um prefixo, um hífen e 15 caracteres aleatórios, como PROMO-99n0xjzfum1o6tk | Influenciadores (um código para cada um), programas de fidelidade, divulgação em massa de códigos de uso único |
Para criar um grupo, ative "Gerar cupons em grupo" ao criar o cupom e informe o número de códigos, até 1.000 pelo Admin. Depois de salvar, a tela "Cupons gerados" permite copiar todos os códigos ou exportá-los em CSV. Acima de 1.000, a geração só é possível pela API. O limite de uso é opcional, com mínimo de 1, e pedidos cancelados não entram na contagem.
Frete grátis, brinde e cupom de valor total
Para frete grátis com cupom, crie uma Promoção Regular com o benefício de frete grátis e a condição de UTM igual à do cupom. Para brinde, a Promoção Regular tem o benefício Brinde, em que se escolhem os SKUs e a quantidade de brindes. No Compre e Ganhe, o brinde ou o frete grátis são aplicados automaticamente quando os critérios são atendidos. Na Promoção Regular, a documentação não diz se o brinde entra sozinho no carrinho ou se o cliente escolhe entre os produtos: teste o fluxo na sua loja antes da data.
Quando o cupom precisa abater o total de uma compra, produto e frete, a VTEX indica criar duas Promoções Regulares ligadas ao mesmo cupom. Uma é de frete grátis e a outra é de desconto de valor nominal, ambas com o mesmo UTM. O cliente abate os dois valores antes de finalizar a compra.
Quando o código não funciona
| O que o cliente vê | Causas mais diretas | O que conferir |
|---|---|---|
| O código não funciona | Cupom não ligado à promoção; UTM diferente nos dois lados; promoção inativa ou fora da data; limite de uso atingido | O mesmo UTM nos dois lados, o status e as datas da promoção e o uso do cupom |
| O benefício aparece no produto errado | Promoção aberta para a loja inteira; restrição de produto ou coleção ausente | A opção "Aplicar a todos os itens da loja" ou só aos itens com restrições |
| O benefício se soma a outro | Acúmulo com outras promoções permitido sem intenção | A opção "Permitir acumular com outras promoções" e as promoções ativas |
| O brinde não aparece | Condição não cumprida; duas promoções de brinde configuradas para acumular | A condição da promoção e a configuração de acúmulo |
Para campanhas grandes: API e mais de um cupom por compra
O que o Admin faz, a API de Promoções e Taxas também faz, e é o que um time técnico usa em campanhas grandes. Ela cria, atualiza e arquiva cupons, consulta o uso de cada código e gera cupons em massa. Por padrão, o cliente usa um cupom por pedido. Mais de um por compra só existe por API, com limite de 20, e exige customização do checkout e um pedido de liberação ao suporte da VTEX. As promoções precisam permitir a combinação.
Onde a Popconvert entra
A Popconvert não cria o cupom dentro da VTEX: a promoção e o cupom nascem lá. A campanha entrega o prêmio ao visitante, que participa, deixa o contato com opt-in e recebe o cupom. O cupom é o criado na VTEX, colado nas recompensas da campanha; o prêmio também pode ser frete grátis ou um brinde.
A campanha pode ser uma Roleta, um TNT, um Pick a Gift ou um pop-up sem jogo. O contato de cada participante segue para o Master Data pelo aplicativo na VTEX App Store. Com a promoção desenhada, fale com a nossa equipe.
Perguntas frequentes
Como criar um cupom na VTEX?
No Admin, em Promoções, Cupons, clique em Criar cupom e informe o código (até 300 caracteres, só letras, números e hífens) e ao menos um UTM, utm_source ou utm_campaign. Depois ligue o cupom a uma promoção, com o mesmo UTM na condição da promoção. Sem uma promoção ligada, o cupom não vale.
Como ligar um cupom a uma promoção na VTEX?
Preenchendo o mesmo utm_source ou utm_campaign no cupom e na condição de UTM da promoção. A ligação vale para todos os tipos de promoção, exceto a Promoção de Campanha.
Qual a diferença entre cupom único e grupo de cupons na VTEX?
O cupom único tem um só código, com número de usos configurável. O grupo reúne vários códigos com o mesmo efeito, gerados com prefixo, hífen e 15 caracteres aleatórios, até 1.000 por grupo pelo Admin.
Quantos cupons o cliente pode usar por pedido na VTEX?
Por padrão, um por pedido. A VTEX permite mais de um por API, com limite de 20 por compra, mediante customização do checkout e liberação pelo suporte.
Dá para aplicar a promoção sem o cliente digitar o cupom?
Sim. A condição de UTM da promoção também vale para quem chega à loja por uma URL com aquele UTM, como o clique num anúncio, e o benefício é aplicado sem o código.
A Popconvert cria os cupons na VTEX?
Não. A promoção e o cupom nascem na VTEX. A Popconvert monta a campanha que entrega o prêmio ao visitante, com o cupom criado na VTEX.