Segments de catálogo
Segments de catálogo são um tipo de extensão de segmento SQL criados pela combinação de dados de catálogo com dados de eventos personalizados ou compras. Eles podem ser referenciados em um Segment e, em seguida, direcionados por Campaigns e Canvas.
Segments de catálogo usam SQL para unir dados de catálogos e dados de eventos personalizados ou compras. Para isso, você precisa ter um campo identificador comum entre seus catálogos e seus eventos personalizados ou compras. Por exemplo, o valor de um ID de item em um catálogo deve corresponder ao valor de uma propriedade em um evento personalizado.
Criando um segment de catálogo
- Acesse Extensões de segmento > Criar nova extensão > Começar com modelo e selecione um modelo.

-
O editor SQL é preenchido automaticamente com um modelo.

Esse modelo une dados de eventos de usuários com dados de catálogo para segmentar usuários que interagiram com determinados itens do catálogo. -
Use a guia Variáveis para fornecer os campos necessários para o seu modelo antes de gerar o segment.
Para que a Braze identifique os usuários com base no engajamento deles com itens do catálogo, você precisa fazer o seguinte:
- Selecionar um catálogo que contenha um campo de catálogo
- Selecionar um evento personalizado que contenha uma propriedade de evento
- Fazer a correspondência entre os valores do campo de catálogo e da propriedade de evento
Veja as diretrizes para selecionar as variáveis:
| Campo de variável | Descrição |
|---|---|
Catalog |
O nome do catálogo que você está usando para direcionar usuários. |
Catalog field |
O campo no seu catálogo que contém os mesmos valores que a sua Custom event property. Geralmente é um tipo de ID. No caso de uso de eCommerce, seria shopify_id. |
Custom event |
O nome do seu evento personalizado, que é o mesmo evento que contém uma propriedade com valores correspondentes ao seu Catalog field. No caso de uso de eCommerce, seria Made Order. |
Custom event property |
O nome da propriedade do seu evento personalizado, que corresponde aos valores do seu Catalog field. No exemplo de caso de uso de eCommerce, seria Shopify_ID. |
- Se necessário, preencha campos opcionais adicionais para o seu caso de uso, a fim de segmentar por um valor de campo específico dentro do seu catálogo:
Catalog field: Um campo específico (nome da coluna) dentro deste catálogoValue: Um valor específico dentro desse campo ou coluna
Usando o app de saúde como exemplo, digamos que dentro do catálogo de cada médico que você pode agendar, existe um campo chamadospecialtyque contém um valor comovisionoudental. Para segmentar usuários que visitaram médicos com o valordental, você pode selecionarspecialtycomo oCatalog fielde selecionardentalcomo oValue.
- Após criar uma extensão de segmento SQL, recomendamos clicar em Executar pré-visualização para verificar se a sua consulta retorna usuários ou se há erros. Para saber mais sobre pré-visualização de resultados de consulta, gerenciamento de extensões de segmento SQL e mais, confira Extensões de segmento SQL.
Se você estiver criando um segment SQL que usa a tabela CATALOGS_ITEMS_SHARED, é necessário especificar um ID de catálogo. Por exemplo:
1
2
3
SELECT * FROM CATALOGS_ITEMS_SHARED
WHERE CATALOG_ID = 'XYZ'
LIMIT 10
Determinando se você precisa inverter o SQL
Embora não seja possível consultar diretamente usuários com zero eventos, você pode usar Inverter SQL para direcionar esses usuários.
Por exemplo, para direcionar usuários que fizeram menos de três compras, primeiro escreva uma consulta para selecionar usuários que fizeram três ou mais compras. Em seguida, selecione Inverter SQL para direcionar usuários com menos de três compras (incluindo aqueles com zero compras).

