Types de données

Cette page regroupe les types de données pris en charge pour les attributs personnalisés, les propriétés d’événement et les catalogues. Chaque type de données personnalisé offre une prise en charge et des contraintes légèrement différentes.

Définitions

Utilisez ce tableau pour identifier les types de données disponibles pour les attributs de profil utilisateur, les données d’événement ou les éléments de catalogue. Consultez les sections suivantes pour connaître l’utilisation et les contraintes de chaque type.

Considérations importantes

• Tableau : les attributs personnalisés et les propriétés d’événement ont des limites de taille. Les dates ne sont pas prises en charge dans les tableaux des propriétés d’événement. Les catalogues ne prennent en charge que les tableaux de chaînes de caractères, avec un maximum de 100 éléments.
• Objet : dans Braze, ce type apparaît sous le nom « attributs personnalisés imbriqués » pour les attributs personnalisés, « objets imbriqués » pour les propriétés d’événement et « objet JSON » pour les catalogues.
• Heure : dans les propriétés d’événement, ce type est intitulé « Datetime ».

Types de données des attributs personnalisés

Les attributs personnalisés prennent en charge les types de données répertoriés dans le tableau Définitions. Les sections suivantes décrivent l’utilisation et la segmentation pour chaque type de données pris en charge.

• valeur booléenne
• nombres
• chaînes de caractères
• tableaux
• heure
• objets
• tableaux d'objets

Vous pouvez bloquer individuellement des attributs personnalisés depuis le menu d’actions, ou sélectionner et bloquer jusqu’à 100 attributs en masse. Lorsqu’un attribut personnalisé est bloqué, aucune donnée n’est collectée pour cet attribut, les données existantes ne sont plus accessibles (sauf réactivation), et les attributs bloqués n’apparaissent pas dans les filtres ni les graphiques. De plus, si l’attribut est actuellement référencé par des filtres ou des déclencheurs dans d’autres zones du tableau de bord de Braze, une fenêtre modale d’avertissement s’affiche pour vous informer que toutes les instances de filtres ou de déclencheurs qui le référencent seront supprimées et archivées.

Marquer comme information personnelle identifiable (PII)

Les administrateurs peuvent également créer des attributs personnalisés et les marquer comme PII depuis cette page. Ces attributs ne sont visibles que par les administrateurs et les utilisateurs du tableau de bord disposant de l’autorisation « View Custom Attributes Marked as PII ».

Ajouter des descriptions

Vous pouvez ajouter une description à un attribut personnalisé après sa création si vous disposez de l’autorisation utilisateur Manage Events, Attributes, Purchases. Modifiez l’attribut personnalisé et saisissez ce que vous souhaitez, par exemple une note pour votre équipe.

Ajouter des étiquettes

Vous pouvez ajouter des étiquettes à un attribut personnalisé après sa création si vous disposez de l’autorisation utilisateur « Manage Events, Attributes, Purchases ». Vous pouvez ensuite utiliser ces étiquettes pour filtrer la liste des attributs.

Supprimer des attributs personnalisés

Il existe deux façons de supprimer des attributs personnalisés des profils utilisateur :

• Sélectionnez le nom de l’attribut personnalisé à supprimer dans une étape de mise à jour utilisateur.
• Définissez la valeur null dans votre requête API vers l’endpoint /users/track.

Définir la valeur null

Important

Définir un attribut à null et le définir à "" (chaîne vide) ne revient pas au même.

• null supprime entièrement l’attribut du profil utilisateur. Il n’apparaît plus dans le profil et ne correspond à aucun filtre IS NOT BLANK.
• "" définit l’attribut comme une valeur de chaîne vide. L’attribut apparaît dans le profil avec une valeur de chaîne vide, mais ne correspond pas aux filtres IS NOT BLANK (il est considéré comme vide).

De plus, "" n’est valide que pour les attributs de type chaîne de caractères. Si le type de données de l’attribut est défini sur un type autre que chaîne (comme valeur booléenne, nombre ou heure) dans le tableau de bord, l’envoi de "" n’efface pas la valeur — utilisez null à la place.

Exporter des données

Pour exporter la liste des attributs personnalisés sous forme de fichier CSV, sélectionnez Export all en haut de la page. Le système génère un fichier CSV et vous envoie un lien de téléchargement par e-mail.

