DokumentationExperience PlatformZielhandbuch

HubSpot-Verbindung

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

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.

IMPORTANT
Der privaten App sollten die folgenden Bereiche zugewiesen werden:
crm.objects.contacts.write, crm.objects.contacts.read
crm.schemas.contacts.write, crm.schemas.contacts.read
Anmeldedaten
Beschreibung
Beispiel
Bearer token
Die 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.

Ziel-Identität
Beispiel
Beschreibung
Zu beachten
email
test@test.com
E-Mail-Adresse des Kontakts.
Obligatorisch

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.

Zielgruppentyp
Beschreibung
Benutzerdefinierte Uploads
Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

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.

Element
Typ
Anmerkungen
Exporttyp
Profilbasiert
  • 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.
Exporthäufigkeit
Streaming
  • 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

IMPORTANT
Um eine Verbindung mit dem Ziel herzustellen, benötigen Sie Ziele anzeigen und Ziele verwalten Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle – Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.

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.
Screenshot der Platform-Benutzeroberfläche, auf dem die Authentifizierung gezeigt wird.

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.
Screenshot der Platform-Benutzeroberfläche mit den Zieldetails.

  • 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

IMPORTANT
Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen ​Zugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.

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:

  1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird nun eine neue Zuordnungszeile angezeigt.
    Screenshot der Platform-Benutzeroberfläche mit hervorgehobener Schaltfläche „Neue Zuordnung hinzufügen“.
  2. Wählen Sie im Fenster Quellfeld auswählen den Identity-Namespace und wählen Sie eine Identität aus.
    Screenshot der Platform-Benutzeroberfläche mit Auswahl von E-Mail als Quellattribut, das als Identität zugeordnet werden soll.
  3. Wählen Sie im Fenster Zielfeld auswählen die Option Attribute auswählen und wählen Sie email aus.
    Screenshot der Platform-Benutzeroberfläche mit Auswahl von E-Mail als Zielattribut, das als Identität zugeordnet werden soll.
Quellfeld
Zielfeld
Obligatorisch
IdentityMap: Email
Identity: email
Ja

Nachfolgend finden Sie ein Beispiel mit der Identitätszuordnung:
Beispiel-Screenshot der Platform-Benutzeroberfläche mit E-Mail-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:

  1. Wählen Sie Im Schritt Zuordnung die Option Neue Zuordnung hinzufügen aus. Auf dem Bildschirm wird nun eine neue Zuordnungszeile angezeigt.
    Screenshot der Platform-Benutzeroberfläche mit hervorgehobener Schaltfläche „Neue Zuordnung hinzufügen“.
  2. Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und wählen Sie das XDM-Attribut aus.
    Screenshot der Platform-Benutzeroberfläche mit Auswahl von Vorname als Quellattribut.
  3. 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.
    Screenshot der Platform-Benutzeroberfläche mit Auswahl von Vorname als Zielattribut.

Nachfolgend finden Sie einige verfügbare Zuordnungen zwischen Ihrem XDM-Profilschema und Hubspot:

Quellfeld
Zielfeld
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:
Beispiel-Screenshot der Platform-Benutzeroberfläche mit 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:

  1. 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.
    Screenshot der HubSpot-Benutzeroberfläche mit der Seite „Kontakte“ mit Spaltenüberschriften, die den Namen der Zielgruppe und die Zellen des Zielgruppenstatus enthalten

  2. 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.
    Screenshot der HubSpot-Benutzeroberfläche mit der Kontaktseite mit benutzerdefinierten Eigenschaften, auf der 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:

Änderungsprotokoll

In diesem Abschnitt werden aktualisierte Funktionen und wesentliche Dokumentationsänderungen für diesen Ziel-Connector erfasst.

Änderungsprotokoll anzeigen
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.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6