Attribut
Les attributs sont des données descriptives détaillées sur le comportement des utilisateurs, classées en trois types : attributs d'événement, attributs d'utilisateur et attributs d'appareil. En définissant plus précisément les événements, les utilisateurs et les appareils à l'aide d'attributs, ceux-ci peuvent être utilisés comme conditions de filtrage dans les parcours utilisateurs.
Types d'attributs
Les attributs sont classés en trois catégories : attributs d'événement, attributs d'utilisateur et attributs d'appareil. Chaque catégorie est subdivisée en attributs standards, recommandés et personnalisés.
| Catégorie | Type d'attribut | Description |
|---|---|---|
| Attributs d'événement | Standard | Attributs d'événement prédéfinis, collectés et rapportés automatiquement par le SDK ou générés via des calculs backend |
| Recommandé | Attributs d'événement prédéfinis rapportés par les développeurs via des appels API | |
| Personnalisé | Attributs d'événement créés et rapportés par les développeurs selon les besoins métier | |
| Attributs d'appareil | Standard | Informations d'appareil prédéfinies, collectées et rapportées automatiquement par le SDK ou générées via des calculs backend |
| Attributs d'utilisateur | Standard | Informations utilisateur prédéfinies, collectées et rapportées automatiquement par le SDK ou générées via des calculs backend |
| Recommandé | Attributs d'utilisateur prédéfinis rapportés par les développeurs via des appels API | |
| Personnalisé | Attributs utilisateur créés et rapportés librement par les développeurs selon les besoins métier |
Types de données des attributs
| Type de donnée | Description |
|---|---|
| STRING | Type chaîne de caractères, par exemple "Nom d'utilisateur", généralement défini comme type STRING |
| NUMBER | Type numérique, prend en charge les entiers et les décimaux, par exemple "Nombre d'achats", généralement défini comme type NUMBER |
| BOOL | Type booléen, prend en charge true/false, par exemple "Est membre VIP", généralement défini comme type BOOL |
| DATETIME | Type date et heure, prend en charge les données rapportées au format ISO8601. Par exemple, "Date d'inscription du compte" est généralement défini comme type DATETIME |
| LIST | Type liste, qui est un tableau d'éléments de type chaîne (ex. : ["Tesla", "Volkswagen", "Audi"]), par exemple "Tags d'intérêt", généralement défini comme type LIST |
Attributs personnalisés
En plus des attributs standards et recommandés prédéfinis, les développeurs peuvent créer des attributs d'événement et d'utilisateur personnalisés selon les besoins métier. Les attributs personnalisés peuvent être créés de deux manières : création via la page ou via l'API.
Création via la page
Les attributs peuvent être pré-créés sur la page, individuellement ou en masse via l'importation Excel. Les informations requises sont les suivantes :
| Information | Obligatoire | Description |
|---|---|---|
| Nom de l'attribut | Obligatoire | Le nom de l'attribut rapporté, prend en charge les lettres minuscules, les chiffres et les underscores, et doit commencer par une lettre, ex. : open_app. Une fois défini, il ne peut pas être modifié. |
| Description de l'attribut | Obligatoire | Ajoutez une note pour faciliter la compréhension de votre attribut, jusqu'à 50 caractères. Modifiable après création. |
| Type de donnée | Obligatoire | Le type de donnée détermine la façon dont le système MA traite les données de l'attribut. Si les données rapportées ne correspondent pas au type, elles seront converties de force. En cas d'échec de conversion, les données seront rejetées. Types pris en charge : STRING, NUMBER, BOOL, DATETIME et LIST. |
Création via l'API
Les attributs peuvent être librement rapportés via des appels API. Si l'attribut n'existe pas, il sera automatiquement créé :
- Si l'attribut d'événement n'existe pas, il sera automatiquement créé et associé à l'événement.
- Si l'attribut utilisateur n'existe pas, il sera automatiquement créé.
Interfaces API de rapport d'événement : API Android, API iOS, API Web, API Rest
Interfaces API de rapport d'attribut utilisateur : API Android, API iOS, API Web, API Rest
Statut de l'attribut
Une fois les attributs d'événement ou d'utilisateur personnalisés créés, leur statut initial est défini sur "Visible". Vous pouvez modifier leur statut selon les besoins métier.
| Statut | Description |
|---|---|
| Visible | Affiché dans le filtre d'attributs et peut recevoir des rapports d'attributs |
| Caché | Non affiché dans le filtre d'attributs mais peut recevoir des rapports d'attributs |
| Désactivé | Non affiché dans le filtre d'attributs et ne peut pas recevoir de rapports d'attributs |
Attributs standards
EngageLab a prédéfini les noms et descriptions des "attributs d'événement, attributs d'utilisateur et attributs d'appareil". Les données sont collectées et rapportées automatiquement par le SDK ou générées via des calculs backend.
Les attributs standards ne peuvent pas être modifiés ni supprimés. La liste des attributs standards peut être consultée sur la page ou téléchargée au format Excel pour référence.
Attributs recommandés
EngageLab a prédéfini des "attributs d'événement et d'utilisateur", et les données sont rapportées par les développeurs via des appels API.
Nous recommandons de rapporter autant que possible les attributs recommandés afin de faciliter les analyses ultérieures.
Les attributs recommandés ne peuvent pas être modifiés ni supprimés. La liste des attributs recommandés peut être consultée sur la page ou téléchargée au format Excel pour référence.
