HubSpot und Guest WiFi: Lead-Enrichment und Segmentierung

Dieser Leitfaden bietet IT-Managern, HubSpot-Admins und Marketing-Operations-Teams ein praktisches Integrations-Playbook für die Verbindung von Purple Guest WiFi mit HubSpot. Er deckt die gesamte technische Architektur ab — von der Datenerfassung über das Captive Portal und das Property-Mapping bis hin zur Automatisierung der Lifecycle-Phasen, Deduplizierung und Listen-Segmentierung — und ermöglicht es Standortbetreibern, anonyme WiFi-Verbindungen in angereicherte, verwertbare CRM-Kontakte zu verwandeln.

📖 9 Min. Lesezeit📝 2,047 Wörter🔧 2 ausgearbeitete Beispiele❓ 3 Übungsfragen📚 9 Schlüsseldefinitionen

Diesen Leitfaden anhören

Podcast-Transkript ansehen

Willkommen beim Purple Integration Playbook. Ich bin Ihr Moderator, und heute werfen wir einen Blick auf die Architektur unserer nativen HubSpot-Integration. Speziell geht es darum, wie Sie Gast-WiFi-Daten in HubSpot einspeisen, um Leads anzureichern und zu segmentieren. Wenn Sie IT-Manager, Netzwerkarchitekt oder CRM-Verantwortlicher an einem großen Standort sind – sei es ein Stadion, eine Einzelhandelskette oder ein Hotel –, ist diese Session genau das Richtige für Sie. Wir verzichten auf Marketing-Floskeln. Heute dreht sich alles um Datenfluss, Eigenschafts-Mapping und Lifecycle-Automatisierung. Legen wir los.

Zunächst zum Kontext: Das Gast-WiFi-Netzwerk ist eine der am wenigsten genutzten Datenquellen an jedem Standort. Jedes Mal, wenn sich ein Besucher verbindet, liefert er ein verifiziertes Identitätssignal – seinen Namen, seine E-Mail-Adresse und, was ganz entscheidend ist, seine ausdrückliche Zustimmung zur Kontaktaufnahme. Die meisten Unternehmen erfassen diese Daten und lassen sie dann in einer separaten WiFi-Management-Plattform liegen, völlig isoliert vom CRM. Das ist eine große verpasste Chance. Die HubSpot-Integration von Purple wurde speziell entwickelt, um diese Lücke zu schließen.

Beginnen wir mit der Datenerfassungsebene. Wenn sich ein Gast über das Captive Portal mit dem Netzwerk verbindet, authentifiziert die Purple-Plattform die Sitzung. An diesem Punkt gibt der Nutzer demografische Daten an – in der Regel Vorname, Nachname und E-Mail-Adresse – sowie die ausdrückliche Zustimmung zum Marketing. Dieser Einwilligungsmechanismus ist entscheidend. Er muss den GDPR-Anforderungen entsprechen, was bedeutet, dass das Kontrollkästchen für die Einwilligung auf dem Portal standardmäßig nicht angekreuzt sein darf und der Nutzer sich aktiv anmelden (Opt-in) muss. Dies ist nicht nur eine gesetzliche Vorgabe, sondern der Mechanismus, der bestimmt, ob die von Ihnen erfassten Daten tatsächlich für Outbound-Marketing nutzbar sind.

Sobald die Sitzung authentifiziert ist, löst die native Integration einen API-Aufruf an HubSpot aus. Die Daten werden als JSON-Payload über eine sichere HTTPS-Verbindung übertragen. Aber wie genau wird dies im CRM zugeordnet? Schauen wir uns das genauer an.

Die Standardfelder lassen sich direkt und sauber zuordnen. Vorname wird der HubSpot-Eigenschaft firstname zugeordnet. Nachname wird lastname zugeordnet. E-Mail-Adresse wird email zugeordnet. Dies sind native HubSpot-Kontakteigenschaften, die keine zusätzliche Konfiguration erfordern. Der wahre Wert dieser Integration liegt jedoch in der Abstimmung benutzerdefinierter Eigenschaften. Das WiFi-Netzwerk generiert umfassende Verhaltensdaten, für die es in HubSpot keinen standardmäßigen Platz gibt. Sie müssen benutzerdefinierte Eigenschaften erstellen, um diese zu speichern.

Ich empfehle, vor der Aktivierung der Integration die folgenden benutzerdefinierten Eigenschaften in HubSpot zu erstellen. Erstens: wifi last visit — dies sollte eine Eigenschaft vom Typ „Datumsauswahl“ sein. Sie erfasst das letzte Datum, an dem sich der Kontakt über WiFi authentifiziert hat. Zweitens: wifi venue — eine einzeilige Texteigenschaft. Dies ist für Bereitstellungen an mehreren Standorten unerlässlich. Drittens: wifi session count — eine Numerische Eigenschaft. Diese erfasst, wie oft sich der Kontakt bei allen Besuchen verbunden hat. Viertens: wifi dwell time — eine weitere Numerische Eigenschaft, die die durchschnittliche Sitzungsdauer in Minuten aufzeichnet. Diese vier benutzerdefinierten Eigenschaften sind das Fundament Ihrer Segmentierungsstrategie.

Lassen Sie uns nun über die Deduplizierung sprechen. Dies ist eine häufige Fehlerquelle bei WiFi-zu-CRM-Integrationen, und es lohnt sich, hier Zeit zu investieren. HubSpot verwendet die E-Mail-Adresse als primären eindeutigen Identifikator für Kontaktdatensätze. Wenn die Purple-Payload am HubSpot-API-Endpunkt eingeht, führt HubSpot einen Abgleich durch. Wenn bereits ein Kontakt mit dieser E-Mail-Adresse existiert, aktualisiert HubSpot den bestehenden Datensatz mit den neuen Daten. Ist dies nicht der Fall, wird ein neuer Kontakt erstellt. Dies ist das korrekte Verhalten und bedeutet, dass Sie niemals doppelte Datensätze für dieselbe Person erhalten sollten – vorausgesetzt, die E-Mail-Adresse ist konsistent.