Consulter les rapports d’utilisation

Le rapport d’utilisation répertorie tous les Canvas, Campaigns et Segments utilisant un attribut personnalisé spécifique. Cette liste n’inclut pas les utilisations de Liquid.

Vous pouvez consulter jusqu’à 100 rapports d’utilisation à la fois en cochant les cases des attributs personnalisés concernés, puis en sélectionnant View usage report.

Onglet Values

Lorsque vous consultez un rapport d’utilisation, sélectionnez l’onglet Values pour afficher les principales valeurs des attributs personnalisés sélectionnés, basées sur un échantillon d’environ 250 000 utilisateurs. Notez que comme les résultats proviennent d’un sous-ensemble d’utilisateurs, l’échantillon ne comprend pas toutes les valeurs existantes. L’onglet Values ne doit donc pas être utilisé pour la résolution des problèmes ou pour des cas d’usage nécessitant l’intégration des données de tous les utilisateurs.

Définir des attributs personnalisés

Voici la liste des méthodes utilisées sur les différentes plateformes pour définir des attributs personnalisés.

Développer pour consulter la documentation par plateforme

• Android et FireOS
• iOS
• Web
• React Native
• Unity
• .NET MAUI (anciennement Xamarin)
• Roku

Stockage des attributs personnalisés

Toutes les données stockées dans le profil utilisateur, y compris les données d’attributs personnalisés, sont conservées indéfiniment tant que chaque profil est actif.

Types de données des attributs personnalisés

Les attributs personnalisés sont des outils extrêmement flexibles qui permettent un ciblage précis.

Les types de données suivants peuvent être stockés en tant qu’attributs personnalisés :

• Valeurs booléennes
• Nombres
• Chaînes de caractères
• Tableaux
• Heure
• Objets
• Tableaux d’objets

Valeurs booléennes (vrai/faux)

Les attributs booléens sont utiles pour stocker des données binaires simples concernant vos utilisateurs, comme les statuts d’abonnement. Vous pouvez trouver les utilisateurs qui ont explicitement une variable définie à vrai ou faux, en plus de ceux qui n’ont pas encore d’enregistrement pour cet attribut.

Pour les attributs booléens, les options de segmentation suivantes sont disponibles.

Options de segmentation	Filtre déroulant	Options de saisie	Exemples
Vérifier si la valeur booléenne est vrai, faux, vrai ou non défini, ou faux ou non défini	IS	TRUE, FALSE, TRUE OR NOT SET, ou FALSE OR NOT SET	Si ce filtre spécifie coffee_drinker, un utilisateur correspondra à ce filtre dans les circonstances suivantes : Si ce filtre est true et que l'utilisateur possède la valeur coffee_drinker Si ce filtre est false et que l'utilisateur ne possède pas la valeur coffee_drinker Si ce filtre est true or not set et que l'utilisateur possède la valeur coffee_drinker ou aucune valeur Si ce filtre est false or not set et que l'utilisateur ne possède pas coffee_drinker ou aucune valeur
Vérifier si la valeur booléenne existe dans le profil d’un utilisateur et n’est pas null	IS NOT BLANK	N/A	Si ce filtre spécifie coffee_drinker et qu’un utilisateur possède une valeur pour l’attribut coffee_drinker, l’utilisateur correspondra à ce filtre.
Vérifier si la valeur booléenne n’existe pas dans le profil d’un utilisateur ou est null	IS BLANK	N/A	Si ce filtre spécifie coffee_drinker et qu’un utilisateur ne possède pas l’attribut coffee_drinker ou que la valeur de coffee_drinker est null, l’utilisateur correspondra à ce filtre.

Conseil

Les dépenses ne doivent pas être enregistrées par cette méthode. Elles doivent plutôt être enregistrées via les événements d’achat.

Pour les attributs numériques, les options de segmentation suivantes sont disponibles.

Options de segmentation	Filtre déroulant	Options de saisie	Exemples
Vérifier si l’attribut numérique est exactement un nombre	EXACTLY	NUMBER	Si ce filtre spécifie 10 et qu’un profil utilisateur possède la valeur 10, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut numérique n’est pas égal à un nombre	DOES NOT EQUAL	NUMBER	Si ce filtre spécifie 10 et qu’un profil utilisateur ne possède pas la valeur 10, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut numérique est supérieur à un nombre	MORE THAN	NUMBER	Si ce filtre spécifie 10 et qu’un profil utilisateur possède une valeur supérieure à 10, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut numérique est inférieur à un nombre	LESS THAN	NUMBER	Si ce filtre spécifie 10 et qu’un profil utilisateur possède une valeur inférieure à 10, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut numérique existe dans le profil d’un utilisateur et n’est pas null	IS NOT BLANK	N/A	Si un profil utilisateur contient l’attribut numérique spécifié, quelle que soit sa valeur, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut numérique n’existe pas dans le profil d’un utilisateur ou est null	IS BLANK	N/A	Si un profil utilisateur ne contient pas l’attribut numérique spécifié ou si la valeur de l’attribut est null, l’utilisateur correspondra à ce filtre.

Détails des attributs numériques

• Les filtres « Exactly 0 » et « Less Than » incluent les utilisateurs avec des champs NULL
  • Pour exclure les utilisateurs sans valeur pour les attributs personnalisés, vous devez inclure le filtre is not blank.

Les attributs de type chaîne de caractères peuvent contenir jusqu’à 255 caractères. Notez que si vous saisissez des valeurs avec des espaces entre, avant ou après les mots, Braze vérifiera également la présence de ces mêmes espaces.

Pour les attributs de type chaîne de caractères, les options de segmentation suivantes sont disponibles.

Options de segmentation	Filtre déroulant	Options de saisie	Exemples
Vérifier si l’attribut de type chaîne correspond partiellement à une chaîne saisie OU à une expression régulière	MATCHES REGEX	STRING OU REGULAR EXPRESSION Non sensible à la casse ; maximum de 32 764 caractères
Vérifier si l’attribut de type chaîne ne correspond pas partiellement à une chaîne saisie OU à une expression régulière	DOES NOT MATCH REGEX *	STRING OU REGULAR EXPRESSION Non sensible à la casse ; maximum de 32 764 caractères
Vérifier si l’attribut de type chaîne existe dans le profil d’un utilisateur et n’est pas une chaîne vide	IS NOT BLANK	N/A	Si ce filtre spécifie favorite_genre et qu’un profil utilisateur possède l’attribut favorite_genre, l’utilisateur correspondra à ce filtre quelle que soit la valeur de l’attribut. Par exemple, l’utilisateur peut avoir sci-fi, romance ou une autre valeur.
Vérifier si l’attribut de type chaîne n’existe pas dans le profil d’un utilisateur	BLANK	N/A	Si ce filtre spécifie favorite_genre et qu’un profil utilisateur ne possède pas l’attribut favorite_genre, l’utilisateur correspondra à ce filtre.
Vérifier si la chaîne correspond exactement à l’une des chaînes saisies	IS ANY OF	STRING Sensible à la casse ; plusieurs chaînes autorisées (256 maximum)	Si ce filtre spécifie book, bookmark et reading light, et qu’un profil utilisateur possède au moins l’une de ces chaînes, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut de type chaîne ne correspond exactement à aucune des chaînes saisies	IS NONE OF	STRING Sensible à la casse ; plusieurs chaînes autorisées (256 maximum)	Si ce filtre spécifie book, bookmark et reading light, et qu’un profil utilisateur ne contient aucune de ces chaînes, l’utilisateur correspondra au filtre.
Vérifier si l’attribut de type chaîne correspond partiellement à l’une des chaînes saisies	CONTAINS ANY OF	STRING Sensible à la casse ; plusieurs chaînes autorisées (256 maximum)	Si ce filtre spécifie gold et qu’un profil utilisateur contient gold dans n’importe quelle chaîne, comme gold_tier ou former_gold_tier, l’utilisateur correspondra au filtre.
Vérifier si l’attribut de type chaîne ne correspond partiellement à aucune des chaînes saisies	DOESN’T CONTAIN ANY OF	STRING Sensible à la casse ; plusieurs chaînes autorisées (256 maximum)	Si ce filtre spécifie gold et qu’un profil utilisateur ne contient pas gold dans aucune chaîne, l’utilisateur correspondra à ce filtre.

