Skip to content

Atributos padrão

Atributos padrão são campos predefinidos que a Braze reconhece em todos os perfis de usuário. Use esta página como referência rápida para o nome do campo, o tipo de dados e o formato esperado de cada atributo padrão.

Atributos padrão (às vezes chamados de atributos default ou chaves reservadas) são diferentes dos atributos personalizados, que são exclusivos do seu negócio. Quando você envia dados para a Braze com um dos nomes de campo listados nesta página, a Braze armazena o valor no campo de perfil predefinido em vez de criar um novo atributo personalizado.

Você pode definir atributos padrão por qualquer um destes métodos:

Identificadores

Os identificadores informam à Braze qual perfil de usuário deve ser atualizado ou criado. Toda solicitação de API e linha de CSV deve incluir pelo menos um identificador. Para detalhes sobre como escolher o identificador correto, consulte Resolução de identificadores.

Campos de perfil

Esses campos capturam dados demográficos, de contato e de localidade sobre seus usuários.

Esses campos gerenciam como um usuário recebe mensagens em diferentes canais. Atualizá-los não conta para o seu uso de pontos de dados.

Para saber mais sobre a configuração de grupos de inscrições, consulte Grupos de inscrições.

Sessões e engajamento

Esses campos capturam quando o usuário usou seu app pela primeira ou última vez. O SDK os registra automaticamente; normalmente, você os define apenas por meio de API ou CSV ao migrar de outra plataforma.

Tokens por push

Use esses campos ao migrar tokens por push de outra plataforma. Após a integração do SDK da Braze, os tokens por push são capturados automaticamente. Para orientações sobre migração, consulte Migração de tokens por push.

Perfil social

Esses campos armazenam dados de integrações com redes sociais.

Exemplo de API

A solicitação a seguir define atributos padrão em dois usuários por meio do endpoint /users/track.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "attributes": [
    {
      "external_id": "user1",
      "first_name": "Alex",
      "last_name": "Doe",
      "email": "[email protected]",
      "country": "US",
      "language": "en",
      "time_zone": "America/New_York",
      "dob": "1988-02-14",
      "email_subscribe": "opted_in"
    },
    {
      "external_id": "user2",
      "first_name": "Alex",
      "phone": "+14155552671",
      "current_location": {
        "longitude": -73.991443,
        "latitude": 40.753824
      },
      "subscription_groups": [
        {
          "subscription_group_id": "abc-123",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}

Para consultar o contrato completo da API, acesse o Objeto de atributos de usuário.

Exemplo de CSV

O CSV a seguir atualiza atributos padrão para dois usuários. Os cabeçalhos das colunas devem corresponder exatamente aos nomes dos campos neste artigo. Cabeçalhos que não correspondem (por exemplo, First_name em vez de first_name) são importados como atributos personalizados.

1
2
3

external_id,first_name,last_name,email,country,language,dob,email_subscribe
user1,Jane,Doe,[email protected],US,en,1988-02-14,opted_in
user2,Alex,Smith,[email protected],GB,en,1992-09-30,subscribed

Não é possível definir alguns atributos padrão por meio da importação de CSV. Você deve enviar arrays, tokens por push e objetos aninhados pela API ou pela Ingestão de Dados na Nuvem. Para a lista completa de campos compatíveis com CSV e as etapas de importação, consulte Atributos padrão.

Considerações

Leve em conta estes pontos ao trabalhar com atributos padrão:

  • Os nomes dos campos diferenciam maiúsculas de minúsculas. Use sempre letras minúsculas. Um cabeçalho ou chave que não corresponda exatamente ao nome de um atributo padrão é tratado como um atributo personalizado.
  • A captura automática do SDK é suprimida quando você define valores por API ou CSV. Quando você define country ou language por API ou CSV, a Braze para de capturar automaticamente esses campos pelo SDK para esse usuário.
  • null remove um valor. Defina um atributo padrão como null para removê-lo do perfil. Alguns campos, incluindo external_id e user_alias, não podem ser removidos após serem definidos.
  • Valores em branco no CSV não sobrescrevem. Uma célula em branco em uma importação de CSV mantém o valor existente no perfil. Para limpar um valor, use a API.
  • Os fusos horários usam UTC como padrão. Strings de data sem deslocamento são interpretadas como meia-noite UTC e exibidas no fuso horário do seu espaço de trabalho. Para especificar um fuso horário, adicione um deslocamento UTC (por exemplo, 2024-11-10T18:00:00-05:00).
New Stuff!