Criador de consultas

O Construtor de consultas gera relatórios usando dados do Braze no Snowflake. O Criador de consultas vem com modelos de consultas de SQL pré-construídas para você começar, ou você pode escrever suas próprias consultas de SQL personalizadas para desbloquear ainda mais insights.

Como o Criador de consultas permite acesso direto a alguns dados de clientes, você só pode acessar o Criador de consultas se tiver a permissão “Ver IPI”.

Execução de relatórios no Query Builder

Para executar um relatório do Query Builder:

1. Acesse Análise de dados > Criador de consultas.
2. Selecione Create SQL Query (Criar consulta de SQL). Se precisar de inspiração ou ajuda para elaborar sua consulta, selecione Query Template (Modelo de consulta ) e escolha um modelo da lista. Caso contrário, selecione Editor de SQL para ir direto ao editor.
3. Seu relatório recebe automaticamente um nome com a data e a hora atuais. Passe o mouse sobre o nome e selecione para dar à sua consulta de SQL um nome significativo.
4. Escreva sua consulta de SQL no editor ou obtenha ajuda da IA na guia IA Query Builder. Se estiver escrevendo seu próprio SQL, consulte Como escrever consultas de SQL personalizadas para obter requisitos e recursos.
5. Selecione Executar consulta.
6. Salve sua consulta.
7. Para baixar um CSV de seu relatório, selecione Exportar.

Os resultados de cada relatório podem ser gerados uma vez por dia. Se você executar o mesmo relatório mais de uma vez em um dia do calendário, verá os mesmos resultados em ambos os relatórios.

Modelos de consulta

Acesse os modelos de consulta selecionando Criar consulta de SQL > Modelo de consulta ao criar um relatório pela primeira vez.

Consulte Modelos de consulta para obter uma lista dos modelos disponíveis.

Período de dados

Todas as consultas apresentam dados dos últimos 60 dias.

Fuso horário do Query Builder

O fuso horário padrão para consultas ao nosso banco de dados Snowflake é UTC. Como resultado, pode haver algumas discrepâncias de dados entre a página de engajamento do canal de e-mail (que segue o fuso horário de sua empresa) e os resultados do Query Builder.

Para converter o fuso horário nos resultados da consulta, adicione o seguinte SQL à consulta e personalize-o de acordo com o fuso horário de sua empresa:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
SELECT
DATE_TRUNC(
'day',
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME))
) AS send_date_sydney,
COUNT(ID) AS emails_sent
USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE
-- Apply the date range in Sydney time as well
CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) >= '2025-03-25 00:00:00'
AND CONVERT_TIMEZONE('UTC','Australia/Sydney', TO_TIMESTAMP(TIME)) < '2025-03-29 00:00:00'
AND APP_GROUP_ID = 'your app group ID'
GROUP BY
send_date_sydney
ORDER BY
send_date_sydney;

Geração de SQL com o Criador de consultas com IA

O Criador de consultas com IA usa o GPT, desenvolvido pela OpenAI, para recomendar SQL para sua consulta.

Para gerar SQL com o Criador de consultas com IA:

1. Depois de criar um relatório no Criador de consultas, selecione a guia Criador de consultas com IA.
2. Digite seu prompt ou selecione um prompt de amostra e selecione Gerar para traduzir seu prompt para SQL.
3. Revise o SQL gerado para ter certeza de que está correto e, em seguida, selecione Insert into Editor (Inserir no editor).

Dicas

• Familiarize-se com as tabelas de dados disponíveis do Snowflake. A solicitação de dados que não existem nessas tabelas pode fazer com que o ChatGPT crie uma tabela falsa.
• Familiarize-se com as regras de escrita SQL para esse recurso. O não cumprimento dessas regras causará um erro.
• Você pode enviar até 20 prompts por minuto com o Criador de consultas com IA.

Como meus dados são usados e enviados para a OpenAI?