Remarque

Une chaîne de caractères de date telle que « 12-1-2021 » ou « 12/1/2021 » sera convertie en objet datetime et traitée comme un attribut time.

Important

Lors de la segmentation avec le filtre DOES NOT MATCH REGEX, l’utilisateur doit déjà avoir un attribut personnalisé avec une valeur attribuée dans son profil. Braze recommande d’utiliser la logique « OR » pour vérifier si un attribut personnalisé est vide afin de s’assurer que les utilisateurs sont correctement ciblés.

Tableaux

Les tableaux ont une taille maximale de 100 Ko. La longueur par défaut d’un attribut est de 500 éléments maximum (par exemple, si vous envoyez un attribut tel que « Films regardés » avec 500 éléments, lorsqu’un utilisateur regarde un 501e film, le premier film est supprimé et le plus récent est ajouté). Notez que si vous saisissez des valeurs avec des espaces entre, avant ou après les mots, Braze vérifiera également la présence de ces mêmes espaces.

Les attributs personnalisés de type tableau ne peuvent pas être importés via l’importation CSV. Pour charger des valeurs de tableau, utilisez l’endpoint /users/track ou l’ingestion de données cloud.

Remarque

L’option d’augmentation de la longueur maximale ne sera pas disponible si l’attribut est configuré pour détecter automatiquement le type de données ; le type de données doit être défini sur tableau.

Résolution des problèmes : l’attribut personnalisé de type tableau n’affiche aucune valeur dans le profil utilisateur

Si un attribut personnalisé de type tableau apparaît dans un profil utilisateur mais n’affiche aucune valeur, vérifiez si la longueur maximale de l’attribut est définie à 0 dans le tableau de bord.

1. Allez dans Data Settings > Custom Attributes.
2. Filtrez la liste par Array.
3. Trouvez l’attribut et vérifiez sa longueur maximale.
4. Si la longueur maximale est 0, mettez-la à jour avec une valeur supérieure à 0.

Définir la longueur maximale à 0 empêche l’affichage des valeurs dans le profil utilisateur.

Pour des exemples de comportement de tableau centrés sur le SDK, consultez l’aperçu de l’analyse.

Pour les attributs de type tableau, les options de segmentation suivantes sont disponibles.

