Como Criar Expressões para Execução Condicional de Integrações
Introdução
Este documento serve para ajudar você a compreender e aplicar fórmulas dinâmicas para controlar a execução de integrações em nosso sistema. As fórmulas possibilitam definir condições lógicas baseadas em dados de entrada, que determinam se uma integração será executada ou não.
Padrões de Expressão
As expressões são escritas usando placeholders para dados e operadores lógicos ou de comparação para formular condições. Abaixo estão os componentes que você pode usar:
- Placeholders: Representados por
{{}}
, identificam dados específicos. Exemplos incluem{{id_da_pergunta}}
,{{hidden_field_name}}
,{{utm_source}}
, e{{variable_name}}
. Neste link pode encontrar em Guia para Placeholders que pode oferecer mais detalhes sobre como personalizar e-mails e mensagens usando placeholders específicos. - Valores Booleanos:
TRUE
: Representa um valor verdadeiro.FALSE
: Representa um valor falso.
- Operadores Lógicos:
AND
: Conjunção (e).OR
: Disjunção (ou).NOT
: Negação.
- Operadores de Comparação:
EQUALS
: Igualdade.CONTAINS
: Contém texto.>
: Maior que.<
: Menor que.>=
: Maior ou igual.<=
: Menor ou igual.
- Parênteses: Usados para alterar a precedência padrão das operações, garantindo que expressões específicas sejam avaliadas primeiro.
Exemplos de Expressões
- Expressão Simples
- Fórmula:
{{629gf8238a124a052r02b98}} EQUALS "sim"
- Descrição: A integração é executada se o campo
629gf8238a124a052r02b98
é igual a "value".
- Fórmula:
- Uso de Campo Oculto
- Fórmula:
{{hidden_field}} EQUALS "iniciante"
- Descrição: A integração é executada se um campo oculto contém o valor "secret".
- Fórmula:
- Tracking com UTM
- Fórmula:
{{utm_source}} EQUALS "google"
- Descrição: A integração é executada se o parâmetro UTM de origem é "google".
- Fórmula:
- Condição com Variável
- Fórmula:
{{score}} EQUALS "10"
- Descrição: A integração é executada se uma variável específica está definida como "active".
- Fórmula:
- Expressão Composta com Parênteses
- Fórmula:
({{629gf8238a124a052r02b81}} > 20 AND {{629gf8238a124a052r02b98}} < 30) OR ({{utm_campaign}} EQUALS "launch" AND NOT {{email}} CONTAINS "@gmail.com")
- Descrição: A integração é executada se a pergunta
629gf8238a124a052r02b81
é maior que 20 e a pergunta629gf8238a124a052r02b98
é menor que 30, ou se o parâmetro UTM da campanha é "launch" e um campo oculto não contém "@gmail.com".
- Fórmula:
OBS: Você pode pegar o ID de uma pergunta na tela de edição do formulário. Ao selecionar uma pergunta, a URL vai acabar em algo assim ?fieldid=629gf8238a124a052r02b98.
O que vier depois do sinal de igual é o ID da pergunta.
Aqui está um exemplo de como enviar uma conversão personalizada para a Meta:
Conclusão
Utilize este guia como uma referência ao definir condições para execução de suas integrações. A compreensão e o uso correto dos operadores, especialmente dos parênteses, são essenciais para criar lógicas de controle eficazes e seguras.