Para gerar seu SQL, a Braze enviará seus prompts para a API Platform da OpenAI. Todas as consultas enviadas pela Braze à OpenAI são anônimas, o que significa que a OpenAI não poderá identificar o remetente da consulta, a menos que você inclua informações exclusivamente identificáveis no conteúdo fornecido. Conforme detalhado nos Compromissos da Plataforma de API da OpenAI, os dados enviados à API da OpenAI via Braze não são usados para treinar ou melhorar seus modelos e serão excluídos após 30 dias. Siga às políticas da OpenAI relevantes para você, incluindo a Política de Uso. A Braze não oferece nenhuma garantia de qualquer tipo com relação a qualquer conteúdo gerado por IA.

Escrever consultas de SQL personalizadas

Escreva sua consulta de SQL usando a sintaxe do Snowflake. Consulte a referência da tabela para obter uma lista completa das tabelas e colunas disponíveis para consulta.

Para visualizar os detalhes da tabela no Query Builder:

1. Na página do Construtor de consultas, abra o painel Referência e selecione Tabelas de dados disponíveis para visualizar as tabelas de dados disponíveis e seus nomes.
2. Selecione See Details para visualizar a descrição da tabela e as informações sobre as colunas da tabela, como os tipos de dados.
3. Para inserir o nome da tabela em seu SQL, selecione .

Para usar consultas pré-escritas fornecidas pelo Braze, selecione Modelo de consulta ao criar um relatório pela primeira vez no Query Builder.

Restringir sua consulta a um período de tempo específico o ajudará a gerar resultados mais rapidamente. A seguir, um exemplo de consulta que obtém o número de compras e a receita gerada na última hora.

1
2
3
SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

Essa consulta recupera o número de envios de e-mail no último mês:

1
2
3
SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

Se você consultar CANVAS_ID, CANVAS_VARIATION_API_ID ou CAMPAIGN_ID, suas colunas de nome associadas serão automaticamente incluídas na tabela de resultados. Não é necessário incluí-los na própria consulta SELECT.

Essa consulta recupera todos os três IDs e suas colunas de nome associadas com um máximo de 100 linhas:

1
2
3
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Preencher automaticamente o nome da variante da campanha

Se quiser que o nome da variante de campanha seja preenchido automaticamente, inclua o nome da coluna MESSAGE_VARIATION_API_ID em sua consulta, como neste exemplo:

1
2
3
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID, MESSAGE_VARIATION_API_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED 
LIMIT 100

Solução de problemas

Sua consulta pode falhar por qualquer um dos seguintes motivos:

• Erros de sintaxe em sua consulta de SQL
• Tempo limite de processamento (após 6 minutos)
  • Os relatórios que demorarem mais de 6 minutos para serem executados serão encerrados.
  • Se um relatório não atingir o tempo limite, tente limitar o intervalo de tempo em que está consultando os dados ou consulte um conjunto de dados mais específico.

Uso de variáveis

Use variáveis para usar tipos de variáveis predefinidas no SQL para fazer referência a valores sem precisar copiar manualmente o valor. Por exemplo, em vez de copiar manualmente o ID de uma campanha para o editor SQL, você pode usar {{campaign.${My campaign}}} para selecionar diretamente uma campanha em um menu suspenso na guia Variables (Variáveis ).

Depois que uma variável for criada, ela aparecerá na guia Variáveis de seu relatório do Criador de consultas. 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.

Diretrizes

As variáveis devem obedecer à seguinte sintaxe Liquid: {{ type.${name}}}, em que type deve ser um dos tipos aceitos e name pode ser qualquer coisa que você escolher. Os rótulos dessas variáveis têm como padrão o nome da variável.

Por padrão, todas as variáveis são obrigatórias (e o relatório não será executado a menos que os valores das variáveis sejam selecionados), exceto o intervalo de datas, cujo padrão é os últimos 30 dias quando o valor não é fornecido.

Tipos de variáveis

Os seguintes tipos de variáveis são aceitos:

• Número
• Período
• Envio de mensagens
• Produtos
• Eventos personalizados
• Propriedades de eventos personalizados
• Espaço de trabalho
• Catálogos
• Campos do catálogo
• Opções
• Segmentos
• String
• Tags

Número

• Valor de substituição: O valor fornecido, como 5.5
• Exemplo de uso: some_number_column < {{number.${some name}}}

Período

Se estiver usando start_date e end_date, eles devem ter o mesmo nome para que você possa usá-los como um intervalo de datas.

Valores de exemplo

O tipo de intervalo de datas pode ser relativo, data inicial, data final ou intervalo de datas.

Todos os quatro tipos são mostrados se start_date e end_date forem usados com o mesmo nome. Se apenas um for usado, somente os tipos relevantes serão exibidos.

• Valor de substituição: Substitui start_date e end_date por um carimbo de data/hora Unix em segundos para uma data especificada em UTC, como 1696517353.
• Exemplo de uso: Para todas as variáveis relativas, data de início, data de término e intervalo de datas:
  • time > {{start_date.${some name}}} AND time < {{end_date.${some name}}}
    • Você pode usar start_date ou end_date se não quiser um intervalo de datas.

Envio de mensagens

Todas as variáveis de envio de mensagens devem compartilhar o mesmo identificador quando você quiser unir o estado delas em um grupo.

Canva

Para selecionar um Canva. Compartilhar o mesmo nome com uma campanha resultará em um botão de opção na guia Variables (Variáveis ) para selecionar Canva ou campanha.

• Valor de substituição: ID do BSON da tela
• Exemplo de uso: canvas_id = ‘{{canvas.${some name}}}’

Canvas

Para selecionar várias telas. Compartilhar o mesmo nome com uma campanha resultará em um botão de opção na guia Variables (Variáveis ) para selecionar Canva ou campanha.

• Valor de substituição: Canvas IDs BSON
• Exemplo de uso: canvas_id IN ({{canvases.${some name}}})

Campanha interrompida

Para selecionar uma campanha. Compartilhar o mesmo nome com um Canvas resultará em um botão de opção na guia Variables (Variáveis ) para selecionar Canvas ou campanha.

• Valor de substituição: ID BSON da campanha
• Exemplo de uso: campaign_id = ‘{{campaign.${some name}}}’

Campanhas

Para campanhas de seleção múltipla. Compartilhar o mesmo nome com um Canvas resultará em um botão de opção na guia Variables (Variáveis ) para selecionar Canvas ou campanha.

• Valor de substituição: IDs BSON de campanhas
• Exemplo de uso: campaign_id IN ({{campaigns.${some name}}})

Variantes de campanha

Para selecionar variantes de campanha que pertencem à campanha selecionada. Ele deve ser usado em conjunto com uma variável de campanha ou de campanhas.

• Valor de substituição: IDs da API de variantes de campanha, strings delimitadas por vírgulas, como api-id1, api-id2.
• Exemplo de uso: message_variation_api_id IN ({{campaign_variants.${some name}}})

Variantes da tela

Para selecionar as variantes do Canvas que pertencem a um Canvas escolhido. Ele deve ser usado com uma variável Canvas ou Canvases.

• Valor de substituição: IDs de API das variantes do canva, strings delimitadas por vírgulas, como em api-id1, api-id2.
• Exemplo de uso: canvas_variation_api_id IN ({{canvas_variants.${some name}}})

Etapa do canva

Para selecionar uma etapa do Canva que pertença a um Canvas escolhido. Ele deve ser usado com uma variável Canva.

• Valor de substituição: ID da API da etapa do canva
• Exemplo de uso: canvas_step_api_id = ‘{{canvas_step.${some name}}}’

Etapas do canva

Para selecionar as etapas do Canvas que pertencem aos Canvases escolhidos. Ele deve ser usado com uma variável Canvas ou Canvases.

• Valor de substituição: IDs da API das etapas do canva
• Exemplo de uso: canvas_step_api_id IN ({{canvas_steps.${some name}}})