Options de segmentation	Filtre déroulant	Options de saisie	Exemples
Vérifier si l’attribut de type tableau inclut une valeur qui correspond exactement à une valeur saisie	INCLUDES VALUE	STRING	Si ce filtre spécifie sci-fi et qu’un profil utilisateur possède la valeur sci-fi, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut de type tableau n’inclut pas une valeur qui correspond exactement à une valeur saisie	DOESN’T INCLUDE VALUE	STRING	Si ce filtre spécifie sci-fi et qu’un profil utilisateur ne possède pas la valeur sci-fi, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut de type tableau contient une valeur qui correspond partiellement à une valeur saisie OU à une expression régulière	MATCHES REGEX	STRING OU REGULAR EXPRESSION Maximum de 32 764 caractères
Vérifier si l’attribut de type tableau possède une valeur ou n’est pas vide	HAS A VALUE	N/A	Si ce filtre spécifie favorite_genres et qu’un profil utilisateur contient favorite_genres avec n’importe quelle valeur, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut de type tableau est vide ou n’existe pas	IS EMPTY	N/A	Si ce filtre spécifie favorite_genres et qu’un profil utilisateur ne contient pas favorite_genres ou contient favorite_genres sans aucune valeur, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut de type tableau inclut une valeur qui correspond exactement à l’une des valeurs saisies	INCLUDES ANY OF	STRING Sensible à la casse ; plusieurs valeurs autorisées (256 maximum)	Si ce filtre spécifie sci-fi, fantasy, romance et qu’un profil utilisateur possède n’importe quelle combinaison de sci-fi, fantasy ou romance, y compris une seule d’entre elles (comme uniquement sci-fi). Un utilisateur peut avoir horror ou une autre valeur dans sa chaîne à condition de posséder également l’une des valeurs sci-fi, fantasy ou romance.
Vérifier si l’attribut de type tableau n’inclut pas de valeur correspondant exactement à l’une des valeurs saisies	INCLUDES NONE OF	STRING Sensible à la casse ; plusieurs valeurs autorisées (256 maximum)	Si ce filtre spécifie sci-fi, fantasy, romance et qu’un profil utilisateur ne possède aucune combinaison de sci-fi, fantasy ou romance, l’utilisateur correspondra à ce filtre. L’utilisateur peut avoir horror ou une autre valeur à condition de ne posséder aucune des valeurs sci-fi, fantasy ou romance.
Vérifier si l’attribut de type tableau contient une valeur qui correspond partiellement à l’une des valeurs saisies	VALUES CONTAIN ANY OF	STRING Sensible à la casse ; plusieurs valeurs autorisées (256 maximum)	Si ce filtre spécifie gold et qu’un tableau du profil utilisateur contient gold dans au moins une chaîne, l’utilisateur correspondra à ce filtre. Cela inclut des valeurs de chaîne comme gold_tier, former_gold_tier et d’autres.
Vérifier si l’attribut de type tableau ne contient pas de valeur qui correspond partiellement à l’une des valeurs saisies	VALUES DON’T CONTAIN ANY OF	STRING Sensible à la casse ; plusieurs valeurs autorisées (256 maximum)	Si ce filtre spécifie gold et qu’un tableau du profil utilisateur ne contient gold dans aucune chaîne, l’utilisateur correspondra à ce filtre. Cela signifie que les utilisateurs ayant des valeurs de chaîne comme gold_tier et former_gold_tier ne correspondront pas à ce filtre.
Vérifier si l’attribut de type tableau inclut toutes les valeurs saisies	IS ALL OF	STRING Sensible à la casse ; plusieurs valeurs autorisées (256 maximum)	Si ce filtre spécifie sci-fi, fantasy, romance et qu’un profil utilisateur possède toutes ces valeurs, l’utilisateur correspondra à ce filtre. L’utilisateur peut aussi avoir horror ou d’autres valeurs et correspondre à ce filtre.
Vérifier si l’attribut de type tableau n’inclut pas toutes les valeurs saisies	ISN’T ALL OF	STRING Sensible à la casse ; plusieurs valeurs autorisées (256 maximum)	Si ce filtre spécifie sci-fi, fantasy, romance et qu’un profil utilisateur ne possède pas toutes ces valeurs, l’utilisateur correspondra à ce filtre.

Conseil

Pour en savoir plus sur l’utilisation des expressions régulières (regex), consultez ces ressources :

• Expressions régulières compatibles Perl (PCRE)
• Regex avec Braze
• Débogueur et testeur de regex
• Tutoriel regex

Les attributs temporels sont utiles pour stocker la dernière fois qu’une action spécifique a été effectuée, afin de pouvoir proposer des communications de réengagement spécifiques à vos utilisateurs.

Les filtres temporels utilisant des dates relatives (par exemple, il y a plus d’un jour, il y a moins de deux jours) mesurent 1 jour comme 24 heures. Toute Campaign que vous exécutez avec ces filtres inclura tous les utilisateurs par incréments de 24 heures. Par exemple, last used app more than 1 day ago capturera tous les utilisateurs qui « ont utilisé l’application pour la dernière fois il y a plus de 24 heures » à partir du moment exact où la Campaign s’exécute. Il en sera de même pour les Campaigns définies avec des plages de dates plus longues — ainsi, cinq jours à partir de l’activation signifieront les 120 heures précédentes.

Pour cibler les utilisateurs dont un attribut temporel se situe dans une plage de temps donnée, utilisez deux filtres d’audience : in more than pour la borne inférieure et in less than pour la borne supérieure. Un seul filtre ne peut pas exprimer les deux côtés de cette plage. Par exemple, pour cibler les utilisateurs dont un attribut temporel se situe dans les prochaines 24 heures (entre maintenant et un jour à partir de maintenant), appliquez in more than 0 days et in less than 1 day.

Avertissement

La dernière date à laquelle un événement personnalisé ou un événement d’achat a eu lieu est automatiquement enregistrée et ne doit pas être enregistrée à nouveau via un attribut personnalisé de type heure.

Pour les attributs de type heure, les options de segmentation suivantes sont disponibles.

