Skip to content

Establecer atributos del usuario

Aprende a configurar los atributos de usuario a través del SDK de Braze.

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK de Web Braze.

Atributos predeterminados del usuario

Métodos predefinidos

Braze proporciona métodos predefinidos para configurar los siguientes atributos de usuario dentro de la clase User:

  • Nombre
  • Apellido
  • Idioma
  • País
  • Fecha de nacimiento
  • Correo electrónico
  • Género
  • Ciudad natal
  • Número de teléfono

Configuración de atributos predeterminados

Para establecer un atributo predeterminado para un usuario, llama al método getUser() en tu instancia de Braze para obtener una referencia al usuario actual de tu aplicación. A continuación, puedes llamar a métodos para establecer un atributo de usuario.

1

braze.getUser().setFirstName("SomeFirstName");

1

braze.getUser().setGender(braze.User.Genders.FEMALE);

1

braze.getUser().setDateOfBirth(2000, 12, 25);

Con Google Tag Manager, los atributos de usuario estándar (como el nombre del usuario) deben registrarse de la misma manera que los atributos de usuario personalizados. Asegúrate de que los valores que pasas para los atributos estándar coinciden con el formato esperado especificado en la documentación de la clase User.

Por ejemplo, el atributo género puede aceptar cualquiera de los siguientes valores: "m" | "f" | "o" | "u" | "n" | "p". Por lo tanto, para establecer el género de un usuario como femenino, crea una etiqueta HTML personalizada con el siguiente contenido:

1
2
3

<script>
window.braze.getUser().setGender("f")
</script>

Eliminar atributos predeterminados

Para eliminar un atributo de usuario predeterminado, pasa null al método relacionado. Por ejemplo:

1

braze.getUser().setFirstName(null);

1

braze.getUser().setGender(null);

1

braze.getUser().setDateOfBirth(null, null, null);

Atributos personalizados del usuario

Establecer atributos personalizados

Además de los métodos de atributos de usuario predeterminados, también puedes establecer atributos personalizados para tus usuarios. Para obtener las especificaciones completas del método, consulta nuestros JSDocs.

Para establecer un atributo personalizado con un valor string:

1
2
3
4

braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  YOUR_STRING_VALUE
);

Para establecer un atributo personalizado con un valor integer:

1
2
3
4
5
6
7
8
9
10

braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  YOUR_INT_VALUE
);

// Integer attributes may also be incremented using code like the following
braze.getUser().incrementCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  THE_INTEGER_VALUE_BY_WHICH_YOU_WANT_TO_INCREMENT_THE_ATTRIBUTE
);

Para establecer un atributo personalizado con un valor date:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  YOUR_DATE_VALUE
);

// This method will assign the current time to a custom attribute at the time the method is called
braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  new Date()
);

// This method will assign the date specified by secondsFromEpoch to a custom attribute
braze.getUser().setCustomUserAttribute(
  YOUR_ATTRIBUTE_KEY_STRING,
  new Date(secondsFromEpoch * 1000)
);

La cantidad predeterminada y máxima de elementos en un array es 500. Puedes actualizar la cantidad máxima de elementos en el dashboard de Braze, en Configuración de datos > Atributos personalizados. Los arrays que superen la cantidad máxima de elementos se truncarán para contener la cantidad máxima de elementos.

Para establecer un atributo personalizado con un valor array:

1
2
3
4
5
6
7

braze.getUser().setCustomUserAttribute(YOUR_ATTRIBUTE_KEY_STRING, YOUR_ARRAY_OF_STRINGS);

// Adding a new element to a custom attribute with an array value
braze.getUser().addToCustomAttributeArray(YOUR_ATTRIBUTE_KEY_STRING, "new string");

// Removing an element from a custom attribute with an array value
braze.getUser().removeFromCustomAttributeArray(YOUR_ATTRIBUTE_KEY_STRING, "value to be removed");

Los atributos personalizados de usuario no están disponibles debido a una limitación del lenguaje de scripting de Google Tag Manager. Para registrar atributos personalizados, crea una etiqueta HTML personalizada con el siguiente contenido:

1
2
3
4
5

<script>
  // Note: If using SDK version 3.x or below, use `window.appboy` instead of `window.braze`
  // Version 4 or greater should use `window.braze`
window.braze.getUser().setCustomUserAttribute("attribute name", "attribute value");
</script>

Eliminar atributos personalizados

Para eliminar un atributo personalizado, pasa null al método relacionado.

1

braze.getUser().setCustomUserAttribute(YOUR_ATTRIBUTE_KEY_STRING, null);

Atributos personalizados anidados

También puedes anidar propiedades dentro de atributos personalizados. En el siguiente ejemplo, un objeto favorite_book con propiedades anidadas se establece como un atributo personalizado en el perfil de usuario. Para obtener más información, consulta Atributos personalizados anidados.

1
2
3
4
5
6
7
8
9

import * as braze from "@braze/web-sdk";

const favoriteBook = {
  title: "The Hobbit",
  author: "J.R.R. Tolkien",
  publishing_date: "1937"
};

braze.getUser().setCustomUserAttribute("favorite_book", favoriteBook);

Uso de la API REST

También puedes utilizar nuestra API REST para establecer o eliminar atributos de usuario. Para obtener más información, consulta Puntos finales de datos de usuario.

Configuración de suscripciones de usuarios

Para configurar una suscripción para tus usuarios (ya sea por correo electrónico o push), llama a las funciones setEmailNotificationSubscriptionType() o setPushNotificationSubscriptionType(), respectivamente. Ambas funciones toman el tipo de enumeración braze.User.NotificationSubscriptionTypes como argumento. Este tipo tiene tres estados diferentes:

Cuando un usuario se registra para recibir notificaciones push, el navegador le obliga a elegir entre permitir o bloquear las notificaciones, y si elige permitirlas, se establece como OPTED_IN de forma predeterminada.

Visita Gestionar las suscripciones de los usuarios para obtener más información sobre la implementación de las suscripciones y las adhesiones voluntarias explícitas.

Cancelar la suscripción de un usuario al correo electrónico

1

braze.getUser().setEmailNotificationSubscriptionType(braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED);

Cancelar la suscripción de un usuario a las notificaciones push

1

braze.getUser().setPushNotificationSubscriptionType(braze.User.NotificationSubscriptionTypes.UNSUBSCRIBED);

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK de Android Braze.

Atributos predeterminados del usuario

Métodos predefinidos

Braze proporciona métodos predefinidos para establecer los siguientes atributos de usuario dentro de la clase BrazeUser. Para obtener especificaciones sobre los métodos, consulta nuestro KDoc.

  • Nombre
  • Apellido
  • País
  • Idioma
  • Fecha de nacimiento
  • Correo electrónico
  • Género
  • Ciudad de origen
  • Número de teléfono

Configuración de atributos predeterminados

Para establecer un atributo predeterminado para un usuario, llama al método getCurrentUser() en tu instancia de Braze para obtener una referencia al usuario actual de tu aplicación. A continuación, puedes llamar a métodos para establecer un atributo de usuario.

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setFirstName("first_name");
  }
}

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setFirstName("first_name")
}

Eliminar atributos predeterminados

Para eliminar un atributo de usuario, pasa null al método correspondiente.

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setFirstName(null);
  }
}

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setFirstName(null)
}

Atributos personalizados del usuario

Además de los atributos de usuario predeterminados, Braze también te permite definir atributos personalizados utilizando varios tipos de datos diferentes. Para obtener más información sobre la opción de segmentación de cada atributo, consulta Recopilación de datos de usuario.

Establecer atributos personalizados

Para establecer un atributo personalizado con un valor string:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", "your_attribute_value");
  }
}

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", "your_attribute_value")
}

Para establecer un atributo personalizado con un valor int:

1
2
3
4
5
6
7
8
9

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_INT_VALUE);
    
    // Integer attributes may also be incremented using code like the following:
    brazeUser.incrementCustomUserAttribute("your_attribute_key", YOUR_INCREMENT_VALUE);
  }
}

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_INT_VALUE)

  // Integer attributes may also be incremented using code like the following:
  brazeUser.incrementCustomUserAttribute("your_attribute_key", YOUR_INCREMENT_VALUE)
}

Para establecer un atributo personalizado con un valor entero long:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_LONG_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_LONG_VALUE)
}

Para establecer un atributo personalizado con un valor float:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_FLOAT_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_FLOAT_VALUE)
}

Para establecer un atributo personalizado con un valor double:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DOUBLE_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DOUBLE_VALUE)
}

Para establecer un atributo personalizado con un valor boolean:

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_BOOLEAN_VALUE);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_BOOLEAN_VALUE)
}

1
2
3
4
5
6
7
8
9
10

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DATE_VALUE);
    // This method will assign the current time to a custom attribute at the time the method is called:
    brazeUser.setCustomUserAttributeToNow("your_attribute_key");
    // This method will assign the date specified by SECONDS_FROM_EPOCH to a custom attribute:
    brazeUser.setCustomUserAttributeToSecondsFromEpoch("your_attribute_key", SECONDS_FROM_EPOCH);
  }
});

1
2
3
4
5
6
7

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setCustomUserAttribute("your_attribute_key", YOUR_DATE_VALUE)
  // This method will assign the current time to a custom attribute at the time the method is called:
  brazeUser.setCustomUserAttributeToNow("your_attribute_key")
  // This method will assign the date specified by SECONDS_FROM_EPOCH to a custom attribute:
  brazeUser.setCustomUserAttributeToSecondsFromEpoch("your_attribute_key", SECONDS_FROM_EPOCH)
}

La cantidad predeterminada y máxima de elementos en una matriz es 500. Puedes actualizar la cantidad máxima de matrices en el panel de Braze, en Configuración de datos > Atributos personalizados. Las matrices que superan la cantidad máxima de elementos se truncan para contener la cantidad máxima de elementos. Para obtener más información sobre las matrices de atributos personalizados y su comportamiento, consulta Matrices.

1
2
3
4
5
6
7
8
9
10
11

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    // Setting a custom attribute with an array value
    brazeUser.setCustomAttributeArray("your_attribute_key", testSetArray);
    // Adding to a custom attribute with an array value
    brazeUser.addToCustomAttributeArray("your_attribute_key", "value_to_add");
    // Removing a value from an array type custom attribute
    brazeUser.removeFromCustomAttributeArray("your_attribute_key", "value_to_remove");
  }
});

1
2
3
4
5
6
7
8

Braze.getInstance(context).getCurrentUser { brazeUser ->
  // Setting a custom attribute with an array value
  brazeUser.setCustomAttributeArray("your_attribute_key", testSetArray)
  // Adding to a custom attribute with an array value
  brazeUser.addToCustomAttributeArray("your_attribute_key", "value_to_add")
  // Removing a value from an array type custom attribute
  brazeUser.removeFromCustomAttributeArray("your_attribute_key", "value_to_remove")
}

Eliminar atributos personalizados

Para eliminar un atributo personalizado, pasa la clave del atributo correspondiente al método unsetCustomUserAttribute.

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.unsetCustomUserAttribute("your_attribute_key");
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.unsetCustomUserAttribute("your_attribute_key")
}

Atributos personalizados anidados

También puedes anidar propiedades dentro de atributos personalizados. En el siguiente ejemplo, un objeto favorite_book con propiedades anidadas se establece como un atributo personalizado en el perfil de usuario. Para obtener más información, consulta Atributos personalizados anidados.

1
2
3
4
5
6
7
8
9
10
11
12
13

JSONObject favoriteBook = new JSONObject();
try {
  favoriteBook.put("title", "The Hobbit");
  favoriteBook.put("author", "J.R.R. Tolkien");
  favoriteBook.put("publishing_date", "1937");
} catch (JSONException e) {
  e.printStackTrace();
}

braze.getCurrentUser(user -> {
  user.setCustomUserAttribute("favorite_book", favoriteBook);
  return null;
});

