Segmentos

Os segmentos são atualizados automaticamente conforme os usuários interagem com seu aplicativo ou site—sem necessidade de rastreamento extra.

Notificações push, e-mails e mensagens SMS são enviados apenas para Assinaturas com opt-in (inscritas). O editor de segmentos mostra as contagens de inscritas e não inscritas para transparência, mas apenas as Assinaturas inscritas recebem mensagens quando você direciona um segmento. As Mensagens In-App são exibidas para todas as Assinaturas móveis, independentemente do status.Quando usados em Journeys, todas as Assinaturas em um segmento, independentemente do status, são avaliadas em relação aos seus respectivos usuários e esses usuários entram na Journey.

Tipos de segmentos

A plataforma OneSignal suporta duas categorias principais de segmentos:

Segmentos Baseados em Assinatura

Os segmentos baseados em assinatura são construídos usando filtros em atributos de assinatura, como tipo de dispositivo, idioma ou versão do aplicativo.

Segmentos Baseados em Usuário

Os segmentos baseados em usuário são construídos usando filtros em atributos no nível do usuário em vez de assinaturas individuais. Atualmente, esses segmentos suportam filtros em eventos de mensagens e eventos personalizados. Exemplos incluem:

Quando um usuário abriu pela última vez um email, SMS ou notificação push enviada via OneSignal.
Eventos personalizados específicos rastreados em seu aplicativo ou site.

Um segmento baseado em usuário inclui todos os usuários que atendem aos critérios e automaticamente torna todas as suas assinaturas elegíveis para serem direcionadas, permitindo definições de audiência mais ricas que podem alcançar qualquer um dos dispositivos do usuário.

Criando segmentos

Os segmentos podem ser criados no dashboard, via API ou fazendo upload de um CSV. Direcione sua audiência incluindo e excluindo segmentos ao enviar mensagens ou criar Journeys.

Dashboard

Crie e gerencie segmentos em Audiência > Segmentos.

API

Crie segmentos programaticamente usando a API de Criar Segmento.

Importação CSV

Importe em massa Assinaturas para um segmento fazendo upload de um CSV.

Criar um segmento no dashboard

Acesse Audiência > Segmentos

Navegue até a página de Segmentos no dashboard.

Página de Segmentos mostrando a lista de segmentos — Página de Segmentos

Clique em Novo Segmento

Abre a interface de criação de segmento.

Interface de criação de segmento mostrando opções de filtros e campo de nome do segmento — Interface de criação de segmento

Adicione filtros, nomeie o segmento e clique em Criar Segmento

Adicione filtros para definir seus critérios de audiência. Se nenhum filtro for selecionado, o padrão será todos os usuários do seu aplicativo.
Nomeie o segmento e clique em Criar Segmento.

Lógica de segmento: AND vs OR

Use AND para combinar filtros que todos devem corresponder. Use OR para corresponder a qualquer de várias condições.

Exemplo AND
Exemplo OR

Crie um segmento de usuários que:

Estiveram ativos nos últimos 30 dias
Têm pelo menos 3 sessões no total

Filtros

Os filtros definem quais assinaturas pertencem a um segmento. Você pode combinar vários filtros usando lógica AND ou OR. Se nenhum filtro for selecionado, o segmento terá como padrão todos os usuários do seu aplicativo.

Filtro	Descrição
First session	Data/hora da criação do usuário.
Last session	Última vez que a Assinatura abriu o aplicativo ou site.
Session count	Número de vezes que a Assinatura abriu o aplicativo ou visitou o site.
Usage duration	Total de segundos que a Assinatura teve seu aplicativo/site aberto.
Language	Idioma preferido do usuário (baseado no dispositivo/navegador). Consulte suporte multi-idioma.
App version	Extraído do `versionCode` do Android ou `CFBundleShortVersionString` do iOS. Combine com Device type para filtrar por diferentes versões de aplicativo para cada plataforma. Consulte direcionar versões desatualizadas de aplicativo.
Device type	iOS, Android, Web Push (navegador), Email, etc.
User tag	Tags personalizadas que você define através do SDK ou API. Consulte Adicionar Tags.
Location	Filtrar por raio a partir de coordenadas (lat/long). Requer pelo menos 1 metro e até 2 casas decimais de precisão. Consulte permissão de localização.
Country	Baseado na última geolocalização de IP (código ISO 3166-2).
Test users	Usuários marcados como Usuários de Teste.
Message Event	Filtrar por evento de mensagem (ex.: “clicado”, “entregue”, “falhou”). Consulte filtros de evento de mensagem.
Custom Event	Filtrar por evento personalizado (ex.: “compra”, “login do usuário”). Consulte filtros de evento personalizado.

Filtros de evento de mensagem

Os filtros de evento de mensagem permitem que você filtre usuários com base em sua interação com um dos seus canais de mensagens dentro de uma certa janela.

Opções de filtro de evento de mensagem mostrando seletores de canal, ação e janela de tempo — Filtros de evento de mensagem

