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:

• El SDK de Braze
• El objeto de atributos de usuario en el endpoint /users/track
• Importación CSV
• Ingesta de datos en la nube

Importante

Los nombres de los atributos estándar distinguen entre mayúsculas y minúsculas. Utiliza siempre minúsculas (por ejemplo, first_name, no First_Name). Si la ortografía o las mayúsculas no coinciden exactamente, Braze almacena el valor como un atributo personalizado.

Identificadores

Los identificadores le 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 obtener más información 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.

Suscripción y consentimiento

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 más detalles 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 utilizó 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

Usa 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 CSV. Debes enviar matrices, tokens de notificaciones push y objetos anidados a través de la API o la ingesta de datos en la nube. Para ver 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 campo 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 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 después de haberse establecido.
• 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 desfase se interpretan como medianoche UTC y se muestran en la zona horaria de tu espacio de trabajo. Para especificar una zona horaria, agrega un desfase UTC (por ejemplo, 2024-11-10T18:00:00-05:00).

Páginas relacionadas

• Objeto de atributos de usuarioContrato completo de la API para el objeto de atributos.
• Endpoint /users/trackEndpoint REST para crear y actualizar perfiles de usuario.
• Establecer atributos de usuarioMétodos del SDK para establecer atributos estándar y personalizados.
• Importación CSVCarga atributos estándar a través de un archivo CSV.
• Atributos personalizadosDefine atributos únicos para tu negocio.
• Tipos de datosReferencia de tipos de datos compatibles.