Menu
Feedback
Comece aqui

Troubleshooting

Troubleshooting
Promoção não foi aplicada ao cluster de clientes
Publicado em28/02/2025
Última atualização em14/08/2025
3 min de leitura

Uma promoção personalizada pode ser configurada para atender a um grupo específico de usuários em sua loja, ou seja, um cluster de clientes. No entanto, podem ocorrer situações em que a promoção não é exibida corretamente para este público segmentado. As principais causas são:

  • Ausência ou cadastro incorreto do valor do cluster durante a configuração da promoção.
  • Inconsistência entre os valores cadastrados na promoção e os valores atribuídos nos perfis dos clientes.

Solução

Confira a seguir algumas soluções que podem ajudar a garantir a exibição da promoção para o cluster de cliente desejado.

Verificar valor do cluster configurado na promoção

Para identificar se um cluster de clientes está associado a uma promoção, siga os passos abaixo:

  1. No Admin VTEX, acesse Promoções > Promoções, ou digite Promoções na barra de busca no topo da página.

  2. Clique na promoção que deseja verificar.

  3. Na seção Quais as condições para a promoção ser válida?, verifique se a opção Cluster de clientes está marcada e se o campo está preenchido com o valor correto do respectivo cluster.

{"base64":"  ","img":{"width":730,"height":222,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":12865,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/pt/troubleshooting/opera%C3%A7%C3%B5es-da-loja/promocao-nao-foi-aplicada-ao-cluster-de-clientes_1.png"}}

O valor cadastrado no campo deve ser exatamente igual ao valor anteriormente atribuído ao cluster de cliente, pois o sistema interpreta diferenças entre letras maiusculas e minúsculas (case sensitive). Por exemplo, se o valor adotado para um determinado identificador do cluster é funcionario=true e na promoção for cadastrado Funcionario=true ou funcionario=True, a promoção não será exibida para os usuários daquele cluster.

  1. Caso necessário, adicione ou modifique o valor referente ao cluster desejado.

  2. Clique em Salvar.

Para garantir que uma mesma promoção seja aplicada simultaneamente a clusters de clientes que possuem valores diferentes cadastrados, é necessário selecionar a condição Pelo menos um dos seguintes e configurar todos os valores dos clusters na promoção.

Verificar valor atribuído no perfil do cliente

Em um cenário em que a promoção tenha mais de um valor cadastrado no campo disponível em Cluster de clientes, e a condição selecionada seja Todos os seguintes, é necessário que os clientes do cluster atendam a todos os critérios cadastrados.

Por exemplo, uma promoção configurada com a condição Todos os seguintes, preenchida com Funcionario=true e code=platinum, será aplicada apenas para clientes que tenham o perfil cadastrado como funcionário e o código platinum. Clientes que atendam a apenas um dos requisitos não poderão utilizar a promoção.

Para resolver este caso, você poderia realizar uma das seguintes ações:

  • Alterar a opção Cluster de clientes para a condição Pelo menos um dos seguintes, permitindo que clientes identificados como funcionário ou com código platinum possam acessar a promoção.

  • Manter a opção Cluster de clientes com a condição Todos os seguintes e atualizar os cadastros dos clientes desejados por meio do Master Data para incluir ambos os critérios: ser funcionário e estar classificado na categoria platinum.

  • Manter a opção Cluster de clientes com a condição Todos os seguintes e declarar outros valores que estejam atualmente presentes nos clientes aos quais deseja exibir a promoção.

Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na VTEX Community
Junte-se à nossa comunidade
Solicite suporte à VTEX
Receba assistência personalizada com nossos especialistas
Abra um ticket de suporte
GitHubDeveloper PortalComunidadeFeedback