Como usar correspondência de RegEx na segmentação
O que é correspondência de regex?
A correspondência de regex permite filtrar perfis com base em padrões de texto, em vez de valores exatos. Isso é útil para encontrar perfis que seguem um formato específico, como endereços de e-mail de determinados domínios ou números de telefone em um formato específico.
⚠️ Importante: As expressões regulares (Regex) sempre correspondem ao valor completo, do início ao fim.
Como usar regex
Ao criar um segmento, você pode usar 2 operadores de regex com propriedades de Texto:
- corresponde à regex - Inclui perfis em que o valor corresponde à sua regex
- não corresponde à regex - Inclui perfis em que o valor não corresponde à sua regex
Use regex nas seguintes condições de segmento:
- Propriedades sobre alguém (incluindo objetos personalizados). Para usar dados de objetos, primeiro crie um objeto personalizado. Saiba como usar objetos personalizados em segmentos.
- Filtros em O que alguém fez (ou não fez) e Etapas que alguém realizou (ou deixou de realizar) em uma ordem específica
Os funis de eventos estão incluídos na Personalização e no Advanced Klaviyo Data Platform. Aprenda como usar funis de eventos na segmentação.
Aplicar um filtro regex
- Abra o criador de segmentos para um novo segmento ou abra um segmento existente e clique em Editar definição.
- Escolha uma das condições acima e selecione a propriedade a ser correspondida. Para uma condição de evento, selecione um evento e clique no ícone de filtro dele para escolher a propriedade do evento.
- Use uma propriedade de Texto. Se o tipo de dados for editável, selecione Texto.
- Selecione corresponde ao regex ou não corresponde ao regex e insira seu padrão.
- Clique em Criar segmento para um novo segmento ou em Atualizar segmento para salvar alterações em um segmento existente.
Noções básicas de regex
Caracteres correspondentes
- Letras e números — Digite normalmente: hello corresponde a "hello"
- Qualquer dígito: use \d para corresponder a qualquer número de 0 a 9
- Qualquer letra: use [a-z] para minúsculas, [A-Z] para maiúsculas ou [a-zA-Z] para ambas
- Ou/ou — Use | para corresponder às opções: gmail|yahoo corresponde a "gmail" ou "yahoo"
- Qualquer coisa - Use .* para corresponder a qualquer caractere
Caracteres especiais
Adicione uma barra invertida \ antes destes para corresponder a eles literalmente:
- Ponto final: \. corresponde a um ponto final
- Sinal de mais: \+ corresponde a um sinal de mais
- Parênteses: \( e \) correspondem a parênteses
Padrões repetidos
- {5} - Exatamente 5 vezes (por exemplo, \d{5} corresponde a 5 dígitos)
- {2,4} - Entre 2 e 4 vezes
- ? - Opcional (0 ou 1 vez)
Observação: os limites de repetição em {n}, {n,m} ou {n,} não podem exceder 1.000. Isso não limita * ou + a 1.000 repetições.
Exemplos comuns
- Domínio específico:
- .*@example\.com
- Correspondências: john@example.com, support@example.com
- Vários domínios:
- .*@(gmail|yahoo|hotmail)\.com
- Correspondências: user@gmail.com, user@yahoo.com, user@hotmail.com
- Qualquer .com e-mail:
- .*@.*\.com
Números de Telefone
- Número dos EUA de 10 dígitos
- \d{10}
- Correspondências: 5.551.234.567
- Formatado com parênteses:
- \(\d{3}\) \d{3}-\d{4}
- Correspondências: (555) 123-4567
Códigos postais
- CEP de 5 dígitos:
- \d{5}
- Correspondências: 12345
- CEP+4:
- \d{5}-\d{4}
- Correspondências: 12345-6789
Para referências avançadas: nossa implementação usa o Google RE2 como padrão. Saiba mais aqui.
Limites de Regex
Limite | Valor | Exemplo |
Comprimento da regex | máx. 1.000 caracteres | – |
Linhas de regex | máximo de 100 linhas | – |
Limites de repetição contada | Limite máximo: 1.000 | \d{1000} permitido |
Nível superior | separadores | Máximo de 5 separadores (6 alternativas) | a|b|c|d|e|f é permitido; a|b|c|d|e|f|g excede o limite |
Além disso, os seguintes recursos não são compatíveis no momento.
Destacar | Exemplo |
Lookahead/Lookbehind | (?=...), (?!...), (?<=...), (?<!...) |
Referências inversas | \1, \2, (\w+)\s+\1 |
Escapes Unicode | \uXXXX, \u00A0 |
Quantificadores aninhados | (a+)+, (x*)*, (a{2,5})+ |
Dicas para ter sucesso
1. O regex corresponde ao valor completo
Sua regex deve descrever o valor inteiro, não apenas uma parte dele.
Incorreto: gmail\.com (corresponde apenas ao texto "gmail.com")
Direita: .*@gmail\.com (corresponde a e-mails completos, como john@gmail.com)
2. Escape pontos finais literais
Ao corresponder a .com, .net, etc., escreva como \\.com com uma barra invertida.
Incorreto: .*@gmail.com (o ponto não escapado corresponde a qualquer caractere)
Correto: .*@gmail\\.com (corresponde ao ponto literal em e-mails como john@gmail.com)
3. Use .* para "Anything"
Corresponda a quaisquer caracteres com .*
- .*@company\.com: qualquer e-mail em company.com
- \+.* - Qualquer coisa que comece com +
- .*urgente.* - Texto que contém "urgente"
4. Comece com o básico e, em seguida, refine
Comece com uma regex básica e adicione detalhes gradualmente.
- Exemplo: .*@gmail\.com → [a-z]+\.[a-z]+@gmail\.com
Faça a divisão de uma lógica complexa em várias condições simples quando possível. Una as condições com AND quando os perfil precisarem atender às duas, como no exemplo abaixo.
- Exemplo de "e-mails do Gmail ou Yahoo da Califórnia":
- Filtro 1: O e-mail corresponde à regex .*@(gmail|yahoo)\.com
- Filtro 2: estado igual a Califórnia
5. RegEx diferencia maiúsculas de minúsculas por padrão
Se você quiser que uma instrução ignore maiúsculas e minúsculas, você pode adicionar (?i) como um prefixo.
- Correspondências de produtos (?i)^iphone$
Quando usar regex vs. operadores padrão
Use regex quando você precisar corresponder a formatos ou padrões específicos. Para necessidades mais simples, recomendamos fortemente usar operadores padrão em vez disso:
- Contém - O texto aparece em qualquer lugar
- Começa com - Corresponde ao início
- Termina com - Corresponde ao final
- Igual = correspondência exata