DokumentationExperience PlatformZielhandbuch

HubSpot-Verbindung

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
  • Benutzende

HubSpot ist eine CRM-Plattform mit allen Software, Integrationen und Ressourcen, die Sie für die Verbindung von Marketing, Vertrieb, Content Management und Kundendienst benötigen. Dadurch 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 nach der Aktivierung von einer bestehenden Experience Platform-Audience 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 Kontakte, 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 in Experience Platform und HubSpot einrichten müssen, sowie Informationen, die Sie vor der Arbeit mit dem HubSpot-Ziel erfassen müssen.

Voraussetzungen für Experience Platform prerequisites-in-experience-platform

Bevor Sie Daten für das Ziel HubSpot aktivieren, müssen Sie über ein Schema, einen Datensatz und Zielgruppen verfügen, die in Experience Platform erstellt wurden.

Informationen zum Zielgruppenstatus finden Sie in der Experience Platform-Dokumentation für die Schemakonferenz Zielgruppenzugehörigkeitsdetails .

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 Konto haben, besuchen Sie die Seite Einrichten Ihres HubSpot-Kontos und befolgen Sie die Anweisungen zum Registrieren und Erstellen Ihres Kontos.

Erfassen des Zugriffs-Tokens für die private App HubSpot gather-credentials

Sie benötigen Ihre HubSpot Access token, damit das HubSpot-Ziel API-Aufrufe über Ihre HubSpot private App innerhalb Ihres HubSpot-Kontos tätigen kann. Die Access token dient als Bearer token, wenn Sie das Ziel authentifizieren.

Wenn Sie keine private App haben, befolgen Sie die Dokumentation zu 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 privaten HubSpot App.
Um Ihre HubSpot Access token zu erhalten, befolgen Sie die 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 den Ratenbeschränkungen. Die Anzahl der Aufrufe, die Ihre private App tätigen kann, hängt von Ihrem HubSpot -Kontoabonnement und davon ab, ob Sie das API-Add-on erworben haben. Weitere Informationen finden Sie unter Sonstige 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
Email-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) gemäß Ihrer Feldzuordnung.
  • Darüber hinaus wird in HubSpot eine neue Eigenschaft mit dem Zielgruppennamen erstellt und ihr Wert weist für jede der ausgewählten Zielgruppen den entsprechenden Zielgruppenstatus von Platform auf.
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 zum Ziel herzustellen, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen und Ziele verwalten .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 Sie im Abschnitt Zugriffstoken für private Apps sammeln HubSpot 2} .

  • Trägertoken: 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
Um Daten zu aktivieren, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen .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 korrekt von Adobe Experience Platform an das Ziel HubSpot zu senden, müssen Sie den Schritt für die Feldzuordnung durchlaufen. Die Zuordnung besteht darin, eine Verknüpfung zwischen den Schemafeldern Ihres Experience-Datenmodell (XDM) in Ihrem Platform-Konto und den entsprechenden Entsprechungen vom Ziel zu erstellen.

Gehen Sie wie folgt vor, um Ihre XDM-Felder korrekt den HubSpot -Zielfeldern 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 jetzt eine neue Zuordnungszeile angezeigt.
    Screenshot der Platform-Benutzeroberfläche mit hervorgehobener Schaltfläche zum Hinzufügen einer neuen Zuordnung.
  2. Wählen Sie im Fenster Quellfeld auswählen den Namen Identitäts-Namespace auswählen und wählen Sie eine Identität aus.
    Screenshot der Platform-Benutzeroberfläche, in dem E-Mail als Quellattribut ausgewählt wird, das als Identität zugeordnet werden soll.
  3. Wählen Sie im Fenster Zielfeld auswählen die Option Attribute auswählen und danach email aus.
    Screenshot der Platform-Benutzeroberfläche, in dem E-Mail als Zielattribut ausgewählt wird, das als Identität zugeordnet werden soll.
Quellfeld
Zielfeld
Obligatorisch
IdentityMap: Email
Identity: email
Ja

Nachfolgend finden Sie ein Beispiel mit der Identitätszuordnung:
Screenshot der Platform-Benutzeroberfläche mit E-Mail-Identitätszuordnung.

Zuordnen von optionalen Attributen

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 jetzt eine neue Zuordnungszeile angezeigt.
    Screenshot der Platform-Benutzeroberfläche mit hervorgehobener Schaltfläche zum Hinzufügen einer neuen Zuordnung.
  2. Wählen Sie im Fenster Quellfeld auswählen die Kategorie Attribute auswählen und danach das XDM-Attribut aus.
    Screenshot der Platform-Benutzeroberfläche, in dem Vorname als Quellattribut ausgewählt wird.
  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 gefüllt werden. Das Ziel verwendet die API HubSpot Eigenschaften , um diese Informationen abzurufen. Sowohl HubSpot Standardeigenschaften als auch benutzerdefinierte Eigenschaften werden zur Auswahl als Zielfelder abgerufen.
    Screenshot der Platform-Benutzeroberfläche zur Auswahl des Vornamens 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:
Screenshot der Platform-Benutzeroberfläche mit Attributzuordnungen.

Wenn Sie die Zuordnungen für Ihre Zielverbindung bereitgestellt haben, wählen Sie Weiter aus.

Ü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 Zielgruppenstatus 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 ihr Wert dem Zielgruppenstatus entspricht.
    HubSpot UI-Screenshot mit der Seite Kontakte mit Spaltenüberschriften, die den Zielgruppennamen und den Status der Zellen-Zielgruppe anzeigen

  2. Alternativ können Sie einen Drilldown zu einer einzelnen Seite mit dem Namen Person durchführen und zu den Eigenschaften navigieren, die den Zielgruppennamen und den Zielgruppenstatus anzeigen.
    HubSpot UI-Screenshot mit der Kontaktseite mit benutzerdefinierten Eigenschaften, die den Zielgruppennamen und den Zielgruppenstatus anzeigen.

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 Erste Zielversion und Veröffentlichung der Dokumentation.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6