--- title: "Atributos & tags" slug: "attributes-tags" updated: 2026-06-12T10:30:51Z published: 2026-06-12T10:30:51Z canonical: "docs.xtremepush.com/attributes-tags" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # 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](/documentation/docs/pt-br/attributes-tags#system-attributes) 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](/documentation/docs/pt-br/attributes-tags#create-a-custom-attribute-or-tag) 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](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/107bece39c5ed20437a294592197d0a669f604950e3584b38b35cffeb39aeee2-Screenshot_2025-04-03_at_14.45.12(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A43Z&se=2026-11-04T10%3A28%3A43Z&sr=c&sp=r&sig=z%2FP%2FzQcSdy%2BE0%2FAsFt0lq6qSBgt4b0gZlVGcHMgougQ%3D) 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. > [!WARNING] > 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](/docs/pt-br/attributes-tags#attribute-name-validation) 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` `1``false` Todas essas versões serão convertidas para um formato numérico (1/0). | > [!WARNING] > 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). > [!NOTE] > 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. > [!TIP] > 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 `true`valores , `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. > [!TIP] > 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](https://docs.xtremepush.com/reference/tag-create#type-identifiers) 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. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/09f0830402365993cbb4982241cb7278dfa0ea1e78f708d7e71889e7a18ba9a4-Screenshot_2026-02-25_at_11.41.57(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A43Z&se=2026-11-04T10%3A28%3A43Z&sr=c&sp=r&sig=z%2FP%2FzQcSdy%2BE0%2FAsFt0lq6qSBgt4b0gZlVGcHMgougQ%3D) 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. ![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/e474f41b7cccdb99ba9a4e6e56128c908a3a87d106cb66bd628203555a071921-Screenshot_2026-03-02_at_09.25.45(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A28%3A43Z&se=2026-11-04T10%3A28%3A43Z&sr=c&sp=r&sig=z%2FP%2FzQcSdy%2BE0%2FAsFt0lq6qSBgt4b0gZlVGcHMgougQ%3D) 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. > [!WARNING] > 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](/documentation/docs/pt-br/user-profile-create#manual-entry) 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](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) . 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](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) 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](/ref:user-profile-import)) para o sistema, pode atribuir atributos a eles. Confira nosso [guia sobre importação e criação de perfis de usuário](/documentation/docs/pt-br/user-profile-create#import-user-profiles) 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](/documentation/docs/pt-br/web-tagging), [Android](/documentation/docs/pt-br/android-tagging) e [iOS](/documentation/docs/pt-br/ios-tagging). > [!NOTE] > 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](/documentation/docs/pt-br/set-user-id) 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.