HubSpot et Guest WiFi : Enrichissement et segmentation des leads

Résumé analytique

Pour les grands sites — des vastes chaînes de magasins aux stades à grande capacité — le réseau WiFi invité est l'une des couches d'acquisition de données les plus sous-utilisées de la pile technologique. Chaque session authentifiée représente un signal d'identité vérifié : un nom, une adresse e-mail et un consentement marketing explicite. Pourtant, la majorité des organisations laissent ces données cloisonnées au sein de leur plateforme de gestion WiFi, totalement déconnectées du CRM. L'intégration Purple HubSpot comble ce fossé en établissant un pipeline de données en temps réel et axé sur les événements entre le Captive Portal et HubSpot.

Ce guide couvre l'ensemble de l'architecture de déploiement : comment mapper les champs du portail Guest WiFi vers les propriétés standard et personnalisées de HubSpot, comment configurer la logique de déduplication, comment créer des workflows de phase de cycle de vie déclenchés par des événements de session WiFi, et comment segmenter les contacts en listes exploitables. Il est rédigé pour les administrateurs HubSpot, les responsables des opérations marketing et les architectes informatiques qui doivent mettre en œuvre cette intégration dans un environnement de production, et non l'évaluer en théorie.

Analyse technique approfondie

Architecture et flux de données

L'intégration repose sur une architecture pilotée par webhooks. Lorsqu'un utilisateur s'authentifie via le Captive Portal de Purple, la plateforme agit en tant que fournisseur d'identité, validant la session et générant une charge utile (payload) JSON structurée contenant les données démographiques et de session de l'utilisateur. Cette charge utile est transmise via un appel API REST HTTPS sécurisé vers le point de terminaison de l'API Contacts de HubSpot.

Le flux de données suit quatre étapes distinctes : l'authentification au niveau de la couche portail, la génération de la charge utile par la plateforme Purple, la transmission API vers HubSpot, et la création ou mise à jour de la fiche dans le CRM. Pour les déploiements multi-sites — courants dans les environnements de la Vente au détail et de l' Hôtellerie —, l'identifiant du site est intégré dans la charge utile au moment de sa génération, garantissant que chaque fiche de contact porte le contexte de localisation requis pour la segmentation régionale.

La couche WiFi Analytics au sein de Purple génère les métriques comportementales — nombre de sessions, temps de séjour, fréquence des visites — qui sont transmises aux côtés des données démographiques. Ces métriques constituent le facteur de différenciation entre une simple capture d'e-mail et un contact CRM véritablement enrichi.

Mécanique de mappage des propriétés

Un mappage précis des propriétés est le fondement d'une intégration fiable. Les propriétés de contact natives de HubSpot gèrent les champs démographiques standard, mais les données comportementales spécifiques au WiFi nécessitent la création de propriétés personnalisées avant l'activation de l'intégration.

Le tableau suivant définit la configuration de mappage de propriétés recommandée :

Les quatre propriétés personnalisées — wifi_last_visit, wifi_venue, wifi_session_count et wifi_dwell_time — doivent être créées dans HubSpot avant l'activation de l'intégration. Si vous ne créez pas ces propriétés au préalable, les données de la charge utile seront silencieusement rejetées par l'API HubSpot.

Déduplication et résolution d'identité

HubSpot utilise l'adresse e-mail comme principal identifiant unique pour les fiches de contacts. Lorsque la charge utile de Purple est reçue, HubSpot effectue une recherche parmi les fiches existantes. Si un contact avec l'adresse e-mail correspondante existe, HubSpot met à jour la fiche avec les nouvelles données de session — en incrémentant wifi_session_count et en mettant à jour wifi_last_visit. Si aucune correspondance n'est trouvée, une nouvelle fiche de contact est créée.

Ce comportement est déterministe et fiable, à condition que l'adresse e-mail soit cohérente d'une visite à l'autre. Le principal risque réside dans les données incorrectes à la source. Si le Captive Portal autorise des adresses e-mail mal formées ou fausses, des fiches orphelines sont créées dans HubSpot, qui ne pourront pas être associées lors des visites ultérieures et ne pourront pas recevoir d'e-mails. L'atténuation consiste à appliquer une validation stricte du format d'e-mail selon la norme RFC 5322 sur le formulaire du portail, en rendant le champ e-mail obligatoire avec une validation côté serveur. Il s'agit d'une option configurable dans les paramètres du portail Purple et elle doit être traitée comme une exigence de base non négociable.

Pour les organisations opérant dans les secteurs de la Santé ou du secteur public où la conformité au GDPR est soumise à audit, il convient également de noter que le mécanisme de déduplication permet à une seule fiche de contact de consolider tout l'historique des visites. Cela simplifie les réponses aux demandes d'accès aux données (SAR) et les demandes de suppression de données en vertu de l'article 17 du GDPR.

