Atributos & tags

Armazene dados contra seus usuários

Atributos e tags são chaves pré-definidas que permitem que valores de dados sejam armazenados em um perfil de usuário ou dispositivos.

Um Atributo é vinculado um a um a um perfil de usuário ou de dispositivo, contendo um único valor que pode ser atualizado a qualquer momento, por exemplo, last_name ou last_deposited. Atributos podem ser usados para segmentação ou personalização de campanhas de mensagens.

Existem vários atributos definidos do sistema para armazenar informações, como número de celular, endereço de e-mail, etc; Os clientes podem criar seus próprios atributos personalizados definidos para garantir máxima flexibilidade para seu caso de uso.

Uma Tag pode ser definida várias vezes contra um dispositivo com valores diferentes (por exemplo, uma relação um-para-muitos). Cada registro tem carimbo de data e não pode ser modificado. Tags podem ser usadas para registrar o comportamento do usuário ao longo do tempo e podem ser usadas em segmentação para campanhas de mensagens.

Visualizar, editar, converter e excluir atributos

Para visualizar ou editar os atributos e tags já definidos para um projeto, navegue até o Data > Data Manager > Attributes & Tags.

A tabela mostra quais são configurados como atributos de Dispositivo ou Perfil . A lista pode ser filtrada usando os campos de busca no topo da tabela.

Os atributos podem ser editados, convertidos ou excluídos usando os ícones na linha da tabela correspondente.

Atributos de edição

Essa opção permite atualizar o nome de exibição, alias, atributo do dispositivo e status do atributo do perfil.

Conversão de atributos

Essa opção permite que você mude o tipo de atributo. Uma vez que o novo tipo de atributo seja selecionado, uma janela exibirá os valores aceitos e mostrará uma contagem de atributos que têm valores definidos, indicando se esses valores seguem o formato correto. Você pode pré-visualizar perfis de exemplo ou baixar um relatório completo.

Example of the conversion of an attribute from Number to Integer — Exemplo da conversão de um atributo de Número para Inteiro

Deletando um atributo

Quando você clica em Excluir de uma linha de atributo, isso será adicionado a uma fila de tarefas. Todos os dados associados ao atributo também serão removidos dos perfis de usuário que tivessem esse atributo associado. Esse processo pode levar algumas horas para ser concluído.

Crie um atributo ou tag personalizado

Para armazenar dados contra um perfil de usuário ou dispositivo, o atributo ou tag deve ser criado primeiro pressionando o botão Criar marca .

Defina o nome, o tipo de dado e escolha se a nova chave deve ser usada como um atributo de Perfil de Usuário ou de Dispositivo. Se nenhuma dessas opções for selecionada, uma tag será criada.

Atributos de nomeação e tags
O nome deve evitar espaços e pontos, e idealmente limitar-se a letras minúsculas, dígitos e sublinhaduras. Isso permitirá o uso mais fácil do atributo ou tag através dos SDKs móveis e web e da API. Veja a Validação de Nome de Atributo abaixo para mais detalhes.
O campo Nome de Exibição pode ser usado para fornecer um nome amigável para o campo na interface Xtremepush. Por exemplo, para um atributo chamado first_name, você pode definir First Name como nome de exibição.
Você também pode definir um Alias, útil se você nomeou uma tag Android e uma de iOS de forma diferente e precisar usar um alias dos dois juntos para manter a consistência das análises entre os apps.

