Kontoobjekte

Verwenden Sie Kontoobjekte, um Messaging mit Kontodaten zu segmentieren und zu personalisieren.

Mit Kontoobjekten können Sie:

• Segmente mit Kontokriterien erstellen
• Nachrichten mit Kontoattributen über Liquid personalisieren
• Kontodatensätze an einem Ort verwalten

Kontoobjekte sind Datenmodelle auf Workspace-Ebene, die mit Nutzerprofilen verknüpft sind. Ein Kontodatensatz ist ein bestimmtes Konto mit den zugehörigen Felddaten. Verwenden Sie Kontoobjekte, wenn Kontokontext, wie z. B. Unternehmensattribute, Ihnen beim Targeting und bei der Personalisierung von Messaging hilft. Sie können auch Kontohierarchien modellieren (z. B. übergeordnete und untergeordnete Konten) und ein Nutzerprofil mit mehreren Konten verknüpfen.

Warum Account-Objekte verwenden?

Einige Anwendungsfälle erfordern Kontext auf Account-Ebene, selbst wenn Ihre Campaigns und Canvases an einzelne Nutzer:innen gesendet werden.

Mit Account-Objekten können Sie Account-Daten einmal speichern und sie in ganz Braze für Segmentierung und Personalisierung wiederverwenden.

Damit können Sie:

• Nach Account-Attributen segmentieren
• Nachrichten mit gemeinsamem Account-Kontext personalisieren (z. B. Firmenname oder Branche)
• Beziehungen zwischen Accounts abbilden und ein Nutzerprofil mit mehreren Accounts verknüpfen

So müssen Sie dieselben Account-Attribute nicht mehr in vielen Nutzerprofilen duplizieren.

Voraussetzungen

Bevor Sie beginnen:

• Ihr Workspace muss für Accounts bereitgestellt sein. Accounts ist zwar allgemein verfügbar, Sie müssen die Bereitstellung jedoch anfordern, bevor Sie die Funktion im Dashboard oder über die Data-Objects-Endpunkte nutzen können. Die einzelnen Schritte finden Sie unter Schritt 1: Accounts aktivieren.
• In Braze müssen bereits Nutzer:innen vorhanden sein.

Konto-Datenmodell

Jedes Konto benötigt einen Bezeichner (id) und einen Namen (name).

Die Kontofelder in diesem Abschnitt definieren das Schema des Account-Objekts. Diese Felder gelten für jeden einzelnen Kontodatensatz, den Sie in Braze speichern.

Braze enthält standardmäßig Account-Objekte mit Standardfeldern. Sie können je nach Anwendungsfall angepasste Felder hinzufügen und entfernen. Die Feldnamen id, object_id und display_name sind reserviert, daher können Sie sie nicht als Namen für angepasste Felder verwenden.

Optionen für die Datenintegration

Sie können Kontodatensätze auf folgende Weise verwalten:

• REST API-Endpunkte für Kontodatensätze
• Bearbeitung einzelner Datensätze direkt im Browser unter Dateneinstellungen > Konten

Erste Schritte

Schritt 1: Accounts aktivieren

Accounts wird auf Unternehmensebene aktiviert. So beantragen Sie die Bereitstellung:

1. Gehen Sie im Braze-Dashboard zu Dateneinstellungen > Accounts.
2. Füllen Sie den Fragebogen aus.

Nachdem Sie den Fragebogen abgeschickt haben, wird er zur Prüfung an Braze weitergeleitet. Sie sollten innerhalb einer Woche eine Antwort erhalten. Bei Anwendungsfällen mit hohem Volumen kann es länger dauern.

Sobald die Bereitstellung abgeschlossen ist, gehen Sie zu Dateneinstellungen > Accounts und schließen Sie den einmaligen Initialisierungsablauf ab, falls Sie dazu aufgefordert werden.

Schritt 2: Account-Datensätze hinzufügen

Fügen Sie Account-Datensätze über die REST API oder die Bearbeitung im Browser hinzu oder aktualisieren Sie sie.

Schritt 3: Berechneten Filter für Account-Kriterien erstellen

Bevor Sie auf Basis von Account-Daten segmentieren, erstellen Sie einen berechneten Filter, der Ihre Account-Kriterien definiert:

1. Gehen Sie zu Zielgruppe > Berechnete Filter.
2. Wählen Sie Filter erstellen und anschließend Datenobjekt-Filter aus.
3. Definieren Sie Ihre Account-Kriterien.

Weitere Informationen finden Sie unter Berechnete Filter.

Schritt 4: Berechneten Filter im Segment Builder verwenden

Wählen Sie im Segment Builder den von Ihnen erstellten berechneten Filter aus und fügen Sie anschließend weitere Filter für Nutzerattribute hinzu, die das Targeting Ihrer Campaign oder Ihres Canvas unterstützen.

Limits

Accounts umfasst die folgenden Standardlimits, die die meisten Anwendungsfälle abdecken:

Diese Werte sind Anfangskapazitäten. Wenn Sie mehr Account-Datensätze oder ein höheres Limit benötigen, wenden Sie sich an Ihr Braze-Account-Team, um eine Erhöhung anzufragen.

Informationen zu Fehlercodes bei Limits und dazu, was passiert, wenn eine API-Anfrage ein Limit überschreiten würde, finden Sie unter Produktlimits.

Kontobasierte Segmente erstellen

Sobald Ihre Kontodatensätze und Ihr berechneter Filter bereit sind:

1. Gehen Sie zum Segment Builder.
2. Fügen Sie Ihren vorkonfigurierten berechneten Filter für Kontokriterien hinzu.
3. Fügen Sie bei Bedarf weitere Filter für Nutzerattribute hinzu.
4. Speichern Sie Ihr Segment.

Zum Beispiel:

• Berechneter Filter: Konto-industry ist genau healthcare
• Filter für Nutzerattribute: days_since_last_login ist kleiner als 30

Personalisierung mit Liquid

Verwenden Sie den Liquid-Tag {% data_object account %}, um Kontodaten für Nutzer:innen in das Array data_objects zu laden.

Hinweis

Wenn Sie Vorschau und Test verwenden, nutzen Sie ein Segment, das Kontodaten enthält, damit die Personalisierung korrekt aufgelöst werden kann.

1
2
3

{% data_object account %}
Hi {{${first_name}}},
We'd love to invite you and your peers at {{ data_objects[0].name }}.

So iterieren Sie über alle zugeordneten Konten:

1
2
3
4

{% data_object account %}
{% for acct in data_objects %}
- {{ acct.name }}
{% endfor %}

API-Grundlagen

Sie können die REST API verwenden, um Kontodatensätze zu verwalten.

Details zu den Endpunkten finden Sie unter Endpunkte für Datenobjekte.

Informationen zur Authentifizierung und zu den Grundlagen der REST-Endpunkte finden Sie in der Übersicht über die Braze API.

Häufig gestellte Fragen

Kann ich Accounts angepasste Felder hinzufügen?

Ja. Sie können angepasste Account-Felder in Ihrem Workspace festlegen und verwalten. Die Anforderungen an die Felder finden Sie unter Datenmodell für Accounts.

Ist Accounts ein kostenpflichtiges Add-on?

Nein. Accounts ist kein kostenpflichtiges Add-on und steht in allen Tarifen zur Verfügung. Ihr Workspace muss jedoch bereitgestellt sein, bevor Sie Accounts nutzen können. Die einzelnen Schritte finden Sie unter Schritt 1: Accounts aktivieren.