1
2
3
4
5
6
7
8

val favoriteBook = JSONObject()
  .put("title", "The Hobbit")
  .put("author", "J.R.R. Tolkien")
  .put("publishing_date", "1937")

braze.getCurrentUser { user ->
  user.setCustomUserAttribute("favorite_book", favoriteBook)
}

Uso de la API REST

También puedes utilizar nuestra API REST para establecer o eliminar atributos de usuario. Para obtener más información, consulta Puntos finales de datos de usuario.

Configuración de suscripciones de usuarios

Para configurar una suscripción para tus usuarios (por correo electrónico o push), llama a las funciones setEmailNotificationSubscriptionType() o setPushNotificationSubscriptionType(), respectivamente. Estas dos funciones toman como argumento el tipo de enumeración NotificationSubscriptionType. Este tipo tiene tres estados diferentes:

Configuración de las suscripciones por correo electrónico

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setEmailNotificationSubscriptionType(emailNotificationSubscriptionType);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setEmailNotificationSubscriptionType(emailNotificationSubscriptionType)
}

Configuración de la suscripción a notificaciones push

1
2
3
4
5
6

Braze.getInstance(context).getCurrentUser(new IValueCallback<BrazeUser>() {
  @Override
  public void onSuccess(BrazeUser brazeUser) {
    brazeUser.setPushNotificationSubscriptionType(pushNotificationSubscriptionType);
  }
});

1
2
3

Braze.getInstance(context).getCurrentUser { brazeUser ->
  brazeUser.setPushNotificationSubscriptionType(pushNotificationSubscriptionType)
}

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK de Swift Braze.

Atributos predeterminados del usuario

Atributos admitidos

Los siguientes atributos deben establecerse en el objeto Braze.User:

  • firstName
  • lastName
  • email
  • dateOfBirth
  • country
  • language
  • homeCity
  • phone
  • gender

Configuración de atributos predeterminados

Para establecer un atributo de usuario predeterminado, configura el campo adecuado en el objeto Braze.User compartido. A continuación se muestra un ejemplo de configuración del atributo nombre:

1

AppDelegate.braze?.user.set(firstName: "Alex")

1

[AppDelegate.braze.user setFirstName:@"Alex"];

Eliminar los atributos predeterminados

Para eliminar un atributo de usuario predeterminado, pasa nil al método correspondiente.

1

AppDelegate.braze?.user.set(firstName: nil)

1

[AppDelegate.braze.user setFirstName:nil];

Atributos personalizados del usuario

Además de los atributos de usuario predeterminados, Braze también te permite definir atributos personalizados utilizando varios tipos de datos diferentes. Para obtener más información sobre la opción de segmentación de cada atributo, consulta Recopilación de datos de usuario.

Establecer atributos personalizados

Para establecer un atributo personalizado con un valor string:

1

AppDelegate.braze?.user.setCustomAttribute(key: "your_attribute_key", value: "your_attribute_value")

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" stringValue:"your_attribute_value"];

Para establecer un atributo personalizado con un valor integer:

1

AppDelegate.braze?.user.setCustomAttribute(key: "your_attribute_key", value: yourIntegerValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andIntegerValue:yourIntegerValue];

Braze trata de la misma manera los valores float y double dentro de nuestra base de datos. Para establecer un atributo personalizado con un valor double:

1

AppDelegate.braze?.user.setCustomAttribute(key: "your_attribute_key", value: yourDoubleValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andDoubleValue:yourDoubleValue];

Para establecer un atributo personalizado con un valor boolean:

1

AppDelegate.braze?.user.setCustomAttribute("your_attribute_key", value: yourBoolValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andBOOLValue:yourBOOLValue];

Para establecer un atributo personalizado con un valor date:

1

AppDelegate.braze?.user.setCustomAttribute("your_attribute_key", dateValue:yourDateValue)

1

[AppDelegate.braze.user setCustomAttributeWithKey:@"your_attribute_key" andDateValue:yourDateValue];

