Consultas de SQL do Query Builder

Aprenda a usar consultas de SQL no Query Builder, para que possa reutilizar suas consultas e evitar a codificação de dados em seu código.

Por que usar variáveis SQL?

Os benefícios do uso de variáveis SQL incluem:

• Economize tempo criando uma variável de campanha para selecionar em uma lista ao criar seu relatório, em vez de colar os IDs de campanha.
• Troque os valores adicionando variáveis que lhe permitam reutilizar o relatório para casos de uso ligeiramente diferentes no futuro (como um evento personalizado diferente).
• Reduza o erro do usuário ao editar seu SQL, reduzindo a quantidade de edição necessária para cada relatório. Os colegas de equipe que se sentem mais à vontade com o SQL podem criar relatórios que podem ser usados por colegas de equipe menos técnicos.

Uso de variáveis

Etapa 1: Adicionar uma variável

Para adicionar uma variável à sua consulta, use a seguinte sintaxe:

1
{{variable_type.${custom_label}}}

Substitua o seguinte:

No exemplo a seguir, o número total de usuários entre o primeiro e o último dia de um mês é consultado para uma campanha. Cada variável será atribuída a um valor na próxima etapa.

1
2
3
4
5
SELECT COUNT(*) AS total_users
FROM USERS_CAMPAIGNS_REVENUE_SHARED
WHERE campaign_id = '{{campaign.${Campaign}}}'
  AND TIME > '{{start_date.${Month First Day}}}'
  AND TIME < '{{end_date.${Month Last Day}}}';

Etapa 2: Atribuir um valor

Por padrão, a guia Variables (Variáveis ) não é exibida no Query Builder. Ele só aparece depois de adicionar sua primeira variável à consulta. Lá, você poderá atribuir um valor a ele. Os valores específicos que você pode escolher dependerão do tipo da variável específica.

No exemplo a seguir, a campanha “Summer Feature Launch” é atribuída como um valor, juntamente com o primeiro e o último dias de junho de 2025.

Tipos de variáveis gerais

Número

number pode ser usado em combinação com outras variáveis não string. Aceita qualquer número positivo ou negativo, inclusive números decimais, como 5.5.

• uso

1
some_number_column < {{number.${custom_label}}}

String

Para alterar os valores repetitivos da string entre as execuções do relatório. Use essa variável para evitar a codificação de um valor várias vezes em seu SQL.

• uso

1
'{{string.${add a string here.}}}'

Lista

Para selecionar em uma lista de opções.

• escolha uma
• escolha múltipla

1
{{options.${metrics} | is_radio_button: 'true' | options: '[{"label": "test", "value": "test_value"}, {"label": "test2", "value": "test_value2"}]'}}

1
{{options.${metrics} | is_multi_select: 'true' | options: '[{"label": "test", "value": "test_value"}, {"label": "test2", "value": "test_value2"}]'}}

Botão de rádio

Para mostrar opções como botões de rádio em vez de um menu suspenso de seleção na guia Variables (Variáveis ). Isso não pode ser usado isoladamente - deve ser usado em combinação com uma lista.

• uso

1
is_radio_button: 'true'

Seleção múltipla

Para saber se o menu suspenso de seleção permite uma seleção única ou múltipla. Isso não pode ser usado isoladamente - deve ser usado em combinação com uma lista.

• uso

1
is_multi_select: 'true'

Opções

Para fornecer a lista de opções selecionáveis na forma de um rótulo e valor. O rótulo é o que é exibido e o valor é o que substitui a variável quando a opção é selecionada. Isso não pode ser usado isoladamente - deve ser usado em combinação com uma lista.

• uso

1
options: '[{"label": "test", "value": "test_value"}, {"label": "test2", "value": "test_value2"}]'

Tipos de variáveis específicas do Braze

Período

Para exibir um calendário para selecionar datas. Substitua start_date e end_date por um carimbo de data/hora Unix em segundos para uma data especificada em UTC, como 1696517353. Opcionalmente, você pode definir apenas um start_date ou end_date para exibir apenas uma única data no calendário. Se os rótulos dos sites start_date e end_date não coincidirem, eles serão tratados como duas datas separadas, em vez de um intervalo de datas.

• uso

1
time > {{start_date.${custom_label}}} AND time < {{end_date.${custom_label}}}

Você pode definir o intervalo de datas para qualquer uma das seguintes opções. Se ambos start_date e end_date forem usados e compartilharem o mesmo rótulo, todas as opções serão mostradas. Caso contrário, se apenas uma for usada, somente a opção especificada será exibida.

