DocumentaçãoCampaignInterface do Campaign Web

Criar a primeira consulta build-query

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Para começar a criar uma consulta, acesse o modelador de consultas do local de sua escolha, dependendo da ação que deseja executar. O modelador de Consulta é aberto com uma tela em branco. Clique no botão + para configurar o primeiro nó da consulta.

Você pode adicionar dois tipos de elementos:

  • Os componentes de filtragem (Condição personalizada, Selecionar público, Filtro predefinido) permitem que você crie suas próprias regras, selecione um público ou um filtro predefinido para refinar sua consulta. Elas são adicionadas no início da query e em transições pontilhadas. Saiba como trabalhar com componentes de filtragem

    Exemplo: Destinatários que assinaram o informativo "Esportes". Recipients morando em Nova York, Recipients morando em São Francisco

    {modal="regular"}

  • Operadores de grupo (AND, OR, EXCEPT) permitem agrupar componentes de filtragem no diagrama. Eles são adicionados em transições existentes antes de um componente de filtragem. Saiba como trabalhar com operadores

    Exemplo: Recipients que assinaram o informativo "Esportes"AND ​que vivem em Nova York OR ​San Francisco.

    {modal="regular"}

Adicionar componentes de filtragem filtering

Os componentes de filtragem permitem refinar a consulta usando:

  • Condições personalizadas: filtre sua consulta criando sua própria condição com atributos do banco de dados e expressões avançadas.
  • Públicos: filtre sua consulta usando um público existente.
  • Filtro predefinido: filtre sua consulta usando filtros predefinidos existentes.

Configurar uma ação personalizada custom-condition

Para filtrar sua consulta usando uma condição personalizada, siga estas etapas:

  1. Clique no botão + no nó desejado e selecione Condição personalizada. O painel de propriedades de condição personalizada é aberto no lado direito.

  2. No campo Atributo, selecione o atributo do banco de dados que você deseja usar para criar sua condição. A lista de atributos inclui todos os atributos do banco de dados do Campaign, incluindo atributos de tabelas vinculadas.

    {modal="regular"}

    note note
    NOTE
    O botão Editar expressão permite que você aproveite o editor de expressão da Web do Campaign para definir manualmente uma expressão usando campos do banco de dados e funções auxiliares. Saiba como editar expressões

  3. Selecione o operador a ser aplicado na lista suspensa. Vários operadores estão disponíveis para uso. Observe que os operadores disponíveis na lista suspensa dependem do tipo de dados 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. Last name (@lastName) equal to 'Jones', retornará apenas destinatários cujo sobrenome seja Jones.
    Diferente de Retorna todos os valores não idênticos ao valor inserido. Idioma (@language) a ser igual a 'English'
    Maior que Retorna um valor maior que o valor digitado. Age (@age) greater than 50, retornará todos os valores maiores que '50', ou seja, '51', '52' etc.
    Menor que Retorna um valor menor que o valor digitado. Creation date (@created) before '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 maiores que o valor digitado. Age (@age) greater than or equal to '30', retornará todos os destinatários maiores de 30 anos ou mais.
    Menor que ou igual a Retorna todos os valores iguais ou inferiores ao valor inserido. Age (@age) less than or equal to '60', retornará todos os destinatários com 60 anos ou menos.
    Incluído em Retorna resultados incluídos nos valores indicados. Esses valores devem ser separados por vírgula. Birth date (@birthDate) is included in '12/10/1979,12/10/1984' retornará os destinatários nascidos entre essas datas.
    Não está em Funciona como o operador Is included in. Aqui, queremos excluir destinatários com base nos valores inseridos. A data de nascimento (@birthDate) não está incluída em '12/10/1979,12/10/1984'. Ao contrário do exemplo anterior, os destinatários nascidos nessas datas não serão retornados.
    Está vazio Nesse caso, o resultado que estamos procurando corresponde a um valor vazio na segunda coluna de valor. Mobile (@mobilePhone) is empty retorna todos os destinatários que não têm número de celular.
    Não está vazio Funciona de forma inversa ao operador Is empty. Não é necessário inserir dados na segunda coluna de valor. O email (@email) não está vazio.
    Inicia com Retorna os resultados iniciando com o valor inserido. Account # (@account) starts with '32010'.
    Não começa com Retorna os resultados que não começam com o valor inserido Account # (@account) não começa com '20'
    Contém Retorna os resultados contendo pelo menos o valor inserido. Email domain (@domain) contains 'mail' retornará todos os nomes de domínio que contêm 'mail'. Assim, o domínio "gmail.com" também será retornado.
    Não contém Retorna resultados não contendo o valor digitado. O domínio de email (@domain) não contém 'vo'. Nesse caso, nomes de domínio que contêm 'vo' não serão retornados. O nome de domínio 'voila.fr' não aparecerá nos resultados.
    Como Like é muito semelhante ao operador Contains. Permite inserir um caractere curinga % no valor. Sobrenome (@lastName) como 'Jon%s'. Aqui, o caractere curinga é usado como "joker" para localizar o nome "Jones", o operador esqueceu a letra ausente entre o 'n' e o 's'.
    Not like Like é muito semelhante ao operador Contains. Permite inserir um caractere curinga % no valor. Sobrenome (@lastName) diferente de 'Smi%h'. Aqui, os destinatários que têm 'Smi%h' como sobrenome não serão retornados.

  4. No campo Value, defina o valor esperado. Você também pode usar o editor de expressão da Web do Campaign para definir manualmente uma expressão usando campos do banco de dados e funções auxiliares. Para fazer isso, clique no botão Editar expressão. Saiba como editar expressões

    Exemplo de consulta retornando todos os perfis com 21 anos ou mais:

    {modal="regular"}

    Para atributos do tipo data, os valores predefinidos estão disponíveis usando a opção Predefinições.

    {modal="regular"}

