Criador de consultas

Saiba como usar o Query Builder para gerar relatórios usando dados da Braze no Snowflake. O Query Builder vem com modelos de consultas de SQL pré-construídos para você começar, ou você pode escrever suas próprias consultas de SQL personalizadas para desbloquear ainda mais insights.

Pré-requisitos

Você precisará de permissões “View IPI” para usar o Query Builder, pois ele permite acesso direto a alguns dados de clientes.

Uso do Query Builder

Etapa 1: Criar uma consulta de SQL

Para criar uma nova consulta, acesse Análise de dados > Query Builder e selecione Criar consulta de SQL.

Se precisar de inspiração ou ajuda para elaborar sua consulta, escolha Query Template (Modelo de consulta) e selecione um modelo pronto. Para começar com uma consulta em branco, selecione SQL Editor.

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.

Etapa 2: Crie sua consulta

Ao criar sua consulta, você pode optar por obter ajuda da IA ou criá-la por conta própria.

• using brazeai
• on my own

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()));

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()));

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

Etapa 3: Gerar seu relatório

Quando terminar de criar sua consulta, selecione Run Query. Se não houver erros ou tempo limite do relatório, um arquivo CSV será gerado a partir da consulta.

Para baixar o relatório CSV, selecione Exportar.

Tempo limite de relatórios

Os relatórios que demorarem mais de seis minutos para serem executados serão encerrados. Se esta for a primeira consulta que você está executando em algum tempo, ela poderá levar mais tempo para ser processada e, portanto, terá uma probabilidade maior de atingir o tempo limite. Se isso acontecer, tente executar o relatório novamente.

Se o seu relatório continuar a apresentar tempo limite após várias tentativas, fale com o Suporte.

Consultando motivos de cancelamento

Você pode consultar a coluna ABORT_TYPE em qualquer tabela USERS_MESSAGES_*_ABORT_SHARED para analisar por que as mensagens não foram enviadas. O campo ABORT_TYPE contém um valor da string descrevendo o motivo específico do cancelamento, e o campo complementar ABORT_LOG contém informações adicionais (como a regra de limite de frequência que foi acionada).

Por exemplo, para contar cancelamentos de e-mail por tipo nos últimos 30 dias:

1
2
3
4
5
SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

Para a lista completa de valores de ABORT_TYPE e suas descrições, consulte Tipos de cancelamento.

Dados e resultados

Todas as consultas apresentam dados dos últimos 60 dias. Quando você exportar seus resultados, eles conterão apenas até 1.000 linhas. Para relatórios que exigem grandes quantidades de dados, você pode usar ferramentas como o Currents ou o endpoint da API de exportação.

Créditos do Snowflake

Cada empresa tem 5 créditos Snowflake disponíveis por mês, compartilhados em todos os espaços de trabalho. Uma pequena parte de um crédito do Snowflake é usada sempre que você executa uma consulta ou visualiza a prévia de uma tabela.

O uso de crédito está correlacionado ao tempo de execução de sua consulta de SQL. Quanto maior for o tempo de execução, maior será a porção de crédito do Snowflake que uma consulta custará. O tempo de execução pode variar de acordo com a complexidade e o tamanho de suas consultas ao longo do tempo. Quanto mais complexas e frequentes forem as consultas executadas, maior será a alocação de recursos e mais rápido será o tempo de execução.

Os créditos não são usados ao escrever, editar ou salvar relatórios no editor SQL da Braze. Seus créditos serão redefinidos para 5 no primeiro dia de cada mês, às 12h UTC. Você pode monitorar o uso mensal de créditos na parte superior da página do Query Builder.

Quando você atinge o limite de crédito, não pode executar consultas, mas pode criar, editar e salvar relatórios de SQL. Se quiser comprar mais créditos do Query Builder, entre em contato com o gerente da sua conta.