CRM-Objektdaten in CMS Hub verwenden

Last updated:

Sie können CRM-Objekte abfragen, um Daten aus den Datensätzen des Objekts in den von HubSpot gehosteten Inhalten zu verwenden, sodass Daten zwischen Ihren Geschäftsprozessen, Ihrer Website und Ihren E-Mails ausgetauscht werden können. Unter Verwendung der HubL-Funktionen crm_object, crm_objects und crm_associations können Sie die Logik auf der Grundlage Ihrer CRM-Objektdaten anzeigen und steuern. 

Die Verwendung von CRM-Daten auf Ihrer Website bedeutet, dass Ihre Vertriebs-, Marketing- und Website-Daten alle am selben Ort sind und immer dieselben Informationen enthalten. Und da Sie CRM-Datensätze miteinander verknüpfen können, können Sie auch die zugehörigen Daten auf Ihre Webseiten holen.

Ebenso können Sie Sätze dynamischer Seiten erstellen, die automatisch aus CRM-Objekt- oder HubDB-Daten generiert werden.

Weitere Informationen zum Erstellen datenbasierter CMS-Seiten finden Sie im Kurs zu CMS-datengestütztem Content der HubSpot Academy.

Anwendungsfall als Beispiel

Ein Beispiel für die Verwendung von CRM-Objektdaten in Seiten ist eine Seite mit Immobilienangeboten. Mit einem benutzerdefinierten Objekt namens property können für jedes Haus, das aufgelistet werden soll, individuelle Objektdatensätze erstellt werden. Immobilienmakler können dann Informationen zu Objekteigenschaften hinzufügen, um Details wie Standort, Anzahl der Schlafzimmer und Preisvorstellungen zu speichern. 

Die Website-Seiten können dann diese Daten für jede Immobilie übernehmen, um eine Angebotsseite und Detailseiten für jede Immobilie zu erstellen. 

Besuchen Sie das GitHub-Repository , um das vollständige Beispiel zu sehen.

Einen Überblick über dieses Beispiel finden Sie in der Aufzeichnung des HubSpot Developer Day 2020. 

Unterstützte CRM-Objekttypen

Im Folgenden sind die Typen von CRM-Objekten aufgeführt, aus denen Sie Daten für Ihre CMS Hub-Seiten abrufen können. Ob Sie die Daten auf allen Seiten oder nur auf privaten Seiten verwenden können, hängt vom Objekttyp ab.

In den folgenden Tabellen erfahren Sie, welche Objekttypen für CMS-Content zur Verfügung stehen und wie deren Objekttypnamen und vollständig qualifizierten Namen lauten. 

Bitte beachten: Bei Standardobjektnamen wie „Kontakt“ wird nicht zwischen Groß- und Kleinschreibung unterschieden, sie müssen jedoch in der Singularform angegeben werden.

Für alle Seiten verfügbare CRM-Objektdaten

Daten aus den folgenden CRM-Objekten können auf jeder CMS-Seite verwendet werden.

Objekttyp object_type name Vollständig qualifizierter Name
Produkte product PRODUCT
Marketing-Events marketing_event MARKETING_EVENT
Benutzerdefinierte Objekte

Nur Sales Hub Enterprise

Sie können entweder den vollständig qualifizierten Namen des Objekts oder den Namen verwenden, der zum Zeitpunkt der Erstellung eingegeben wurde. Wenn Sie beispielsweise ein Objekt mit dem Namen „Autos“ erstellen, können Sie es nicht mit „autos“ oder „Auto“ referenzieren.

Sie müssen den vollständig qualifizierten Namen verwenden, wenn das benutzerdefinierte Objekt einen Namen mit einem Standardobjekt teilt.

 

Für private Seiten verfügbare CRM-Objektdaten

Daten aus den folgenden CRM-Objekten können nur auf Seiten verwendet werden, die entweder ein Passwort oder eine Mitgliederanmeldung erfordern.

Objekttyp object_type name  VOLLSTÄNDIG QUALIFIZIERTER NAME
Kontakte contact CONTACT
Unternehmen company COMPANY
Deals deal DEAL
Tickets ticket TICKET
Angebote quote QUOTE
Integratorobjekte

Um den Namen eines Integratorobjekts abzurufen, verwenden Sie die CRM-Objektschema-API.

Für Integratorobjekte, die den gleichen Namen wie die Standardobjekte haben, verwenden Sie den vollständig qualifizierten Namen des Integratorobjekts.

 

