Transmettre des attributs utilisateurs à Intercom

Intercom vous permet de créer et suivre des attributs utilisateurs personnalisés se basant sur des critères propres à votre activité.

Vous pouvez utiliser ces données pour filtrer les clients et créer différents segments, mais également envoyer des campagnes et des messages ciblés. Enfin, ces attributs peuvent aussi servir de critères de qualification pour les leads et les utilisateurs réalisant un essai gratuit.

Qu'est-ce qu'un attribut ?

Un attribut suit des données factuelles sur vos clients (telles que le forfait utilisé et la date d'inscription), tandis qu'un événement enregistre les actions récurrentes de vos clients.

Voici un exemple : si vous proposez un outil de gestion de projets, vous pouvez suivre le nombre de fichiers que possède chaque client sur votre plateforme. Ainsi, pour contacter les utilisateurs qui n'ont pas encore ajouté de fichiers ou qui auraient besoin d'aide pour apprendre les bases, il vous suffit de configurer un message ciblé envoyé aux utilisateurs répondant à l'attribut « moins de 1 fichier ».

Sur Intercom, les attributs le plus couramment utilisés concernent des données en lien avec l'utilisation du client, telles que :

Prix de l'abonnement
Valeur des achats
Nombre de coéquipiers ajoutés
Nombre de chansons jouées
Date de fin de l'abonnement

Remarque : vous pouvez uniquement utiliser 250 attributs personnalisés (y compris les attributs archivés) par espace de travail.

Comment créer des attributs personnalisés ?

Il vous suffit d'ajouter à tout moment des paires clé/valeur à votre snippet intercomSettings. L'élément « clé » correspond au nom de l'attribut, tandis que l'élément « valeur » sera remplacé par les données que vous souhaitez suivre.

Une fois que vous aurez ajouté vos paires, Intercom exécutera régulièrement une commande ping pour voir si leur valeur a changé.

Vérifiez bien que vos clés disposent d'une valeur conforme au format JSON, autrement dit se présentant sous forme de texte, de chiffres ou de données booléennes (true ou false). Ainsi, vous devrez utiliser des guillemets droits autour de vos segments de texte et envoyer l'état « NULL » lorsque la valeur n'existe pas pour l'utilisateur.

Il est également possible de nous envoyer des dates ou des URL. Vous pouvez suivre les URL sous forme de segment de texte (par exemple : « http://www.google.com »). Intercom reconnaîtra cette valeur et la transformera automatiquement en hyperlien. Vous pouvez suivre les dates en nous envoyant une heure Unix exprimée en secondes. Si vous créez un nom de clé se terminant par « _at », nous le traiterons automatiquement comme une date et non comme un nombre (exactement comme "last_order_at" dans l'exemple ci-dessous).

Voici quelques exemples de paires clé/valeur utilisées par des attributs :

window.intercomSettings = {
 email: "bob@exemple.com",
 user_id: "123",
 app_id: "abc1234",
 created_at: 1234567890,
 "subdomain": "intercom", // Mettre des guillemets droits autour du texte
 "teammates": 4, // Envoyer les chiffres sans guillemets droits
 "active_accounts": 12,
 "last_order_at" : 1350466020, // Envoyer les dates au format heure unix et terminer le nom de clé par "_at"
 "custom_domain": null // Envoyer l'état null lorsque la valeur n'existe pas pour un utilisateur
}

À ne pas oublier :

Les noms de clés sont sensibles à la casse et ne peuvent pas contenir de point (« . »), de symbole dollar (« $ »), de caractères comme ~`!@#%^&*'{}|\'" ou la valeur NULL.
Les données de valeurs doivent être envoyées sous forme de segment de texte, chiffres ou données booléennes (true ou false) conformes au format JSON. Nous ne pouvons pas accepter les données sous forme d'objet, de hachage imbriqué ou de tableau.
Les valeurs sous forme de segment de texte ne peuvent pas dépasser 255 caractères.
Vous pouvez effacer les valeurs existantes en envoyant des segments vides.
Intercom suit automatiquement un certain nombre d'attributs standard. Consultez-les avant de créer vos propres attributs.

Une fois que vous aurez modifié votre snippet et activé le suivi des données, vous devrez :

Activer la vérification d'identité pour vos utilisateurs
Ajouter une description à chaque attribut afin d'indiquer leur finalité à vos coéquipiers

À quoi correspondent les données de qualification personnalisées ?

Les données de qualification correspondent à un ensemble particulier d'attributs que vous pouvez manuellement mettre à jour dans le profil de vos clients lorsque vous les qualifiez. Vous pouvez les configurer dans Intercom à l'aide d'un simple formulaire. Aucune autre action ne sera requise si vous souhaitez mettre à jour ces données manuellement.

À l'inverse, si vous souhaitez suivre ces données à l'aide d'une commande ping, vous devrez ajouter les paires clé/valeur à votre snippet intercomSettings, comme vous le feriez pour tout autre attribut personnalisé.

Comment créer des données de qualification personnalisées :

Ouvrez le menu de votre profil, qui se trouve dans le coin inférieur gauche de votre espace de travail Intercom, et sélectionnez « Settings ».
Sélectionnez « Intercom data » dans le menu situé à gauche, puis sélectionnez « Qualification settings ».

Cliquez sur « Add data », que vous trouverez en bas de la page.

Sélectionnez ensuite « Create new data » dans le menu déroulant. Vous pourrez alors spécifier un nom (qui correspond à votre clé) et choisir un format pour les valeurs qui seront recueillies (texte, chiffres, liste ou données true ou false). Si vous optez pour le format List, qui crée automatiquement une liste définie d'options parmi lesquelles choisir, vous pourrez également définir les valeurs de cette dernière. Enfin, vous pouvez ajouter une description à vos données pour aider vos collègues à comprendre leur finalité.

Remarque : donnez des noms simples à vos données personnalisées de qualification. En effet, si vous souhaitez qu'Operator qualifie ces données pour vous, les clients pourront voir leur nom dans Messenger.

Comment archiver les attributs ?

Vous pouvez archiver vos attributs à tout moment : ceux-ci n'apparaîtront plus dans les filtres de vos listes d'utilisateurs et de leads. Ainsi, cela permet de retirer les données dont vous n'avez pas besoin. Voici comment procéder :

Ouvrez le menu de votre profil, qui se trouve dans le coin inférieur gauche de votre espace de travail Intercom, et sélectionnez « Settings ».
Sélectionnez « Intercom data » dans le menu situé à gauche, puis « People data ».
Choisissez l'attribut que vous souhaitez archiver, puis cliquez sur « Archive » dans la fenêtre contextuelle. Vous pourrez toujours récupérer ces données si vous changez d'avis. À l'heure actuelle, vous ne pouvez pas supprimer définitivement un attribut personnalisé.

Vous rencontrez des problèmes ?

Si vous rencontrez des problèmes pour ajouter des attributs personnalisés à Intercom, contactez-nous via notre Messenger (en bas de cette page) ou envoyez-nous un e-mail à l'adresse team@intercom.com. Nous vous aiderons à configurer vos attributs en un rien de temps.