As condições personalizadas permitem consultar tabelas vinculadas à tabela usada atualmente pela regra. Isso inclui tabelas com um link de cardinalidade 1-1 ou tabelas de coleção (link 1-N).

Para um link 1-1, navegue até a tabela vinculada, selecione o atributo desejado e defina o valor esperado.

Você também pode selecionar diretamente um link de tabela no seletor de Valor e confirmar. Nesse caso, os valores disponíveis para a tabela selecionada precisam ser selecionados usando um seletor dedicado, como mostrado no exemplo abaixo.

Exemplo de consulta

Aqui, a consulta está direcionando marcas cujo rótulo é "running".

  1. Navegue dentro da tabela Marca e selecione o atributo Etiqueta.

    {modal="regular"}

  2. Defina o valor esperado para o atributo.

    {modal="regular"}

Esta é uma amostra de consulta em que um link de tabela foi selecionado diretamente. Os valores disponíveis para esta tabela devem ser selecionados em um seletor dedicado.

{modal="regular"}

Para um link 1-N, você pode definir subcondições para refinar sua consulta, como mostrado no exemplo abaixo.

Exemplo de consulta

Aqui, o query é direcionado a recipients que fizeram compras relacionadas ao produto BrewMaster, para um valor total de pelo menos 100$.

  1. Selecione a tabela Compras e confirme.

    {modal="regular"}

  2. Uma transição de saída é adicionada, permitindo criar subcondições.

    {modal="regular"}

  3. Selecione o atributo Preço e direcione compras de US$ 1000 ou mais

    {modal="regular"}

  4. Adicione subcondições para atender às suas necessidades. Aqui adicionamos uma condição aos perfis do público-alvo que compraram um produto BrewMaster.

    {modal="regular"}

Trabalhar com dados agregados aggregate

As condições personalizadas permitem executar operações agregadas. Para fazer isso, você precisa selecionar diretamente um atributo de uma tabela de coleção:

  1. Navegue dentro da tabela de coleção desejada e selecione o atributo no qual deseja executar uma operação agregada.

    {modal="regular"}

  2. No painel de propriedades, alterne a opção Aggregate data e selecione a função de agregação desejada.

    {modal="regular"}

Selecionar um público-alvo audiences

Para filtrar sua query usando um público existente, siga estas etapas:

  1. Clique no botão + no nó desejado e escolha Selecionar público-alvo.

  2. O painel de propriedades Selecionar público-alvo é aberto no lado direito. Escolha o público-alvo que deseja usar para filtrar o query.

    Exemplo de consulta retornando todos os perfis que pertencem ao público-alvo do "Festival Goers":

    {modal="regular"}

