Extensões de segmento do SQL
Você pode gerar uma extensão de segmento usando consultas de SQL do Snowflake de dados do Snowflake. O SQL pode ajudá-lo a desbloquear novos casos de uso de segmentos porque oferece a flexibilidade de descrever as relações entre os dados de maneiras que não são possíveis por meio de outros recursos de segmentação.
Como as extensões de segmento padrão, você pode consultar eventos dos últimos dois anos (730 dias) em sua extensão de segmento SQL. Diferentemente das extensões de segmento padrão, as extensões de segmento SQL consomem créditos.
Pré-requisitos
Como é possível acessar dados de IPI por meio desse recurso, você deve ter permissões de IPI para executar consultas de segmento SQL.
Criação de uma extensão de segmento
Etapa 1: Escolha um editor
Há dois tipos de editores SQL para escolher ao criar sua extensão de segmento SQL: o SQL Editor e o Incremental SQL Editor.
- Atualização completa: Toda vez que seu segmento for atualizado, o Braze consultará todos os dados disponíveis para atualizar seu segmento, o que usará mais créditos do que as atualizações incrementais. As extensões de atualização completa podem regenerar automaticamente a associação diariamente, mas não podem ser atualizadas usando a atualização incremental.
- Atualização incremental: A atualização incremental calcula apenas os dados dos últimos dois dias, o que é mais econômico e usa menos créditos a cada vez. Ao criar um segmento SQL de atualização incremental, você pode configurá-lo para regenerar automaticamente a associação diariamente. Isso permite que você defina seu segmento para atualizar automaticamente a associação diariamente, o que ajuda a reduzir o custo de uma atualização diária de dados para as extensões de segmento do SQL.
- Gerador de IA SQL: O IA SQL Generator permite que você escreva um prompt em linguagem simples e o transforma em uma consulta de SQL para o seu segmento. É uma maneira rápida de começar sem precisar escrever o SQL por conta própria.
Você pode fazer uma atualização manual completa em todos os segmentos SQL criados em qualquer um dos editores SQL.
Para criar uma extensão de segmento SQL totalmente atualizada:
- Acesse Público > Extensões de segmento.
- Selecione Create New Extension (Criar nova extensão) e, em seguida, selecione Full refresh (Atualização completa).
- Adicione um nome para sua extensão de segmento e insira seu SQL. Consulte a Etapa 2 para obter os requisitos e recursos.
- Salve sua extensão de segmento.
O editor SQL de atualização incremental permite que as agregações de consultas do usuário ocorram por data para um evento dentro de um determinado período de tempo. Para criar uma extensão de segmento SQL de atualização incremental:
- Acesse Público > Extensões de segmento.
Se estiver usando a navegação mais antiga, poderá encontrar essa página em Engajamento > Segmentos > Extensões de segmento.
2. Selecione Create New Extension (Criar nova extensão ) e selecione Incremental refresh (Atualização incremental).
3. Adicione um nome para sua extensão de segmento e insira seu SQL. Consulte a seção Escrevendo SQL para obter os requisitos e recursos.
4. Se desejar, selecione Regenerate Extension Daily (Regenerar extensão diariamente).
Quando selecionado, o Braze atualizará automaticamente a associação ao segmento todos os dias. Isso significa que todos os dias, à meia-noite no fuso horário da sua empresa (com uma possível postergação de uma hora), o Braze verificará se há novos usuários no seu segmento e os adicionará automaticamente ao seu segmento. Se uma extensão de segmento não tiver sido usada em 7 dias, a Braze pausará automaticamente a regeneração diária. Uma extensão de segmento não utilizada é aquela que não faz parte de uma campanha ou de um Canvas (a campanha ou o Canvas não precisa estar ativo para que a extensão seja considerada “usada”).
5. Salve sua extensão de segmento.
O gerador de IA SQL está atualmente disponível como um recurso beta. Entre em contato com seu gerente de sucesso do cliente se tiver interesse em participar dessa avaliação beta.
O gerador de IA SQL aproveita o GPT, desenvolvido pela OpenAI, para recomendar SQL para seu segmento SQL.
Para usar o gerador de IA SQL, faça o seguinte:
- Selecione Iniciar o IA SQL Generator depois de criar um segmento SQL usando a atualização completa ou incremental.
- Digite o prompt e selecione Generate para traduzir o prompt em SQL.
- Revise o SQL gerado para ter certeza de que está correto e, em seguida, salve o segmento.
Exemplos de prompts
- Usuários que receberam um e-mail no último mês
- Usuários que fizeram menos de cinco compras no último ano
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. Por exemplo, seu código SQL deve selecionar a coluna
user_id. Iniciar seu prompt com “users who” pode ajudar. - Você pode enviar até 20 prompts por minuto com o IA SQL Generator.
#### How is my data used and sent to OpenAI? {#ai-policy}
In order to generate AI output through Braze AI features that Braze identifies as leveraging OpenAI (“Output”), Braze will send your prompt, such as message content, brand guidelines, past campaign data, or any other input, as applicable (“Input”) to OpenAI. Input sent to OpenAI from Braze does not identify you or your Users unless you choose to include uniquely identifiable information in your Input. Per OpenAI’s API platform commitments, data sent to OpenAI’s API via Braze is not used to train or improve OpenAI models and will be deleted after 30 days by OpenAI from their systems. Between you and Braze, Output is your intellectual property. Braze will not assert any claims of copyright ownership on such Output. Braze makes no warranty of any kind with respect to any AI-generated content generally, including Output.
As consultas de SQL que demorarem mais de 20 minutos para serem executadas serão encerradas.
Quando a extensão terminar o processamento, você poderá criar um segmento usando sua extensão de segmento e direcionar esse novo segmento com suas campanhas e Canvas.
Etapa 2: Escreva seu SQL
Sua consulta de SQL deve ser escrita usando a sintaxe do Snowflake. Consulte a referência da tabela para obter uma lista completa das tabelas e colunas disponíveis para consulta.
Observe que as tabelas disponíveis para consulta contêm apenas dados de eventos. Se desejar consultar os atributos do usuário, deverá combinar seu segmento SQL com filtros de atributos personalizados do segmentador clássico.
Além disso, seu SQL deve obedecer às seguintes regras:
- Escreva uma única instrução SQL. Não inclua nenhum ponto e vírgula.
- Seu SQL deve selecionar apenas uma coluna: a coluna
user_id. Isso significa que seu SQL deve conter:
1
SELECT DISTINCT user_id FROM "INSERT TABLE NAME"
- Não é possível consultar usuários com zero eventos, o que significa que qualquer consulta para usuários que tenham feito um evento menos de X vezes precisaria seguir essa solução alternativa:
- Escreva uma consulta para selecionar usuários que tenham o evento MAIS de X vezes.
- Ao fazer referência à extensão de segmento em seu segmento, selecione
doesn't includepara inverter o resultado.
Regras adicionais
Além disso, sua consulta de SQL padrão deve obedecer às seguintes regras:
- Você não pode usar as declarações do
DECLARE.
Todas as consultas de atualização incremental consistem em duas partes: uma consulta e detalhes do esquema.
- No editor, escreva uma consulta que selecione
user_ids de sua tabela desejada. - Adicione detalhes do esquema selecionando um Operador, Número de vezes e Período de tempo nos campos acima do editor. A consulta verificará se a soma da coluna agregada atende a uma determinada condição especificada pelos espaços reservados
{{operator}}e{{number of times}}. Isso funciona de forma semelhante ao fluxo de trabalho para a criação de extensões de segmento clássicas.
- Operador: Indique se o evento ocorreu mais do que, menos do que ou igual a um número de ocorrências.
- Número de vezes: Quantas vezes você gostaria de avaliar o evento em relação ao operador.
- Período: Número de dias, de 1 a 730, em que você deseja verificar as instâncias do evento. Esse período de tempo se refere a dias passados em relação ao dia atual. O exemplo a seguir mostra a consulta de usuários que realizaram o evento mais de 5 vezes nos últimos 365 dias.
- Operador: Indique se o evento ocorreu mais do que, menos do que ou igual a um número de ocorrências.
No exemplo a seguir, o segmento resultante conteria usuários que realizaram o evento favorited mais de 3 vezes nos últimos 30 dias, após uma data especificada.
Os segmentos de atualização incremental levam em conta eventos tardios, que são eventos que ocorreram há mais de dois dias (por exemplo, eventos SDK que não foram enviados no momento em que foram capturados).
Regras adicionais
Além disso, sua consulta de atualização incremental deve obedecer às seguintes regras:
- Escreva uma única instrução SQL. Não inclua nenhum ponto e vírgula.
- Seu segmento SQL incremental seria capaz de se referir a apenas um único evento. Seus menus suspensos para data e contagem referem-se ao evento escolhido.
- Seu SQL deve ter as seguintes colunas:
user_id,$start_date, e uma função de agregação (comoCOUNT). Qualquer SQL salvo sem esses três campos resultará em um erro. - Você não pode usar as declarações do
DECLARE.
Se estiver criando um segmento SQL que use a tabela CATALOGS_ITEMS_SHARED, será necessário especificar uma ID de catálogo. Por exemplo:
1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10
Etapa 3: Prévia da consulta
Antes de salvar, você pode executar uma prévia de sua consulta. As prévias de consultas são automaticamente limitadas a 100 linhas e atingem o tempo limite após 60 segundos. O requisito da coluna user_id não se aplica ao executar uma prévia.
Para extensões de segmento SQL incrementais, a prévia não incluirá os critérios adicionais de seu operador, o número de vezes e os campos de período de tempo.
Etapa 4: Determine se você precisa inverter o SQL
Em seguida, determine se você precisa inverter o SQL. Embora não seja possível consultar diretamente os usuários com zero eventos, você pode usar o Invert SQL para direcionar esses usuários.
Por padrão, o Invert SQL não está ativado. No entanto, se você usar o gerador de IA SQL para gerar uma instrução SQL que precise ser negada, o ChatGPT poderá retornar uma saída que ativa automaticamente esse recurso.
Por exemplo, para direcionar usuários que tenham menos de três compras, primeiro escreva uma consulta para selecionar usuários que tenham três ou mais compras. Em seguida, selecione Inverter SQL para direcionamento a usuários com menos de três compras (incluindo aqueles com zero compras).
A menos que esteja direcionando especificamente para usuários com zero eventos, não será necessário inverter o SQL. Se Invert SQL for selecionado, confirme se o recurso é necessário e se o segmento corresponde ao público desejado. Por exemplo, se uma consulta direcionar usuários com pelo menos um evento, ela só direcionará usuários com zero eventos quando invertida.
Atualização da associação de segmentos
Para atualizar a associação de segmentos de qualquer extensão de segmento criada usando o SQL, abra a extensão de segmento e selecione Refresh (Atualizar).
Se tiver criado um segmento no qual espera que os usuários entrem e saiam regularmente, atualize manualmente a extensão de segmento que ele usa antes de direcionar esse segmento em uma campanha ou Canva.
Gerenciamento de suas extensões de segmento
Na página Extensões de segmento, os segmentos gerados usando SQL são indicados com ao lado do nome.
Selecione uma extensão de segmento SQL para visualizar onde a extensão está sendo usada, arquivar a extensão ou atualizar manualmente a associação do segmento.
Designar configurações de atualização
Se não precisar que sua extensão seja atualizada regularmente, você poderá salvá-la sem usar as configurações de atualização, e o Braze gerará sua extensão de segmento com base na associação do usuário naquele momento. Use o comportamento padrão se quiser gerar o público apenas uma vez e depois direcioná-lo com uma campanha única.
Seu segmento sempre começará a ser processado após o salvamento inicial. Sempre que seu segmento for atualizado, o Braze executará novamente o segmento e atualizará a associação do segmento para refletir os usuários em seu segmento no momento da atualização. Isso pode ajudar suas campanhas recorrentes a alcançar os usuários mais relevantes.
Configuração de uma atualização recorrente
Para definir uma agenda recorrente designando configurações de atualização, selecione Ativar atualização. A opção de designar configurações de atualização está disponível para todos os tipos de extensões de segmento, incluindo segmentos SQL, extensões de segmento CDI e extensões de segmento simples baseadas em formulário.
Para otimizar seu gerenciamento de dados, as configurações de atualização são automaticamente desativadas para extensões de segmento não utilizadas. As extensões de segmento são consideradas não utilizadas quando são:
- Não usado em nenhuma campanha, tela ou segmento ativo ou inativo (rascunho, interrompido, arquivado); ou
- Sem modificação há mais de 7 dias
O Braze notificará o contato da empresa e o criador da extensão se essa configuração estiver desativada. A opção de regenerar extensões diariamente pode ser ativada novamente a qualquer momento.
Seleção de suas configurações de atualização
No painel Refresh Interval Settings (Configurações de intervalo de atualização ), você pode selecionar a frequência de atualização dessa extensão de segmento: por hora, diariamente, semanalmente ou mensalmente. Também será necessário selecionar o horário específico (que está no fuso horário da sua empresa) em que a atualização ocorrerá, como, por exemplo:
- Se você tiver uma campanha de envio de e-mail que é enviada todas as segundas-feiras às 11 horas, horário da empresa, e quiser garantir que seu segmento seja atualizado logo antes do envio, deverá escolher uma agenda de atualização semanal às 10 horas das segundas-feiras.
- Se quiser que seu segmento seja atualizado todos os dias, selecione a frequência de atualização diária e, em seguida, escolha a hora do dia para atualizar.
A capacidade de definir um cronograma de atualização por hora não está disponível para extensões de segmento baseadas em formulário (mas você pode definir cronogramas diários, semanais ou mensais).
Consumo de crédito e custos adicionais
Como as atualizações executam novamente a consulta do seu segmento, cada atualização para segmentos SQL consumirá créditos de segmento SQL e cada atualização para extensões de segmento CDI incorrerá em um custo em seu data warehouse de terceiros.
Os segmentos podem levar até 60 minutos para serem atualizados devido ao tempo de processamento dos dados. Os segmentos que estão atualmente em processo de atualização terão o status “Processing” (Processando) na lista de extensões de segmento. Isso tem algumas implicações:
- Para concluir o processamento de seu segmento antes de um horário específico, escolha um horário de atualização que seja 60 minutos antes.
- Somente uma atualização pode ocorrer de cada vez em uma extensão de segmento específica. Se houver um conflito em que uma nova atualização seja iniciada quando uma atualização existente já tiver começado a ser processada, o Braze cancelará a nova solicitação de atualização e continuará o processamento em andamento.
Critérios para desativar automaticamente extensões obsoletas
As atualizações programadas são automaticamente desativadas quando uma extensão de segmento se torna obsoleta. Uma extensão de segmento estará obsoleta se atender aos seguintes critérios:
- Não usado em nenhuma campanha ou tela ativa
- Não usado em nenhum segmento que esteja em uma campanha ativa ou canva
- Não usado em nenhum segmento que tenha o rastreamento de dados ativado
- Não é modificado há mais de sete dias
- Não foi adicionado a uma campanha ou Canva (incluindo rascunhos) ou segmento há mais de sete dias
Se a atualização programada estiver desativada para uma extensão de segmento, essa extensão terá uma notificação informando isso.
Quando estiver pronto para usar uma extensão de segmento desatualizada, revise as configurações de atualização, selecione a programação de atualização que corresponda ao seu caso de uso e salve as modificações.
Créditos para Snowflake
Cada espaço de trabalho da Braze tem 5 créditos Snowflake disponíveis por mês. Se precisar de mais créditos, entre em contato com o gerente da sua conta. Os créditos são usados sempre que você atualiza, ou salva e atualiza, a associação de um SQL Segment. Os créditos não são usados quando você executa prévias em um SQL Segment ou salva ou atualiza uma extensão de segmento clássica.
Os créditos do Snowflake não são compartilhados entre os recursos. Por exemplo, os créditos nas extensões de segmento do SQL e no Criador de Consultas são independentes um do outro.
O uso de crédito está correlacionado ao tempo de execução de sua consulta de SQL. Quanto mais longo for o tempo de execução, mais créditos a 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.
Para economizar créditos, faça uma prévia de sua consulta para garantir que ela esteja correta antes de salvar a extensão de segmento SQL.
Seus créditos serão redefinidos para 5 no primeiro dia de cada mês, às 12 horas UTC. Você pode monitorar o uso do seu crédito durante o mês no painel de uso de créditos. Na página Extensões de segmento, clique em View SQL Credit Usage.
O seguinte ocorrerá quando seus créditos chegarem a zero:
- Todas as extensões de segmento do SQL configuradas para atualização automática deixam de ser atualizadas, afetando a associação desses segmentos e todas as campanhas ou telas direcionadas a esses segmentos.
- Você só pode salvar novas extensões de segmento do SQL como rascunhos durante o restante do mês.
Todos os usuários da empresa que criaram um SQL Segment e os administradores da sua empresa receberão um envio de e-mail de notificação quando você tiver usado 50%, 80% e 100% dos seus créditos. Depois que seus créditos forem redefinidos no início do mês seguinte, você poderá criar mais SQL Segments, e as atualizações automáticas serão retomadas.
Se quiser comprar mais créditos do SQL Segment ou extensões de segmento adicionais, entre em contato com o gerente da sua conta.
Editar esta página no GitHub