Guide de mise en œuvre

Étape 1 : Pré-configurer les propriétés personnalisées HubSpot

Accédez à dans Paramètres HubSpot > Propriétés > Propriétés du contact. Créez les quatre propriétés personnalisées répertoriées dans le tableau de correspondance ci-dessus. Assurez-vous que les types de données sont correctement définis — wifi_last_visit doit être un sélecteur de date, wifi_session_count et wifi_dwell_time doivent être de type Nombre. Des types de données incorrects amèneront l'API à rejeter les valeurs du payload.

Étape 2 : Auditer et aligner les champs du Captive Portal

Examinez la configuration actuelle du captive portal de Purple. Assurez-vous que le champ E-mail est configuré comme obligatoire avec la validation du format activée. Pour les déploiements multi-sites, confirmez que l'identifiant du site est configuré pour être transmis de manière dynamique en fonction de l'emplacement du point d'accès. Les sites dans les environnements de Transport — tels que les aéroports ou les gares ferroviaires — peuvent comporter plusieurs zones au sein d'un même site, chacune nécessitant un identifiant de site distinct.

Étape 3 : Configurer le mappage des propriétés dans Purple

Dans les paramètres d'intégration HubSpot de la plateforme Purple, mappez chaque champ du portail à la propriété interne HubSpot correspondante. Utilisez les noms exacts des propriétés internes (par exemple, wifi_session_count, et non WiFi Session Count) pour garantir que le payload de l'API est correctement structuré.

Étape 4 : Établir l'automatisation des phases du cycle de vie

Ne définissez pas par défaut toutes les nouvelles connexions WiFi sur la phase du cycle de vie « Lead ». Implémentez un modèle multiniveau basé sur les événements à l'aide des workflows HubSpot.

La progression recommandée du cycle de vie est la suivante. Lors de la première connexion WiFi, définissez la phase du cycle de vie sur Subscriber — la phase HubSpot correcte pour un contact qui a fourni ses coordonnées mais n'a pas encore manifesté d'intention comportementale. Lorsque wifi_session_count atteint 2 ou plus dans une fenêtre glissante de 30 jours, déclenchez un workflow pour faire passer le contact à Marketing Qualified Lead (MQL). Lorsque wifi_dwell_time dépasse 45 minutes sur plusieurs sessions, passez à Sales Qualified Lead (SQL). Lorsqu'un tag de programme de fidélité est appliqué, passez à Customer.

Dans HubSpot, créez chaque transition sous forme de workflow distinct avec le déclencheur défini sur « La valeur de la propriété du contact a changé ». Cela garantit que la transition se déclenche immédiatement lorsque le seuil est franchi, plutôt que d'attendre un traitement par lot planifié.

Étape 5 : Mapper la base juridique du traitement

Cette étape est non négociable pour la conformité au GDPR. La case de consentement marketing sur le captive portal doit être mappée à la propriété hs_legal_basis de HubSpot. Lorsqu'un utilisateur donne son accord, la valeur doit être définie sur Freely given consent from the contact. Sans ce mappage, les contrôles de conformité intégrés de HubSpot bloqueront les envois d'e-mails sortants vers ces contacts, rendant l'intégration commercialement inutile pour l'automatisation du marketing.

Étape 6 : Créer des listes de segmentation

Une fois les données de propriété transmises correctement, créez des listes actives HubSpot pour les principaux cas d'utilisation de segmentation. Les exemples incluent : tous les contacts où wifi_venue = un emplacement spécifique (pour les campagnes géo-ciblées), tous les contacts où wifi_session_count >= 5 (pour les campagnes de programme de fidélité), et tous les contacts où wifi_last_visit remonte à moins de 30 jours (pour un réengagement basé sur la récence).

Bonnes pratiques

Imposer la validation des e-mails à la source. Chaque problème de qualité des données dans HubSpot provenant de l'intégration WiFi peut être attribué à une adresse e-mail mal validée. Traisez le formulaire du portail comme la première ligne de défense pour la qualité des données CRM.

Segmentez par site dès le premier jour. Pour tout déploiement couvrant plusieurs sites — qu'il s'agisse d'un réseau de points de vente, d'un groupement hospitalier ou d'un complexe de stades — la propriété wifi_venue est la dimension de segmentation la plus importante. Configurez-la correctement dès le départ. Adapter la segmentation par site après la création de milliers de contacts sans cette propriété représente un effort de correction considérable.

Respectez l'architecture de consentement. Le principe de limitation des finalités du GDPR signifie que les données collectées via un portail WiFi à des fins d'accès au réseau ne peuvent pas être automatiquement réutilisées pour le marketing direct sans consentement explicite. Le mappage hs_legal_basis n'est pas une formalité technique — c'est le mécanisme juridique qui autorise l'utilisation marketing.