Tipo de dado	Formato de valor
Corda	Caracteres de texto (máximo 100 caracteres).
Número	Um valor numérico assinado com máximo 4 dígitos em casas decimais e máximo 14 dígitos no total. Se um número tiver mais de 4 casas decimais, ele será arredondado para cima ou para baixo. Por exemplo, `10.22222` será salvo como `10.2222`, mas `10.22225` será salvo como `10.2223`.
Integer	Um valor numérico assinado sem decimal. Se um valor numérico tiver casas decimais, ele será arredondado para cima para um número inteiro.
DataHora	Data com o tempo, ISO-8601 (`YYYY-MM-DD HH:MM:SS`) ou formato Reino Unido (`DD-MM-YYYY HH:MM:SS`). Todas convertidas para `YYYY-MM-DD HH:MM:SS` for DateTime quando o valor é salvo. Os atributos de data estão sempre no fuso horário UTC, então se seu projeto estiver em um fuso horário diferente, você pode indicar o fuso no valor do atributo: `2023-12-13 11:36:00 +01:00`.
Data	Namorar sem tempo. ISO-8601 (`YYYY-MM-DD`) ou formato Reino Unido (`DD-MM-YYYY`). Todos convertidos para `YYYY-MM-DD` para Data quando o valor é salvo.
Array	Array JSON, por exemplo: `["value1","value2","value3"]`.
Objetivo	Objeto JSON, por exemplo: `{"order_total": "12.34", "item_count": 3, "items": [{...}, {...}, ...]}`. Chaves de objeto não devem consistir apenas de caracteres numéricos, pois isso causaria um erro.
Booleano	`true`, ou , ou , ou , ou `Y` , `F` ou , `N`. `no` `T` `yes` `0` `1false` Todas essas versões serão convertidas para um formato numérico (1/0).

Valores inválidos para tipos de atributos
Valores inválidos para tipos de atributos serão descartados durante as importações e ao atribuir atributos ao perfil (o valor não será atualizado).

Atributos não aplicados
Atributos antigos não são automaticamente aplicados para validação. Para manter a consistência dos dados e permitir a validação desses atributos, clique no rótulo Não Forçado ao lado do atributo relevante em Data > Gerenciador de Dados e siga o processo descrito no modal aberto para converter seu tipo de atributo.

Limites de atributos
Há um limite para o número total de atributos personalizados que podem ser armazenados em um projeto. Atributos de tipo string ocupam mais espaço do que outros tipos. Usar o tipo correto permitirá mais espaço de atributo. Se, por exemplo, um atributo armazenar truevalores , false ou 1, 0 você deve selecionar um tipo booleano. Não é possível mudar o tipo de atributo após sua criação, então considere isso com cuidado.

Permissões de atualização do SDK
Ao criar um atributo ou tag, você pode escolher se a Atualização do SDK está ativada selecionando ou especificando Sim ou Não. Se você selecionar Não, o atributo não pode ser atualizado usando o Xtremepush mobile ou web SDK.

Validação do Nome do Atributo

Quando você cria um novo atributo, o nome do atributo é automaticamente validado. Isso determina se o atributo é criado e armazenado com sucesso no Xtremepush.

Essa validação se aplica apenas a atributos criados manualmente no painel, ou a atributos criados usando a API Create tag , onde Perfil Atributo ou Agregado é especificado. Veja Criar API de Tags para mais detalhes. Essa validação não afeta nenhum atributo existente no seu projeto.

Para passar na validação, os nomes dos atributos não devem:

Comece com um número
Consistem apenas em números
Conter quaisquer espaços
Contenham quaisquer caracteres maiúsculos
Conter caracteres especiais ou não-ASCII
Use palavras-chave SQL ou JSON reservadas, por exemplo json ou json_extract

Após salvar um novo atributo, uma etiqueta amarela de Criação aparece ao lado dele, como mostrado na imagem abaixo.

Esse rótulo indica que o nome está passando por verificações de validação. Atualize a página após 5 a 30 segundos para atualizar o status. Se o nome atender a todos os requisitos, o rótulo é removido.

Se o nome do atributo não validar, aparece um rótulo de Erro , como mostrado na imagem abaixo.

Se isso ocorrer, você deve criar o atributo novamente usando um nome que siga as regras de validação. Os detalhes da falha são registrados em Histórico de Tarefas. Você pode clicar no rótulo Erro para navegar diretamente até o registro específico da tarefa para mais informações.

Desativar a Validação do Nome de Atributos
A validação do nome do atributo está ativada por padrão para todos os novos atributos criados a partir de março de 2026. Se você não quiser que essa validação seja ativada para o seu projeto, entre em contato com o suporte do Xtremepush.

Atributos do sistema

