Extensões de Segment
As extensões de Segment permitem que você crie segmentos muito precisos ao longo de um período estendido do histórico de um usuário. Por exemplo, usando extensões de Segment, você pode direcionar usuários que compraram um produto específico nos últimos dezesseis meses ou que gastaram uma determinada quantia com o seu serviço. Refine esse público usando propriedades de eventos para tornar o direcionamento ainda mais granular.
A segmentação da Braze permite que você direcione usuários com base em eventos personalizados ou comportamento de compra. As extensões de Segment ampliam essa capacidade, permitindo que você utilize dados históricos salvos no perfil do usuário. Com as extensões de Segment, você pode identificar e alcançar usuários que realizaram qualquer evento personalizado ou evento de compra qualquer número de vezes nos últimos dois anos (730 dias).
Por que usar extensões de Segment?
Os Segments da Braze oferecem ferramentas de direcionamento poderosas para criar grupos dinâmicos de usuários. Na maioria dos casos de uso, isso já é suficiente para alcançar seu público de forma eficaz. As extensões de Segment são projetadas para casos de uso avançados em que você precisa analisar comportamentos de até dois anos atrás ou aplicar lógica complexa, sem comprometer a retenção de dados ou o desempenho do sistema. Você pode usar consultas SQL (extensões de Segment SQL) ou dados do seu próprio data warehouse para refinar ainda mais seu público.
Por exemplo, a segmentação padrão da Braze encontra usuários que atendem a critérios específicos que você define, como identificar um usuário que comprou recentemente um dos seus produtos. As extensões de Segment permitem ir mais fundo — como identificar usuários que compraram uma cor específica de um produto específico pelo menos duas vezes entre 18 e 24 meses atrás. As extensões de Segment são um aprimoramento, não um requisito. Se você precisa de filtros mais avançados ou de uma janela de análise mais longa, elas são uma ótima ferramenta para ajudar, mantendo o uso dos seus dados otimizado.
Há uma cota padrão de 50 extensões de Segment ativas por espaço de trabalho em um determinado momento. Se você precisar aumentar esse limite, entre em contato com seu gerente de sucesso do cliente da Braze para discutir seu caso de uso.
Criando uma extensão de Segment
Para criar uma extensão de Segment, você cria um filtro para refinar um segmento dos seus usuários com base em propriedades de eventos personalizados. Ao criar uma extensão de Segment, você escolhe se o segmento será estático ou atualizado dinamicamente em um intervalo definido.
Etapa 1: Acesse as extensões de Segment
Acesse Audience > Segment Extensions.
Na tabela de extensões de Segment, selecione Create New Extension e, em seguida, selecione sua experiência de criação de extensão de Segment:
- Simple extension: Crie uma extensão de Segment focada em um único evento usando um formulário guiado. Ideal quando você não quer usar SQL.
- Start with a template: Crie um Segment SQL com um modelo personalizável usando dados do Snowflake.
- Incremental refresh: Escreva um Segment SQL do Snowflake que atualiza automaticamente os últimos 2 dias de dados ou atualize manualmente conforme necessário. Ideal para equilibrar precisão e eficiência de custo.
- Full refresh: Escreva um Segment SQL com dados do Snowflake ou qualquer fonte conectada CDI que recalcula todo o público ao atualizar manualmente. Ideal quando você precisa de uma visão completa e atualizada do seu público.
Se você selecionar uma experiência que usa SQL, consulte Extensões de Segment SQL para mais informações. Se selecionar Simple extension, continue para a etapa 2.
Uso de créditos SQL
| Tipo de extensão de Segment | Créditos SQL da Braze |
|---|---|
| Extensões de Segment SQL (atualização incremental e completa) | Consomem créditos SQL da Braze. |
| Segments de catálogo | Consomem créditos SQL da Braze. |
| Segments CDI | Não consomem créditos SQL da Braze. Eles consultam seu data warehouse diretamente, então os custos são cobrados pelo seu provedor de data warehouse. |
Etapa 2: Nomeie sua extensão de Segment
Nomeie sua extensão de Segment descrevendo o tipo de usuários que você pretende filtrar. Isso ajuda outras pessoas a encontrar e aplicar a extensão com precisão.
Etapa 3: Escolha seus critérios
Selecione entre critérios de compra, engajamento com mensagem, evento recomendado de eCommerce ou evento personalizado para direcionamento. Depois de selecionar os critérios de tipo de evento desejados, escolha qual item comprado, interação com mensagem, evento recomendado de eCommerce ou evento personalizado você deseja direcionar para sua lista de usuários. Em seguida, escolha quantas vezes (mais que, menos que ou igual a) o usuário precisaria ter realizado o evento, e o período de tempo — para extensões de Segment especificamente, você pode retroceder até 730 dias (2 anos).
Para dados recentes de interação com mensagens apenas, consulte Filtros calculados.
A segmentação baseada em dados de eventos com mais de 730 dias pode ser feita usando outros filtros localizados em Segments. Ao escolher seu período de tempo, você pode especificar um intervalo de datas relativo para selecionar os últimos X dias, uma data de início, uma data de término ou um intervalo de datas exato (data A até data B).
Se você estiver criando uma extensão de Segment usando um evento recomendado de eCommerce, primeiro selecione eCommerce Recommended Event como seu critério e, em seguida, selecione um evento no menu suspenso.
Segmentação por propriedade de evento
Para aumentar a precisão do direcionamento, marque a caixa de seleção Add Property Filters. Isso permite que você faça um detalhamento com base nas propriedades específicas da sua compra ou evento personalizado. Oferecemos suporte à segmentação por propriedade de evento com base em objetos de string, numéricos, booleanos e de tempo.
Tipos de dados de propriedade
Para propriedades de string, você pode inserir vários valores de uma vez. No exemplo a seguir, esse filtro procura usuários com uma raça de cachorro igual a qualquer uma das seis raças específicas.
Propriedades de eventos recomendados de eCommerce
Quando você adiciona uma propriedade de evento para um evento recomendado de eCommerce, o menu suspenso de propriedades é preenchido automaticamente com as propriedades disponíveis para aquele evento.
As extensões de Segment suportam apenas propriedades de evento na lista de permissões documentada para cada evento recomendado de eCommerce. Propriedades personalizadas de nível superior que você envia pela API ou SDK não são válidas para filtros de propriedade de extensão — mesmo que essas propriedades apareçam nos dados do seu evento. Usar uma propriedade de nível superior fora da lista de permissões impede que a extensão seja salva ou desarquivada.
Se você precisar filtrar por propriedades não padrão, aninhe-as dentro de metadata ao registrar o evento (por exemplo, metadata.color em vez de color). Para propriedades suportadas, consulte Esquemas de evento e Tipos de eventos recomendados de eCommerce.
Propriedades de evento aninhadas
Também oferecemos suporte à segmentação com base em propriedades de evento aninhadas. No menu suspenso de comparação, selecione a comparação que corresponde ao tipo de dado da sua propriedade aninhada. Você pode usar a mesma sintaxe de propriedade de evento aninhada para adicionar propriedades aninhadas a qualquer evento recomendado de eCommerce que contenha propriedades aninhadas.
Para informações sobre as diferentes propriedades aninhadas disponíveis, consulte Tipos de eventos recomendados de eCommerce. Para gerar o esquema necessário para o nome da propriedade da sua extensão de Segment, siga as etapas em Objetos aninhados em eventos personalizados.
Janela de retrospectiva e pontos de dados
As extensões de Segment dependem do armazenamento de longo prazo de propriedades de evento e não possuem um limite de armazenamento de propriedade com carimbo de data/hora. Você pode consultar propriedades de evento rastreadas nos últimos dois anos. O uso de propriedades de evento nas extensões de Segment não afeta o uso de pontos de dados.
Você não precisa de extensões de Segment para usar propriedades de evento ou atributos personalizados aninhados no seu Segment. As extensões de Segment apenas ampliam a janela histórica usada para criar um Segment padrão. Você pode criar um Segment padrão em tempo real que usa propriedades de evento dos últimos 30 dias ou atributos personalizados aninhados. Da mesma forma, você pode agendar sua mensagem para disparar em tempo real com base em uma propriedade de evento — sem necessidade de extensão de Segment.
Etapa 4: Defina as configurações de atualização (opcional)
Se não precisar que sua extensão seja atualizada regularmente, você pode salvá-la sem usar as configurações de atualização, e a Braze gerará sua extensão de Segment 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 Campaign única.
Seu Segment sempre começará a ser processado após o salvamento inicial. Sempre que seu Segment for atualizado, a Braze executará novamente o Segment e atualizará a associação do Segment para refletir os usuários em seu Segment no momento da atualização. Isso pode ajudar suas Campaigns recorrentes a alcançar os usuários mais relevantes.
Configuração de uma atualização recorrente
Para definir uma programação 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 Segment, incluindo segmentos SQL, extensões de Segment CDI e extensões de Segment 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 Segment não utilizadas. As extensões de Segment são consideradas não utilizadas quando:
- Não são usadas em nenhuma Campaign, Canvas ou Segment ativo ou inativo (rascunho, interrompido, arquivado); ou
- Não foram modificadas há mais de 7 dias
A Braze notificará o contato da empresa e o criador da extensão se essa configuração for desativada. A opção de regenerar extensões diariamente pode ser ativada novamente a qualquer momento.
Seleção das configurações de atualização
No painel Configurações de intervalo de atualização, você pode selecionar a frequência de atualização dessa extensão de Segment: por hora, diariamente, semanalmente ou mensalmente. Também será necessário selecionar o horário específico (no fuso horário da sua empresa) em que a atualização ocorrerá, como por exemplo:
- Se você tiver uma Campaign de e-mail que é enviada todas as segundas-feiras às 11h, horário da empresa, e quiser garantir que seu Segment seja atualizado logo antes do envio, escolha uma programação de atualização semanal às 10h das segundas-feiras.
- Se quiser que seu Segment 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 uma programação de atualização por hora não está disponível para extensões de Segment baseadas em formulário (mas você pode definir programações diárias, semanais ou mensais).
Consumo de crédito e custos adicionais
Como as atualizações executam novamente a consulta do seu Segment, cada atualização para segmentos SQL consumirá créditos de Segment SQL, e cada atualização para extensões de Segment CDI incorrerá em um custo no 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 em processo de atualização terão o status “Processing” na lista de extensões de Segment. Isso tem algumas implicações:
- Para concluir o processamento do seu Segment 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 para uma extensão de Segment 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, a 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 Segment se torna obsoleta. Uma extensão de Segment é considerada obsoleta se atender aos seguintes critérios:
- Não é usada em nenhuma Campaign ou Canvas ativo
- Não é usada em nenhum Segment que esteja em uma Campaign ou Canvas ativo
- Não é usada em nenhum Segment que tenha o rastreamento de análise de dados ativado
- Não foi modificada há mais de sete dias
- Não foi adicionada a uma Campaign ou Canvas (incluindo rascunhos) ou Segment há mais de sete dias
Se a atualização programada for desativada para uma extensão de Segment, essa extensão terá uma notificação informando isso.
Quando estiver pronto para usar uma extensão de Segment obsoleta, 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.
Etapa 5: Salve sua extensão de Segment
Depois de selecionar Save, sua extensão de Segment começa a ser processada. O tempo necessário para gerar sua extensão de Segment depende de quantos usuários você tem, quantos eventos personalizados ou eventos de compra você está capturando e quantos dias de histórico está consultando.
Enquanto sua extensão de Segment está sendo processada, você vê uma pequena animação ao lado do nome da extensão de Segment e Processing na coluna Status na lista de extensões de Segment. Observe que você não pode editar uma extensão de Segment enquanto ela está sendo processada.
Quando uma extensão de Segment está sendo processada, a Braze continuará usando o histórico de versão do Segment padrão de antes do início do processamento para fins de segmentação de público. O processamento ocorre cada vez que um salvamento ou atualização é feito e envolve consultar e atualizar perfis de usuário — em outras palavras, a composição do seu Segment padrão não é atualizada instantaneamente. Isso significa que, a menos que a ação do usuário seja realizada antes do início do processamento da atualização, não podemos garantir que o usuário será incluído na extensão de Segment quando essa atualização específica for concluída. Da mesma forma, usuários que estavam na extensão de Segment antes da atualização e que não atendem mais aos critérios continuarão correspondendo ao seu Segment padrão até que o processo de atualização seja concluído e as atualizações sejam aplicadas.
Status das extensões de Segment
Na página Segment Extensions, cada extensão exibe um Status e um carimbo de data/hora Last Processed. Depois de salvar ou atualizar uma extensão, use essas colunas para confirmar se o processamento foi concluído com sucesso.
| Status | Descrição |
|---|---|
| Active | A extensão concluiu o processamento com sucesso e está disponível para segmentação. Last Processed mostra quando a atualização mais recente foi concluída. |
| Draft | A extensão foi salva, mas ainda não foi ativada. |
| Archived | A extensão está arquivada e indisponível para segmentação. |
| Refresh disabled | As atualizações recorrentes de público estão desativadas. |
| Processing | A Braze está processando um salvamento ou atualização. A coluna Status mostra Processing, uma pequena animação aparece ao lado do nome da extensão e você não pode editar a extensão até que o processamento seja concluído. |
Quando o processamento não é concluído com sucesso, um ícone de erro aparece ao lado do nome da extensão, mesmo que a coluna Status ainda mostre Active. Passe o mouse sobre o ícone para ver o motivo da falha. Se você receber uma falha, mas acreditar que a extensão deveria ter sido processada, tente atualizar a extensão primeiro — o status pode estar desatualizado.
Etapa 6: Use sua extensão em um Segment
Depois de criar uma extensão de Segment, você pode usá-la como filtro ao criar um Segment ou definir um público para uma Campaign ou Canvas. Comece escolhendo Braze Segment Extension na lista de filtros na seção User Attributes.
Na lista de filtros de Braze Segment Extension, escolha a extensão de Segment que você deseja incluir ou excluir deste Segment.
Para visualizar os critérios da extensão de Segment, selecione View Extension Details para exibir os detalhes em uma nova janela.
Agora você pode prosseguir normalmente com a criação do seu Segment.
Perguntas frequentes
Posso criar uma extensão de Segment que use vários eventos personalizados?
Sim. Você pode adicionar vários eventos ou fazer referência a várias tabelas do Snowflake ao usar extensões de Segment SQL.
Ao usar extensões de Segment do tipo Extensão simples, você pode selecionar um evento personalizado, um evento de compra ou uma interação de canal. No entanto, é possível combinar várias extensões de Segment com AND ou OR ao criar o Segment padrão.
Posso arquivar extensões de Segment se elas existem em uma campanha ativa?
Não. Antes de arquivar uma extensão de Segment, você precisa removê-la de todos os envios de mensagens ativos.
Posso usar arrays em extensões de Segment?
Sim. Para usar arrays, adicione colchetes ([]) ao nome da sua propriedade. Se a sua propriedade for location_code, você digitaria location_code[].
A Braze usa [] para percorrer arrays e verificar se algum item no array percorrido corresponde à propriedade do evento. Por exemplo, você pode criar uma extensão de Segment de usuários que correspondem a pelo menos um valor de uma propriedade de array.
Como a Braze calcula o período para um intervalo de tempo relativo de “últimos __ dias”?
Quando as extensões de Segment calculam o período de tempo relativo (“últimos X dias”), o horário de início é definido como meia-noite UTC. Por exemplo, para uma extensão de Segment que atualiza em 16/09/2024 às 21:00 UTC e especifica 10 dias, o horário de início é definido como 06/09/2024 às 00:00 UTC, e não 06/09/2024 às 21:00 UTC.
No entanto, você pode especificar os fusos horários usando Segments SQL para identificar usuários que realizaram o evento personalizado 10 dias atrás com base na meia-noite no horário da empresa, ou usuários que realizaram o evento 10 dias atrás com base no horário atual.