Surveillez le débit de l'API. Pour les environnements à haute densité tels que les stades ou les centres de conférence, le volume d'authentification simultanée pendant les périodes de pointe peut solliciter l'API HubSpot. Purple met les payloads en file d'attente et réessaie les requêtes ayant échoué, mais il est conseillé de surveiller les volumes d'appels API dans le tableau de bord développeur de HubSpot lors d'événements majeurs et de s'assurer que le niveau du compte HubSpot prend en charge le débit requis.

Utilisez des mises à jour incrémentielles, pas des écrasements complets. Lorsqu'un visiteur récurrent se connecte, le payload doit uniquement mettre à jour les propriétés modifiées (wifi_last_visit, wifi_session_count) plutôt que d'écraser tous les champs. Cela évite la perte accidentelle de données si, par exemple, un contact a mis à jour son nom directement dans HubSpot.

Résolution des problèmes et atténuation des risques

Problème : Les contacts sont créés mais ne peuvent pas recevoir d'e-mails marketing. Cause racine : La propriété hs_legal_basis n'a pas été mappée ou a été mappée avec une chaîne de valeur incorrecte. Résolution : Vérifiez la valeur exacte de la chaîne transmise. HubSpot requiert Freely given consent from the contact — toute variation entraînera l'échec silencieux du contrôle de conformité.

Problème : Des fiches de contact en double apparaissent dans HubSpot. Cause racine : Plusieurs adresses e-mail sont soumises par le même utilisateur (par exemple, personnelle et professionnelle), ou le champ e-mail n'est pas obligatoire sur le portail. Résolution : Activez la validation obligatoire des e-mails sur le portail. Envisagez de mettre en œuvre un workflow de fusion dans HubSpot pour consolider les fiches où le même nom apparaît avec des adresses e-mail différentes.

Problème : Les propriétés personnalisées ne sont pas renseignées bien que l'intégration soit active. Cause racine : Les propriétés personnalisées n'ont pas été créées dans HubSpot avant l'activation de l'intégration, ou les noms de propriétés internes dans la configuration de mappage Purple ne correspondent pas exactement aux noms de propriétés internes de HubSpot. Résolution : Comparez les noms de propriétés internes dans Paramètres HubSpot > Propriétés avec la configuration de mappage dans Purple. Les noms internes sont sensibles à la casse et utilisent des tirets du bas (underscores), pas des espaces.

Problème : L'étape du cycle de vie ne progresse pas bien que le seuil du nombre de sessions soit atteint. Cause racine : Le déclencheur du workflow HubSpot est configuré sur « Le contact est inscrit » plutôt que sur « La valeur de la propriété du contact change ». Résolution : Reconstruisez le workflow avec le bon type de déclencheur. « La valeur de la propriété du contact change » se déclenche à chaque mise à jour de la propriété, ce qui est le mécanisme correct pour une progression basée sur un seuil.

Risque : Non-conformité au GDPR en raison de la conservation des données. Atténuation : Implémentez un workflow HubSpot qui marque les contacts comme inactifs après 24 mois sans activité WiFi (c'est-à-dire que wifi_last_visit remonte à plus de 24 mois). Déclenchez un e-mail de re-consentement. Si aucune réponse n'est reçue dans les 30 jours, excluez le contact de toutes les communications marketing. Cela s'aligne sur le principe de limitation de conservation du GDPR.

ROI et impact commercial

L'intérêt commercial de l'intégration de Purple avec HubSpot est simple : elle convertit un coût d'infrastructure réseau passif en un pipeline de données actif générateur de revenus. Les indicateurs clés de performance pour mesurer le succès du déploiement sont :

Dans le cadre d'un déploiement hôtelier, un hôtel de 300 chambres générant 2 000 connexions WiFi uniques par mois peut s'attendre à ajouter environ 400 à 500 nouveaux contacts enrichis nets à HubSpot chaque mois, en supposant un taux de conversion de 20 à 25 % entre la connexion et la soumission du formulaire. Avec un taux de conversion prudent de 10 % en MQL, cela représente 40 à 50 nouveaux prospects qualifiés par le marketing (MQL) par mois à partir d'une source de données qui ne générait auparavant aucune valeur CRM.

Pour une chaîne de vente au détail opérant sur 50 points de vente, le volume global de données est nettement plus élevé, et la valeur de la segmentation — en particulier la capacité à cibler les contacts par emplacement de magasin spécifique — permet de mener des campagnes promotionnelles hyper-localisées qui surpassent systématiquement les e-mails de diffusion génériques, tant en termes de taux d'ouverture que de conversion.