Options de segmentation	Filtre déroulant	Options de saisie	Exemples
Vérifier si l’attribut temporel est avant une date sélectionnée	BEFORE	CALENDAR DATE sélecteur	Si ce filtre spécifie 2024-01-31 et qu’un profil utilisateur possède une date avant le 2024-1-31, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel est après une date sélectionnée	AFTER	CALENDAR DATE sélecteur	Si ce filtre spécifie 2024-01-31 et qu’un profil utilisateur possède une date après le 2024-1-31, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel remonte à plus de X jours	MORE THAN	NUMBER OF DAYS AGO	Si ce filtre spécifie 7 et qu’un profil utilisateur possède une date datant de plus de sept jours, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel remonte à moins de X jours	LESS THAN	NUMBER OF DAYS AGO	Si ce filtre spécifie 7 et qu’un profil utilisateur possède une date datant de moins de sept jours, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel est dans plus de X jours dans le futur	IN MORE THAN	NUMBER OF DAYS IN FUTURE	Si ce filtre spécifie 7 et qu’un profil utilisateur possède une date située à plus de sept jours dans le futur, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel est dans moins de X jours dans le futur	IN LESS THAN	NUMBER OF DAYS IN FUTURE	Si ce filtre spécifie 7 et qu’un profil utilisateur possède une date située à moins de sept jours dans le futur, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel existe dans le profil d’un utilisateur et n’est pas null	IS NOT BLANK	N/A	Si ce filtre spécifie un attribut temporel présent dans un profil utilisateur, l’utilisateur correspondra à ce filtre.
Vérifier si l’attribut temporel n’existe pas dans le profil d’un utilisateur ou est null	IS BLANK	N/A	Si ce filtre spécifie un attribut temporel absent du profil utilisateur, l’utilisateur correspondra à ce filtre.

Remarque

Lors de l’utilisation des opérateurs in less than ou in more than avec 90 jours ou plus, Braze convertit automatiquement la valeur en semaines lorsque vous enregistrez le Segment. Par exemple, 90 jours est converti en 13 semaines.

Détails des attributs temporels

• Jour d’événement récurrent
  • Lorsque vous utilisez le filtre « Jour d’événement récurrent » et que vous êtes invité à sélectionner le « Jour calendaire d’événement récurrent », si vous sélectionnez IS LESS THAN ou IS MORE THAN, la date actuelle sera prise en compte pour ce filtre de segmentation.
  • Par exemple, si le 10 mars 2020, vous avez sélectionné la date de l’attribut comme étant LESS THAN ... March 10, 2020, les attributs seront pris en compte pour les jours allant jusqu’au 10 mars 2020 inclus.
• Il y a moins de X jours : le filtre « Il y a moins de X jours » inclut les dates comprises entre il y a X jours et la date/heure actuelle.
• Dans moins de X jours : inclut les dates comprises entre la date/heure actuelle et X jours dans le futur.

Vous pouvez utiliser des attributs personnalisés imbriqués pour envoyer des objets en tant que type de données pour les attributs personnalisés. Pour plus d’informations, consultez Attributs personnalisés imbriqués.

Utilisez un tableau d’objets pour regrouper des attributs associés. Pour plus de détails, consultez Tableau d’objets.

Vous pouvez modifier le type de données de votre attribut personnalisé, mais vous devez être conscient des impacts. Consultez Modifier le type de données d’un attribut personnalisé ou d’un événement pour en savoir plus.

Opérateurs consolidés

Nous avons consolidé la liste des opérateurs disponibles pour les filtres d’attributs, les filtres d’attributs personnalisés et les filtres d’attributs personnalisés imbriqués. Si vous avez des filtres existants utilisant ces opérateurs, ils seront automatiquement mis à jour pour utiliser les nouveaux opérateurs.

Types de données des propriétés d’événement

Lorsque vous enregistrez un événement, vous pouvez y associer des informations supplémentaires (par exemple, le nom du produit ou le prix) sous forme de propriétés d’événement. Chaque propriété a un nom et une valeur. Les valeurs des propriétés d’événement prennent en charge les types de données du tableau Définitions (le type Heure est intitulé « Datetime » dans les propriétés d’événement).

Format attendu

