{"section":"tutorials","requestedLocale":"pt","requestedSlug":"criando-promocao-para-um-cluster-de-clientes","locale":"pt","slug":"criando-promocao-para-um-cluster-de-clientes","path":"docs/pt/tutorials/promoções-e-taxas/promoções/criando-promocao-para-um-cluster-de-clientes.md","branch":"main","content":"Uma promoção para um cluster de clientes é uma promoção válida apenas para um grupo de clientes pré-determinado a partir do módulo Master Data. Essa promoção será concedida apenas aos clientes selecionados após o login no site e somente exibida no carrinho de compras.\n\nConfigurar clusters de clientes permite criar uma variedade de promoções personalizadas para públicos segmentados.\n\nAntes de criar uma promoção, é preciso definir a propriedade que determina se um cliente faz parte ou não do cluster. Para isso, é possível utilizar campos já existentes no perfil do cliente (por exemplo: `email`) ou [criar um cluster de clientes no módulo Master Data](/pt/docs/tutorials/como-criar-um-cluster-de-clientes/).\n\nCom a propriedade definida, siga as instruções abaixo.\n\n1. No Admin VTEX, acesse *Promoções > Promoções*, ou digite *Promoções* na barra de busca no topo da página.\n2. Busque pela promoção em que deseja realizar essa configuração ou [crie uma nova promoção](/pt/tutorial/como-criar-promocoes/).\n3. Navegue para a área **Quais as condições para a promoção ser válida?**\n4. Selecione a opção **Cluster de clientes**.\n5. Selecione a configuração de critérios que desejar:\n    *   **Todos os seguintes:** é preciso que o cliente cumpra todos os requisitos para ser incluído na promoção.\n    *   **Pelo menos um dos seguintes:** se o cliente cumprir qualquer um dos critérios listados, ele será incluído na promoção.\n6. Preencha o campo com o cluster que deseja relacionar à promoção — [veja abaixo mais informações sobre como preencher este campo](#como-preencher-o-campo-cluster-de-clientes). Você pode adicionar mais de um cluster, clicando no botão `+`.\n7. Clique no botão `Salvar`.\n\n> ℹ️  Você pode inserir no máximo 50 clusters na opção **Cluster de clientes**. \n\n## Como preencher o campo Cluster de clientes\n\nExistem dois critérios possíveis para a seleção de um cluster para a promoção e, portanto, duas opções de preenchimento do campo **Cluster de clientes**: \n\n*   com uma [função de igualdade](#funcao-de-igualdade): `{nomedapropriedade}={\"valor\"}`.\n*   com uma [função `contains`](#funcao-contains): `{nomedapropriedade} contains {valor}`\n\nPerceba que, em ambas opções, `{nomedapropriedade}` deve ser alterado pelo nome do campo na entidade de dados e `{\"valor\"}` deve ser substituído pelo valor definido no Master Data.\n\n> ℹ️  O uso das aspas duplas varia [de acordo com o tipo de campo](/pt/docs/tutorials/entidade-de-dados#entendendo-os-tipos) criado no Master Data. \n\n### Função de igualdade\n\nA expressão `{nomedapropriedade}={\"valor\"}` deve ser utilizada caso a informação contida no perfil do cliente referente à propriedade em questão deva ser **exatamente igual** ao valor preenchido na expressão.\n\nNa configuração abaixo, por exemplo, apenas registros `funcionario` com o valor `true` (utilizado em um campo do tipo **[Boolean](/pt/docs/tutorials/entidade-de-dados#entendendo-os-tipos)**, em que os valores são sempre verdadeiro ou falso) receberão a promoção. \n\nDessa forma, você poderia configurar também `funcionario=false`, em que apenas registros `funcionario` com valor `false` no campo receberiam a promoção.\n\n![Campo funcionário Master Data PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/promoções-e-taxas/promoções/criando-promocao-para-um-cluster-de-clientes_1.png)\n\n![Cluster de clientes PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/promoções-e-taxas/promoções/criando-promocao-para-um-cluster-de-clientes_2.png)\n\nConsiderando um campo do tipo **[Varchar](/pt/docs/tutorials/entidade-de-dados#entendendo-os-tipos)**, poderíamos configurar `funcionario=\"sim\"` para que apenas clientes com valor `\"sim\"` no campo recebessem a promoção.\n\n> ⚠️  Para campos do tipo **Varchar**, o valor informado na seção **Cluster de clientes **da promoção diferencia caracteres minúsculos e maiúsculos. Isso quer dizer que, ao preencher a opção **Cluster de clientes** de forma diferente daquela definida para o campo no Master Data, a promoção não será aplicada. \n\nPortanto, considerando o exemplo acima de um campo tipo **Varchar** com os valores cadastrados `\"sim\"` e `\"não\"`, o cadastro na promoção obrigatoriamente será `funcionario=\"sim\"`. Ao cadastrar na promoção o termo `funcionario=\"Sim\"`, por exemplo, o cluster de clientes desejado não receberá a promoção.\n\n### Função contains\n\nA expressão `{nomedapropriedade} contains {valor}` deve ser utilizada quando a informação contida no perfil do cliente referente à propriedade em questão deve **conter** o `valor` preenchido na expressão.\n\nPor exemplo, caso você queira criar um cluster apenas com clientes cujos emails contenham `@teste.com`, a configuração seria igual à representada na imagem abaixo.\n\n![Campo Email Master Data](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/promoções-e-taxas/promoções/criando-promocao-para-um-cluster-de-clientes_3.png)\n\n![cluster email PT](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/promoções-e-taxas/promoções/criando-promocao-para-um-cluster-de-clientes_4.PNG)\n\nNesse caso, `email contains test.com` será verdadeiro, por exemplo, quando o valor for `joao@test.com` e falso quando o valor for `joao@test.org`."}