Skip to content

Atributos estándar

Los atributos estándar son campos predefinidos que Braze reconoce en cada perfil de usuario. Utiliza esta página como referencia rápida para el nombre del campo, el tipo de datos y el formato esperado de cada atributo estándar.

Los atributos estándar (a veces llamados atributos predeterminados o claves reservadas) son diferentes de los atributos personalizados, que son exclusivos de tu empresa. Cuando envías datos a Braze con uno de los nombres de campo que aparecen en esta página, Braze los almacena en el campo de perfil predefinido en lugar de crear un nuevo atributo personalizado.

Puedes establecer atributos estándar a través de cualquiera de estos métodos:

Identificadores

Los identificadores le dicen a Braze qué perfil de usuario actualizar o crear. Cada solicitud de API y fila de CSV debe incluir al menos un identificador. Para más detalles sobre cómo elegir el correcto, consulta Resolución de identificadores.

Campos de perfil

Estos campos capturan datos demográficos, de contacto y de configuración regional sobre tus usuarios.

Estos campos gestionan cómo un usuario recibe mensajes a través de los canales. Actualizarlos no cuenta para tu uso de punto de datos.

Para obtener más información sobre la configuración de grupos de suscripción, consulta Grupos de suscripción.

Sesiones y participación

Estos campos capturan cuándo el usuario usó tu aplicación por primera o última vez. El SDK los registra automáticamente; normalmente solo los configuras a través de la API o CSV cuando migras desde otra plataforma.

Tokens de notificaciones push

Utiliza estos campos cuando migres tokens de notificaciones push desde otra plataforma. Después de integrar Braze SDK, los tokens de notificaciones push se capturan automáticamente. Para obtener orientación sobre la migración, consulta Migración de tokens de notificaciones push.

Perfil social

Estos campos almacenan datos de integraciones con redes sociales.

Ejemplo de API

La siguiente solicitud establece atributos estándar en dos usuarios a través del 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 el contrato completo de la API, consulta el objeto de atributos de usuario.

Ejemplo de CSV

El siguiente CSV actualiza atributos estándar para dos usuarios. Los encabezados de columna deben coincidir exactamente con los nombres de campo de este artículo. Los encabezados que no coincidan (por ejemplo, First_name en lugar de first_name) se importan 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

No puedes establecer algunos atributos estándar a través de la importación de CSV. Debes enviar matrices, tokens de notificaciones push y objetos anidados a través de la API o de la ingesta de datos en la nube. Para consultar la lista completa de campos compatibles con CSV y los pasos de importación, consulta Atributos predeterminados.

Consideraciones

Ten en cuenta estos puntos cuando trabajes con atributos estándar:

  • Los nombres de los campos distinguen entre mayúsculas y minúsculas. Usa siempre minúsculas. Un encabezado o clave que no coincida exactamente con el nombre de un atributo estándar se tratará como un atributo personalizado.
  • La captura automática del SDK se suprime cuando estableces valores a través de la API o CSV. Cuando estableces country o language a través de la API o CSV, Braze deja de capturar automáticamente esos campos desde el SDK para ese usuario.
  • null elimina un valor. Establece un atributo estándar como null para eliminarlo del perfil. Algunos campos, incluidos external_id y user_alias, no se pueden eliminar después de haber sido establecidos.
  • Los valores en blanco en CSV no sobrescriben. Una celda en blanco en una importación CSV mantiene el valor existente en el perfil. Para borrar un valor, usa la API.
  • Las zonas horarias se establecen en UTC de forma predeterminada. Las cadenas de fecha sin un desfase se interpretan como medianoche UTC y se muestran en la zona horaria de tu espacio de trabajo. Para especificar una zona horaria, añade un desfase UTC (por ejemplo, 2024-11-10T18:00:00-05:00).
New Stuff!