HubSpot-Verbindung
HubSpot ist eine CRM-Plattform mit all der Software, Integrationen und Ressourcen, die Sie für die Verbindung von Marketing, Vertrieb, Content-Management und Kundendienst benötigen. Damit können Sie Ihre Daten, Teams und Kunden auf einer CRM-Plattform verbinden.
Dieses Adobe Experience Platform Ziel nutzt die HubSpot Kontakte-API, um Kontakte innerhalb von HubSpot aus einer bestehenden Experience Platform-Zielgruppe nach der Aktivierung zu aktualisieren.
Anweisungen zur Authentifizierung bei Ihrer HubSpot-Instanz sehen Sie weiter unten im Abschnitt Authentifizieren bei Ziel.
Anwendungsfälle use-cases
Damit Sie besser verstehen können, wie und wann Sie das HubSpot-Ziel verwenden sollten, finden Sie hier ein Anwendungsbeispiel, das für Kundinnen und Kunden von Adobe Experience Platform mit diesem Ziel geeignet ist.
HubSpot Kontakte speichern Informationen über die Personen, die mit Ihrem Unternehmen interagieren. Ihr Team verwendet die in HubSpot vorhandenen Kontakte, um die Experience Platform-Zielgruppen zu erstellen. Nachdem diese Zielgruppen an HubSpot gesendet wurden, werden ihre Informationen aktualisiert und jedem Kontakt wird eine Eigenschaft mit dem Wert als Zielgruppenname zugewiesen, der angibt, zu welcher Zielgruppe der Kontakt gehört.
Voraussetzungen prerequisites
In den folgenden Abschnitten finden Sie alle Voraussetzungen, die Sie für das Einrichten in Experience Platform und HubSpot benötigen, sowie Informationen, die Sie vor der Arbeit mit dem HubSpot-Ziel sammeln müssen.
Voraussetzungen für Experience Platform prerequisites-in-experience-platform
Bevor Sie Daten für das HubSpot-Ziel aktivieren, müssen Sie ein Schema, einen Datensatz und Audiences in Experience Platform erstellt haben.
Weitere Informationen finden Sie in der Experience PlatformDokumentation für die Schemafeldgruppe „Details zur Zielgruppenzugehörigkeit , wenn Sie Anleitungen zu Zielgruppenstatus benötigen.
Voraussetzungen für das HubSpot Ziel prerequisites-destination
Beachten Sie die folgenden Voraussetzungen, um Daten von Platform in Ihr HubSpot-Konto zu exportieren:
Sie müssen über ein HubSpot Konto verfügen prerequisites-account
Um Daten von Platform in Ihr Hubspot-Konto zu exportieren, benötigen Sie ein HubSpot-Konto. Wenn Sie noch kein solches Konto haben, besuchen Sie die Seite HubSpot-Konto einrichten und befolgen Sie die Anweisungen zur Registrierung und Erstellung Ihres Kontos.
Abrufen des Zugriffstokens für die HubSpot private App gather-credentials
Sie benötigen Ihre HubSpot Access token
, damit das HubSpot-Ziel API-Aufrufe über Ihre HubSpot private App in Ihrem HubSpot-Konto durchführen kann. Die Access token
dient als Bearer token
bei der Authentifizierung des Ziels.
Wenn Sie keine private App haben, befolgen Sie die Dokumentation unter Erstellen einer privaten App in HubSpot.
crm.objects.contacts.write
, crm.objects.contacts.read
crm.schemas.contacts.write
, crm.schemas.contacts.read
Bearer token
Access token
Ihrer HubSpot privaten App.Um Ihre HubSpot abzurufen,
Access token
Sie der HubSpot-Dokumentation, um API-Aufrufe mit dem Zugriffstoken Ihrer App durchzuführen.pat-na1-11223344-abcde-12345-9876-1234a1b23456
Leitplanken guardrails
HubSpot private Apps unterliegen Ratenbeschränkungen. Die Anzahl der Aufrufe, die Ihre private App tätigen kann, hängt von Ihrem HubSpot-Kontoabonnement ab und davon, ob Sie das API-Add-on erworben haben. Siehe auch " Beschränkungen.
Unterstützte Identitäten supported-identities
HubSpot unterstützt die Aktualisierung von Identitäten, die in der folgenden Tabelle beschrieben werden. Erhalten Sie weitere Informationen zu Identitäten.
email
test@test.com
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt werden alle Zielgruppen beschrieben, die Sie an dieses Ziel exportieren können.
Dieses Ziel unterstützt die Aktivierung aller durch die Experience Platform generierten Zielgruppen über den Segmentierungsdienst.
Dieses Ziel unterstützt auch die Aktivierung der in der folgenden Tabelle beschriebenen Zielgruppen.
Exporttyp und -häufigkeit export-type-frequency
Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.
- Sie exportieren alle Mitglieder einer Zielgruppe zusammen mit den gewünschten Schemafeldern z. B. E-Mail-Adresse, Telefonnummer, Nachname) entsprechend Ihrer Feldzuordnung.
- Darüber hinaus wird in HubSpot für jede der ausgewählten Zielgruppen eine neue Eigenschaft unter Verwendung des Zielgruppennamen erstellt, deren Wert mit dem entsprechenden Zielgruppenstatus aus Platform geändert wird.
- Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.
Herstellen einer Verbindung mit dem Ziel connect
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Füllen Sie im Workflow zum Konfigurieren des Ziels die Felder aus, die in den beiden folgenden Abschnitten aufgeführt sind.
Suchen Sie in Ziele > Katalog nach HubSpot. Alternativ können Sie es unter der CRM-Kategorie finden.
Beim Ziel authentifizieren authenticate
Füllen Sie die erforderlichen Felder aus. Eine Anleitung dazu finden im Abschnitt HubSpot -Zugriffstoken für private.
- Bearer-Token: Das Zugriffstoken für Ihre HubSpot private App.
Um sich beim Ziel zu authentifizieren, wählen Sie Mit Ziel verbinden.
Wenn die angegebenen Details gültig sind, zeigt die Benutzeroberfläche den Status Verbunden mit einem grünen Häkchen an. Sie können dann mit dem nächsten Schritt fortfahren.
Ausfüllen der Zieldetails destination-details
Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.
- Name: Ein Name, durch den Sie dieses Ziel in Zukunft erkennen können.
- Beschreibung: Eine Beschreibung, die Ihnen hilft, dieses Ziel in Zukunft zu identifizieren.
Aktivieren von Warnhinweisen enable-alerts
Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.
Aktivieren von Zielgruppen für dieses Ziel activate
Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Profilen und Zielgruppen für Streaming-Zielgruppen-Exportziele.
Zuordnen von Attributen und Identitäten map
Um Ihre Zielgruppendaten ordnungsgemäß von Adobe Experience Platform an das HubSpot Ziel zu senden, müssen Sie den Schritt zur Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodells (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.
Gehen Sie wie folgt vor, um Ihre XDM-Felder den HubSpot-Zielfeldern korrekt zuzuordnen:
Zuordnen der Email
Identität
Die Email
Identität ist eine obligatorische Zuordnung für dieses Ziel. Gehen Sie wie folgt vor, um sie zuzuordnen:
- Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird nun eine neue Zuordnungszeile angezeigt.
- Wählen Sie im Fenster Quellfeld auswählen den Identity-Namespace und wählen Sie eine Identität aus.
- Wählen Sie im Fenster Zielfeld auswählen die Option Attribute auswählen und wählen Sie
email
aus.
IdentityMap: Email
Identity: email
Nachfolgend finden Sie ein Beispiel mit der Identitätszuordnung:
Zuordnung optional Attribute
Um weitere Attribute hinzuzufügen, die Sie zwischen Ihrem XDM-Profilschema und Ihrem HubSpot-Konto aktualisieren möchten, wiederholen Sie die folgenden Schritte:
- Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird nun eine neue Zuordnungszeile angezeigt.
- Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und wählen Sie das XDM-Attribut aus.
- Wählen Sie im Fenster Zielfeld auswählen die Kategorie Attribute auswählen und wählen Sie aus der Liste der Attribute aus, die automatisch aus Ihrem HubSpot-Konto ausgefüllt werden. Das Ziel verwendet die HubSpot Properties-API, um diese Informationen abzurufen. Sowohl HubSpot Standardeigenschaften als auch alle benutzerdefinierten Eigenschaften werden zur Auswahl als Zielfelder abgerufen.
Nachfolgend finden Sie einige verfügbare Zuordnungen zwischen Ihrem XDM-Profilschema und Hubspot:
xdm: person.name.firstName
Attribute: firstname
xdm: person.name.lastName
Attribute: lastname
xdm: workAddress.street1
Attribute: address
xdm: workAddress.city
Attribute: city
xdm: workAddress.country
Attribute: country
Nachfolgend finden Sie ein Beispiel für die Verwendung dieser Attributzuordnungen:
Wenn Sie mit dem Eingeben der Zuordnungen für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.
Überprüfen des Datenexports exported-data
Gehen Sie wie folgt vor, um zu überprüfen, ob Sie das Ziel korrekt eingerichtet haben:
-
Melden Sie sich bei der HubSpot-Website an und navigieren Sie dann zur Seite Kontakte, um den Status der Zielgruppe zu überprüfen. Diese Liste kann so konfiguriert werden, dass Spalten für die benutzerdefinierten Eigenschaften angezeigt werden, die mit dem Zielgruppennamen erstellt wurden, wobei deren Wert die Zielgruppenstatus sind.
-
Alternativ können Sie einen Drilldown zu einer einzelnen Person-Seite durchführen und zu den Eigenschaften navigieren, in denen der Zielgruppenname und der Zielgruppenstatus angezeigt werden.
Datennutzung und -Governance data-usage-governance
Alle Adobe Experience Platform-Ziele sind bei der Verarbeitung Ihrer Daten mit Datennutzungsrichtlinien konform. Ausführliche Informationen darüber, wie Adobe Experience Platform Data Governance erzwingt, finden Sie unter Data Governance – Übersicht.
Zusätzliche Ressourcen additional-resources
Weitere nützliche Informationen aus der HubSpot Dokumentation finden Sie unten:
- Authentifizierungsmethoden auf HubSpot
- HubSpot API-Referenzen für die Kontakte und Eigenschaften APIs.
Änderungsprotokoll
In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
Veröffentlichungsmonat | Art der Aktualisierung | Beschreibung |
September 2023 | Erstmalige Veröffentlichung | Erstmalige Zielveröffentlichung und Dokumentation. |