Skip to content


Définir des attributs personnalisés pour iOS

Braze fournit des méthodes pour assigner des attributs aux utilisateurs. Vous pourrez filtrer et segmenter vos utilisateurs en fonction de ces attributs depuis le tableau de bord.

Avant de procéder à l’implémentation, pensez à consulter les exemples d’options de segmentation offertes par les événements personnalisés, les attributs personnalisés et les événements d’achat dans nos bonnes pratiques, ainsi que nos notes sur les conventions de nommage des événements.

Affecter des attributs utilisateur par défaut

Pour affecter des attributs utilisateur, vous devez définir le champ approprié sur l’objet partagé ABKUser.

Voici un exemple de définition de l’attribut prénom :

1

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

1

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

Les attributs suivants doivent être définis sur l’objet ABKUser :

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

Affecter des attributs utilisateur personnalisés

En plus des attributs utilisateur par défaut, Braze vous permet également de définir des attributs personnalisés en utilisant plusieurs types de données différents. Consultez notre documentation sur la collecte de données utilisateur pour plus d’informations sur les options de segmentation offertes par chacun de ces attributs.

Attribut personnalisé avec une valeur de chaîne de caractères

1

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

1

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

Attribut personnalisé avec une valeur entière

1

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

1

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

Attribut personnalisé avec une valeur double

Braze traite les valeurs float et double de la même manière dans sa base de données.

1

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

1

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

Attribut personnalisé avec une valeur booléenne

1

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

1

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

Attribut personnalisé avec une valeur de date

Les dates transmises à Braze avec cette méthode doivent être au format ISO 8601 (par exemple 2013-07-16T19:20:30+01:00) ou au format 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)

Attribut personnalisé avec une valeur de tableau

Le nombre maximum d’éléments par défaut dans un tableau est de 500. Vous pouvez modifier le nombre maximum d’éléments dans le tableau de bord de Braze, sous Paramètres des données > Attributs personnalisés. Les tableaux dépassant le nombre maximum d’éléments sont tronqués pour ne contenir que le nombre maximum d’éléments.

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")

Supprimer un attribut personnalisé

Les attributs personnalisés peuvent également être supprimés à l’aide de la méthode suivante :

1

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

1

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

Incrémenter/décrémenter des attributs personnalisés

Ce code est un exemple d’incrémentation d’un attribut personnalisé. Vous pouvez incrémenter la valeur d’un attribut personnalisé par n’importe quelle valeur entière ou longue, positive ou négative :

1

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

1

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

Définir un attribut personnalisé via la REST API

Vous pouvez également utiliser notre REST API pour définir des attributs utilisateur. Consultez la documentation de l’API utilisateur pour plus de détails.

Limites de valeur des attributs personnalisés

Les valeurs des attributs personnalisés ont une longueur maximale de 255 caractères ; les valeurs plus longues seront tronquées.

Informations complémentaires

Configurer les abonnements des utilisateurs

Pour configurer un abonnement pour vos utilisateurs (e-mail ou notification push), appelez les fonctions setEmailNotificationSubscriptionType ou setPushNotificationSubscriptionType, respectivement. Ces deux fonctions prennent le type enum ABKNotificationSubscriptionType comme argument. Ce type possède trois états différents :

Statut d’abonnement Définition
ABKOptedin Abonné, et explicitement inscrit
ABKSubscribed Abonné, mais pas explicitement inscrit
ABKUnsubscribed Désabonné et/ou explicitement désinscrit

Les utilisateurs qui autorisent une application à leur envoyer des notifications push ont par défaut le statut ABKOptedin, car iOS exige un abonnement explicite.

Les utilisateurs seront automatiquement définis sur ABKSubscribed à la réception d’une adresse e-mail valide ; cependant, nous vous recommandons de mettre en place un processus d’abonnement explicite et de définir cette valeur sur OptedIn dès réception du consentement explicite de votre utilisateur. Consultez Gestion des abonnements des utilisateurs pour plus de détails.

Configurer les abonnements e-mail

1

[[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

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

Configurer les abonnements aux notifications push

1

[[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

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

Consultez Gestion des abonnements des utilisateurs pour plus de détails.
New Stuff!