Primeiro selecione o canal de mensagens que você deseja filtrar, depois especifique a ação que você deseja rastrear para esse canal e se o usuário realizou ou não realizou essa ação. Você pode especificar um número mínimo, máximo ou exato de vezes que o usuário deve ter realizado a ação para se qualificar, bem como uma janela de tempo que varia das últimas 24 horas aos últimos 90 dias. Use a opção between para definir um intervalo personalizado de início e fim (em dias atrás). Interações rastreáveis por canal:

Canal	Interações Rastreáveis
Push	Enviado, Recebido, Clicado, Falhou
SMS	Enviado, Entregue, Falhou
Email	Enviado, Entregue, Aberto, Clicado, Devolvido, Falhou, Suprimido, Relatado como spam
In-App	Recebido, Clicado

Segmentos criados com filtros de evento de mensagem são baseados em usuário.Eles não podem ser combinados com segmentos baseados em assinatura para inclusão ou exclusão ao enviar mensagens fora de Journeys.Dentro de Journeys, que são baseadas em usuário, você pode combinar segmentos baseados em eventos com segmentos baseados em assinatura para um direcionamento mais flexível.

Retenção de eventos de mensagem O tempo de retenção dos dados de eventos de mensagem depende do seu plano. O seletor de janela de tempo do dashboard mostra até 90 dias, mas dados além do período de retenção do seu plano não retornarão resultados.

Retenção de eventos de mensagem por plano

Os períodos de retenção variam por plano — consulte o FAQ de Cobrança para detalhes.

Filtros de evento personalizado

Os filtros de evento personalizado permitem que você direcione usuários com base em ações significativas que eles realizaram em seu aplicativo, site ou sistemas externos.

Os filtros de eventos personalizados estão atualmente em Acesso Antecipado.Para solicitar acesso, entre em contato com support@onesignal.com com o nome da sua empresa, seu ID de Organização do OneSignal e seu(s) ID(s) de Aplicativo do OneSignal.

Opções de filtro de evento personalizado mostrando seletores de tipo de evento e propriedade — Filtros de evento personalizado

Comece selecionando:

O nome do evento que você deseja filtrar.
Se o usuário realizou ou não realizou essa ação.
O número mínimo, máximo ou exato de vezes que a ação deve ser realizada.
Uma janela de tempo durante a qual a ação deve (ou não deve) ocorrer — escolha um intervalo predefinido ou defina uma janela personalizada usando a opção between (início e fim em dias atrás).

Após especificar o evento, você pode opcionalmente filtrar por propriedades específicas ou múltiplas:

all — aplica uma condição AND entre as propriedades.
at least one — aplica uma condição OR.

Em seguida, defina as propriedades que você deseja filtrar usando notação de ponto.

Eventos personalizados são representados como Objetos JSON.
Consulte Eventos personalizados para mais detalhes.

Exemplo Dado o seguinte evento personalizado:

{
  "events": [
    {
      "name": "cart_updated",
      "properties": {
        "product_name": "24 Pack of Acorns",
        "product_price": "12.99",
        "product_quantity": "2"
      },
      "external_id": "ID_OF_THE_USER"
    }
  ]
}

Você pode filtrar por:

product_name → para direcionar usuários com nome de produto 24 Pack of Acorns.
product_price → para direcionar usuários com preço de produto 12.99.
product_quantity → para direcionar usuários com quantidade de produto 2.

Exemplo de filtro de evento personalizado mostrando nome do produto, imagem, preço, quantidade e URL do carrinho — Exemplo de filtro de evento personalizado

Segmentos criados com filtros de evento personalizado estão em Acesso Antecipado e são baseados em usuário. Um segmento de evento personalizado pode conter apenas filtros de evento personalizado e não pode ser combinado com outros segmentos para inclusão ou exclusão ao enviar mensagens.

Contagens de audiência

O editor de segmentos mostra quantas Assinaturas inscritas e não inscritas estão em seu segmento, com uma divisão por canal (push, email e SMS).

As Assinaturas inscritas têm opt-in e receberão mensagens quando você direcionar este segmento.
As Assinaturas não inscritas correspondem aos seus filtros de segmento, mas recusaram e não receberão mensagens.

A divisão por canal permite que você veja as Assinaturas alcançáveis vs. não alcançáveis por canal — útil para entender quais canais serão mais eficazes antes de criar uma mensagem ou Journey.

Contagens de audiência mostrando contagens de inscritas e não inscritas por canal — Contagens de audiência

Contagens exatas e estimativas

O OneSignal sempre retorna uma contagem em aproximadamente 15 segundos. Sempre que possível dentro desse limite de tempo, você verá uma contagem exata. Para segmentos grandes ou complexos onde as contagens exatas podem demorar muito para calcular, uma estimativa é mostrada em vez disso. As estimativas são rotuladas para deixar claro que não são exatas:

Tamanho do segmento	Formato	Exemplo
Acima de 10.000	Contagem com margem de erro	`140,000 +/- 5,000`
Abaixo de 10.000	Valor menor que	`<4,800`

