Erstellen und verfolgen Sie benutzerdefinierte Datenattribute (CDAs) über Ihre users und leads, basierend auf Kriterien, die speziell für Ihr Unternehmen gelten. Sie können diese Daten verwenden, um Kunden-Segmente zu filtern und zu erstellen sowie gezielte Nachrichten und Kampagnen zu senden. Sie können sie auch als Qualifikationsdaten verwenden, um leads und Testusers zu qualifizieren.
Was ist ein benutzerdefiniertes Datenattribut?
Ein benutzerdefiniertes Datenattribut (CDA) verfolgt Fakten über Ihre Kunden – wie den Tarif, den jemand hat, oder wann er sich angemeldet hat – im Gegensatz zu einem Ereignis, das wiederkehrende Kunden-Aktionen verfolgt.
Hier ein Beispiel: Wenn Ihr Produkt ein Projektmanagement-Tool ist, könnten Sie Daten über die Anzahl der Dateien verfolgen, die jeder user hat. Wenn Sie dann users ansprechen möchten, die noch keine Dateien zum Tool hinzugefügt haben und möglicherweise Hilfe beim Onboarding benötigen, könnten Sie eine Nachricht an users mit „Dateien weniger als 1“ einrichten.
Die am häufigsten eingerichteten CDAs bei Intercom betreffen die Kundenentwicklung, wie zum Beispiel:
Preistarif
Wert der Einkäufe
Anzahl der hinzugefügten Teammitglieder
Anzahl der abgespielten Songs
Datum, an dem das Abonnement endet
Wichtig:
Der signed_up-Wert sollte über Ihre Integration an Intercom gesendet werden. Dieser Wert gibt die Zeit an, zu der sich ein user für Ihren Service angemeldet hat.
Sie können wählen, den Wert zu aktualisieren durch:
Senden des
created_at-Parameters Zeitstempel im intercomSettings-Snippet.Setzen des Werts für
signed_up_at, wenn Sie unsere REST API verwenden.Verwendung eines CSV-Imports, indem eine der importierten Spalten als Anmeldedatum zugeordnet wird.
Intercom setzt den Wert für das signed_up-Datum nur in folgenden Fällen automatisch:
SDKs (Android/iOS) und nicht identifizierte users
users, die über das JS-Snippet ohne
created_at-Wert erstellt wurden
In diesen Fällen wird die Anmeldezeit auf die Zeit der Erstellungsanfrage gesetzt. In allen anderen Fällen muss der Wert von Ihnen gesetzt werden.
Benutzerdefinierte Datenattribute erstellen
Um ein neues Attribut in Intercom zu erstellen, gehen Sie zu Einstellungen > Daten > Personen und klicken Sie auf + Attribut erstellen. Geben Sie Ihrem neuen Attribut einen Namen, eine Beschreibung und wählen Sie den Datentyp aus, den es speichern soll.
Attribut-Updates über den Messenger verhindern
Wenn "Attribut-Updates" aktiviert sind, werden Aktualisierungen dieses Attributs nur akzeptiert, wenn sie von einer authentifizierten Anfrage stammen (über REST API oder JSON-Web-Token im Messenger). Nicht authentifizierte Anfragen werden ignoriert.
Diese Einstellung kann für jedes Attribut ein- oder ausgeschaltet werden und beeinflusst keine Updates aus anderen Quellen wie unserer Public API, CSV-Imports usw. Alle Attribute, bei denen dies nicht aktiviert ist, sind für unsichere Updates offen.
Hinweis:
Wir empfehlen, "Attribut-Updates" zu aktivieren, um unautorisierte Aktualisierungen Ihrer Daten zu verhindern. Sie können dann Messenger-Sicherheit mit JWTs einrichten, um diese Felder sicher über den Messenger zu aktualisieren.
Attribute sind nur dann vor unsicheren Updates über den Messenger geschützt, wenn die Einstellung für jedes einzelne Attribut aktiviert ist.
Attribut-Updates über den Messenger werden nur verarbeitet, wenn die Anfrage mit JWT authentifiziert ist. Die veraltete Methode der Identitätsprüfung (User hash) funktioniert nicht, und keine Aktualisierung wird für Anfragen verarbeitet, die geschützte Attribute mit user_hash anstelle von JWTs aktualisieren wollen.
Klicken Sie auf Speichern, und das Attribut wird Ihrer Attributliste hinzugefügt. Es wird noch für keinen Ihrer Kunden gefüllt sein, Sie müssen es über das JavaScript-Snippet, die API oder eine App aus unserem App Store an Intercom senden. 👌
Wenn Sie das Format oder die Beschreibung des gerade erstellten Attributs ändern müssen, können Sie es bearbeiten und die Änderung vornehmen:
Wichtig: Der Name des benutzerdefinierten Datenattributs kann nach der Erstellung nicht mehr geändert werden. Sie müssen das bestehende Attribut archivieren und ein neues erstellen.
Benutzerdefinierte Attribute über den Messenger aktualisieren
Benutzerdefinierte Datenattribute können mit dem Messenger-JavaScript-Code-Snippet aktualisiert werden.
Beim Aktualisieren benutzerdefinierter Attribute über den Messenger überprüfen Sie immer, dass Ihre Schlüssel einen JSON-gültigen Wert haben, der ein String (Text), eine Zahl oder ein Boolean (true oder false) ist. Das bedeutet, dass Textstrings in doppelte Anführungszeichen gesetzt werden müssen und NULL gesendet wird, um Fälle abzudecken, in denen kein Wert für einen user existiert.
Sie können uns auch Daten oder URLs senden. Sie können URLs als Textstring verfolgen, z. B. "http://www.google.com". Intercom erkennt dies und macht automatisch einen Hyperlink daraus. Verfolgen Sie Daten, indem Sie uns einen Unix-Zeitstempel in Sekunden senden. Wenn Sie einen Schlüsselname erstellen, der mit „_at“ endet, behandeln wir ihn automatisch als Datum und nicht als Zahl (siehe „last_order_at“ unten). Erfahren Sie hier, wie Daten in Intercom funktionieren.
Wichtig: Stellen Sie sicher, dass Sie UNIX in Sekunden und nicht in Millisekunden übergeben.
Hier sind einige Beispiele für Datenattribut-Schlüssel- und Wertpaare:
window.intercomSettings = {
email: "bob@example.com",
user_id: "123",
app_id: "abc1234",
created_at: 1234567890,
"subdomain": "intercom", // Put quotes around text strings
"teammates": 4, // Send numbers without quotes
"active_accounts": 12,
"last_order_at" : 1350466020, // Send dates in unix timestamp format and end key names with "_at"
"custom_domain": null // Send null when no value exists for a user
}
Wichtig: Verwenden Sie kein custom_attributes: {}-verschachteltes Objekt, wenn Sie CDAs über das Messenger-JS-Snippet übergeben. Dieses Format (z. B. custom_attributes: { lead_source: "Intercom" }) ist nur für die REST API gültig. Wenn es über window.intercomSettings oder window.Intercom("boot", ...) übergeben wird, verwirft der Messenger diese Werte stillschweigend und sie werden im Backend nicht aktualisiert. Übergeben Sie CDAs immer als oberste Schlüssel direkt im Einstellungsobjekt, wie im obigen Beispiel gezeigt. Das Attribut muss auch bereits in Intercom existieren, bevor ein Wert über den Messenger akzeptiert wird.
Verschiedene Arten von CDAs, die Sie an Intercom senden können
String (d. h. Wörter) z. B. URLs, Tarifname, user-Typ usw.
Zahl (Ganzzahl)
Boolean (true / false)
Zeitstempel (Datum und Uhrzeit, wann etwas passiert), z. B. „converted_at“
Dinge, an die Sie denken sollten:
Schlüssel-Namen sind case-sensitive und dürfen keine Punkte ('.'), Dollarzeichen ('$'), Zeichen wie ~`!@#%^&*'{}[]|\'" oder das NULL-Zeichen enthalten. — Wenn ein nicht unterstütztes Zeichen verwendet wird, wird das Attribut mit einem Unterstrich an dieser Stelle erstellt.
Datenwerte müssen als JSON-Strings, Zahlen oder Booleans (true oder false) gesendet werden. Wir können keine Objekte, verschachtelte Hashes oder Array-Datenformate akzeptieren.
Text-String-Werte können nur bis zu 255 Zeichen enthalten. Dies gilt nur für benutzerdefinierte Attribute und nicht für Konversationsdatenattribute.
Sie können bestehende Daten löschen, indem Sie leere Strings senden.
Intercom verfolgt automatisch eine Reihe von Standardattributen. Prüfen Sie diese, bevor Sie benutzerdefinierte Attribute erstellen.
Die Soft-Grenze liegt bei 250 aktiven CDAs.
Zahlenwerte dürfen nicht mit einer "0" beginnen. Ganzzahlen sind ganze Zahlen, daher sollte "01234" als "1234" eingegeben werden. Wenn Sie eine Zahlenfolge erfassen müssen, wie eine Postleitzahl, die mit einer "0" beginnt, sollten Sie stattdessen ein String-Attribut verwenden.
Firmen-„Plan Name“-Attribut: Intercom enthält ein integriertes Systemattribut namens „Plan Name“ für Firmen. Es erscheint nicht in den Einstellungen, wird aber in der Gesprächsseitenleiste angezeigt. Wenn Sie ein benutzerdefiniertes Firmenattribut mit demselben Namen erstellen, werden beide in der Seitenleiste angezeigt – was zu einer scheinbaren Duplizierung führt. Verwenden Sie einen eindeutigen Namen (z. B. „Abonnementplan“), um dies zu vermeiden.
Sobald Sie Ihren Code-Snippet aktualisiert und mit der Datenerfassung begonnen haben, sollten Sie:
Beschreibungen erstellen für jedes Attribut, um Ihren Teammitgliedern das Verständnis zu erleichtern.
Wichtig: Wir erhalten unsere Geolokalisierungsdaten basierend auf der IP-Adresse des Users von einem Drittanbieterdienst namens Maxmind. Wir haben keine Kontrolle über diese Daten, und es ist nicht möglich, sie über die API zu aktualisieren. Sie können jedoch eine Datenkorrekturanfrage über diese Seite stellen, wenn Sie glauben, dass die Daten falsch sind.
Außerdem ist es möglich, dass diese users ein VPN verwenden oder gerade unterwegs sind, was erklärt, warum der Standort falsch erscheint.
Bezüglich des Attributs „region“: Für die Vereinigten Staaten bezieht sich „region“ auf den Bundesstaat. In anderen Ländern kann dies variieren – zum Beispiel bezieht sich „region“ in Kanada auf die Provinz.
Eine Liste aller Regionswerte und deren Abkürzungen finden Sie hier.
Andere Methoden
Es ist auch möglich, benutzerdefinierte Attribute über CSV-Imports, Intercoms REST API oder viele Drittanbieteranwendungen zu verfolgen und zu aktualisieren.
Wichtig: Benutzerdefinierte Datenattribute müssen in Intercom erstellt werden, bevor eine Integration oder Drittanbieter-App deren Werte aktualisieren kann. Integrationen und die REST API können nur die Werte bestehender Attribute aktualisieren – sie können keine neuen Attributdefinitionen erstellen. Um ein neues Attribut hinzuzufügen, gehen Sie zuerst manuell zu Einstellungen > Daten > Personen und erstellen es dort.
Was sind benutzerdefinierte Qualifikationsdaten?
Qualifikationsdaten sind eine spezielle Gruppe von Attributen, die Sie manuell in Ihren Kundenprofilen aktualisieren können, während Sie diese qualifizieren. Sie können diese über ein einfaches Formular in Intercom einrichten. Wenn Sie diese Daten manuell aktualisieren möchten, müssen Sie nichts weiter tun.
Wenn Sie diese Daten per Ping verfolgen möchten, müssen Sie die Schlüssel/Wert-Paare zu Ihrem intercomSettings-Code-Snippet hinzufügen, genau wie bei anderen benutzerdefinierten Daten.
Um neue benutzerdefinierte Qualifikationsdaten zu erstellen, gehen Sie zu Einstellungen > Daten > Personen > Lead-Qualifikation.
Scrollen Sie nach unten und klicken Sie auf Daten hinzufügen und dann im Dropdown-Menü auf + Neue Daten erstellen.
Hier können Sie einen Namen erstellen (das ist Ihr Schlüssel) und ein Format für die Werte auswählen, die Sie sammeln werden (Text, Zahl, Wahr oder Falsch oder Liste).
Wenn Sie das Listenformat wählen, handelt es sich nicht um eine Array-Struktur, sondern um eine Liste von Auswahlmöglichkeiten, bei denen die Werte vorgegeben sind.
Hinweis: Es ist möglich, den Wert eines Listenattributs auf einen Wert zu setzen, den Sie manuell nicht für die Liste konfiguriert haben, indem Sie unsere REST API verwenden. Dieser Wert wird jedoch nicht als permanente Option für diese Liste hinzugefügt, wenn der Wert manuell geändert wird, und kann verloren gehen, wenn ein Teammitglied diesen Wert manuell ändert.
Schließlich können Sie eine Beschreibung hinzufügen, um Ihren Teammitgliedern das Verständnis der Daten zu erleichtern.
Wählen Sie einfache Namen für Ihre benutzerdefinierten Qualifikationsdaten. Wenn Sie sich entscheiden, diese Daten über den Messenger zu qualifizieren, sehen Kunden diese Namen im Messenger.
Wichtig: Manuell auswählbare Dropdown-(Listen-)Attribute in den Personendaten sind auf 35 Optionen pro Attribut begrenzt. Dieses Limit kann nicht aufgehoben werden. Wenn Sie mehr als 35 Werte benötigen, verwenden Sie stattdessen ein Textattribut und setzen Sie die Werte über die REST API.
Datenattribute archivieren
Benutzerdefinierte Datenattribute können nicht vollständig gelöscht werden, aber Sie können sie archivieren. Archivierte Daten erscheinen nicht als Filter in Ihren user- oder lead-Listen, daher ist dies eine gute Möglichkeit, Daten zu bereinigen, die Sie nicht benötigen.
Gehen Sie zu Einstellungen > Daten > Personen.
Wählen Sie ein Datum, das Sie archivieren möchten. Klicken Sie auf das Bearbeitungssymbol daneben und dann im Pop-up-Fenster auf Archivieren. Sie können es wiederherstellen, wenn Sie Ihre Meinung ändern, aber Sie können benutzerdefinierte Datenattribute nicht vollständig löschen.
Um Ihre archivierten benutzerdefinierten Attribute zu finden, scrollen Sie einfach bis zum Ende der Seite.
Wenn Sie Ihr benutzerdefiniertes Attribut wiederherstellen möchten, öffnen Sie das Attribut und klicken Sie auf „Wiederherstellen“.
Verstehen der CDA-Grenzen und bewährten Methoden
Benutzerdefinierte Datenattribute (CDAs) haben Workspace-Grenzen, um eine optimale Leistung zu gewährleisten.
Es gibt ein Limit von 250 People- und Company-CDAs pro Workspace, aber Sie können nicht verwendete Attribute archivieren, um Platz zu schaffen.
Beim Erstellen neuer Attribute sollten Sie diese bewährten Methoden beachten:
Erstellen Sie Attribute, die eine breite Anwendung bei users finden.
Vermeiden Sie es, Attribute für Einzelfälle zu erstellen.
Erwägen Sie die Verwendung von Ereignissen als Alternative für spezifische Szenarien.
Verwenden Sie Tags, wenn es angebracht ist, da sie nicht die gleichen Einschränkungen haben.
Überprüfen Sie regelmäßig Ihre CDA-Nutzung, um eine effiziente Workspace-Verwaltung sicherzustellen. Wenn Sie nach der Umsetzung von Optimierungsstrategien mehr Kapazität benötigen, sind zusätzliche Limit-Erhöhungen auf Anfrage möglich.
Hinweis: Wenn Sie Daten über Ihre users über den Messenger senden, empfehlen wir dringend, Ihren Messenger zu sichern. Weitere Informationen:
FAQs
Wie wird das Attribut „Country“ befüllt und wie schnell wird es für workflows aktualisiert?
Wie wird das Attribut „Country“ befüllt und wie schnell wird es für workflows aktualisiert?
Das Attribut „Country“ wird automatisch basierend auf der IP-Adresse des users befüllt und aktualisiert. Dies geschieht sofort, wenn ein user in Ihrer App aktiv ist oder mit dem Messenger interagiert. Da die Daten in Echtzeit verfügbar sind, können Sie sie verwenden, um einen workflow sofort zu verzweigen, sobald ein user ein Gespräch beginnt.
Kann das Attribut „Country“ manuell bearbeitet werden?
Kann das Attribut „Country“ manuell bearbeitet werden?
Nein, das Attribut „Country“ ist ein systemgeneriertes Feld und kann nicht manuell bearbeitet werden. Wenn Sie ein Länderfeld benötigen, das manuell von einem user oder einem Admin aktualisiert werden kann, sollten Sie dafür ein benutzerdefiniertes Attribut erstellen.
Warum schlagen meine API-Aktualisierungen eines benutzerdefinierten Attributs fehl, wenn ich die Jira-Integration verwende?
Warum schlagen meine API-Aktualisierungen eines benutzerdefinierten Attributs fehl, wenn ich die Jira-Integration verwende?
API-Aktualisierungen von benutzerdefinierten Attributen können stillschweigend fehlschlagen, wenn ein benutzerdefiniertes Attribut denselben Namen wie ein Jira-Attribut hat. Wenn doppelte Namen existieren, werden API-Aktualisierungsanfragen an das Jira-Attribut statt an Ihr benutzerdefiniertes Attribut weitergeleitet – und Aktualisierungen von Jira-Attributen werden blockiert, was zum Fehlschlag der Anfrage führt.
Um dies zu beheben, benennen Sie Ihr benutzerdefiniertes Attribut um, sodass es keinen Jira-Attributnamen dupliziert. Beachten Sie, dass benutzerdefinierte Attributnamen nach der Erstellung nicht geändert werden können, daher müssen Sie das bestehende Attribut archivieren und ein neues mit einem eindeutigen Namen erstellen.