La cantidad predeterminada y máxima de elementos en un array es 500. Puedes actualizar la cantidad máxima de arrays en el panel de Braze, en Configuración de datos > Atributos personalizados. Los arrays que superen la cantidad máxima de elementos se truncarán para contener la cantidad máxima de elementos.

Para establecer un atributo personalizado con un valor array:

1
2
3
4
5
6

// Setting a custom attribute with an array value
AppDelegate.braze?.user.setCustomAttributeArray(key: "array_name", array: ["value1",  "value2"])
// Adding to a custom attribute with an array value
AppDelegate.braze?.user.addToCustomAttributeArray(key: "array_name", value: "value3")
// Removing a value from an array type custom attribute
AppDelegate.braze?.user.removeFromCustomAttributeArray(key: "array_name", value: "value2")

1
2
3
4
5
6
7
8

// Setting a custom attribute with an array value
[AppDelegate.braze.user setCustomAttributeArrayWithKey:@"array_name" array:@[@"value1",  @"value2"]];
// Adding to a custom attribute with an array value
[AppDelegate.braze.user addToCustomAttributeArrayWithKey:@"array_name" value:@"value3"];
// Removing a value from an array type custom attribute
[AppDelegate.braze.user removeFromCustomAttributeArrayWithKey:@"array_name" value:@"value2"];
// Removing an entire array and key
[AppDelegate.braze.user setCustomAttributeArrayWithKey:@"array_name" array:nil];

Incrementar o decrementar atributos personalizados

Este código es un ejemplo de un atributo personalizado que se incrementa. Puedes incrementar el valor de un atributo personalizado con cualquier valor integer o long:

1

AppDelegate.braze?.user.incrementCustomUserAttribute(key: "your_attribute_key", by: incrementIntegerValue)

1

[AppDelegate.braze.user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];

Eliminar atributos personalizados

Para eliminar un atributo personalizado, pasa la clave del atributo correspondiente al método unsetCustomAttribute.

1

AppDelegate.braze?.user.unsetCustomAttribute(key: "your_attribute_key")

Para eliminar un atributo personalizado, pasa la clave del atributo correspondiente al método unsetCustomAttributeWithKey.

1

[AppDelegate.braze.user unsetCustomAttributeWithKey:@"your_attribute_key"];

Atributos personalizados anidados

También puedes anidar propiedades dentro de atributos personalizados. En el siguiente ejemplo, un objeto favorite_book con propiedades anidadas se establece como un atributo personalizado en el perfil de usuario. Para obtener más información, consulta Atributos personalizados anidados.

1
2
3
4
5
6
7

let favoriteBook: [String: Any?] = [
  "title": "The Hobbit",
  "author": "J.R.R. Tolkien",
  "publishing_date": "1937"
]

braze.user.setCustomAttribute(key: "favorite_book", dictionary: favoriteBook)

1
2
3
4
5
6
7

NSDictionary *favoriteBook = @{
  @"title": @"The Hobbit",
  @"author": @"J.R.R. Tolkien",
  @"publishing_date": @"1937"
};

[AppDelegate.braze.user setCustomAttributeWithKey:@"favorite_book" dictionary:favoriteBook];

Uso de la API REST

También puedes utilizar nuestra API REST para establecer o eliminar atributos de usuario. Para obtener más información, consulta Puntos finales de datos de usuario.

Configuración de suscripciones de usuarios

Para configurar una suscripción para tus usuarios (por correo electrónico o push), llama a las funciones set(emailSubscriptionState:) o set(pushNotificationSubscriptionState:), respectivamente. Estas dos funciones toman como argumento el tipo de enumeración Braze.User.SubscriptionState. Este tipo tiene tres estados diferentes:

Los usuarios que conceden permiso para que una aplicación les envíe notificaciones push tienen de forma predeterminada el estado optedIn, ya que iOS requiere una adhesión voluntaria explícita.

Los usuarios se configurarán en subscribed automáticamente al recibir una dirección de correo electrónico válida; sin embargo, te sugerimos que establezcas un proceso de adhesión voluntaria explícito y configures este valor en optedIn al recibir el consentimiento explícito de tu usuario. Consulta Gestión de las suscripciones de los usuarios para obtener más detalles.

