Skip to content


Establecer atributos personalizados para iOS

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.

Antes de la implementación, asegúrate de revisar los ejemplos de las opciones de segmentación que ofrecen los eventos personalizados, los atributos personalizados y los eventos de compra en nuestras mejores prácticas, así como nuestras notas sobre las convenciones de denominación de eventos.

Asignar atributos predeterminados al usuario

Para asignar atributos de usuario, necesitas establecer el campo apropiado en el objeto compartido ABKUser.

El siguiente es un ejemplo de cómo establecer el atributo de nombre:

1

[Appboy sharedInstance].user.firstName = @"first_name";

1

Appboy.sharedInstance()?.user.firstName = "first_name"

Los siguientes atributos deben establecerse en el objeto ABKUser:

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

Asignar atributos personalizados al usuario

Más allá de los atributos de usuario predeterminados, Braze también te permite definir atributos personalizados utilizando varios tipos de datos diferentes. Consulta nuestra recopilación de datos de usuario para obtener más información sobre las opciones de segmentación que te ofrecerá cada uno de estos atributos.

Atributo personalizado con un valor de cadena

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andStringValue:"your_attribute_value"];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andStringValue: "your_attribute_value")

Atributo personalizado con un valor entero

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andIntegerValue:yourIntegerValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andIntegerValue: yourIntegerValue)

Atributo personalizado con un valor double

Braze trata los valores float y double de la misma manera dentro de nuestra base de datos.

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDoubleValue:yourDoubleValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDoubleValue: yourDoubleValue)

Atributo personalizado con un valor booleano

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andBOOLValue:yourBOOLValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andBOOLValue: yourBoolValue)

Atributo personalizado con un valor de fecha

Las fechas enviadas a Braze con este método deben estar en formato ISO 8601 (por ejemplo, 2013-07-16T19:20:30+01:00) o en el formato yyyy-MM-dd'T'HH:mm:ss:SSSZ (2016-12-14T13:32:31.601-0800).

1

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDateValue:yourDateValue];

1

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDateValue:yourDateValue)

Atributo personalizado con un valor de matriz

La cantidad predeterminada y máxima de elementos en una matriz es de 500. Puedes actualizar la cantidad máxima de matrices en el panel de Braze, en Configuración de datos > Atributos personalizados. Las matrices que excedan la cantidad máxima de elementos se truncarán para contener la cantidad máxima de elementos.

1
2
3
4
5
6
7
8

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

1
2
3
4
5
6

// Setting a custom attribute with an array value
Appboy.sharedInstance()?.user.setCustomAttributeArrayWithKey("array_name", array: ["value1",  "value2"])
// Adding to a custom attribute with an array value
Appboy.sharedInstance()?.user.addToCustomAttributeArrayWithKey("array_name", value: "value3")
// Removing a value from an array type custom attribute
Appboy.sharedInstance()?.user.removeFromCustomAttributeArrayWithKey("array_name", value: "value2")

Desestablecer un atributo personalizado

Los atributos personalizados también se pueden desestablecer utilizando el siguiente método:

1

[[Appboy sharedInstance].user unsetCustomAttributeWithKey:@"your_attribute_key"];

1

Appboy.sharedInstance()?.user.unsetCustomAttributeWithKey("your_attribute_key")

Incrementar/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 entero o long, positivo o negativo:

1

[[Appboy sharedInstance].user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];

1

Appboy.sharedInstance()?.user.incrementCustomUserAttribute("your_attribute_key", by: incrementIntegerValue)

Establecer un atributo personalizado a través de la REST API

También puedes utilizar nuestra REST API para establecer atributos de usuario. Consulta la documentación de la API de usuario para obtener más detalles.

Límites de valores de atributos personalizados

Los valores de los atributos personalizados tienen una longitud máxima de 255 caracteres; los valores más largos se truncarán.

Información adicional

Configurar las suscripciones de usuario

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

Estado de suscripción Definición
ABKOptedin Suscrito y con adhesión voluntaria explícita
ABKSubscribed Suscrito, pero sin adhesión voluntaria explícita
ABKUnsubscribed Cancelada la suscripción o exclusión voluntaria explícita

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

Los usuarios se establecerán automáticamente como ABKSubscribed tras la recepción de una dirección de correo electrónico válida; sin embargo, te recomendamos que establezcas un proceso de adhesión voluntaria explícito y configures este valor como OptedIn cuando recibas el consentimiento explícito de tu usuario. Consulta Gestión de suscripciones de usuario para más detalles.

Configurar las suscripciones de correo electrónico

1

[[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

Appboy.sharedInstance()?.user.setEmailNotificationSubscriptionType(ABKNotificationSubscriptionType)

Configurar las suscripciones de notificaciones push

1

[[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

Appboy.sharedInstance()?.user.setPushNotificationSubscriptionType(ABKNotificationSubscriptionType)

Consulta Gestión de suscripciones de usuario para más detalles.
New Stuff!