Définition des attributs personnalisés

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

Avant la mise en œuvre, assurez-vous de consulter des exemples des options de segmentation offertes par les événements personnalisés, les attributs personnalisés et les événements d’achat dans nos meilleures pratiques, ainsi que nos notes sur les conventions de nommage des événements.

Affecter des attributs utilisateur par défaut

Pour attribuer des attributs utilisateur, vous devez définir le champ approprié sur les objets ABKUser partagés.

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

• swift
• objectif-c

1
AppDelegate.braze?.user.set(firstName: "first_name")

1
[AppDelegate.braze.user setFirstName:@"first_name"];

Les attributs suivants doivent être définis sur l’objet Braze.User :

• firstName
• lastName
• email
• dateOfBirth
• country
• language
• homeCity
• phone
• 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 collecte de données utilisateur pour plus d’informations sur les options de segmentation que chacun de ces attributs vous offrira.

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

• swift
• objectif-c

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"];

Attribut personnalisé avec une valeur de nombre entier

• swift
• objectif-c

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

1
[AppDelegate.braze.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 notre base de données.

• swift
• objectif-c

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

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

Attribut personnalisé avec une valeur booléenne

• swift
• objectif-c

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

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

Attribut personnalisé avec une valeur de date

• swift
• objectif-c

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

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

Attribut personnalisé avec une valeur de tableau

Le nombre maximum d’éléments dans les tableaux d’attributs personnalisés est par défaut de 25. Les tableaux dépassant le nombre maximum d’éléments seront tronqués pour contenir le nombre maximum d’éléments. Le maximum pour les tableaux individuels peut être augmenté jusqu’à 100. Si vous souhaitez que cette limite soit augmentée, contactez votre gestionnaire de services clients.

• swift
• objectif-c

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];

Enlever la configuration d’un attribut personnalisé

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

• swift
• objectif-c

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

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

Incrémenter ou décrémenter les 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é avec n’importe quel entier positif ou négatif ou valeur longue :

• swift
• objectif-c

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

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

Définir un attribut personnalisé via l’API REST

Vous pouvez également utiliser notre API REST pour définir les attributs utilisateur. Reportez-vous à la Documentation de l’API utilisateur pour plus de détails.

Limites de valeur d’attribut personnalisé

Les valeurs d’attribut personnalisé ont une longueur maximale de 255 caractères ; les valeurs plus longues seront tronquées.

Informations supplémentaires

• Reportez-vous à la documentation Braze.User pour plus d’informations.

Configuration des abonnements utilisateur

Pour configurer un abonnement pour vos utilisateurs (par e-mail ou notification push), appelez les fonctions set(emailSubscriptionState:) ou set(pushNotificationSubscriptionState:), respectivement. Ces deux fonctions considèrent le type de enum Braze.User.SubscriptionState comme arguments. Ce type a trois états différents :

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

Les utilisateurs seront automatiquement définis sur subscribed dès la réception d’une adresse e-mail valide ; cependant, nous vous suggérons d’établir un processus d’abonnement explicite et de définir cette valeur sur optedIn dès réception du consentement explicite de votre utilisateur. Reportez-vous à Gérer les inscriptions des utilisateurs pour plus de détails.

Définir des inscriptions par e-mail

• swift
• objectif-c

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

1
[AppDelegate.braze.user setEmailSubscriptionState: BRZUserSubscriptionState]

Définition des abonnements par notification push

• swift
• objectif-c

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

1
[AppDelegate.braze.user setPushNotificationSubscriptionState: BRZUserSubscriptionState]

Reportez-vous à Gérer les inscriptions des utilisateurs pour plus de détails.