Configuración de las suscripciones por correo electrónico

1

AppDelegate.braze?.user.set(emailSubscriptionState: Braze.User.SubscriptionState)

1

[AppDelegate.braze.user setEmailSubscriptionState: BRZUserSubscriptionState]

Configuración de suscripciones a notificaciones push

1

AppDelegate.braze?.user.set(pushNotificationSubscriptionState: Braze.User.SubscriptionState)

1

[AppDelegate.braze.user setPushNotificationSubscriptionState: BRZUserSubscriptionState]

Consulta Gestión de las suscripciones de los usuarios para obtener más detalles.

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK de Flutter Braze.

Atributos predeterminados del usuario

Atributos admitidos

Se admiten los siguientes atributos:

  • Nombre
  • Apellido
  • Género
  • Fecha de nacimiento
  • Ciudad natal
  • País
  • Número de teléfono
  • Idioma
  • Correo electrónico

Configuración de atributos predeterminados

Para configurar los atributos de usuario recogidos automáticamente por Braze, puedes utilizar los métodos de configuración incluidos en el SDK.

1

braze.setFirstName('Name');

Atributos personalizados del usuario

Establecer atributos personalizados

Además de los atributos de usuario predeterminados, Braze también te permite definir atributos personalizados utilizando distintos tipos de datos:

Para establecer un atributo personalizado con un valor string:

1

braze.setStringCustomUserAttribute("custom string attribute", "string custom attribute");

Para establecer un atributo personalizado con un valor integer:

1
2
3
4

// Set Integer Attribute
braze.setIntCustomUserAttribute("custom int attribute key", integer);
// Increment Integer Attribute
braze.incrementCustomUserAttribute("key", integer);

Para establecer un atributo personalizado con un valor double:

1

braze.setDoubleCustomUserAttribute("custom double attribute key", double);

Para establecer un atributo personalizado con un valor boolean:

1

braze.setBoolCustomUserAttribute("custom boolean attribute key", boolean);

Para establecer un atributo personalizado con un valor date:

1

braze.setDateCustomUserAttribute("custom date attribute key", date);

Para establecer un atributo personalizado con un valor array:

1
2
3
4

// Adding to an Array
braze.addToCustomAttributeArray("key", "attribute");
// Removing an item from an Array
braze.removeFromCustomAttributeArray("key", "attribute");

Desactivar atributos personalizados

Para desactivar un atributo personalizado, pasa la clave del atributo correspondiente al método unsetCustomUserAttribute.

1

braze.unsetCustomUserAttribute('attribute_key');

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK de Roku Braze.

Atributos predeterminados del usuario

Métodos predefinidos

Braze proporciona métodos predefinidos para configurar los siguientes atributos de usuario utilizando el objeto m.Braze.

  • FirstName
  • LastName
  • Email
  • Gender
  • DateOfBirth
  • Country
  • Language
  • HomeCity
  • PhoneNumber

Configuración de atributos predeterminados

Para establecer un atributo predeterminado, llama al método correspondiente en el objeto m.Braze.

1

m.Braze.setFirstName("Alex")

1

m.Braze.setLastName("Smith")

1

m.Braze.setGender("m") ' Accepts: "m", "f", "o", "n", "u", "p"

1

m.Braze.setDateOfBirth(1990, 5, 15) ' Year, month, day

1

m.Braze.setCountry("United States")

1

m.Braze.setLanguage("en")

1

m.Braze.setHomeCity("New York")

1

m.Braze.setPhoneNumber("+1234567890")

Atributos personalizados del usuario

Además de los atributos predeterminados de usuario, Braze también te permite definir atributos personalizados utilizando varios tipos de datos diferentes.

Configuración de atributos personalizados

Para establecer un atributo personalizado un valor string:

1

m.Braze.setCustomAttribute("stringAttribute", "stringValue")

Para establecer un atributo personalizado con un valor integer:

1

