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 poderosas de direcionamento para criar grupos dinâmicos de usuários. Na maioria dos casos de uso, isso é 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 o seu público.

Por exemplo, a segmentação padrão da Braze encontra usuários que se encaixam em 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 a fundo — como identificar usuários que compraram uma cor específica de um produto 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 retroativa mais longa, elas são uma ótima ferramenta para ajudar, mantendo o uso de dados otimizado.

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 é estático ou atualizado dinamicamente em um intervalo definido.

Etapa 1: Acessar extensões de Segment

Acesse Audience > Segment Extensions.

Na tabela de extensões de Segment, selecione Create New Extension e depois escolha 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 para 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 custo-benefício.
• Full refresh: Escreva um Segment SQL com dados do Snowflake ou qualquer fonte conectada CDI que recalcula todo o público na atualização manual. Ideal para 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

Os seguintes tipos de extensão de Segment consomem créditos SQL:

• Extensões de Segment SQL (tanto incremental quanto full refresh)
• Segments de catálogo
• Segments CDI
  • Os créditos são consumidos no seu próprio 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 o critério de tipo de evento desejado, escolha qual item comprado, interação com mensagem, evento recomendado de eCommerce ou evento personalizado você gostaria de direcionar para sua lista de usuários. Em seguida, escolha quantas vezes (mais que, menos que ou igual a) o usuário precisaria ter concluído o evento, e o período — para extensões de Segment especificamente, você pode voltar até 730 dias (2 anos).

Para dados recentes de interação com mensagem 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, você pode especificar um intervalo de datas relativo para selecionar os últimos X dias, uma data de início, uma data de fim 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 depois 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 permitirá que você faça um detalhamento com base nas propriedades específicas da sua compra ou evento personalizado. Suportamos segmentação por propriedade de evento com base em objetos de string, numéricos, booleanos e de tempo.

Tipos de dados de propriedades

Para propriedades de string, você pode inserir vários valores de uma vez. No exemplo a seguir, esse filtro busca usuários com uma raça de cachorro igual a qualquer uma das seis raças específicas de cachorro.

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 seus dados de evento. Usar uma propriedade de nível superior que não está na 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 sob 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 suportamos segmentação baseada 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 para 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 de armazenamento de longo prazo de propriedades de evento e não possuem limite de armazenamento de propriedades com base em data. Você pode consultar propriedades de evento rastreadas nos últimos dois anos. Usar propriedades de evento dentro de extensões de Segment não afeta o uso de pontos de dados.

Etapa 4: Definir 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.

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.

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.

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 você está consultando no histórico.

Enquanto sua extensão de Segment está sendo processada, você verá 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 segmento padrão anterior ao início do processamento para fins de segmentação de público. O processamento ocorre cada vez que um salvamento ou atualização acontece e envolve consultar e atualizar perfis de usuário — ou seja, a composição do seu segmento padrão não é atualizada instantaneamente. Isso significa que, a menos que a ação de um 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 após a conclusão daquela atualização específica. 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 segmento 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 mostra um Status e um registro de 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 terminou 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 está 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 segmento

Depois de criar uma extensão de Segment, você pode usá-la como filtro ao criar um segmento 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 neste segmento.

Para visualizar os critérios da extensão de Segment, selecione View Extension Details para mostrar os detalhes em uma nova janela.

Agora você pode prosseguir normalmente com a criação do seu segmento.

Perguntas frequentes

Posso criar uma extensão de Segment que usa 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 com 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 Campaign 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ê poderia 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 de tempo para um período 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 é atualizada em 2024-09-16 21:00 UTC e especifica 10 dias, o horário de início é definido como 2024-09-06 00:00 UTC, e não 2024-09-06 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.