Das Risiko liegt hier in fehlerhaften Daten an der Quelle. Wenn Ihr Captive Portal es Nutzern ermöglicht, eine fehlerhafte oder – noch schlimmer – eine gefälschte E-Mail-Adresse einzugeben, erstellen Sie verwaiste Datensätze in HubSpot, die niemals abgeglichen oder per E-Mail kontaktiert werden können. Die Gegenmaßnahme ist einfach: Setzen Sie eine strenge Validierung des E-Mail-Formats im Portal-Formular durch. Machen Sie das E-Mail-Feld zu einem Pflichtfeld und validieren Sie das Format bei der Übermittlung. Dies ist eine Konfigurationsoption innerhalb des Purple-Portals und sollte als Mindestanforderung aktiviert werden.

Kommen wir nun zur Automatisierung der Lifecycle-Phasen. Hier geht die Integration von der reinen Datenerfassung zu echter Marketing Intelligence über. Das Standardverhalten vieler Teams besteht darin, die Lifecycle-Phase jedes neuen WiFi-Kontakts auf „Lead“ zu setzen. Davon würde ich dringend abraten. Dies setzt einen einmaligen Besucher mit einem wirklich interessierten Interessenten gleich, was Ihre Lead-Zahlen künstlich aufbläht und gleichzeitig die Qualität Ihrer Pipeline mindert.

Implementieren Sie stattdessen ein gestuftes, ereignisgesteuertes Lifecycle-Modell. Setzen Sie die Lifecycle-Phase beim ersten WiFi-Login auf „Abonnent“. Wenn die Eigenschaft wifi session count innerhalb eines rollierenden 30-Tage-Fensters zwei oder mehr erreicht, lösen Sie einen Workflow aus, der den Kontakt in einen „Marketing Qualified Lead“ überführt. Wenn die wifi dwell time bei mehreren Besuchen 45 Minuten überschreitet, überführen Sie den Kontakt in einen „Sales Qualified Lead“. Schließlich, wenn ein Loyalty-Programm-Tag zugewiesen wird, überführen Sie den Kontakt in „Kunde“.

Eine große Falle in dieser Phase ist es, die Rechtsgrundlage für die Verarbeitung nicht zuzuordnen. Verknüpfen Sie das Kontrollkästchen für die Marketing-Einwilligung aus dem Captive Portal immer mit der Eigenschaft hs legal basis in HubSpot. Wenn Sie diesen Schritt überspringen, kann Ihr Marketing-Team diese Kontakte nicht per E-Mail anschreiben, was die Integration für Outbound-Kampagnen nutzlos macht.Lassen Sie uns schnell ein paar häufige Fragen klären.

Unterstützt die Integration Bereitstellungen an mehreren Standorten (Multi-Venue)? Ja, absolut. Übergeben Sie die Standort-ID von Purple an die benutzerdefinierte WiFi-Standorteigenschaft in HubSpot. Dies ermöglicht es regionalen Marketingteams, Listen nach Standort zu segmentieren. Für eine Einzelhandelskette mit 50 Filialen bedeutet dies, dass jeder Filialleiter eine Liste von Kontakten haben kann, die seinen spezifischen Standort besucht haben.

Was passiert, wenn das HubSpot API-Ratenlimit erreicht wird? Die Purple-Plattform reiht Payloads in eine Warteschlange ein und versucht fehlgeschlagene Anfragen erneut. Bei Umgebungen mit sehr hoher Dichte – wie einem Stadion mit 50.000 gleichzeitigen Authentifizierungen beim Anpfiff – sollten Sie sich jedoch der Limits Ihres HubSpot API-Tiers bewusst sein und entsprechend planen.

Zusammenfassend die wichtigsten Punkte: Ordnen Sie zuerst Ihre standardmäßigen demografischen Felder zu, um die Identität in HubSpot zu etablieren. Erstellen und verknüpfen Sie dann die benutzerdefinierten Eigenschaften – „wifi last visit“, „wifi venue“, „wifi session count“ und „wifi dwell time“ –, um die Segmentierung zu ermöglichen. Nutzen Sie die E-Mail-Adresse immer als Primärschlüssel für die Duplikatbereinigung und erzwingen Sie die E-Mail-Validierung auf dem Portal. Setzen Sie nicht alle Kontakte standardmäßig auf "Lead". Nutzen Sie WiFi-Sitzungsdaten, um ereignisgesteuerte Änderungen der Lifecycle-Phasen auszulösen. Und ganz entscheidend: Verknüpfen Sie immer die Marketing-Einwilligung mit "hs legal basis", bevor Sie live gehen.

Überprüfen Sie als nächsten Schritt Ihre aktuellen Formularfelder des Captive Portals im Vergleich zu Ihrer HubSpot-Eigenschaftskonfiguration. Ordnen Sie jedes Feld einer entsprechenden Eigenschaft zu. Jeder erfasste Datenpunkt sollte einen Zweck und einen festen Platz im CRM haben.

Vielen Dank, dass Sie sich das Purple Integration Playbook angehört haben. Wir sehen uns bei der nächsten Bereitstellung.

Wichtigste Erkenntnisse

✓Purple Guest WiFi fungiert als Echtzeit-Datenerfassungsebene für HubSpot und wandelt anonyme Netzwerkverbindungen in angereicherte CRM-Kontakte mit verifizierter Identität und Verhaltensdaten um.
✓Vor der Aktivierung müssen vier benutzerdefinierte HubSpot-Eigenschaften erstellt werden: wifi_venue, wifi_session_count, wifi_last_visit und wifi_dwell_time – diese bilden das Fundament jeder WiFi-basierten Segmentierung.
✓HubSpot verwendet die E-Mail-Adresse als primären Schlüssel zur Dublettenbereinigung. Erzwingen Sie eine strikte Validierung des E-Mail-Formats auf dem Captive Portal, um zu verhindern, dass fehlerhafte Daten in das CRM gelangen.
✓Stufen Sie WiFi-Verbindungen standardmäßig niemals pauschal als "Lead" ein – nutzen Sie ein ereignisgesteuertes Lifecycle-Modell: Subscriber beim ersten Login, MQL bei 2 oder mehr Besuchen innerhalb von 30 Tagen, SQL bei hoher Verweildauer.
✓Die Zuordnung der Eigenschaft hs_legal_basis ist obligatorisch; ohne sie blockiert HubSpot alle ausgehenden E-Mails an über WiFi gewonnene Kontakte, unabhängig von der Gültigkeit der E-Mail-Adresse.
✓Standardisieren Sie bei Bereitstellungen an mehreren Standorten die Standortnamen vor dem Go-Live – eine uneinheitliche Namensgebung führt unbemerkt zur Fragmentierung aktiver Listen und beeinträchtigt die Segmentierung geografisch ausgerichteter Kampagnen.
✓Überwachen Sie die HubSpot-API-Ratenbegrenzungen bei Veranstaltungen mit hoher Auslastung. Purple reiht Payloads in eine Warteschlange ein und versucht die Übertragung erneut, doch anhaltende Lastspitzen können die Datensynchronisierung verzögern und zeitkritische Workflow-Trigger beeinträchtigen.