A menos que você esteja especificamente tentando direcionar usuários com zero eventos, não será necessário inverter o SQL. Se Inverter SQL estiver selecionado, confirme que o recurso é necessário e que o segment corresponde ao público desejado. Por exemplo, se uma consulta direciona usuários com pelo menos um evento, ela direcionará apenas usuários com zero eventos quando invertida.
Atualizando a associação ao segment
Para atualizar a associação de qualquer segment de catálogo, abra o segment de catálogo e selecione Ações > Atualizar > Sim, atualizar.
Se você criou um segment em que espera que os usuários entrem e saiam regularmente, atualize manualmente o segment de catálogo que ele usa antes de direcionar esse segment em uma Campaign ou Canvas.
Definindo configurações de atualização
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 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 Campaign única.
Seu segmento sempre começará a ser processado após o salvamento inicial. Sempre que seu segmento for atualizado, a 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 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 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:
- Não são usadas em nenhuma Campaign, Canvas ou segmento 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 segmento: 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 segmento seja atualizado logo antes do envio, escolha uma programação de atualização semanal às 10h 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 uma programação de atualização por hora não está disponível para extensões de segmento 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 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 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 segmento. Isso tem algumas implicações:
- Para concluir o processamento do 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 para 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, 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 segmento se torna obsoleta. Uma extensão de segmento é considerada obsoleta se atender aos seguintes critérios:
- Não é usada em nenhuma Campaign ou Canvas ativo
- Não é usada em nenhum segmento que esteja em uma Campaign ou Canvas ativo
- Não é usada em nenhum segmento 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 segmento há mais de sete dias
Se a atualização programada for 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 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.
Casos de uso
App de saúde
Digamos que você tem um app de saúde e quer segmentar usuários que agendaram uma visita ao dentista. Você também tem o seguinte:
- Um catálogo
Doctorsque contém os diferentes médicos que um paciente pode agendar, cada um com umdoctor IDatribuído - Um evento personalizado
Booked Visitcom uma propriedadedoctor IDque compartilha os mesmos valores do campodoctor IDno seu catálogo - Um campo
specialitydentro do seu catálogo que contém o valordental
Você configuraria um segment de catálogo usando as seguintes variáveis:
| Variável | Propriedade |
|---|---|
Catalog |
Doctors |
Catalog field |
doctor ID |
Custom event |
Booked Visit |
Custom event property |
doctor ID |
(Under Filter SQL Results) Catalog field |
Specialty |
(Under Filter SQL Results) Value |
Dental |
Plataforma SaaS
Digamos que você tem uma plataforma SaaS B2B e quer segmentar usuários que são colaboradores de um cliente existente. Você também tem o seguinte:
- Um catálogo
Accountsque contém as diferentes contas que estão usando sua plataforma SaaS atualmente, cada uma com umaccount IDatribuído - Um evento personalizado
Event Attendancecom uma propriedade “account ID” que compartilha os mesmos valores do campo “account ID” no seu catálogo - Um campo
Classificationdentro do seu catálogo que contém o valorenterprise
Você configuraria um segment de catálogo usando as seguintes variáveis:
| Variável | Propriedade |
|---|---|
Catalog |
Accounts |
Catalog field |
account ID |
Custom event |
Event Attendance |
Custom event property |
account ID |
(Under Filter SQL Results) Catalog field |
Classification |
(Under Filter SQL Results) Value |
Enterprise |
Perguntas frequentes
Executar um segment de catálogo consome créditos de extensão de segmento SQL?
Sim, segments de catálogo são alimentados por SQL e consomem créditos de extensão de segmento SQL. Para saber mais, confira Uso de Segments SQL.
Criar um segment de catálogo consome a cota de extensões de segmento SQL?
Sim. Da mesma forma que as extensões de segmento SQL contam para a sua cota de extensões de segmento, os segments de catálogo também contam para essa cota.
Tenho um caso de uso de segment de catálogo que o modelo atual não atende. Como devo configurar isso?
Fale com o seu gerente de suporte ao cliente ou com o suporte da Braze para orientação adicional.