Les valeurs des propriétés sont envoyées sous forme d’objet : les clés sont les noms des propriétés et les valeurs sont les valeurs des propriétés. Les noms de propriétés doivent être des chaînes non vides de 255 caractères maximum, sans signe dollar ($) en début.

Règles spécifiques aux propriétés d’événement :

• Heure (Datetime) : utilisez le format ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ. Non pris en charge dans les tableaux.
• Tableau : les dates ne sont pas prises en charge dans les tableaux.
• Objet imbriqué : voir Objets imbriqués.
• Payload : les objets de propriétés d’événement contenant des valeurs de tableau ou d’objet peuvent atteindre 102 400 octets (100 Ko).

Vous pouvez modifier le type de données de votre propriété d’événement personnalisé, mais soyez conscient des impacts de la modification des types de données après la collecte des données.

Pour le comportement complet des propriétés d’événement, les clés réservées et l’utilisation dans les déclencheurs et la personnalisation, consultez Propriétés d’événement personnalisé.

Événements d’achat et chiffre d’affaires

Les données d’achat et de chiffre d’affaires sont enregistrées via les événements d’achat ou les événements eCommerce recommandés.

Remarque

Les événements recommandés ont des schémas prédéfinis avec des types de données définis. Pour plus de détails, consultez Événements eCommerce recommandés.

L’enregistrement d’événements d’achat établit la valeur vie client (LTV) pour chaque profil utilisateur, et ces données sont consultables sur la page de chiffre d’affaires sous forme de séries temporelles. Vous pouvez segmenter selon le montant dépensé, la date du dernier achat, le nombre d’achats dans une fenêtre temporelle, et plus encore.

Types de données des propriétés d’événement d’achat

Les valeurs des propriétés d’événement d’achat (l’objet properties d’un achat) prennent en charge les types de données du tableau Définitions, avec la même structure et les mêmes règles de nommage que les propriétés d’événement.

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

Pour le schéma complet de l’objet d’achat et des exemples, consultez Objet d’achat. Pour l’enregistrement des événements d’achat, les filtres de segmentation et tous les détails, consultez Événements d’achat.

Modifier le type de données d’un attribut personnalisé ou d’un événement

Pour modifier le type de données d’un attribut personnalisé ou d’un événement :

1. Accédez à Data Settings et sélectionnez Custom Attributes ou Custom Events.
2. Trouvez votre attribut ou événement dans la liste, puis sélectionnez More actions.
3. Sélectionnez un nouveau Data type dans le menu déroulant.
4. Sélectionnez Save.

Si vous modifiez le type de données d’un attribut personnalisé ou d’un événement (par exemple, en changeant time en string), tenez compte des points suivants :

• Les filtres ne sont pas automatiquement mis à jour. Les Segments, Campaigns, Canvas ou autres emplacements utilisant l’attribut ou l’événement modifié ne sont pas mis à jour. Avant de modifier le type de données, arrêtez toutes les Campaigns ou Canvas qui utilisent l’attribut dans des Segments ou des filtres, et supprimez l’attribut des filtres qui le référencent.
• Les données utilisateur existantes ne sont pas mises à jour rétroactivement. Si l’attribut modifié était présent dans un profil utilisateur avant le changement, cette valeur conserve l’ancien type de données. Les utilisateurs peuvent sortir des Segments contenant l’attribut modifié car le filtre recherche le nouveau type de données. Mettez à jour ces profils utilisateur (par exemple, avec l’endpoint /users/track) pour qu’ils correspondent au nouveau type et réintègrent le Segment si nécessaire.
• Les nouvelles données doivent correspondre au nouveau type. Les appels API envoyant l’ancien type de données pour l’attribut modifié ne sont pas acceptés. Envoyez le nouveau type de données.

Important

La possibilité d’empêcher la détection automatique de mettre à jour le type de données d’un attribut personnalisé est actuellement en accès anticipé. Contactez votre gestionnaire de la satisfaction client si vous souhaitez participer.

Types de données des catalogues

Les catalogues prennent en charge les types répertoriés dans le tableau Définitions. Le tableau suivant détaille chaque type, comment il peut être créé ou mis à jour, ainsi que le format et des exemples.

Format et exemples

Pour la création et la mise à jour des catalogues, consultez Créer un catalogue.