Executive Summary

Für Unternehmen mit physischen Standorten – von weitläufigen Einzelhandelsketten bis hin zu Stadien mit hoher Kapazität – ist das Gast-WiFi-Netzwerk eine der am wenigsten genutzten Datenerfassungsebenen im Technologie-Stack. Jede authentifizierte Sitzung stellt ein verifiziertes Identitätssignal dar: einen Namen, eine E-Mail-Adresse und eine ausdrückliche Marketing-Einwilligung. Dennoch lassen die meisten Organisationen zu, dass diese Daten isoliert in ihrer WiFi-Management-Plattform verbleiben, völlig getrennt vom CRM. Die Purple-HubSpot-Integration schließt diese Lücke, indem sie eine echtzeitbasierte, ereignisgesteuerte Datenpipeline zwischen dem Captive Portal und HubSpot einrichtet.

Dieser Leitfaden deckt die gesamte Bereitstellungsarchitektur ab: wie Sie Portal-Felder für Gast-WiFi den Standard- und benutzerdefinierten Eigenschaften von HubSpot zuordnen, wie Sie die Deduplizierungslogik konfigurieren, wie Sie durch WiFi-Sitzungsereignisse ausgelöste Lifecycle-Phasen-Workflows erstellen und wie Sie Kontakte in zielgerichtete Listen segmentieren. Er richtet sich an HubSpot-Admins, Marketing Operations Managers und IT-Architekten, die diese Integration in einer Produktionsumgebung implementieren und nicht nur theoretisch bewerten möchten.

Technical Deep-Dive

Architektur und Datenfluss

Die Integration basiert auf einer Webhook-gesteuerten Architektur. Wenn sich ein Benutzer über das Purple Captive Portal authentifiziert, fungiert die Plattform als Identitätsanbieter, validiert die Sitzung und generiert einen strukturierten JSON-Payload, der die demografischen Daten und Sitzungsdaten des Benutzers enthält. Dieser Payload wird über einen sicheren HTTPS-REST-API-Aufruf an den HubSpot Contacts-API-Endpunkt übertragen.

Der Datenfluss verläuft in vier diskreten Phasen: Authentifizierung auf der Portal-Ebene, Payload-Generierung durch die Purple-Plattform, API-Übertragung an HubSpot sowie Erstellung oder Aktualisierung von Datensätzen im CRM. Bei Bereitstellungen an mehreren Standorten – wie sie im Einzelhandel und im Gastgewerbe üblich sind – wird der Standort-Identifikator zum Zeitpunkt der Generierung in den Payload eingebettet. So wird sichergestellt, dass jeder Kontaktdatensatz den für die regionale Segmentierung erforderlichen Standortkontext enthält.

Die WiFi Analytics -Ebene innerhalb von Purple generiert die Verhaltensmetriken – Sitzungsanzahl, Verweildauer, Besuchshäufigkeit –, die zusammen mit den demografischen Daten übermittelt werden. Diese Metriken sind der entscheidende Unterschied zwischen einer einfachen E-Mail-Erfassung und einem wirklich angereicherten CRM-Kontakt.

Funktionsweise des Property-Mappings

Eine präzise Eigenschaftszuordnung (Property Mapping) ist das Fundament einer zuverlässigen Integration. Die nativen Kontakteigenschaften von HubSpot decken standardmäßige demografische Felder ab, aber WiFi-spezifische Verhaltensdaten erfordern die Erstellung benutzerdefinierter Eigenschaften, bevor die Integration aktiviert wird.

Die folgende Tabelle definiert die empfohlene Konfiguration für die Eigenschaftszuordnung:

Portal-Feld	HubSpot-Eigenschaft	Eigenschaftstyp	Anmerkungen
Vorname	`firstname`	Einzeiliger Text	Native HubSpot-Eigenschaft
Nachname	`lastname`	Einzeiliger Text	Native HubSpot-Eigenschaft
E-Mail-Adresse	`email`	E-Mail	Primärer Deduplizierungsschlüssel
Telefonnummer	`phone`	Telefonnummer	Native HubSpot-Eigenschaft
Geburtsdatum	`date_of_birth`	Datumsauswahl	Benutzerdefinierte Eigenschaft erforderlich
Postleitzahl / ZIP	`zip`	Einzeiliger Text	Native HubSpot-Eigenschaft
Marketing-Einwilligung	`hs_legal_basis`	Einzeiliger Text	Festgelegt auf 'Freely given consent'
Zeitstempel des Besuchs	`wifi_last_visit`	Datumsauswahl	Benutzerdefinierte Eigenschaft erforderlich
Name des Standorts (Venue Name)	`wifi_venue`	Einzeiliger Text	Benutzerdefinierte Eigenschaft erforderlich
Anzahl der Sitzungen	`wifi_session_count`	Nummer	Benutzerdefinierte Eigenschaft erforderlich
Verweildauer (Min.)	`wifi_dwell_time`	Nummer	Benutzerdefinierte Eigenschaft erforderlich

Die vier benutzerdefinierten Eigenschaften — wifi_last_visit, wifi_venue, wifi_session_count und wifi_dwell_time — müssen in HubSpot erstellt werden, bevor die Integration aktiviert wird. Wenn diese Eigenschaften nicht vorab erstellt werden, führt dies dazu, dass die Payload-Daten von der HubSpot-API stillschweigend verworfen werden.

Deduplizierung und Identitätsauflösung

HubSpot verwendet die E-Mail-Adresse als primären eindeutigen Identifikator für Kontaktdatensätze. Wenn die Purple-Payload empfangen wird, führt HubSpot einen Abgleich mit bestehenden Datensätzen durch. Wenn ein Kontakt mit der übereinstimmenden E-Mail-Adresse existiert, aktualisiert HubSpot den Datensatz mit den neuen Sitzungsdaten — erhöht wifi_session_count und aktualisiert wifi_last_visit. Wenn keine Übereinstimmung gefunden wird, wird ein neuer Kontaktdatensatz erstellt.