m.Braze.setCustomAttribute("intAttribute", 5)

Braze trata exactamente igual los valores float y double. Para establecer un atributo personalizado con cualquier valor:

1

m.Braze.setCustomAttribute("floatAttribute", 3.5)

Para establecer un atributo personalizado con un valor boolean:

1

m.Braze.setCustomAttribute("boolAttribute", true)

Para establecer un atributo personalizado con un valor date:

1
2
3

dateAttribute = CreateObject("roDateTime")
dateAttribute.fromISO8601String("1992-11-29 00:00:00.000")
m.Braze.setCustomAttribute("dateAttribute", dateAttribute)

Para establecer un atributo personalizado con un valor array:

1
2
3
4
5

stringArray = createObject("roArray", 3, true)
stringArray.Push("string1")
stringArray.Push("string2")
stringArray.Push("string3")
m.Braze.setCustomAttribute("arrayAttribute", stringArray)

Aumento y disminución de atributos personalizados

Este código es un ejemplo de atributo personalizado que se incrementa. Puedes incrementar el valor de un atributo personalizado en cualquier valor entero positivo o negativo.

1

m.Braze.incrementCustomUserAttribute("intAttribute", 3)

Desactivar atributos personalizados

Para desactivar un atributo personalizado, pasa la clave del atributo correspondiente al método unsetCustomAttribute.

1

m.Braze.unsetCustomAttribute("attributeName")

Utilizar la API REST

También puedes utilizar nuestra API REST para establecer o desestablecer atributos de usuario. Para más información, consulta Puntos finales de datos de usuario.

Configuración de las suscripciones por correo electrónico

Puedes configurar los siguientes estados de suscripción por correo electrónico para tus usuarios mediante programación a través del SDK.

El método para configurar el estado de la suscripción por correo electrónico es setEmailSubscriptionState(). Los usuarios se configurarán en Subscribed automáticamente al recibir una dirección de correo electrónico válida, sin embargo, te sugerimos que establezcas un proceso de adhesión voluntaria explícito y configures este valor en OptedIn al recibir el consentimiento explícito de tu usuario. Para más detalles, visita Gestionar las suscripciones de los usuarios.

1

m.Braze.setEmailSubscriptionState(BrazeConstants().SUBSCRIPTION_STATES.OPTED_IN)

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK Braze de Unity.

Atributos predeterminados del usuario

Métodos predefinidos

Braze proporciona métodos predefinidos para configurar los siguientes atributos de usuario utilizando el objeto BrazeBinding. Para más información, consulta el archivo de declaración de Unity de Braze.

  • Nombre
  • Apellido
  • Correo electrónico del usuario
  • Género
  • Fecha de nacimiento
  • País del usuario
  • Ciudad de residencia del usuario
  • Suscripción por correo electrónico del usuario
  • Suscripción push de usuario
  • Número de teléfono del usuario

Configuración de atributos predeterminados

Para establecer un atributo predeterminado, llama al método correspondiente en el objeto BrazeBinding.

1

BrazeBinding.SetUserFirstName("first name");

1

BrazeBinding.SetUserLastName("last name");

1

BrazeBinding.SetUserGender(Appboy.Models.Gender);

1

BrazeBinding.SetUserDateOfBirth("year(int)", "month(int)", "day(int)");

1

BrazeBinding.SetUserCountry("country name");

1

BrazeBinding.SetUserHomeCity("city name");

1

BrazeBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType);

1

BrazeBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType);

1

BrazeBinding.SetUserPhoneNumber("phone number");

Desactivar atributos predeterminados

Para desactivar un atributo predeterminado del usuario, pasa null al método correspondiente.

1

BrazeBinding.SetUserFirstName(null);

Atributos personalizados del usuario

Además de los atributos predeterminados de usuario, Braze también te permite definir atributos personalizados utilizando varios tipos de datos diferentes. Para más información sobre la opción de segmentación de cada atributo, consulta Recopilación de datos de usuario.

Establecer atributos personalizados

Para establecer un atributo personalizado, utiliza el método correspondiente para el tipo de atributo:

1

AppboyBinding.SetCustomUserAttribute("custom string attribute key", "string custom attribute");

1
2
3
4

// Set Integer Attribute
AppboyBinding.SetCustomUserAttribute("custom int attribute key", 'integer value');
// Increment Integer Attribute
AppboyBinding.IncrementCustomUserAttribute("key", increment(int))

1

AppboyBinding.SetCustomUserAttribute("custom double attribute key", 'double value');

1

AppboyBinding.SetCustomUserAttribute("custom boolean attribute key", 'boolean value');

1

AppboyBinding.SetCustomUserAttributeToNow("custom date attribute key");

1

AppboyBinding.SetCustomUserAttributeToSecondsFromEpoch("custom date attribute key", 'integer value');

1
2
3
4
5
6

// Setting An Array
AppboyBinding.SetCustomUserAttributeArray("key", array(List), sizeOfTheArray(int))
// Adding to an Array
AppboyBinding.AddToCustomUserAttributeArray("key", "Attribute")
// Removing an item from an Array
AppboyBinding.RemoveFromCustomUserAttributeArray("key", "Attribute")

Desactivar atributos personalizados

Para desactivar un atributo personalizado, pasa la clave del atributo correspondiente al método UnsetCustomUserAttribute.

1

AppboyBinding.UnsetCustomUserAttribute("custom attribute key");

Utilizar la API REST

También puedes utilizar nuestra API REST para establecer o desestablecer atributos de usuario. Para más información, consulta Puntos finales de datos de usuario.

Configuración de las suscripciones de los usuarios

Para configurar una suscripción por correo electrónico o push para tus usuarios, llama a una de las siguientes funciones.

1
2
3
4
5

// Email notifications
AppboyBinding.SetUserEmailNotificationSubscriptionType()

// Push notifications
AppboyBinding.SetPushNotificationSubscriptionType()`

Ambas funciones toman como argumento Appboy.Models.AppboyNotificationSubscriptionType, que tiene tres estados diferentes:

Configuración de las suscripciones por correo electrónico

1

AppboyBinding.SetUserEmailNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);

Configuración de suscripciones a notificaciones push

1

AppboyBinding.SetUserPushNotificationSubscriptionType(AppboyNotificationSubscriptionType.OPTED_IN);

Requisitos previos

Antes de poder utilizar esta característica, tendrás que integrar el SDK Braze de React Native.

Registro de atributos personalizados

Braze proporciona métodos para asignar atributos a los usuarios. Podrás filtrar y segmentar a tus usuarios según estos atributos en el panel.

Atributos predeterminados del usuario

Para configurar los atributos de usuario recopilados automáticamente por Braze, puedes utilizar los métodos de configuración que vienen con el SDK.

1

Braze.setFirstName("Name");

Se admiten los siguientes atributos:

  • Nombre
  • Apellido
  • Género
  • Fecha de nacimiento
  • Ciudad natal
  • País
  • Número de teléfono
  • Idioma
  • Correo electrónico

Todos los valores de cadena como nombre, apellidos, país y ciudad de residencia están limitados a 255 caracteres.

Atributos personalizados del usuario

Además de nuestros métodos predefinidos de atributos de usuario, Braze también proporciona atributos personalizados para hacer un seguimiento de los datos de tus aplicaciones.

1
2
3

Braze.setCustomUserAttribute("attribute_key", "attribute_value", function(){
    // optional onResult callback
});

Desactivar atributos personalizados

1
2
3

Braze.unsetCustomUserAttribute("attribute_key", function(){
    // optional onResult callback
});

Matrices de atributos personalizadas

1
2
3
4
5
6
7
8

// Adds a string to a custom attribute string array, or creates that array if one doesn't exist.
Braze.addToCustomUserAttributeArray("my-attribute-array", "new or existing value", optionalCallback);

// Removes a string from a custom attribute string array.


Braze.removeFromCustomUserAttributeArray("my-attribute-array", "existing value", optionalCallback);
Github   Editar esta página en GitHub
New Stuff!