Nesta página: saiba como usar o construtor de regras para criar consultas direcionadas para suas campanhas orquestradas, adicionando condições de atributos e expressões de banco de dados, combinando-as com operadores lógicos e validando os resultados.
As principais etapas para criar regras para suas campanhas orquestradas são as seguintes:
- Adicionar condições: crie condições personalizadas para filtrar a sua consulta, criando a sua própria condição com atributos do banco de dados e expressões avançadas.
- Combinar condições: organize as condições na tela, usando grupos e operadores lógicos.
- Verificar e validar a regra: verifique os dados resultantes da regra antes de salvá-la.
Adicionar uma condição conditions
Para adicionar condições à sua consulta, siga estas etapas:
-
Acesse o construtor de regras a partir de uma atividade Criar público-alvo.
-
Clique no botão Adicionar condição para criar a primeira condição da sua consulta.
Você também pode iniciar a consulta com um filtro predefinido. Para fazer isso, clique no botão Selecionar ou salvar filtro e escolha Selecionar filtro predefinido. Para obter mais detalhes, consulte Trabalhar com filtros predefinidos.
-
Identifique o atributo do banco de dados a ser usado como critério para a sua condição. O ícone “i” ao lado de um atributo fornece informações sobre a tabela em que ele está armazenado e seu tipo de dado.
note NOTE O botão Editar expressão permite usar o editor de expressão para definir manualmente uma expressão, usando campos do banco de dados e funções auxiliares. Saiba como editar expressões -
Clique na
accordion Distribuição de valores A distribuição de valores permite identificar como os valores são usados no banco de dados. É útil para entender os valores disponíveis, suas contagens e porcentagens. Isso também ajuda a evitar problemas como inconsistências no uso de maiúsculas e minúsculas ou na ortografia ao criar consultas ou expressões.
Para atributos com um grande número de valores, a ferramenta exibe apenas os primeiros vinte. Nesses casos, uma notificação de Carregamento parcial é exibida para indicar essa limitação. É possível aplicar filtros avançados para refinar os resultados exibidos e concentrar-se em valores ou subconjuntos de dados específicos.
Para criar sua condição mais rapidamente, selecione um valor e clique em Selecionar atributo e valor para preencher o atributo e o valor na condição atual.
Você também pode copiar um valor na área de transferência usando a
accordion Adicionar aos favoritos Adicionar atributos ao menu de favoritos agiliza o acesso aos atributos usados com mais frequência. Você pode adicionar até 20 atributos aos favoritos. Atributos favoritos e recentes são associados a cada usuário dentro de uma organização, garantindo acessibilidade em diferentes computadores e proporcionando uma experiência contínua em todos os dispositivos.
Para acessar os atributos adicionados aos favoritos, use o menu Favoritos e recentes. Os atributos favoritos aparecem primeiro, seguidos pelos usados recentemente, o que facilita a localização dos atributos desejados. Para remover um atributo dos favoritos, clique no ícone de estrela novamente.
-
Clique em Confirmar para adicionar o atributo selecionado à sua condição.
-
Um painel de propriedades é exibido, onde você pode configurar o valor desejado para o atributo.
-
Selecione o Operador a ser aplicado na lista suspensa. Vários operadores estão disponíveis para uso. Os operadores disponíveis na lista suspensa dependem do tipo de dado do atributo.
accordion Lista de operadores disponíveis table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 Operador Finalidade Exemplo Igual a Retorna um resultado idêntico aos dados inseridos na segunda coluna de valor. Um sobrenome (@lastName) igual a “Jones” retornará apenas destinatários cujo sobrenome seja Jones. Não é igual a Retorna todos os valores não idênticos ao valor inserido. Um idioma (@language) diferente de “inglês”. Maior que Retorna um valor maior que o valor digitado. Uma idade (@age) maior que 50 retornará todos os valores maiores que “50”, como “51” ou “52”. Menor que Retorna um valor menor que o valor digitado. Uma data de criação (@created) anterior a “DaysAgo(100)” retornará todos os destinatários criados menos de 100 dias atrás. Maior que ou igual a Retorna todos os valores iguais ou superiores ao valor digitado. Uma idade (@age) maior ou igual a “30” retornará todos os destinatários com 30 anos ou mais. Menor que ou igual a Retorna todos os valores iguais ou inferiores ao valor inserido. Uma idade (@age) menor ou igual a “60” retornará todos os destinatários com 60 anos ou menos. Incluído em Retorna resultados incluídos nos valores indicados. Esses valores precisam ser separados por vírgula. Uma data de nascimento (@birthDate) que está incluída em “12/10/1979,12/10/1984” retornará os destinatários nascidos entre essas datas. Não está em Funciona como o operador “Está incluído em”. Aqui, os destinatários são excluídos com base nos valores inseridos. A data de nascimento (@birthDate) não está incluída em “12/10/1979,12/10/1984”. Os destinatários nascidos entre essas datas não serão retornados. Está vazio Retorna os resultados que correspondem a um valor vazio na segunda coluna de valor. Celular (@mobilePhone) ficando em branco, retornará todos os destinatários que não tiverem um número de celular. Não está vazio Funciona ao contrário do operador “Está vazio”. Não é necessário inserir dados na segunda coluna de valor. O email (@email) não está vazio. Começa com Retorna os resultados que começam com o valor inserido. O n.° da conta (@account) começa com “32010”. Não inicia com Retorna os resultados que não começam com o valor inserido. O n.° da conta (@account) não começa com “20”. Contains Retorna os resultados que contêm pelo menos o valor inserido. Um domínio de email (@domain) que contém “mail” retornará todos os nomes de domínio que contiverem “mail”, como “gmail.com”. Não contém Retorna resultados que não contêm o valor digitado. Um domínio de email (@domain) não contém “vo”. Nomes de domínio que contiverem “vo”, como “voila.fr”, não aparecerão nos resultados. É como Semelhante ao operador “Contém”, permite inserir um caractere curinga % no valor. O sobrenome (@lastName) é como “Jon%s”. O caractere atua como um “curinga” para encontrar nomes como “Jones”. Não é como Semelhante ao operador “Contém”, permite inserir um caractere curinga % no valor. O sobrenome (@lastName) não é como “Smi%h”. Destinatários cujo sobrenome for “Smi%h” não serão retornados. -
No campo Valor, defina o valor esperado. Você também pode usar o editor de expressão para definir manualmente uma expressão, usando campos do banco de dados e funções auxiliares. Para isso, clique no ícone
Para atributos do tipo data, os valores predefinidos estão disponíveis por meio da opção Predefinições.
accordion Veja o exemplo 
Condições personalizadas em tabelas vinculadas (vínculos 1-1 e 1-N) links
As condições personalizadas permitem consultar tabelas vinculadas à tabela usada atualmente pela sua regra. Isso inclui tabelas com um vínculo de cardinalidade 1-1 ou tabelas de coleção (vínculo 1-N).
Link 1-1
Para um vínculo 1-1, navegue até a tabela vinculada, selecione o atributo desejado e defina o valor esperado.
Você também pode selecionar diretamente um vínculo de tabela no seletor de Valor e confirmar. Nesse caso, os valores disponíveis para a tabela selecionada precisam ser selecionados com um seletor dedicado, como mostrado no exemplo abaixo.
Aqui, a consulta é direcionada a marcas cujo rótulo é “corrida”.
-
Navegue dentro da tabela Marca e selecione o atributo Rótulo.
-
Defina o valor esperado para o atributo.
Esta é uma amostra de consulta em que um vínculo de tabela foi selecionado diretamente. Os valores disponíveis para a tabela devem ser selecionados em um seletor dedicado.
Link 1-N
Para um link 1-N, você pode definir condições de duas maneiras:
-
Selecione a própria coleção, como Compras. Isso cria uma condição exists como, na qual você pode adicionar subcondições.
accordion Exemplo de consulta Aqui, a consulta é direcionada a destinatários que fizeram compras relacionadas ao produto Brewmsaster de mais de USD 100.
-
Selecione a tabela Compras e confirme.
-
Clique em Adicionar condição para definir as subcondições a serem aplicadas à tabela selecionada.
-
Adicione subcondições para suprir as suas necessidades.
-
-
Selecione um atributo da coleção - Procure na coleção e selecione um atributo, como Preço.
O Journey Optimizer fornece três opções para definir a condição.
-
Padrão: a opção recomendada para a maioria dos casos de uso. Uma condição
exists such asé criada automaticamente para a coleção. É equivalente a selecionar a coleção diretamente com o método descrito acima e produzir o mesmo resultado. Por exemplo, selecionar o atributo Preço de Compras cria uma condição Compras existe, como. Em seguida, você pode definir o operador e o valor, como igual a0. -
Aggregate: aplica uma função de agregação ao atributo de coleção selecionado. Por exemplo, selecione Count para criar uma condição como Count(Price) igual a 0. Você pode usar a condição adicional para refinar os registros incluídos na agregação.
-
Avançado: usa uma associação direta ao elemento de coleção. O atributo selecionado é avaliado diretamente, por exemplo Price (purchases/@price). Use essa opção para uma única condição no elemento de coleção.
A opção Padrão está selecionada por padrão. Use Aggregate quando precisar contar ou agregar registros de coleção, ou Advanced quando precisar de uma associação direta a um atributo de coleção.
-
Combinar condições com operadores operators
Sempre que você adiciona uma nova condição à regra, ela é automaticamente vinculada à condição existente por um operador E. Isso significa que os resultados das duas condições são combinados.
Para alterar o operador entre condições, clique nele e selecione o operador desejado.
Os operadores disponíveis são:
- E (interseção): combina resultados que correspondem a todos os componentes de filtragem nas transições de saída.
- OU (união): inclui resultados que correspondem a pelo menos um dos componentes de filtragem nas transições de saída.
- EXCETO (exclusão): exclui resultados que correspondem a todos os componentes de filtragem na transição de saída.
Manipular condições manipulate
A barra de ferramentas da tela do construtor de regras permite manipular facilmente as condições da sua regra:
Dependendo das suas necessidades, pode ser necessário criar grupos intermediários de componentes, agrupando os componentes em um mesmo grupo e vinculando-os.
-
Para agrupar duas condições existentes, selecione uma das duas condições e clique no
-
Para agrupar uma condição existente com uma nova condição, selecione a condição, clique na
No exemplo abaixo, criamos um grupo intermediário para segmentar os clientes que compraram o produto BrewMaster ou VanillaVelvet.
Verificar e validar sua consulta
Depois de criar a consulta na tela, é possível verificá-la por meio do painel Propriedades da regra. As operações disponíveis são:
- Visualizar resultados: exibe os dados resultantes da sua consulta.
- Visualização do código: exibe uma versão baseada no código da consulta em SQL.
- Calcular: atualiza e exibe o número de registros aos quais a regra se direciona.
- Selecionar ou salvar filtro: escolha um filtro predefinido existente para usar na tela ou salve a sua consulta como um filtro predefinido para reutilização no futuro. Se o filtro incluir parâmetros, forneça valores antes de aplicá-lo. Para obter detalhes, consulte Trabalhar com filtros predefinidos.
Quando a regra estiver pronta, clique no botão Confirmar para salvá-la.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to build rules for Orchestrated campaigns using the rule builder, by adding conditions from database attributes and expressions, combining them with logical operators, and checking and validating the results.
Intents:
- Add a custom condition to a query by selecting an attribute from the database and defining an operator and value.
- Start a query from a predefined filter instead of building a condition from scratch.
- Use the Distribution of values tool to review available attribute values before building a condition.
- Add attributes to a favorites menu for quicker access when building conditions.
- Build conditions on 1-1 linked tables by navigating to the linked table and selecting an attribute, or by selecting the table link directly.
- Build conditions on 1-N (collection) linked tables by selecting the collection itself to create an exists such as condition with sub-conditions, or by selecting an attribute from the collection and choosing the Default, Aggregate, or Advanced option.
- Combine conditions with AND, OR, or EXCEPT operators and group conditions using the canvas toolbar.
- Check the resulting data, view the SQL code, or calculate the number of targeted records before confirming the rule.
Glossary:
- Rule builder: the interface accessed from a Build audience activity used to create targeted queries for Orchestrated campaigns (product-specific)
- Custom condition: a filtering component that lets you filter a query by building a condition with attributes from the database and advanced expressions (product-specific)
- Distribution of values: a tool that shows how values are used within the database, including their counts and percentages, to help avoid issues such as inconsistent capitalization or spelling (product-specific)
- 1-1 link: a table link with one-to-one cardinality, where an attribute from the linked table can be selected directly (product-specific)
- 1-N link (collection table): a table link with one-to-many cardinality, where conditions can target the collection itself or an attribute within it (product-specific)
- Exists such as condition: a condition created when selecting a collection itself (or, with the Default option, an attribute from the collection), which allows sub-conditions to be added (product-specific)
- Default: the recommended option for a collection attribute condition; it automatically creates an exists such as condition for the collection and produces the same result as selecting the collection directly (product-specific)
- Aggregate: an option that applies an aggregate function, such as Count, to the selected collection attribute (product-specific)
- Advanced: an option that uses a direct join to the collection element, evaluating the selected attribute directly, for a single condition on the collection element (product-specific)
- AND (Intersection): an operator that combines results matching all the filtering components in the outbound transitions (product-specific)
- OR (Union): an operator that includes results matching at least one of the filtering components in the outbound transitions (product-specific)
- EXCEPT (Exclusion): an operator that excludes results matching all the filtering components in the outbound transition (product-specific)
- Rule properties pane: the pane used to check a built query, offering View results, Code view, Calculate, and Select or save filter operations (product-specific)
Guardrails:
- For attributes with a large number of values, the Distribution of values tool displays only the first twenty; a Partial load notification appears to indicate this limitation.
- Up to 20 attributes can be added to favorites.
- Each new condition added to a rule is automatically linked to the existing condition by an AND operator.
- Selecting a predefined filter from the Rule properties pane replaces the rule that has been built in the canvas with the selected filter.
Terminology:
- Canonical name: rule builder
FAQ:
- Q: What is a custom condition? — A filtering component that lets you filter a query by building your own condition with attributes from the database and advanced expressions.
- Q: How many attributes can I add to favorites? — Up to 20 attributes.
- Q: What operator links a newly added condition to an existing one? — An AND operator, by default.
- Q: What is the difference between selecting a collection itself and selecting an attribute from the collection with the Default option? — Both create an exists such as condition and produce the same result; the Default option is the recommended choice for most use cases.
- Q: What does the Aggregate option do? — It applies an aggregate function, such as Count, to the selected collection attribute.
- Q: What happens if I select a predefined filter from the Rule properties pane? — It replaces the rule built in the canvas with the selected filter.
Related pages:
- To start a query from a predefined filter, or to save a query as one: Work with predefined filters (orchestrated/predefined-filters.md)
- To manually define an expression using fields from the database and helper functions: Learn how to edit expressions (orchestrated/edit-expressions.md)
Personas:
- marketer: Can build rules for Orchestrated campaigns by adding conditions with database attributes, operators, and values in the rule builder. Can combine conditions using AND, OR, and EXCEPT operators, and check results before confirming. The page states that each new condition is automatically linked to the existing condition by an AND operator. Where: “Combine conditions using operators”.
Onboarding:
- Level: Intermediate
- First minimal step: Access the rule builder from a Build audience activity.
- Success check: You can view the resulting data, view the SQL code, and calculate the number of records targeted by your rule.
- Previous: Starting a query from a predefined filter instead of building a condition from scratch: Work with predefined filters (orchestrated/predefined-filters.md)
- Next: Manually defining an expression using fields from the database and helper functions: Edit expressions (orchestrated/edit-expressions.md)