Usar um filtro predefinido predefined-filters

Para filtrar sua query usando um filtro predefinido, siga estas etapas:

  1. Clique no botão + no nó desejado e selecione Filtro predefinido.

  2. O painel de propriedades Filtro predefinido é aberto no lado direito. Selecione um filtro predefinido na lista de filtros personalizados ou nos favoritos.

    Exemplo de consulta retornando todos os perfis correspondentes ao filtro predefinido "Clientes inativos":

    {modal="regular"}

Copiar e colar componentes copy

O modelador de query permite copiar um ou vários componentes de filtragem e colá-los no final de uma transição. Essa operação pode ser executada na tela de consulta atual ou em qualquer tela na instância.

NOTE
A seleção copiada é mantida enquanto você estiver trabalhando na instância. Se você fizer logoff e logon novamente, sua seleção não estará mais disponível para colagem.

Para copiar e colar componentes de filtragem, siga estas etapas:

  1. Selecione o componente de filtragem que deseja copiar clicando nele na tela de consulta. Para selecionar vários componentes, use a ferramenta de seleção múltipla disponível na barra de ferramentas, localizada no canto superior direito da tela.

  2. Clique no botão Copiar no painel de propriedades do componente ou na faixa de opções azul na parte inferior da tela se tiver selecionado vários componentes.

    table 0-row-2 1-row-2
    Copiar um único componente Copiar vários componentes
    {modal="regular"} {modal="regular"}

  3. Para colar o(s) componente(s), clique no botão + no final da transição desejada e selecione Colar n itens.

    {modal="regular"}

Combinar componentes de filtragem com operadores operators

Sempre que um novo componente de filtragem é adicionado à consulta, ele é automaticamente vinculado ao outro componente por um operador AND. Isso significa que os resultados dos dois componentes de filtragem são combinados.

Neste exemplo, adicionamos novos componentes de filtragem do tipo público-alvo na segunda transição. O componente está vinculado à condição de filtro predefinida com um operador AND, o que significa que os resultados da consulta incluem destinatários direcionados pelo filtro predefinido "Madridians" E pertencentes ao público "Discount hunters".

Para alterar o operador usado para vincular as condições do filtro, clique nele e selecione o operador desejado no painel Grupo que será aberto no lado direito.

Os operadores disponíveis são:

  • AND (Interseção): combina resultados que correspondem a todos os componentes de filtragem nas transições de saída.
  • OR (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.

Além disso, você pode criar grupos intermediários de componentes clicando no botão + em uma transição. Isso permite adicionar um operador nesse local específico para agrupar vários componentes e refinar sua consulta.

No exemplo abaixo, criamos um grupo intermediário para incluir resultados dos públicos "VIP para recompensar" ou "Super VIP".

Verificar e validar sua consulta

Depois de criar a consulta na tela, você pode verificá-la usando o painel Propriedades da regra, localizado no lado direito. Esse painel é exibido ao criar uma consulta para criar um público-alvo. As operações disponíveis são:

  • Exibir resultados: Exibe os dados resultantes da sua consulta.

  • Visualização de código: exibe uma versão baseada em código da consulta no SQL.

  • Calcular: atualiza e exibe o número de registros direcionados por sua consulta.

  • Selecionar ou salvar filtro: escolha um filtro predefinido existente para usar na tela ou salve sua consulta como um filtro predefinido para reutilização futura. Saiba como trabalhar com filtros predefinidos

    note important
    IMPORTANT
    Selecione um filtro predefinido no painel de propriedades Regra para substituir a consulta criada na tela pelo filtro selecionado.

Quando a consulta estiver pronta, clique no botão Confirmar no canto superior direito para salvá-la.

Você pode modificar sua query a qualquer momento abrindo-a. Lembre-se de que, ao abrir uma consulta existente, ela é exibida em uma exibição simplificada, sem a visibilidade dos botões +. Para adicionar novos elementos à consulta, selecione um componente ou operador na tela para exibir os botões +.

recommendation-more-help
c39c2d00-ba9a-424b-adf9-66af58a0c34b