Attributs

Pour ajouter un attribut, rendez-vous dans le module Structure des tables (Hub > Données > Structure des tables).

info

Dans Actito, vous pourrez à tout moment ajouter de nouveaux attributs à votre base de profils.

Pour des raisons de cohérence dans la communication, seuls les utilisateurs ayant la configuration de droits "Administrateur" ou "Utilisateur avancé" peuvent supprimer ou modifier des attributs par eux-mêmes dans l'interface.

Choisir la table à éditer

Sélectionnez la table de profils dont vous souhaitez modifier la structure. Ensuite, cliquez sur le bouton Éditer.

Ensuite, choisissez si vous voulez mettre à jour la table via l'interface ou via un fichier JSON. Ici, nous le ferons depuis l'interface.

Ajouter un attribut

Vous visualisez la structure de la table dans laquelle vous allez pouvoir ajouter un attribut. Pour cela, cliquez sur le bouton Ajouter.

Liste des attributs prédéfinis

Actito propose les attributs prédéfinis suivants. Il est vivement recommandé de les utiliser : leurs paramètres sont pré-remplis sur base des standards définis par Actito.

Attribut prédéfini	Type de champ	Description
birthdate	Date	Conserve une date de naissance. Actito calcule automatiquement l'âge du profil, ce qui permet de cibler des tranches telles que "toutes les personnes qui ont entre 25 et 55 ans" sans exprimer de dates. Sert aussi pour des rapports comme la pyramide des âges.
emailAddress	Adresse email	Le seul champ utilisable pour envoyer des emails avec Actito. Créé par défaut comme obligatoire et unique. Voir la règle d'acceptation ci-dessous.
emailAddressMD5, emailAddressSHA256	Hash (calculé par Actito)	Chiffrent la valeur de emailAddress avec les fonctions de hachage MD5 ou SHA256, par ex. pour communiquer des adresses à des outils externes sans exposer la valeur en clair. Calculés automatiquement à partir de emailAddress : ils nécessitent donc un attribut emailAddress et en partagent les propriétés (unicité, caractère obligatoire). Leur valeur ne peut pas être renseignée manuellement.
firstName, lastName	Texte (max. 64 caractères)	Simples champs textes courts. lastName est obligatoire par défaut.
gsmNumber	Numéro de mobile	Le seul champ utilisable pour envoyer des SMS avec Actito. Seuls les numéros au format international peuvent être contactés (par ex. France : +33 6 XX XX XX XX ; Belgique : +32 4XX XX XX XX). Voir la règle d'acceptation ci-dessous.
motherLanguage	Langue (code ISO 639-1 à deux lettres)	Utilisé pour envoyer les campagnes aux profils dans la bonne langue. Si vous n'utilisez pas cet attribut, décochez la case "langue" présélectionnée à l'étape du ciblage d'une campagne email.
nbreChildren	Nombre entier (zéro ou plus)	Conserve le nombre d'enfants d'un profil.
addressCountry	Pays (code ISO 3166-1 à deux lettres)	Fait partie du bloc adresse postale. Stocke le pays.
addressLocality, addressPostalCode, addressStreet, addressNumber, addressBox	Texte (max. 50 caractères)	Stockent le reste de l'adresse postale (ville, code postal, rue, numéro, boîte). Champs texte et non entiers, afin de conserver des valeurs comme le numéro de maison "41bis".
profession	Grand texte (max. 50 caractères)	Aucune valeur par défaut n'est proposée par Actito.
sex	Texte (M ou F)	Ne peut contenir que M ou F (Masculin ou Féminin). Actito ne propose pas d'attribut civilité (monsieur, madame, mademoiselle). Dans les personnalisations, le "gender test" se base sur ce champ pour la personnalisation "Monsieur"/"Madame".
telephoneNumber	Numéro de téléphone	Un champ de type numéro de téléphone.
marketingConsent	Booléen	Obligatoire par défaut. Stocke le consentement d'un profil à être contacté par des campagnes marketing, dans le cadre du RGPD (voir /docs/Managing_the_Explicit_Consent).
trackingConsent	Booléen	Stocke le consentement d'un profil pour que son comportement soit suivi lors d'une campagne, par ex. ouvertures, clics, type d'appareil, ou déclenchement de goals (voir /docs/Managing_the_Tracking_Consent).
whatsappBSUID	ID utilisateur WhatsApp	Identifiant WhatsApp stable permettant de continuer à adresser un contact lorsque son numéro de téléphone n'est pas disponible. Unique par défaut et non modifiable une fois défini. Lors de l'envoi, Actito l'utilise en priorité et se rabat sur gsmNumber. Voir la note ci-dessous.

