- Armazenar características do usuário como
subscription_tierouname - Rastrear comportamentos como
purchases,clicksoulevels - Segmentar usuários para mensagens e Jornadas
- Personalizar conteúdo de mensagens
Regras de formatação de valor de tag de dados
Todos os valores de Tag devem ser strings. Você ainda pode armazenar números, timestamps e valores booleanos—apenas converta-os em string!| Tipo de Valor | Exemplo de Formato | Notas |
|---|---|---|
| Rótulo String | "free", "VIP" | Para tipos de usuário, privilégios, status |
| Número | "42", "3.14" | Permite filtros numéricos (maior que, menor que) |
| Timestamp | "1685400000" | Timestamp Unix (em segundos). Use com Operadores de Tempo |
| Booleano | "true" / "false", "1" / "0" | Use "1"/"0" para reduzir o tamanho da carga |
Não suportado: Arrays, objetos, valores aninhados ou blobs JSON. Se você precisar armazenar dados complexos, use Eventos Personalizados.
Palavras-chave restritas
As seguintes palavras-chave são restritas e não devem ser usadas como chaves de tag porque são usadas internamente para personalização de mensagens:message, notification, subscription, user, template, app, org, dynamic_content, data_feed, journey, custom_data
Consulte Personalização de Mensagens para mais detalhes.
Tags vs Eventos Personalizados
Tags e Custom Events são ambas formas de adicionar dados aos seus usuários. No entanto, existem algumas diferenças principais:| Recurso | Tags | Custom Events |
|---|---|---|
| Uso de dados | Segmentação e personalização | Disparar Jornadas sem um Segmento, passos Wait Until, personalização diretamente dentro de Jornadas |
| Retenção de dados | Vitalícia | 30+ dias (armazenamento vitalício está disponível) |
| Formato de dados | Strings ou números chave-valor | JSON |
| Fonte de dados | OneSignal SDK, API ou integrações (limitado) | OneSignal SDK, API ou integrações |
| Acesso aos dados | Segmentação e personalização de mensagem | Jornadas e personalização de Journey-message-template, Segmentação (Em breve) |
- Tags para propriedades de usuário que são estáticas e não mudam frequentemente
- Custom Events para cenários em tempo real, segmentação complexa e fluxos de trabalho de jornada mais sofisticados
Estratégias de tags recomendadas
Tags de Dados devem representar informações que você deseja usar em mensagens ou segmentação de público. Elas não são destinadas a armazenar perfis completos de usuário ou logs—use seu banco de dados backend para isso.Tutoriais:
Configuração de carrinho abandonado
Recupere vendas perdidas com lembretes de carrinho abandonado.
Conteúdo dinâmico de carrinho abandonado
Personalize suas mensagens de carrinho abandonado com conteúdo dinâmico.
Tags de comportamento baseadas em eventos
Rastreie ações do usuário com tags. Ótimas para acionar Jornadas, acompanhamentos ou lembretes.| Chave | Exemplo de Valor | Descrição |
|---|---|---|
cart_update | "1685400000" | Última vez que o usuário adicionou algo ao carrinho. Use Operadores de Tempo. |
last_order | "1684100000" | Timestamp da última compra concluída |
amount_spent | "100" | Total gasto—número em string, sem símbolo de moeda |
social_share | "2" | Contagem de compartilhamentos sociais ou indicações |
tutorial_status | "step2" ou "completed" | Progresso do tutorial—use valores de string legíveis ou numerados |
Tags de atividade de jogo
Usadas por jogos para personalizar com base no desempenho do usuário.| Chave | Exemplo de Valor | Descrição |
|---|---|---|
points | "1250" | Pontos de experiência ou do jogo |
level | "8" | Nível atual do jogo |
high_score | "3000" | Maior pontuação alcançada |
Tags de status de conta
Use estas para direcionar usuários por nível de conta ou mudança de status.| Chave | Exemplo de Valor | Descrição |
|---|---|---|
user_type | "free", "premium" | Nível de assinatura ou acesso |
has_downgraded | "1" ou "1685400000" | Booleano ou timestamp do downgrade |
user_privileges | "admin", "guest" | Segmentação baseada em função |
Use ID Externo para identificar usuários individuais. Não use tags para esse propósito. Consulte ID Externo e Aliases.
Tags de personalização
Ótimas para personalização de mensagens baseadas em nome usando Substituição de Variável.| Chave | Exemplo de Valor | Descrição |
|---|---|---|
first_name | "Jon" | Primeiro nome |
last_name | "Smith" | Sobrenome |
user_name | "PokeCatcher22" | Nome de exibição ou nome de tela |
Tags de localização e demográficas
Segmente usuários por região ou idade.| Chave | Exemplo de Valor | Descrição |
|---|---|---|
region | "New York" | Área metropolitana, opcionalmente use ISO 3166-2 |
postcode | "94105" | CEP ou código postal |
location | "Downtown LA" | Localização string personalizada |
birthdate | "915148800" | Timestamp Unix em segundos (data de nascimento) |
birth_year | "1998" | Ano de nascimento de quatro dígitos |
age_range | "18-35" | Útil para segmentação geral de público |
Como adicionar, atualizar e remover Tags
Você pode gerenciar Tags usando qualquer um dos métodos abaixo, dependendo do seu caso de uso e configuração técnica.Métodos SDK (Recomendado)
Defina tags em tempo real do seu aplicativo ou site conforme os usuários executam ações.
REST API
Adicione, atualize ou remova tags do lado do servidor usando nossa REST API.
Jornadas
Aplique tags automaticamente conforme os usuários avançam pelas etapas da Jornada.
Importação CSV
Atualize tags de usuário em massa enviando um CSV com
external_id ou subscription_id.Prompts de Categoria Web
Solicite que os usuários selecionem interesses, que são armazenados como tags.
Mensagens no Aplicativo
Colete ou atualize tags com base em ações de clique em mensagens no aplicativo.
Entrada Manual
Edite tags diretamente do Painel OneSignal.
- Vá para Público > Usuários > Perfil do Usuário > Tags
Integrações de Terceiros
Algumas integrações suportam sincronização automática de tags.
- Segment, HubSpot, Mixpanel e outros
FAQ
Quantas tags posso definir por usuário?
Depende do seu plano. Consulte os limites do seu plano ou entre em contato com vendas para aumentar sua cota.O que acontece com minhas tags se eu exceder os limites do plano?
Não há limite para o número de tags disponíveis dentro de um aplicativo OneSignal. O limite se aplica a quantas tags podem ser definidas em cada usuário individual por vez. Você não pode adicionar ou atualizar tags para usuários que estão no ou acima do limite. Você deve excluir tags primeiro, depois enviar uma segunda solicitação para adicionar novas. Tags já definidas persistirão. Exemplo: Limite do seu plano = 20 tags/usuário.- Usuário tem 19 tags:
- ✅ Adicionar 1 nova tag = sucesso
- ❌ Adicionar 2+ novas tags = falha
- Usuário tem 20 tags:
- ❌ Adicionar qualquer nova tag = falha
- ✅ Atualizar 1+ tag existente = sucesso
Onde posso verificar o uso de tags?
- Painel: Público > Usuários > coluna Tags
- Exportar usuários para uma visualização completa
Como reduzo o uso de tags?
- Remova tags usando SDK ou API
- Use Importação CSV para excluir em massa
- Use menos tags mais reutilizáveis (ex:
status:active)
Precisa de ajuda?Converse com nossa equipe de Suporte ou envie email para
support@onesignal.comPor favor inclua:- Detalhes do problema que você está enfrentando e passos para reproduzir se disponível
- Seu OneSignal App ID
- O External ID ou Subscription ID se aplicável
- A URL para a mensagem que você testou no Dashboard OneSignal se aplicável
- Quaisquer logs ou mensagens de erro relevantes