PLZ Lookup App Setup Guide
für HubSpot

Vorbereitung

Um eine erfolgreiche Installation und Nutzung insbesondere der Funktionen zur Anreicherung aller Kontakte/Unternehmen zu ermöglichen, sollten folgende Dinge beachtet werden:

• Land-Zuweisung: Objekte mit Postleitzahlen außerhalb des DACH-Raums sollten die entsprechenden Länder zugewiesen bekommen. Dies ist insbesondere dann wichtig, wenn die Postleitzahlen dem DACH Format (4/5-stellig) entsprechen, da es sonst zu falschen Zuweisungen kommen kann. Wir empfehlen allgemein die Festlegung der Eigenschaft "Land" als Pflichtfeld in Formularen und Eingabemasken.

• Überprüfung der eingetragenen Werte: Die PLZ Lookup App überschreibt die ausgewählten Felder mit den Informationen aus den offiziellen Quellen. Daher ist es wichtig, vor der Installation sicherzustellen, dass die gewählten Eigenschaften keine absichtlich abweichenden Werte enthalten, da diese sonst verloren gehen würden. Wir empfehlen zur Sicherheit einen Export aller betroffenen Objekte und eine stichprobenartige Kontrolle der bereits eingetragenen Eigenschaftswerte, um abweichende Informationen sichern zu können. Die App bietet aus Datenschutzgründen keine Funktion für Roll-Backs irgendeiner Art!

Installation

1. Im HubSpot App Marketplace auf "Installieren" oder hier klicken

2. Gewünschten HubSpot Account auswählen

3. Auf "Account wählen" klicken

4. Sorgfältig die geforderten Berechtigungen lesen:
   - Lese- und Schreibzugriff auf Kontakte
   - Lese- und Schreibzugriff auf Unternehmen
   - Lese- und Schreibzugriff auf Custom Properties

5. Auf "App verknüpfen" klicken

6. Die Installationsseite überprüfen:
   ->Informiert über mögliche Probleme bei der Installation
   ->Zeigt Status der Installation und der App im System an

Einstellungen

Die App ermöglicht es, alle anzureichernden Eigenschaften und Objekte einzeln zu verwalten.

Objekte:

• Kontakte

• Unternehmen

Eigenschaften:

• Bundesland

• Landkreis

• Stadt

Standardmäßig ist die Anreicherung aller Eigenschaften aktiviert.
Um eine Eigenschaft zu deaktivieren, muss der Haken entfernt und die Einstellungen über den entsprechenden Knopf in der rechten unteren Ecke gespeichert werden.
Dabei können mehrere Eigenschaften über alle Objekte hinweg angepasst und gleichzeitig gespeichert werden.

Über die Knöpfe "Alle Objekte anreichern" können alle Objekte dieses Typen, bei denen eine PLZ eingetragen ist, auf einen Schlag angereichert werden.
Dies geschieht wie gewohnt im Hintergrund.

Funktionsweise

Die PLZ Lookup App reichert automatisch im Hintergrund Kontakte und Unternehmen an, von dem Moment an, an dem sie im HubSpot System installiert wird.

Immer, wenn die Eigenschaft "Postleitzahl" eines Kontaktes oder Unternehmens geändert wird, oder ein Objekt mit dieser Eigenschaft neu erstellt wird, sucht die PLZ Lookup App die zugehörigen Daten raus und trägt sie im HubSpot System ein.

Ein Neu-Laden der Seite ist erforderlich, um die aktualisierten Eigenschaftswerte in HubSpot sehen zu können. Die Änderung ist allerdings unmittelbar im System hinterlegt und kann von Automatisierungen verwendet werden.

Dabei werden nur die Felder befüllt, die in den App-Einstellungen aktiviert wurden.

Die Daten stammen aus offiziellen Quellen des statistischen Bundesamtes (Destatis) und der OpenStreetMap.

Zur genaueren Bestimmung der Postleitzahl wird die Eigenschaft "Land" herangezogen, es ist daher empfohlen, diese vor Eintragung der Postleitzahl ebenfalls korrekt zu befüllen.

Entfernen/Deinstallieren der App

Falls du die PLZ Lookup App wieder aus deinem HubSpot System entfernen möchtest, muss dies über die Einstellungen geschehen. Siehe hierzu folgenden Artikel der HubSpot Knowledge Base: Uninstall an App.

Dies wird die App sofort aus dem System entfernen.
Daten im System sind davon nicht betroffen, auch angelegte Custom Eigenschaften (z.B. "Landkreis") bleiben erhalten und unverändert.