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 indican a Braze qué perfil de usuario actualizar o crear. Cada solicitud de API y cada fila de CSV debe incluir al menos un identificador. Para más detalles sobre cómo elegir el adecuado, 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 puntos de datos.

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

Sesiones e interacción

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

Tokens de notificaciones push

Usa estos campos cuando migres tokens de notificaciones push desde otra plataforma. Después de integrar el SDK de Braze, los tokens de notificaciones push se capturan automáticamente. Para 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 punto de conexión /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": "Jane",
      "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 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 CSV. Debes enviar matrices, tokens de notificaciones push y objetos anidados a través de la API o la Ingesta de datos de Cloud. Para la lista completa de campos compatibles con CSV y los pasos de importación, consulta Atributos predeterminados.

Consideraciones

Ten en cuenta estos puntos al trabajar con atributos estándar:

  • Los nombres de campo distinguen entre mayúsculas y minúsculas. Utiliza siempre minúsculas. Un encabezado o clave que no coincida exactamente con el nombre de un atributo estándar se trata como un atributo personalizado.
  • La captura automática del SDK se suprime cuando estableces valores a través de API o CSV. Cuando estableces country o language a través de 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 una vez establecidos.
  • Los valores en blanco del CSV no sobrescriben. Una celda vacía 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 desplazamiento 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 desplazamiento UTC (por ejemplo, 2024-11-10T18:00:00-05:00).
New Stuff!