Seu Liquid será usado para exibir um calendário dentro do intervalo de datas fornecido:

Campanhas

• uma campanha
• várias campanhas
• variantes de campanha

1
campaign_id = '{{campaign.${custom_label}}}'

1
campaign_id IN ({{campaigns.${custom_label}}})

1
message_variation_api_id IN ({{campaign_variants.${custom_label}}})

Canvas

• uma canva
• várias telas
• variantes de canvas
• uma etapa do canva
• várias etapas do canva

1
canvas_id = '{{canvas.${custom_label}}}'

1
canvas_id IN ({{canvases.${custom_label}}})

1
canvas_variation_api_id IN ({{canvas_variants.${custom_label}}})

1
canvas_step_api_id = '{{canvas_step.${custom_label}}}'

1
canvas_step_api_id IN ({{canvas_steps.${custom_label}}})

Produtos

products é usado para selecionar um ou mais produtos no dashboard do Braze.

• uso
• exemplo

1
({{products.${custom_label}}})

1
2
3
SELECT product_name
FROM FULL_GAME_AND_DLC
WHERE product_id IN ({{products.${Games with DLC}}});

Eventos personalizados

Selecione um ou mais eventos personalizados ou propriedades de eventos personalizados em uma lista.

• evento
• propriedades

1
'{{custom_events.${custom_label}}}'

1
2
3
SELECT event_name
FROM CUSTOM_EVENTS_TABLE
WHERE event_name = '{{custom_events.${Purchased Game}}}';

1
name = '{{custom_event_properties.${property names)}}}'

Espaço de trabalho

workspace é usado para selecionar um único espaço de trabalho no dashboard do Braze.

• uso

1
workspace_id = '{{workspace.${app_group_id}}}'

Catálogos

Selecione um ou mais catálogos ou campos de catálogos em uma lista.

• catálogos
• campos de catálogos

1
catalog_id = '{{catalogs.${catalog}}}'

1
field_name = '{{catalog_fields.${custom_label}}}'

Segmentos

Para selecionar segmentos que tenham a análise de dados ativada. Defina isso como a ID de análise de dados do segmento, que corresponde às IDs armazenadas na coluna user_segment_membership_ids nas tabelas em que essa coluna está disponível.

• uso

1
{{segments.${analytics_segments}}}

Tags

Para selecionar tags para campanhas e telas. Defina Campanhas e Canvas com IDs BSON separados por vírgula e entre aspas simples que estejam associados às tags selecionadas.

• uso

1
{{tags.${some tags}}}

Metadados variáveis

• uso

1
{{string.${my var}| is_required: 'false' | description: 'My optional string var'}}

Booleano

Para saber se o valor de uma variável está preenchido. Isso é útil para variáveis opcionais em que você deseja interromper uma condição se o valor de uma variável não for preenchido. Pode ser definido como true ou false, dependendo do valor da outra variável.

• uso

1
{{string.${type_name_has_no_value} | visible: 'false'}} or {{string.${type_name_has_value} | visible: 'false'}}

type e name referem-se à variável referenciada. Por exemplo, para causar curto-circuito na seguinte variável opcional: {{campaigns.${messaging}}:

1
{{string.${campaigns_messaging_has_no_value}  | visible: 'false'}} OR campaign_id IN ({{campaigns.${messaging} | is_required: 'false'}})

Visível

Para saber se as variáveis estão visíveis. Todas as variáveis são visíveis por padrão na guia Variables (Variáveis ), onde você pode inserir valores.

Há diversas variáveis especiais cujo valor depende de outra variável, como, por exemplo, se outra variável tem um valor. Essas variáveis especiais são marcadas como não visíveis para que não sejam exibidas na guia Variáveis.

• uso

1
visible: 'false'

Obrigatória

Para saber se as variáveis são obrigatórias por padrão. Um valor vazio para uma variável geralmente leva a uma consulta incorreta.

• uso

1
required: 'false'

Pedido

Para selecionar a posição da variável na guia Variáveis.

• uso

1
order: '1'

Incluir cotações

• aspas simples
• aspas duplas

1
include_quotes: 'true'

1
include_double_quotes: 'true'

Espaço reservado

Para especificar o texto do espaço reservado mostrado no campo de entrada da variável.

• uso

1
placeholder: 'enter some value'

Descrição

Para especificar o texto de descrição mostrado no campo de entrada da variável.

• uso

1
description: 'some description'

Valor padrão

Para especificar o valor padrão da variável quando nenhum valor for especificado.

• uso

1
default_value: '5'

Ocultar rótulo

Para ocultar o rótulo da variável.

• uso

1
hide_label: 'true'