Dieses Verhalten ist deterministisch und zuverlässig, vorausgesetzt, dass die E-Mail-Adresse bei allen Besuchen konsistent ist. Das primäre Risiko sind fehlerhafte Daten an der Quelle. Wenn das Captive Portal fehlerhafte oder gefälschte E-Mail-Adressen zulässt, werden in HubSpot verwaiste Datensätze erstellt, die bei nachfolgenden Besuchen nicht zugeordnet werden können und an die keine E-Mails gesendet werden können. Die Gegenmaßnahme besteht darin, eine strenge Validierung des E-Mail-Formats nach RFC 5322 im Portal-Formular zu erzwingen, indem das E-Mail-Feld mit serverseitiger Validierung zum Pflichtfeld gemacht wird. Dies ist eine konfigurierbare Option innerhalb der Purple-Portaleinstellungen und sollte als unverzichtbare Grundvoraussetzung behandelt werden.

Für Organisationen, die im Bereich Healthcare oder im öffentlichen Sektor tätig sind, in denen die GDPR-Compliance einer Prüfung unterliegt, ist zudem erwähnenswert, dass der Deduplizierungsmechanismus dafür sorgt, dass ein einziger Kontaktdatensatz den gesamten Besuchsverlauf zusammenfasst. Dies vereinfacht Antworten auf Auskunftsbegehren (Subject Access Request, SAR) und Datenlöschanfragen gemäß GDPR-Artikel 17.

Implementierungsleitfaden

Schritt 1: Benutzerdefinierte HubSpot-Eigenschaften vorkonfigurieren

Navigieren Sie zu HubSpot-Einstellungen > Eigenschaften > Kontakteigenschaften. Erstellen Sie die vier in der obigen Zuordnungstabelle aufgeführten benutzerdefinierten Eigenschaften. Stellen Sie sicher, dass die Datentypen korrekt eingestellt sind — wifi_last_visit muss ein Datumsauswahler sein, wifi_session_count und wifi_dwell_time müssen vom Typ Zahl sein. Falsche Datentypen führen dazu, dass die API die Payload-Werte ablehnt.

Schritt 2: Captive Portal-Felder überprüfen und abgleichen

Überprüfen Sie die aktuelle Konfiguration des Purple Captive Portal. Stellen Sie sicher, dass das E-Mail-Feld als Pflichtfeld mit aktivierter Formatvalidierung eingerichtet ist. Bestätigen Sie bei Bereitstellungen an mehreren Standorten, dass die Standortkennung so konfiguriert ist, dass sie dynamisch basierend auf dem Standort des Access Points übergeben wird. Standorte in Transport -Umgebungen wie Flughäfen oder Bahnhöfen können mehrere Zonen innerhalb eines einzigen Standorts haben, die jeweils eine eigene Standortkennung erfordern.

Schritt 3: Eigenschaftszuordnung in Purple konfigurieren

Ordnen Sie in den HubSpot-Integrationseinstellungen der Purple-Plattform jedes Portal-Feld dem entsprechenden internen HubSpot-Eigenschaftsnamen zu. Verwenden Sie die exakten internen Eigenschaftsnamen (z. B. wifi_session_count, nicht WiFi Session Count), um sicherzustellen, dass die API-Payload korrekt strukturiert ist.

Schritt 4: Automatisierung der Lifecycle-Phasen einrichten

Setzen Sie standardmäßig nicht alle neuen WiFi-Verbindungen auf die Lifecycle-Phase "Lead". Implementieren Sie stattdessen ein ereignisgesteuertes, gestuftes Modell mithilfe von HubSpot-Workflows.

Der empfohlene Lifecycle-Verlauf sieht wie folgt aus: Setzen Sie beim ersten WiFi-Login die Lifecycle-Phase auf Subscriber — die richtige HubSpot-Phase für einen Kontakt, der seine Daten angegeben, aber noch keine Verhaltensabsicht gezeigt hat. Wenn wifi_session_count innerhalb eines rollierenden 30-Tage-Fensters 2 oder mehr erreicht, lösen Sie einen Workflow aus, um den Kontakt in die Phase Marketing Qualified Lead (MQL) zu überführen. Wenn wifi_dwell_time über mehrere Sitzungen hinweg 45 Minuten überschreitet, wechseln Sie zu Sales Qualified Lead (SQL). Wenn ein Treueprogramm-Tag zugewiesen wird, wechseln Sie zu Customer.

In HubSpot, erstellen Sie jeden Übergang als separaten Workflow, wobei der Trigger auf "Wert der Kontakteigenschaft ändert sich" eingestellt ist. Dies stellt sicher, dass der Übergang sofort nach Erreichen des Schwellenwerts ausgelöst wird und nicht erst auf einen geplanten Batch-Prozess gewartet werden muss.

Schritt 5: Rechtsgrundlage für die Verarbeitung zuordnen

Dieser Schritt ist für die GDPR-Compliance unverzichtbar. Das Kontrollkästchen für die Marketing-Einwilligung im Captive Portal muss der HubSpot-Eigenschaft hs_legal_basis zugeordnet werden. Wenn ein Nutzer zustimmt, sollte der Wert auf Freely given consent from the contact gesetzt werden. Ohne diese Zuordnung blockieren die integrierten Compliance-Kontrollen von HubSpot den Versand ausgehender E-Mails an diese Kontakte, was die Integration für die Marketing-Automatisierung kommerziell nutzlos macht.

Schritt 6: Segmentierungslisten erstellen

Wenn die Eigenschaftsdaten korrekt fließen, erstellen Sie aktive HubSpot-Listen für die primären Segmentierungs-Anwendungsfälle. Beispiele hierfür sind: alle Kontakte mit wifi_venue = einem bestimmten Standort (für geografisch ausgerichtete Kampagnen), alle Kontakte mit wifi_session_count >= 5 (für Loyalty-Programm-Kampagnen) und alle Kontakte, bei denen wifi_last_visit innerhalb der letzten 30 Tage liegt (für Reaktivierungskampagnen basierend auf Aktualität).

Best Practices

E-Mail-Validierung an der Quelle erzwingen. Jedes Datenqualitätsproblem in HubSpot, das auf die WiFi-Integration zurückzuführen ist, lässt sich auf eine schlecht validierte E-Mail-Adresse zurückführen. Betrachten Sie das Portal-Formular als erste Verteidigungslinie für die Datenqualität im CRM.

Vom ersten Tag an nach Standort segmentieren. Bei jeder Bereitstellung an mehreren Standorten – sei es in einem Filialnetz, einer Klinikgruppe oder einem Stadionkomplex – ist die Eigenschaft wifi_venue die wichtigste Segmentierungsdimension. Konfigurieren Sie diese von Anfang an korrekt. Die nachträgliche Einrichtung einer Standortsegmentierung, nachdem bereits Tausende von Kontakten ohne diese Eigenschaft erstellt wurden, bedeutet einen erheblichen Bereinigungsaufwand.

Die Einwilligungs-Architektur respektieren. Das GDPR-Prinzip der Zweckbindung besagt, dass Daten, die über ein WiFi-Portal zum Zweck des Netzwerkzugriffs erhoben werden, nicht ohne ausdrückliche Einwilligung automatisch für das Direktmarketing verwendet werden dürfen. Die Zuordnung von hs_legal_basis ist keine Formsache – sie ist der rechtliche Mechanismus, der den Marketing-Anwendungsfall autorisiert.

API-Durchsatz überwachen. In stark frequentierten Umgebungen wie Stadien oder Konferenzzentren kann das gleichzeitige Authentifizierungsvolumen in Stoßzeiten die HubSpot-API belasten. Purple stellt Payloads in Warteschlangen und unternimmt erneute Versuche bei fehlgeschlagenen Anfragen. Es wird jedoch empfohlen, das API-Aufrufvolumen im HubSpot-Entwickler-Dashboard während Großveranstaltungen zu überwachen und sicherzustellen, dass die HubSpot-Konto-Stufe den erforderlichen Durchsatz unterstützt.

Inkrementelle Aktualisierungen statt vollständiges Überschreiben nutzen. Wenn sich ein wiederkehrender Besucher verbindet, sollte der Payload nur die geänderten Eigenschaften (wifi_last_visit, wifi_session_count) aktualisieren, anstatt alle Felder zu überschreiben. Dies verhindert einen versehentlichen Datenverlust, falls beispielsweise ein Kontakt seinen Namen direkt in HubSpot aktualisiert hat.

Fehlerbehebung & Risikominderung

Problem: Kontakte werden erstellt, können aber keine Marketing-E-Mails empfangen. Ursache: Die Eigenschaft hs_legal_basis wurde nicht zugeordnet oder mit einem falschen Wert-String zugeordnet. Lösung: Überprüfen Sie den genauen übergebenen String-Wert. HubSpot erfordert Freely given consent from the contact – jede Abweichung führt dazu, dass die Compliance-Prüfung stillschweigend fehlschlägt.

Problem: In HubSpot werden doppelte Kontaktdatensätze angezeigt. Fehlerursache: Es werden mehrere E-Mail-Adressen von demselben Benutzer übermittelt (z. B. privat und geschäftlich), oder das E-Mail-Feld ist im Portal nicht als Pflichtfeld eingerichtet. Lösung: Aktivieren Sie die obligatorische E-Mail-Validierung im Portal. Erwägen Sie die Implementierung eines Merge-Workflows in HubSpot, um Datensätze zu konsolidieren, bei denen derselbe Name mit unterschiedlichen E-Mail-Adressen erscheint.

Problem: Benutzerdefinierte Eigenschaften werden trotz aktiver Integration nicht befüllt. Fehlerursache: Die benutzerdefinierten Eigenschaften wurden vor der Aktivierung der Integration nicht in HubSpot erstellt, oder die internen Eigenschaftsnamen in der Purple-Mapping-Konfiguration stimmen nicht exakt mit den internen Eigenschaftsnamen in HubSpot überein. Lösung: Vergleichen Sie die internen Eigenschaftsnamen unter „HubSpot-Einstellungen > Eigenschaften“ mit der Mapping-Konfiguration in Purple. Bei internen Namen wird zwischen Groß- und Kleinschreibung unterschieden und es werden Unterstriche anstelle von Leerzeichen verwendet.

Problem: Die Lifecycle-Phase schreitet nicht voran, obwohl der Schwellenwert für die Anzahl der Sitzungen erreicht wurde. Fehlerursache: Der HubSpot-Workflow-Trigger ist auf ‚Kontakt ist aufgenommen‘ statt auf ‚Wert der Kontakteigenschaft ändert sich‘ eingestellt. Lösung: Erstellen Sie den Workflow mit dem richtigen Trigger-Typ neu. ‚Wert der Kontakteigenschaft ändert sich‘ wird jedes Mal ausgelöst, wenn die Eigenschaft aktualisiert wird, was der richtige Mechanismus für den schwellenwertbasierten Fortschritt ist.

Risiko: GDPR-Nichtkonformität aufgrund von Datenspeicherung. Abmilderung: Implementieren Sie einen HubSpot-Workflow, der Kontakte als inaktiv markiert, wenn 24 Monate lang keine WiFi-Aktivität verzeichnet wurde (d. h. wifi_last_visit liegt länger als 24 Monate zurück). Lösen Sie eine E-Mail zur erneuten Einwilligung aus. Wenn innerhalb von 30 Tagen keine Antwort eingeht, schließen Sie den Kontakt von allen Marketing-Kommunikationen aus. Dies steht im Einklang mit dem GDPR-Grundsatz der Speicherbegrenzung.

ROI & Geschäftsnutzen

Das wirtschaftliche Argument für die Purple HubSpot-Integration ist einfach: Sie verwandelt passive Kosten für die Netzwerkinfrastruktur in eine aktive, umsatzfördernde Datenpipeline. Die wichtigsten Leistungsindikatoren (KPIs) zur Messung des Bereitstellungserfolgs sind:

KPI	Messmethode	Richtwert
Netto-Neukontakte generiert	HubSpot-Kontaktquellenbericht	15–25 % der monatlichen WiFi-Sitzungen
Datensynchronisationsgenauigkeit	% der Kontakte mit allen 4 befüllten benutzerdefinierten Eigenschaften	> 95 %
E-Mail-Zustellbarkeitsrate	HubSpot-E-Mail-Integritäts-Dashboard	> 90 %
MQL-Konversionsrate von WiFi-Kontakten	Bericht zum Fortschritt der Lifecycle-Phase	> 8 % innerhalb von 90 Tagen
Kampagnen-Öffnungsrate (Kontakte aus WiFi-Quellen)	HubSpot-E-Mail-Analysen	> 25 % (im Vergleich zu 18 % Branchendurchschnitt)

Bei einer Bereitstellung im Gastgewerbe kann ein Hotel mit 300 Zimmern, das monatlich 2.000 eindeutige WiFi-Verbindungen generiert, mit einem Zuwachs von etwa 400–500 neuen, angereicherten Kontakten pro Monat in HubSpot rechnen – ausgehend von einer Conversion-Rate von 20–25 % von der Verbindung bis zum Ausfüllen des Formulars. Bei einer konservativen MQL-Conversion-Rate von 10 % entspricht dies 40–50 neuen Marketing-Qualified Leads pro Monat aus einer Datenquelle, die zuvor keinen CRM-Wert generiert hat.

Für eine Einzelhandelskette mit 50 Standorten ist das aggregierte Datenvolumen erheblich höher. Der Segmentierungswert – insbesondere die Möglichkeit, Kontakte nach bestimmten Filialstandorten anzusprechen – ermöglicht hyperlokale Werbekampagnen, die generische Massen-E-Mails sowohl bei der Öffnungs- als auch bei der Conversion-Rate konsistent übertreffen.

Schlüsseldefinitionen

Captive Portal

Die webbasierte Authentifizierungsseite, die Benutzern angezeigt wird, bevor sie Zugriff auf ein Gäste-WiFi-Netzwerk erhalten. Sie dient als primäre Schnittstelle zur Datenerfassung, auf der demografische Informationen und Marketing-Einwilligungen erhoben werden.

IT-Teams begegnen diesem Begriff als Frontend des WiFi-Authentifizierungsflusses. Die im Captive Portal konfigurierten Felder bestimmen direkt, welche Daten für die CRM-Anreicherung zur Verfügung stehen.

JSON Payload

Das strukturierte Datenpaket, das von der Purple-Plattform an die HubSpot API übertragen wird und die demografischen Daten sowie die Sitzungsdaten des Kontakts im JavaScript Object Notation-Format enthält.

Das Verständnis der Payload-Struktur ist für die Behebung fehlerhafter Datensynchronisierungen unerlässlich. Die HubSpot API lehnt Eigenschaften, die nicht existieren oder unpassende Datentypen aufweisen, stillschweigend ab.

Deduplizierung

Der Prozess, durch den das CRM redundante, doppelte Kontaktdatensätze identifiziert und zusammenführt oder deren Erstellung verhindert. HubSpot führt die Deduplizierung automatisch unter Verwendung der E-Mail-Adresse als Primärschlüssel durch.

Kritisch für die Pflege einer sauberen Datenbank. Fehler bei der Deduplizierung – meist verursacht durch uneinheitliche oder ungültige E-Mail-Adressen – führen zu künstlich erhöhten Kontaktzahlen und einer fragmentierten Besuchshistorie.

Lifecycle-Phase

Eine native HubSpot-Kontakteigenschaft, die angibt, wo sich ein Kontakt innerhalb des Marketing- und Vertriebstrichters befindet. Zu den Standardphasen gehören Abonnent, Lead, Marketing Qualified Lead (MQL), Sales Qualified Lead (SQL) und Kunde.

WiFi-Sitzungsereignisse sollten automatische Übergänge der Lifecycle-Phasen steuern. Die manuelle Verwaltung dieser Phasen im großen Stil ist operativ nicht machbar.

Aktive Liste

Eine dynamische Kontaktliste in HubSpot, die sich basierend auf definierten Eigenschaftskriterien automatisch in Echtzeit aktualisiert. Kontakte werden hinzugefügt oder entfernt, wenn sich ihre Eigenschaften ändern.

Der primäre Segmentierungsmechanismus für Kontakte aus WiFi-Quellen. Aktive Listen stellen sicher, dass die Kampagnenzielgruppen ohne manuelles Eingreifen immer die aktuellsten Besuchsdaten widerspiegeln.

Benutzerdefinierte Eigenschaft

Ein benutzerdefiniertes Feld, das in HubSpot erstellt wird, um Daten zu speichern, die nicht durch die nativen Eigenschaften der Plattform abgedeckt sind. Benutzerdefinierte Eigenschaften müssen erstellt werden, bevor die Integration aktiviert wird.

Erforderlich für alle WiFi-spezifischen Verhaltensdaten. Die vier kritischen benutzerdefinierten Eigenschaften für diese Integration sind wifi_venue, wifi_session_count, wifi_last_visit und wifi_dwell_time.

hs_legal_basis

Eine native HubSpot-Kontakteigenschaft, die die Rechtsgrundlage erfasst, auf der die Daten des Kontakts für Marketingzwecke gemäß der GDPR verarbeitet werden.

Muss mit dem Kontrollkästchen für die Marketing-Einwilligung im Captive Portal verknüpft werden. Ohne einen gültigen Wert in dieser Eigenschaft blockiert HubSpot den Versand ausgehender E-Mails an den Kontakt.

API Rate Limiting

Eine von der HubSpot API auferlegte Beschränkung der Anzahl von Anfragen, die innerhalb eines definierten Zeitfensters verarbeitet werden können. Das Überschreiten des Rate Limits führt zu HTTP-429-Fehlern und in die Warteschlange gestellten oder fehlgeschlagenen Payload-Übertragungen.

Ein Bereitstellungsrisiko in Umgebungen mit hoher Dichte wie Stadien oder Konferenzzentren während Spitzenzeiten der Authentifizierung. Purple stellt fehlgeschlagene Payloads in eine Warteschlange und versucht die Übertragung erneut, aber anhaltende Überschreitungen des Rate Limits können zu erheblichen Verzögerungen bei der Datensynchronisierung führen.

Verweildauer

Die Dauer in Minuten, die das Gerät eines Benutzers während einer einzelnen Sitzung mit dem WiFi-Netzwerk verbunden bleibt. Ein Indikator für die Interaktionstiefe und Kaufabsicht in Einzelhandels- und Gastronomieumgebungen.

Wird in der benutzerdefinierten Eigenschaft wifi_dwell_time gespeichert und als Trigger für den Übergang in die Lifecycle-Phase SQL verwendet. Eine hohe Verweildauer korreliert im standortbasierten Marketing mit einer höheren Konversionswahrscheinlichkeit.

