Edição de expressão avançada advanced-expression-editing

Sobre a edição de expressão avançada about-advanced-expression-editing

A edição de uma expressão envolve a inserção manual de condições para formar uma regra.

Esse modo permite usar funções avançadas. Essas funções permitem manipular os valores usados para realizar consultas específicas, como manipular datas, strings, campos numéricos, classificação etc.

Também é possível usar variáveis de eventos de workflows ao editar a expressão. Para obter mais informações, consulte a seção Personalização de atividades com variáveis de eventos.

É possível editar expressões para:

  • Definir uma query, por meio da opção Advanced mode que está disponível quando uma regra é adicionada.

  • Editar uma expressão em um workflow. Por exemplo, para adicionar dados a uma atividade.

  • Edite uma condição de visibilidade para definir como um bloco no editor de conteúdo HTML é exibido. Nesse caso, a expressão é editada no formato JavaScript e não oferece o uso de funções avançadas como padrão.

Editar uma expressão edit-an-expression

A edição de expressão avançada permite definir manualmente uma expressão que corresponde especificamente às suas necessidades.

A edição de expressões pode ser usada na janela Audience ao criar um email ou em uma atividade de Query ao criar um workflow.

  1. Acesse a janela de edição de expressões por meio de um dos métodos detalhados na seção Sobre a edição de expressão avançada. Envolve os seguintes elementos:

    • Um campo de entrada no qual a expressão é definida.
    • A lista dos campos disponíveis que podem ser usados na expressão e correspondem à dimensão de dimensionamento da query (consulte Dimensão de dimensionamento e recursos).
    • A lista de funções disponíveis, classificadas por categoria.

  2. Edite a expressão inserindo uma expressão diretamente no campo correspondente ou usando as listas de campos e funções disponíveis.

    Clicar duas vezes em um campo ou expressão adiciona-o à expressão em que o cursor está inserido.

    É possível usar variáveis de eventos de workflows para criar uma expressão. Para obter mais informações, consulte a seção Personalização de atividades com variáveis de eventos.

  3. Dê um nome específico à sua regra, se necessário. O nome inserido será exibido como o nome da regra no espaço de trabalho do Editor de consultas.

A edição de uma expressão permite personalizar a expressão do Audiences para direcionar sua população conforme necessário.

Tópicos relacionados:

Sintaxe da expressão expression-syntax

Sintaxe padrão standard-syntax

As expressões padrão são formadas por uma ou várias condições que respeitam os seguintes elementos de sintaxe:

  • Cada condição assume a forma de <value1> <comparison operator> <value2> em que:

    • <value1> é um campo ou uma função. Por exemplo, @created para a data em que um perfil foi criado ou Year(@created) para o ano em que um perfil foi criado.
    • <comparison operator> é um dos operadores listados na seção Operadores de comparação. Esse operador define o método de comparação entre <value1> e <value2>.
    • <value2> é um campo, uma função ou um valor inserido manualmente.
    note note
    NOTE
    Os dados dos tipos <value1> e <value2> devem ser idênticos. Por exemplo, se <value1> for uma data, <value2> também deverá ser uma data.
  • Se quiser usar várias condições, elas poderão ser combinadas usando operadores lógicos.

    • AND: duas condições são cruzadas.
    • OR: duas condições são combinadas.

Por exemplo:

Year(@created) = Year(GetDate()) AND Month(@created) = Month(GetDate())

Neste exemplo, os perfis cuja data de criação é no mês e ano atuais são direcionados.

Sintaxe JavaScript javascript-syntax

Ao definir as condições de visibilidade de um bloco de tipo de texto do editor de conteúdo HTML, você deve usar uma expressão com a sintaxe de tipo JavaScript.

As expressões JavaScript são constituídas por uma ou várias condições e usam os seguintes elementos de sintaxe:

  • Cada condição assume a forma de <context> <comparison operator> <value2> em que:

    • <context> é um campo ou uma função que permite especificar o contexto. Por exemplo, context.perfil.@email para um endereço de email do perfil ou context.perfil.firstName.length() para o número de caracteres do nome do perfil.
    • <comparison operator> é um dos operadores listados na seção Operadores de comparação. Esse operador define o método de comparação entre <context> e <value2>.
    • <value2> é um campo, uma função ou um valor inserido manualmente.
    note note
    NOTE
    Os dados dos tipos <context> e <value2> devem ser idênticos. Por exemplo, se <context> for uma data, <value2> também deverá ser uma data.
  • Se quiser usar várias condições, elas poderão ser combinadas usando operadores lógicos.

    • &&: duas condições são cruzadas.
    • ||: duas condições são combinadas.

Por exemplo:

context.profile.age > 21 && context.profile.firstName.length() > 0

Neste exemplo, perfis com mais de 21 anos e cujo nome foi fornecido (simbolizado pelo fato de o campo firstName contém pelo menos um caractere).

Operadores de comparação comparison-operators

Para algumas regras, o Editor de consultas permite escolher um valor para definir sua condição.

As condições devem ser vinculadas a valores usando um dos operadores a seguir.

Operador
Sintaxe padrão
Sintaxe JavaScript
Descrição
Exemplo
Equal to
=
==
O primeiro valor deve ser completamente idêntico ao segundo.
@lastName = Martin recupera perfis cujo sobrenome é 'Martin', com apenas esses caracteres idênticos.
Greater than
>
>
O primeiro valor deve ser categoricamente maior que o segundo.
@age > 50 recupera perfis mais antigos que '50', então '51', '52' etc.
Less than
<
<
O primeiro valor deve ser categoricamente menor que o segundo.
@created < DaysAgo(100) recupera todos os perfis criados no banco de dados há menos de 100 dias.
Greater than or equal to
>=
>=
O primeiro valor deve ser maior que ou igual ao segundo valor.
@age >= 30 recupera perfis com 30 anos ou mais.
Less than or equal to
<=
<=
O primeiro valor deve ser menor que ou igual ao segundo.
@age <= 60 recupera perfis com 60 anos ou menos.
Different
!=
!=
O primeiro valor deve ser diferente do segundo.
@language != English recupera perfis que não foram definidos como falantes do inglês.
Contains
IN
N/A
O primeiro valor deve conter o segundo.
@domain IN mail. Aqui, todos os nomes de domínios com o valor 'mail' são retornados no resultado. Consequentemente, o nome de domínio 'gmail.com' fará parte dos resultados retornados.
Like
LIKE
N/A
Like é muito semelhante ao operador Contains. Permite inserir um caractere curinga % no valor que está sendo pesquisado.
@lastName LIKE Mart%n. Aqui, o caractere de substituição % serve como "joker" para encontrar o nome "Martin" no caso hipotético de a ortografia não estar correta.
Not like
NOT
N/A
É semelhante a Like. Permite que você não recupere o valor inserido. Aqui o valor inserido também deve conter o caractere curinga %.
@lastName NOT Smi%h. Aqui, os destinatários correspondem ao nome 'Smi%h' (então Smith, etc.) não são retornados como resultado.
Is empty
IS NULL
N/A
O primeiro valor deve corresponder a um valor vazio.
@mobilePhone IS NULL recupera todos os perfis cujo número de telefone celular não foi fornecido.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff