Skip to content

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 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.

  1. 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.

  1. 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:

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álogo
  • Value: 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 chamado specialty que contém um valor como vision ou dental. Para segmentar os usuários que visitaram qualquer médico com o valor dental, você pode selecionar specialty como Catalog field e dental como Value.
  1. 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.

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%;”}

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.

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.

Seleção de suas configurações de atualização

Configurações de intervalo de atualização com uma frequência de atualização semanal, horário de início às 10h e segunda-feira selecionada como dia.

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.

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.

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.

Uma notificação informando que "As atualizações programadas foram desativadas para essa extensão porque ela não é usada em nenhuma campanha, canvas ou segmento ativo. A extensão do segmento foi desativada em 23 de fevereiro de 2025 às 12:00 AM."

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 Doctors que contém os diferentes médicos que um paciente pode marcar, cada um atribuído a um doctor ID
  • Um evento personalizado Booked Visit com uma propriedade doctor ID que compartilha os mesmos valores que o campo doctor ID em seu catálogo
  • Um campo speciality em seu catálogo que contém o valor dental

Você configuraria um segmento de catálogo usando as seguintes variáveis:

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 Accounts que contém as diferentes contas que estão usando atualmente sua plataforma SaaS, cada uma atribuída a um account ID
  • Um evento personalizado Event Attendance com uma propriedade “account ID” que compartilha os mesmos valores que o campo “account ID” em seu catálogo
  • Um campo Classification em seu catálogo que contém o valor enterprise

Você configuraria um segmento de catálogo usando as seguintes variáveis:

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.

New Stuff!