Ausgearbeitete Beispiele

Ein Hotel mit 300 Zimmern möchte seine HubSpot-Marketinglisten segmentieren, um zwischen Erstbesuchern, wiederkehrenden Freizeitreisenden und häufigen Geschäftsreisenden zu unterscheiden und für jedes Segment unterschiedliche E-Mail-Sequenzen auszulösen.

Stellen Sie sicher, dass wifi_session_count und wifi_venue für alle neuen Verbindungen korrekt zugeordnet und ausgefüllt werden. 2. Erstellen Sie drei aktive HubSpot-Listen: 'Erstbesucher', bei denen wifi_session_count = 1; 'Wiederkehrende Freizeitreisende', bei denen wifi_session_count >= 2 UND wifi_last_visit innerhalb der letzten 90 Tage liegt UND die Eigenschaft jobtitle des Kontakts leer ist (was auf ein nicht-geschäftliches Profil hinweist); 'Geschäftsreisende', bei denen wifi_session_count >= 3 UND jobtitle bekannt oder company ausgefüllt ist. 3. Erstellen Sie drei separate HubSpot-E-Mail-Sequenzen, die aus den jeweiligen Listen gespeist werden. Die Sequenz für 'Erstbesucher' konzentriert sich auf die Bekanntmachung von Hotelangeboten und einen Anreiz für einen erneuten Besuch. Die Sequenz für 'Wiederkehrende Freizeitreisende' bewirbt das Treueprogramm. Die Sequenz für 'Geschäftsreisende' hebt Tagungsräume und Firmenratenanfragen hervor. 4. Setzen Sie die Lifecycle-Phase auf MQL, sobald wifi_session_count den Wert 3 erreicht, was die Aufnahme in die Geschäftsreisenden-Sequenz automatisch auslöst.

Kommentar des Prüfers: Dieser Ansatz nutzt deterministische Netzwerkdaten — Anzahl der Sitzungen und Aktualität des Besuchs — anstatt sich darauf zu verlassen, dass Mitarbeiter Gäste manuell kategorisieren. Die Segmentierung pflegt sich selbst, da sich aktive HubSpot-Listen in Echtzeit aktualisieren, wenn sich die WiFi-Eigenschaften ändern. Die Identifizierung von Geschäftsreisenden mithilfe der Anreicherung von `jobtitle` und `company` ist eine sekundäre Ebene, die mit einem Tool zur Datenanreicherung wie Clearbit verbessert werden kann, aber die WiFi-Daten allein liefern bereits ein ausreichendes Signal für die erste Segmentierung.

Eine Einzelhandelskette mit 50 Standorten muss sicherstellen, dass Marketing-E-Mails nur an Kunden gesendet werden, die sich in dem von ihnen besuchten Geschäft ausdrücklich angemeldet haben, und dass jeder regionale Marketingleiter nur auf die Kontakte aus seinem Gebiet zugreifen kann.

Ordnen Sie das Purple-Feld 'Venue Name' der benutzerdefinierten Eigenschaft wifi_venue in HubSpot zu. Stellen Sie sicher, dass die Standortnamen standardisiert sind (z. B. 'Manchester Arndale', 'Birmingham Bullring') — eine inkonsistente Namensgebung führt zu einer Fragmentierung der Segmentierung. 2. Ordnen Sie das Kontrollkästchen für die Marketing-Einwilligung dem Wert hs_legal_basis = 'Freely given consent from the contact' zu. 3. Erstellen Sie aktive HubSpot-Listen für jedes Geschäft, gefiltert nach wifi_venue = [Standortname] UND hs_legal_basis = 'Freely given consent from the contact'. 4. Verwenden Sie in HubSpot 'Teams', um den Zugriff der einzelnen regionalen Marketingleiter auf die Listen und Kontakte zu beschränken, die ihrem Gebiet zugeordnet sind. Weisen Sie den einzelnen Teams die entsprechenden Listen zu. 5. Erstellen Sie eine Standard-E-Mail-Vorlage für jede Region, die aus der entsprechenden Standortliste gespeist wird.

Kommentar des Prüfers: Die entscheidende Abhängigkeit liegt hier in der Standardisierung der Standortnamen. Wenn die Purple-Konfiguration für einige Verbindungen 'Manchester - Arndale' und für andere 'Manchester Arndale' übergibt, erfasst der Filter der aktiven Liste nicht alle Datensätze. Legen Sie vor der Bereitstellung eine Namenskonvention fest und setzen Sie diese in der Konfiguration des Purple-Portals durch. Die HubSpot-Teams-Funktion ist der richtige Mechanismus für die gebietsbasierte Zugriffskontrolle — sie vermeidet die Notwendigkeit, separate HubSpot-Portale für jede Region einzurichten, was die Daten fragmentieren und die Lizenzkosten erhöhen würde.

Übungsfragen

Q1. Ein Stadion erwartet 50.000 Besucher für ein Spieltag-Event. Der Stadionbetreiber möchte E-Mails über das WiFi-Portal erfassen und innerhalb von fünf Minuten nach der Verbindung jedes Gastes eine personalisierte Begrüßungs-E-Mail über HubSpot auslösen. Was ist das primäre technische Risiko und wie sollte es gemindert werden?

Hinweis: Berücksichtigen Sie das Volumen der gleichzeitigen Verbindungen beim Anstoß und wie die API mit Datenverkehrsspitzen umgeht.

Musterlösung anzeigen

Das primäre Risiko besteht darin, das HubSpot-API-Ratenlimit aufgrund der konzentrierten Spitze gleichzeitiger Authentifizierungen beim Anstoß zu erreichen. Selbst mit der Payload-Warteschlange und dem Wiederholungsmechanismus von Purple kann ein Ansturm von 10.000–15,000 gleichzeitigen Verbindungen innerhalb eines kurzen Zeitfensters zu erheblichen Verarbeitungsverzögerungen führen, was bedeutet, dass die SLA „Begrüßung innerhalb von 5 Minuten“ für die erste Welle von Verbindungen nicht erreichbar ist. Minderungsstrategien umfassen: (1) Upgrade auf einen HubSpot Enterprise-Tarif mit höheren API-Ratenlimits; (2) Akzeptieren, dass die Begrüßungs-E-Mail-SLA für gestaffelte Ankünfte realistisch ist, aber nicht für die Spitze beim Anstoß, und Anpassung der SLA auf „innerhalb von 30 Minuten“; (3) Konfigurieren des HubSpot-Workflows so, dass die Begrüßungs-E-Mail als Batch zu einer festen Zeit (z. B. 15 Minuten nach Öffnung der Tore) gesendet wird, anstatt einzeln ausgelöst zu werden, was die Auslastung der Workflow-Ausführung reduziert.

