Esta página fue traducida automáticamente y puede contener errores. Para reportar un error de traducción,
abre un issue en GitHub.
warning:
AppboyKit (también conocido como SDK Objective-C) ya no recibe soporte y ha sido sustituido por Swift SDK. Ya no recibirá nuevas características, correcciones de errores, actualizaciones de seguridad ni soporte técnico; sin embargo, la mensajería y los análisis seguirán funcionando con normalidad. Para obtener más información, consulta Presentación del nuevo SDK Swift de Braze.
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 dashboard.
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, tienes que establecer el campo apropiado en el objeto compartido ABKUser.
A continuación se muestra un ejemplo de configuración del atributo nombre:
1
| [Appboy sharedInstance].user.firstName = @"first_name";
|
1
| Appboy.sharedInstance()?.user.firstName = "first_name"
|
Los siguientes atributos deben establecerse en el objeto ABKUser:
firstNamelastNameemaildateOfBirthcountrylanguagehomeCityphoneuserIDgender
Asignar atributos personalizados al usuario
Además de los atributos predeterminados de usuario, 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 ofrece 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 valor doble
Braze trata de la misma manera los valores float y double 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 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 pasadas a Braze con este método deben estar en el formato ISO 8601 (p. ej., 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 elementos de las matrices en el dashboard 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.
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")
|
Desactivar un atributo personalizado
Los atributos personalizados también se pueden desactivar utilizando el siguiente método:
1
| [[Appboy sharedInstance].user unsetCustomAttributeWithKey:@"your_attribute_key"];
|
1
| Appboy.sharedInstance()?.user.unsetCustomAttributeWithKey("your_attribute_key")
|
Aumentar/disminuir 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 o largo positivo o negativo:
1
| [[Appboy sharedInstance].user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];
|
1
| Appboy.sharedInstance()?.user.incrementCustomUserAttribute("your_attribute_key", by: incrementIntegerValue)
|
Configurar un atributo personalizado a través de la API REST
También puedes utilizar nuestra API REST para establecer atributos de usuario. Consulta la documentación de la API de usuario para más detalles.
Límites del valor del atributo personalizado
Los valores de atributos personalizados tienen una longitud máxima de 255 caracteres; los valores más largos se truncarán.
Configuración de las suscripciones de los 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 ABKNotificationSubscriptionType. Este tipo tiene tres estados diferentes:
| Estado de la suscripción |
Definición |
ABKOptedin |
Suscrito y con adhesión voluntaria explícita |
ABKSubscribed |
Suscrito, pero sin adhesión voluntaria explícita |
ABKUnsubscribed |
No suscrito y/o con exclusión voluntaria explícita |
Los usuarios que conceden permiso para que una aplicación les envíe notificaciones push tienen de forma predeterminada el estado ABKOptedin, ya que iOS requiere una adhesión voluntaria explícita.
Los usuarios se configurarán en ABKSubscribed 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 la sección Gestión de las suscripciones de los usuarios para obtener más detalles.
Configuración de las suscripciones por correo electrónico
1
| [[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]
|
1
| Appboy.sharedInstance()?.user.setEmailNotificationSubscriptionType(ABKNotificationSubscriptionType)
|
Configuración de suscripciones a notificaciones push
1
| [[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]
|
1
| Appboy.sharedInstance()?.user.setPushNotificationSubscriptionType(ABKNotificationSubscriptionType)
|
Consulta la sección Gestión de las suscripciones de los usuarios para obtener más detalles.
Editar esta página en GitHub