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 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 :

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

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 de nombre entier

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 notre 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 passées à Braze avec cette méthode doivent être soit au format ISO 8601 (e.g 2013-07-16T19:20:30+01:00) soit 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 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 ce maximum soit augmenté, contactez votre gestionnaire de service à la clientèle.

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

Enlever la configuration d’un attribut personnalisé

Les attributs personnalisés peuvent également être annulé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 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 :

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

Configuration des abonnements utilisateur

Pour configurer un abonnement pour vos utilisateurs (par e-mail ou notification push), appelez les fonctions setEmailNotificationSubscriptionType ou setPushNotificationSubscriptionType, respectivement. Ces deux fonctions considèrent le type de enum ABKNotificationSubscriptionType 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 ABKOptedin, car iOS nécessite un abonnement explicite.

Les utilisateurs seront automatiquement définis sur ABKSubscribed 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

1

[[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

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

Définition des abonnements par notification push

1

[[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]

1

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

Reportez-vous à Gérer les inscriptions des utilisateurs pour plus de détails.
Github   Modifier cette page sur GitHub
New Stuff!