Nome do campo	Descrição
`user_id`	ID de usuário único do seu sistema backend. Identificador primário.
`customer_id`	Um ID de cliente único do seu sistema backend é diferente do que foi dito acima. Este é um identificador opcional e secundário.
`email`	Endereço de e-mail do usuário. Importar esse valor atualizará automaticamente o`email_addressable` atributo do sistema.
`email_addressable`	Isso define se o endereço de e-mail está acessível. Esse campo geralmente não deve ser importado. Ele é definido automaticamente ao importar um valor para `email` com base na validação básica do formato do endereço de e-mail. Também será configurado pelo sistema se `0` as mensagens enviadas ao usuário falharem como permanentemente não entregáveis.
`email_subscription`	Status da assinatura de e-mail do usuário. `1` = assinado, `0` = cancelado, ou deixe em branco para indefinido (não explicitamente cancelado, mas ainda não obtido permissão para contato). Deve estar incluído ao importar e-mail, caso contrário vai ser definido por padrão.
`mobile_number`	Número de celular do usuário. Veja as informações na entrada do Manual para o formato correto do número E.164 .
`sms_addressable`	Isso define se o número SMS é alcançável. Esse campo geralmente não deve ser importado. Ele é definido automaticamente ao importar um valor para `mobile_number` com base na validação básica do formato do número móvel. Também será configurado pelo sistema se `0` as mensagens enviadas ao usuário falharem como permanentemente não entregáveis.
`sms_subscription`	Status da assinatura de SMS do usuário. Usa o mesmo formato que `email_subscription`. Deve ser incluído na importação `mobile_number`, se não for assim, o padrão será indefinido.
`whatsapp_number`	Use o mesmo formato que `mobile_number`.
`whatsapp_addressable`	Se o número do WhatsApp estiver acessível. Esse campo geralmente não deve ser importado. Ele é definido automaticamente ao importar um valor para `mobile_number` com base na validação básica do formato do número móvel. Também será configurado como falso pelo sistema se as mensagens enviadas ao usuário falharem como permanentemente não entregáveis.
`whatsapp_subscription`	Status da assinatura do usuário no WhatsApp. Use o mesmo formato que `email_subscription`. Deve ser incluído na importação `whatsapp_number`, se não for assim, o padrão será indefinido.
`language`	A linguagem deve ser definida usando um código de idioma ISO 639-1 de duas letras . Exemplo: O inglês deve ser inserido junto com o código `en`.
`timezone`	O fuso horário do usuário deve ser definido usando o formato do banco de dados tz da ICANN. Exemplo: O fuso horário de Londres tem o Formato `Europe/London`, Nova York é `America/New_York` e Lagos é `Africa/Lagos`.

Atualização de valores para atributos existentes

Uma vez que uma tag ou atributo foi criado, existem várias maneiras de ingerir dados no sistema.

Atribuição manual de atributos a partir da plataforma

É possível atribuir atributos aos perfis de usuário e definir o valor, o que é prático ao testar a partir da plataforma. Para isso, navegue até Usuários > Dados, clique no ID de perfil desejado e navegue até a seção de Dados > role até a seção Atributos .

Clique em Atribuir atributo. Selecione um dos atributos predefinidos do projeto e digite o valor desse atributo > clique no ícone de salvar .

A partir desta mesma página, você poderá revisar os atributos armazenados e excluí-los.

Importação de dados

Sempre que você importar perfis de usuário (de um CSV ou via API) para o sistema, pode atribuir atributos a eles. Confira nosso guia sobre importação e criação de perfis de usuário para mais detalhes.

Passagem de dados dos SDKs

Nossos SDKs web e mobile permitem que você marque interações.

Você pode definir valores contra o dispositivo atual acessando seu site ou aplicativos para tags existentes usando o tagHit método.

Para mais detalhes sobre esse método, confira nossos guias dedicados para web, Android e iOS.

Se você não definiu o ID de usuário do dispositivo atual, então os dados serão associados a um perfil anônimo. Por isso é importante definir o ID de usuário toda vez que seu ID de cliente estiver disponível na abertura do app ou quando um usuário faz login, para garantir que a identidade esteja definida.