Setup-Anleitung für HubSpot
So verbinden Sie die PLZ Lookup App von CogniCore mit Ihrem HubSpot-Account.
Was die App macht
Die PLZ Lookup App reichert Kontakte und Unternehmen in HubSpot automatisch geografisch an. Dafür braucht sie nur die Postleitzahl. Zusätzlich kann sie alle vorhandenen Kontakte und Unternehmen auf einmal anreichern und fügt sich so in bestehende Abläufe ein.
Damit können Sie Kontakte und Unternehmen nach Bundesland, Landkreis oder Stadt segmentieren, Marketingkampagnen gezielt ausrichten und Vertriebsgebiete zuordnen.
Die Daten stammen aus offiziellen Quellen des Statistischen Bundesamtes (Destatis) und aus OpenStreetMap und decken den DACH-Raum ab. Ein eigenes Abonnement ist nicht nötig, die Basisversion ist kostenfrei.
Vorbereitung
Land zuweisen: Objekte mit Postleitzahlen außerhalb des DACH-Raums sollten das passende Land eingetragen haben. Das ist besonders wichtig, wenn die Postleitzahl dem DACH-Format (vier- oder fünfstellig) entspricht, sonst kann es zu falschen Zuordnungen kommen. Wir empfehlen, die Eigenschaft „Land“ in Formularen und Eingabemasken als Pflichtfeld festzulegen.
Eingetragene Werte prüfen: Die App überschreibt die ausgewählten Felder mit den Informationen aus den offiziellen Quellen. Stellen Sie vor der Installation sicher, dass diese Eigenschaften keine absichtlich abweichenden Werte enthalten, sonst gehen diese verloren. Wir empfehlen zur Sicherheit einen Export aller betroffenen Objekte und eine stichprobenartige Kontrolle der eingetragenen Werte. Aus Datenschutzgründen bietet die App keine Möglichkeit, Änderungen zurückzunehmen.
Installation
- Im HubSpot App Marketplace auf „Installieren“ klicken oder direkt hier starten.
- Den gewünschten HubSpot-Account auswählen.
- Auf „Account wählen“ klicken.
- Die angeforderten Berechtigungen sorgfältig lesen: Lese- und Schreibzugriff auf Kontakte, auf Unternehmen und auf benutzerdefinierte Eigenschaften.
- Auf „App verknüpfen“ klicken.
- Die Installationsseite prüfen. Sie informiert über mögliche Probleme bei der Installation und zeigt den Status der Installation und der App im System. Ein Beispiel für eine erfolgreiche Installation finden Sie auf der Test-Installationsseite.


Einstellungen
In den Einstellungen verwalten Sie jedes Objekt und jede Eigenschaft einzeln. Objekte sind Kontakte und Unternehmen, Eigenschaften sind Bundesland, Landkreis und Stadt.
Standardmäßig ist die Anreicherung aller Eigenschaften aktiv. Um eine Eigenschaft abzuschalten, entfernen Sie den Haken und speichern über den Knopf unten rechts. Sie können mehrere Eigenschaften über alle Objekte hinweg anpassen und gemeinsam speichern.
Mit „Alle Objekte anreichern“ reichern Sie alle Objekte dieses Typs, bei denen eine Postleitzahl eingetragen ist, auf einmal an. Das läuft im Hintergrund.

Funktionsweise
Ab der Installation reichert die App Kontakte und Unternehmen automatisch im Hintergrund an. Immer wenn sich die Eigenschaft „Postleitzahl“ eines Kontakts oder Unternehmens ändert oder ein Objekt mit dieser Eigenschaft neu angelegt wird, sucht die App die zugehörigen Daten heraus und trägt sie in HubSpot ein.
Um die aktualisierten Werte in HubSpot zu sehen, laden Sie die Seite neu. Die Änderung ist aber sofort im System hinterlegt und kann von Automatisierungen genutzt werden. Befüllt werden nur die Felder, die in den Einstellungen aktiviert sind.
Für eine genauere Zuordnung der Postleitzahl zieht die App die Eigenschaft „Land“ heran. Tragen Sie das Land deshalb möglichst vor der Postleitzahl ein.

Deinstallation
Sie entfernen die App in den Einstellungen von HubSpot, siehe den Artikel Uninstall an App in der HubSpot Knowledge Base. Die App ist dann sofort entfernt. Die Daten in Ihrem System bleiben unverändert, auch angelegte benutzerdefinierte Eigenschaften wie „Landkreis“.
Es gelten die Nutzungsbedingungen der PLZ Lookup App. Fragen beantworten wir unter info@cognicore.de.