Ambos os formatos são arredondados para sinalizar que o número é aproximado. As estimativas nunca serão exibidas como 0: se o seu segmento tiver muito poucos membros, a estimativa reflete uma pequena estimativa diferente de zero para evitar sugerir que o segmento está vazio.

As contagens de audiência estão disponíveis para segmentos baseados em assinatura. As contagens de segmentos baseados em usuário ainda não são suportadas.

Gerenciando segmentos

Ao visualizar seus segmentos no dashboard, você pode:

Visualizar Assinaturas: Ver quais Assinaturas estão no segmento.
Copiar ID do segmento: Copiar o ID do segmento para usar na API.
Editar: Alterar filtros ou nome.
Pausar / Retomar: Se você estiver próximo do seu limite de segmentos, pode pausar segmentos sem excluí-los. Direcionar para um segmento pausado falhará.
Definir como padrão: Definir um segmento padrão para ser selecionado automaticamente ao enviar uma nova mensagem. Isso ajuda a reduzir erros de direcionamento e economizar tempo.
Duplicar: Copiar os filtros de um segmento para criar um novo.
Ver Logs de Auditoria: Ver os logs de auditoria de quem pode ter alterado um segmento e quando.
Excluir: Excluir o segmento.

Excluindo segmentos

Excluir um segmento o remove da sua lista de segmentos. Isso não exclui os usuários dentro dele. Para excluir os usuários dentro de um segmento, consulte Excluir Usuários.

Dashboard
API

Vá para Audiência > Segmentos
Clique no menu de três pontos ao lado de um segmento
Selecione Excluir

Menu de opções de três pontos em um segmento mostrando ações de Editar, Pausar, Duplicar e Excluir — Menu de opções de segmento

Perguntas frequentes

Como adiciono a mim mesmo a um segmento?

Defina-se como Usuário de Teste ou adicione uma Tag personalizada, depois crie um segmento que a direcione.

Encontre suas Assinaturas usando seu ID Externo.
Uma das opções:
- Defina-se como um Usuário de Teste
- Adicione uma Tag personalizada
Crie um segmento usando o filtro de Usuários de Teste ou a tag.

As contagens de segmentos incluem usuários opt-out?

Sim. O editor de segmentos mostra contagens para Assinaturas inscritas e não inscritas. As Assinaturas inscritas têm opt-in e receberão mensagens. As Assinaturas não inscritas correspondem aos seus filtros, mas recusaram e não receberão mensagens. Apenas as Assinaturas inscritas são direcionadas quando você envia uma mensagem. Quando usados em Journeys e mensagens in-app, os segmentos incluem Assinaturas inscritas e não inscritas.

As contagens de segmentos são sempre precisas?

O OneSignal sempre retorna uma contagem em aproximadamente 15 segundos. Para segmentos menores ou mais simples, esta é uma contagem exata. Para segmentos maiores ou mais complexos, uma estimativa é mostrada em vez disso. As estimativas são claramente rotuladas com sua precisão. Consulte Contagens de audiência para detalhes sobre como as estimativas são formatadas e o que elas significam.

Primeiros passos & configurações

Canais de mensagem

Jornadas

Público & eventos personalizados

Análises & Integrações

Privacidade & Segurança

Tipos de segmentos

Segmentos Baseados em Assinatura

Segmentos Baseados em Usuário

Criando segmentos

Dashboard

API

Importação CSV

Lógica de segmento: AND vs OR

Filtros

Filtros de evento de mensagem

Retenção de eventos de mensagem por plano

Filtros de evento personalizado

Contagens de audiência

Contagens exatas e estimativas

Gerenciando segmentos

Excluindo segmentos

Perguntas frequentes

Como adiciono a mim mesmo a um segmento?

As contagens de segmentos incluem usuários opt-out?

As contagens de segmentos são sempre precisas?

​Tipos de segmentos

​Segmentos Baseados em Assinatura

​Segmentos Baseados em Usuário

​Criando segmentos

Dashboard

API

Importação CSV

​Lógica de segmento: AND vs OR

​Filtros

​Filtros de evento de mensagem

Retenção de eventos de mensagem por plano

​Filtros de evento personalizado

​Contagens de audiência

​Contagens exatas e estimativas

​Gerenciando segmentos

​Excluindo segmentos

​Perguntas frequentes

​Como adiciono a mim mesmo a um segmento?

​As contagens de segmentos incluem usuários opt-out?

​As contagens de segmentos são sempre precisas?

Tipos de segmentos

Segmentos Baseados em Assinatura

Segmentos Baseados em Usuário

Criando segmentos

Lógica de segmento: AND vs OR

Filtros

Filtros de evento de mensagem

Filtros de evento personalizado

Contagens de audiência

Contagens exatas e estimativas

Gerenciando segmentos

Excluindo segmentos

Perguntas frequentes

Como adiciono a mim mesmo a um segmento?

As contagens de segmentos incluem usuários opt-out?

As contagens de segmentos são sempre precisas?