Daten von einem einzelnen CRM-Datensatz mithilfe der crm_object-Funktion anzeigen

Verwenden Sie die crm_object-Funktion, um einen einzelnen Datensatz aus dem CRM von HubSpot über eine Abfrage oder anhand der CRM-Datensatz-ID abzurufen. 

Objektdatensätze werden als ein Dictionary von Eigenschaften und Werten zurückgegeben.

{# Render custom object by query #} {% set event = crm_object("event", "name=Defensive Health") %} {{ event.name }} {# Render custom objects specifying the id of the object #} {% set event = crm_object("event", 289236) %} {{ event.name }}<p>Defensive Heatlh</p> <p>Defensive Heatlh</p>

Wenn eine Abfrage eine Sammlung von Datensätzen zurückgibt, gibt die Funktion den ersten Datensatz in der Sammlung zurück.

Daten von mehreren CRM-Datensätzen mithilfe der crm_object-Funktion anzeigen

Verwenden Sie die crm_objects()-Funktion, um CRM-Datensätze nach Objekttyp aus dem HubSpot CRM über eine Abfrage oder anhand der CRM-Datensatz-ID abzurufen. Datensätze werden als ein Dictionary von Eigenschaften und Werten zurückgegeben.

Der zurückgegebene Datensatz enthält eine results-Eigenschaft, die in einer Schleife durchlaufen werden kann, um die Informationen in den Elementen des Datensatzes anzuzeigen.

{# Render custom objects by query #} {% set events = crm_objects("event", "limit=3&type=virtual") %} <h3>{{events.total}} New Events:<h3> <ul> {% for event in events.results %} <li>Name: {{ event.name }}</li> {% endfor %} <ul> {# Render custom objects by ids #} {% set events = crm_objects("event", [289236,289237,289238]) %} <h3>{{events.total}} New Events:<h3> <ul> {% for event in events.results %} <li>Name: {{ event.name }}</li> {% endfor %} <ul> <h3>3 New Events:<h3> <ul> <li>Name: Defensive Health</li> <li>Name: Body Balance</li> <li>Name: Happy Heart</li> <ul> <h3>3 New Events:<h3> <ul> <li>Name: Defensive Health</li> <li>Name: Body Balance</li> <li>Name: Happy Heart</li> <ul>

Verknüpfte Datensätze anzeigen

Verwenden Sie die HubL-Funktion crm_associations, um eine Liste der verknüpften Datensätze aus dem CRM von HubSpot abzurufen, die auf der angegebenen Datensatz-ID, der Verknüpfungskategorie und der ID der Verknüpfungsdefinition basiert.

Datensätze werden als ein Dictionary von Eigenschaften und Werten zurückgegeben.

{% set associated_objects = crm_associations(289236, "USER_DEFINED", 3) %} <h3>Contacts Associated With Event</h3> <ul> {% for contact in associated_objects.results %} <li>Name: {{ contact.firstname }} {{ contact.lastname }}</li> {% endfor %} </ul> <h3>Contacts Associated With Event<h3> <ul> <li>Name: Brian Halligan</li> <li>Name: Dharmesh Shah</li> <li>Name: Yamini Rangan</li>

Abrufen der Details eines benutzerdefinierten Objekttyps

Um name, id, fullyQualifiedName, Verknüpfungs-IDs und andere Details eines benutzerdefinierten Objekttyps abzurufen, können Sie eine GET-Anfrage an die CRM-Objektschema-API vornehmen.

Bitte beachten: fullyQualifiedName für account-spezifische Objekttypen enthält die HubSpot-Account-ID. Sie sollten daher vermeiden, diesen zu verwenden, wenn Sie Ihren Code für mehrere HubSpot-Accounts entwickeln.

CRM-Objektmodulfeld

Um Content-Autoren die Möglichkeit zu geben, CRM-Datensätze zur Anzeige oder zum Ausführen von Logik auszuwählen, können Sie Module erstellen, die das CRM-Objektfeld enthalten.

So können Sie beispielsweise Informationen zu einem bestimmten Produkt, Kontakt, Unternehmen, Deal, Angebot, Ticket oder benutzerdefinierten Objekt anzeigen.

CRM-Objektfeld

Tutorials und Ressourcen zu HubDB-Objekten

War dieser Artikel hilfreich?
Dieses Formular dient dazu, Feedback zu unserer Entwicklerdokumentation zu sammeln. Wenn Sie uns Ihre Meinung zu HubSpot-Produkten mitteilen möchten, teilen Sie diese bitte im Ideenforum der Community.