Segmentos do catálogo
Os segmentos de catálogo são um tipo de extensão de segmento SQL criado pela combinação de dados de catálogo com dados de eventos ou compras personalizados. Eles podem ser referenciados em um segmento e, em seguida, direcionados por campanhas e Canvases.
Os segmentos do catálogo estão atualmente em acesso antecipado. Entre em contato com seu gerente de sucesso do cliente se estiver interessado em participar desse acesso antecipado.
Os segmentos de catálogo usam SQL para unir dados de catálogos e dados de eventos personalizados ou compras. Para isso, você deve ter um campo identificador comum em seus catálogos e em seus eventos ou compras personalizados. Por exemplo, o valor de um ID de item em um catálogo deve corresponder ao valor de uma propriedade em um evento personalizado.
Criação de um segmento de catálogo
- Vá para Segment Extensions > Create New Extension > Start With Template e selecione um modelo.
!Modal com a opção de criar um segmento de catálogo para eventos ou compras.
2. O editor SQL é preenchido automaticamente com um modelo.
!Editor SQL com um modelo pré-gerado.
Esse modelo une os dados de eventos do usuário aos dados do catálogo para segmentar os usuários que se envolveram com determinados itens do catálogo.
- Use a guia Variables (Variáveis ) para fornecer os campos necessários para seu modelo antes de gerar seu segmento.
Para que o Braze identifique os usuários com base no envolvimento deles com os itens do catálogo, é necessário fazer o seguinte:
- Selecione um catálogo que contenha um campo de catálogo
- Selecione um evento personalizado que contenha uma propriedade de evento
- Corresponder os valores de propriedade do campo e do evento de seu catálogo
Aqui estão as diretrizes para selecionar as variáveis:
| Campo variável | Descrição |
|---|---|
Catalog |
O nome do catálogo que você está usando para segmentar usuários. |
Catalog field |
O campo em seu catálogo que contém os mesmos valores que o Custom event property. Isso geralmente é um tipo de identificação. No caso de uso de comércio eletrônico, isso seria shopify_id. |
Custom event |
O nome do seu evento personalizado, que é o mesmo evento que contém uma propriedade com valores que correspondem ao seu Catalog field. No caso de uso de comércio eletrônico, isso seria Made Order. |
Custom event property |
O nome de sua propriedade de evento personalizada, que corresponde a valores com seu Catalog field. No caso de uso do exemplo de comércio eletrônico, isso seria Shopify_ID. |
4. Se necessário, preencha campos opcionais adicionais para seu caso de uso para segmentar por um valor de campo específico em seu catálogo:
Catalog field: Um campo específico (nome da coluna) dentro desse catálogoValue: Um valor específico dentro desse campo ou coluna
Usando o aplicativo de saúde como exemplo, digamos que dentro do catálogo de cada médico que você pode marcar, há um campo chamadospecialtyque contém um valor comovisionoudental. Para segmentar os usuários que visitaram qualquer médico com o valordental, você pode selecionarspecialtycomoCatalog fieldedentalcomoValue.
- Depois de criar um segmento SQL, recomendamos clicar em Run Preview (Executar visualização) para ver se a consulta retorna usuários ou se há erros. Para obter mais informações sobre a visualização de resultados de consultas, o gerenciamento de SQL Segment Extensions e muito mais, consulte SQL Segment Extensions.
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
Determinar 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 exemplo, para segmentar 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 segmentar usuários com menos de três compras (incluindo aqueles com zero compras).
Extensão de segmento denominada “Clicou em 1-4 e-mails nos últimos 30 dias” com a opção de inverter o SQL selecionada.](/docs/pt-br/assets/img_archive/sql_segment_invert_sql.png?2450554211189d389864254bcf61ce82){: style=”max-width:70%;”}
A menos que seu objetivo específico seja atingir 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-alvo desejado. Por exemplo, se uma consulta tiver como alvo usuários com pelo menos um evento, ela só terá como alvo usuários com zero eventos quando invertida.
Atualização da associação de segmentos
Para atualizar a associação de segmentos de qualquer segmento do catálogo, abra o segmento do catálogo e selecione Actions > Refresh > Yes, Refresh.
Se você criou um segmento no qual espera que os usuários entrem e saiam regularmente, atualize manualmente o segmento do catálogo que ele usa antes de direcionar esse segmento em uma campanha ou Canvas.
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.
Casos de uso
Aplicativo de saúde
Digamos que você tenha um aplicativo de saúde e queira segmentar os 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 marcar, cada um atribuído a umdoctor ID - Um evento personalizado
Booked Visitcom uma propriedadedoctor IDque compartilha os mesmos valores que o campodoctor IDem seu catálogo - Um campo
specialityem seu catálogo que contém o valordental
Você configuraria um segmento de catálogo usando as seguintes variáveis:
| Variável | Propriedade |
|---|---|
Catalog |
Médicos |
Catalog field |
ID do médico |
Custom event |
Visita reservada |
Custom event property |
ID do médico |
(Under Filter SQL Results) Catalog field |
Especialidade |
(Under Filter SQL Results) Value |
Odontológico |
Plataforma SaaS
Digamos que você tenha uma plataforma SaaS B2B e queira segmentar os usuários que são funcionários de um cliente existente. Você também tem o seguinte:
- Um catálogo
Accountsque contém as diferentes contas que estão usando atualmente sua plataforma SaaS, cada uma atribuída a umaccount ID - Um evento personalizado
Event Attendancecom uma propriedade “account ID” que compartilha os mesmos valores que o campo “account ID” em seu catálogo - Um campo
Classificationem seu catálogo que contém o valorenterprise
Você configuraria um segmento de catálogo usando as seguintes variáveis:
| Variável | Propriedade |
|---|---|
Catalog |
Contas |
Catalog field |
ID da conta |
Custom event |
Participação em eventos |
Custom event property |
ID da conta |
(Under Filter SQL Results) Catalog field |
Classificação |
(Under Filter SQL Results) Value |
Empresa |
Perguntas frequentes
A execução de um segmento de catálogo consome créditos de extensão de segmento de SQL?
Sim, os segmentos de catálogo são alimentados por SQL e consomem créditos de extensão de segmento SQL. Para saber mais, confira o uso de SQL Segments.
A criação de um segmento de catálogo consome alocações de extensão de segmento SQL?
Sim. Da mesma forma que as Extensões de Segmento SQL contam para sua cota de Extensão de Segmento, os segmentos de catálogo também contam para essa cota.
Tenho um caso de uso de segmento de catálogo que o modelo atual não atende. Como devo configurar isso?
Entre em contato com o gerente de suporte ao cliente ou com o Suporte Braze para obter orientação adicional.
Editar esta página no GitHub