Règle d'acceptation pour le champ emailAddress

• L'adresse doit respecter la syntaxe suivante : xxx@yyy.zzz
  • la valeur xxx (le nom d'utilisateur avant le @) ne peut pas contenir de caractères accentués (par ex. é, è, à, ç, ù, ï...)
  • la valeur zzz doit faire partie de la liste internationale des extensions autorisées
• À noter :
  • le nom d'utilisateur peut contenir "a > z", "A > Z", "0 > 9", "-", "_", "." et les caractères spéciaux "!#$%&'*+-/=?^_`{|}~"
  • l'utilisation d'un "@" est obligatoire
  • au moins un caractère est obligatoire avant le "@"
  • le nom de domaine et le suffixe doivent suivre le "@"
  • le nom de domaine ne peut pas commencer ni se terminer par "-"
  • le suffixe doit contenir au moins deux caractères
  • plusieurs points (".") ne peuvent pas se suivre (par ex. "...")
• Les sous-domaines sont autorisés (par ex. subdomain.mydomain.com) et les accents sont autorisés dans les noms de domaine.

Avant chaque envoi, Actito vérifie que l'adresse est contactable (sinon elle est filtrée).

Exemple de hash pour l'adresse "support@actito.com" :

• emailAddressMD5 : b87e913e711d2211acffdc7a5b1703f0
• emailAddressSHA256 : 7e413502940e598d242f58f2c71ac09660c093ecbfc03c3f2b8fe68c3a2316ef

Règle d'acceptation pour le champ gsmNumber

Le champ ne peut contenir que les caractères suivants : +().- /0123456789 (l'espace vide est inclus).

À propos de l'attribut whatsappBSUID

WhatsApp déploie une fonctionnalité optionnelle de noms d'utilisateur. Dès qu'un contact adopte un nom d'utilisateur, son numéro de téléphone n'apparaît plus systématiquement dans les webhooks. Le Business-scoped User ID (BSUID) est un identifiant WhatsApp qui permet de continuer à contacter ces profils.

• Cet attribut est unique par défaut et ne peut pas être modifié manuellement une fois défini.
• Actito maintient la valeur à jour : si le BSUID change côté WhatsApp, il est automatiquement mis à jour dans Actito.
• La valeur doit respecter le format attendu. Si le format est incorrect, le profil ne peut pas être enregistré.
• L'attribut peut également être renseigné par API, à la création comme à la mise à jour d'un profil.

Étape 1 : Paramètres

Pour ajouter un attribut, à cette étape vous aurez le choix entre :

• Sélectionner parmi les attributs prédéfinis proposés par Actito. Les paramètres seront alors pré-remplis sur base des standards définis par Actito. Il est vivement recommandé de toujours opter pour les attributs prédéfinis.

  remarque

  Si besoin, il est possible de modifier certains paramètres de ces attributs prédéfinis (par exemple le nom ou le caractère obligatoire du champ). Par contre, le nom technique ne doit jamais être modifié.

• Déterminer par vous-même l'attribut et ses paramètres. Il est recommandé de définir tous les paramètres de vos attributs.

Les paramètres à remplir sont les suivants :

• "Nom technique" : identification technique de chaque attribut. Il ne sera plus modifiable par la suite, et il est impératif de ne pas le modifier pour les attributs prédéfinis. Il sera utilisé pour toute "communication" avec des outils externes à Actito (exports, synchronisations, imports, personnalisation externe...). Nombre maximum de caractères : 50
• "Nom" : identification fonctionnelle de chaque attribut. Il peut être modifié par la suite.
• "Obligatoire" : permet de définir le caractère optionnel ou obligatoire de l'attribut
  • "obligatoire" : est-ce que chaque profil dans ma base Actito doit avoir cette information ?
  • "optionnel" : est-ce une information qui ne sera pas collectée pour l'ensemble des profils de ma base dans Actito ?
• "Multi-valeur" : permet de déterminer le nombre de valeurs collectées pour cet attribut
  • "valeur simple" : une seule valeur sera autorisée
  • "multi-valeurs" : plusieurs valeurs pourront être conservées pour cet attribut (par ex. l'attribut loisirs peut contenir : football, théâtre, cuisine…)
• "Unicité" : permet de vérifier le caractère unique de l'attribut
  • "non unique" : la valeur pourra se retrouver plusieurs fois dans la base de données, liée à plusieurs profils différents
  • "unique" : la valeur de l'attribut sera unique dans toute la base de données (par ex. numéro client)
  • "unique par profil" : uniquement pour les attributs "multi-valeurs", la valeur ne pourra alors se retrouver qu'une seule fois pour le profil concerné. Pour activer l'affichage de la case "unique par profil", il est nécessaire de passer à l'étape 2 pour définir les valeurs possibles, puis de revenir à l'étape 1 via la piste de navigation en haut de l'écran.
• "Commentaire" : permet d'apporter des informations complémentaires sur l'attribut créé.

Étape 2 : Type de valeur

• "Type de valeur" : vous pouvez choisir parmi plusieurs types d'informations à stocker dans Actito (texte, date, chiffre…). Bien typer une donnée vous permettra d'avoir des données pertinentes (par ex. une adresse email contient bien un "@") et facilitera vos ciblages (par ex. les critères de ciblage sur une date seront différents des critères sur un chiffre ou sur un texte).
• "Restrictions" : vous pouvez définir des restrictions au niveau des valeurs possibles. Le type de restriction varie en fonction du type de valeur sélectionné (par ex. pour une valeur "Langue", il est possible de limiter aux Français, Anglais et Néerlandais, car vous ne comptez pas communiquer dans d'autres langues et ne voulez donc pas que vos profils aient d'autres valeurs pour cet attribut).
• "Valeur par défaut" : vous pouvez définir une valeur par défaut pour l'attribut. Ceci permet de garantir la présence d'une information pour chaque profil. Ceci est particulièrement important si votre attribut est obligatoire : dans ce cas, si la donnée n'est pas présente lors d'une création de profil, ce sera la valeur par défaut qui lui sera attribuée.

Étape 3 : Profils existants

Cette étape permet d'indiquer ce qui doit être fait pour les profils existant déjà dans votre base.

Selon le caractère obligatoire ou optionnel de l'attribut que vous ajoutez, vous aurez les options suivantes :

• "Valeur à attribuer" :
  • "la valeur par défaut" : si une valeur par défaut a été définie (à l'étape précédente), celle-ci sera mentionnée. Vous pourrez opter de mettre à jour tous les profils avec cette valeur.
  • "aucune valeur" : si l'attribut n'est pas obligatoire, vous pouvez choisir de laisser la valeur vide au moment de la création de l'attribut. Vous pourrez le compléter plus tard, via l'import de profils.
  • "une valeur spécifique" : vous pouvez choisir de mettre à jour tous les profils avec une valeur spécifique que vous déterminerez directement.

Étape 4 : Confirmer

Avant de créer effectivement ce nouvel attribut dans Actito, cette dernière étape demande de confirmer votre volonté de le créer. La création ne sera lancée qu'après avoir cliqué sur le bouton Ajouter.

Après l'ajout de l'attribut, un message confirmera le succès de l'opération.