Q2. Das Marketingteam berichtet, dass 8.000 Kontakte, die in den letzten drei Monaten über das WiFi-Netzwerk generiert wurden, keine Marketing-E-Mails erhalten können. Die Kontakte existieren in HubSpot mit gültigen E-Mail-Adressen und sind nicht als abgemeldet markiert. Was ist die wahrscheinlichste Ursache und wie sieht der Weg zur Behebung aus?

Hinweis: Konzentrieren Sie sich auf die GDPR-Compliance-Ebene in HubSpot, nicht auf die E-Mail-Adressen selbst.

Musterlösung anzeigen

Die wahrscheinlichste Ursache ist, dass die Eigenschaft hs_legal_basis während der Integrationskonfiguration nicht zugewiesen wurde oder mit einem falschen String-Wert zugewiesen wurde. HubSpot erfordert genau den String „Freely given consent from the contact“ für GDPR-konforme Outbound-E-Mails. Jede Abweichung – einschließlich eines leeren Werts – führt dazu, dass HubSpot den Kontakt für den E-Mail-Versand sperrt. Der Behebungsweg ist: (1) Überprüfen des aktuellen Werts von hs_legal_basis bei einer Stichprobe der betroffenen Kontakte; (2) falls leer oder fehlerhaft, prüfen, ob das Kontrollkästchen für die Portal-Zustimmung im betreffenden Zeitraum von Purple erfasst wurde; (3) wenn die Zustimmung erfasst, aber nicht zugeordnet wurde, die Integrationszuordnung aktualisieren und einen HubSpot-Massenaktualisierungs-Workflow verwenden, um hs_legal_basis nachträglich für Kontakte festzulegen, bei denen der Zeitstempel der Zustimmung ausgefüllt ist; (4) wenn die Zustimmung nicht am Portal erfasst wurde, können diese Kontakte nicht per E-Mail kontaktiert werden und sollten dauerhaft gesperrt werden – versuchen Sie nicht, nachträglich eine Zustimmung zuzuweisen, die nicht erteilt wurde.

Q3. Ein Veranstaltungsortbetreiber möchte „besonders wertvolle“ Besucher identifizieren – definiert als Gäste, die in den letzten 60 Tagen mindestens viermal zu Besuch waren und deren durchschnittliche Verweildauer 90 Minuten überschreitet – und sie in HubSpot automatisch für eine VIP-Treueprogramm-Kampagnensequenz registrieren. Wie sollte dies architektonisch gelöst werden?

Hinweis: Überlegen Sie, welche Eigenschaften vorhanden sein müssen, wie die Schwellenwertlogik in HubSpot aufgebaut ist und was die Sequenzregistrierung auslöst.

Musterlösung anzeigen

Stellen Sie sicher, dass die benutzerdefinierten Eigenschaften wifi_session_count, wifi_dwell_time und wifi_last_visit korrekt zugeordnet und befüllt sind. 2. Erstellen Sie eine aktive Liste in HubSpot mit den Kriterien: wifi_session_count >= 4 UND wifi_dwell_time >= 90 UND wifi_last_visit liegt innerhalb der letzten 60 Tage. Diese Liste aktualisiert sich automatisch, wenn Kontakte die Kriterien erfüllen oder nicht mehr erfüllen. 3. Erstellen Sie einen HubSpot-Workflow, der durch „Kontakt zur Liste hinzugefügt“ für die obige aktive Liste ausgelöst wird. Legen Sie als Aktion fest, den Kontakt für die VIP-Treueprogramm-E-Mail-Sequenz zu registrieren. 4. Fügen Sie dem Workflow eine Ausschlussbedingung hinzu: Wenn die Lifecycle-Phase des Kontakts bereits „Kunde“ ist (d. h. bereits im Treueprogramm registriert), darf keine erneute Registrierung erfolgen. 5. Lösen Sie optional eine interne CRM-Benachrichtigung an das Gästebetreuungsteam des Veranstaltungsorts aus, wenn ein Kontakt in die VIP-Liste aufgenommen wird, um eine personalisierte Interaktion vor Ort beim nächsten Besuch zu ermöglichen.

Weiterlesen in dieser Reihe

CommScope Ruckus Integration mit Purple WiFi: Einrichtungs- und Konfigurationshandbuch

Dieses technische Referenzhandbuch bietet einen maßgeblichen Konfigurationsleitfaden für die Integration von CommScope Ruckus-Architekturen mit Purple WiFi. Es beschreibt Schritt-für-Schritt-Bereitstellungen für Guest WiFi Captive Portals, sicheres Mitarbeiter-WiFi über 802.1X und mandantenfähige Netzwerkisolierung mithilfe von Ruckus Dynamic PSK.

Allied Telesis Access Points Integration mit Purple WiFi

Dieses Handbuch bietet eine umfassende Konfigurationsanleitung für die Integration von Allied Telesis Access Points der TQ-Serie mit Purple WiFi. Es behandelt die externe Captive Portal-Weiterleitung, die 802.1X-RADIUS-Authentifizierung und die dynamische VLAN-Steuerung mithilfe von Private Pre-Shared Keys (PPSK) für sichere Multi-Tenant-Bereitstellungen.

Grandstream GWN Access Points Integration mit Purple WiFi

Dieses maßgebliche technische Handbuch beschreibt die Integration von Grandstream GWN Access Points mit dem Purple Guest WiFi und der Analytics-Plattform. Es umfasst die Konfiguration des Grandstream Captive Portal, die RADIUS AAA-Einstellungen, die Einrichtung des Walled Garden, die sichere 802.1X-Authentifizierung für Mitarbeiter mit dynamischer VLAN-Steuerung sowie die Multi-Tenant-PPSK-Segmentierung – eine praxisnahe Schritt-für-Schritt-Anleitung für MSPs und IT-Teams, die WiFi für Gäste und Mitarbeiter in großem Stil bereitstellen.