Auf dieser Seite: Konfigurieren Sie ein unitäres Ereignis, damit Sie für eine bestimmte Person in Echtzeit auf Grundlage ihres Verhaltens eine Journey auslösen können, z. B. bei einem Kauf oder einem Treuemeilenstein.
Unitäre Ereignisse sind mit einem bestimmten Profil verknüpft. Sie können regelbasiert oder systemgeneriert sein. Mehr über unitäre Ereignisse erfahren Sie in diesem Abschnitt.
Nachfolgend finden Sie die ersten Schritte zum Konfigurieren eines neuen Ereignisses:
-
Navigieren Sie im Menüabschnitt „VERWALTUNG“ zu Konfigurationen und klicken Sie im Abschnitt Ereignisse auf Verwalten. Die Liste der Ereignisse wird angezeigt.
-
Klicken Sie auf Ereignis erstellen, um ein neues Ereignis zu erstellen. Der Bereich für die Ereigniskonfiguration wird auf der rechten Seite des Bildschirms geöffnet.
-
Geben Sie den Namen Ihres Ereignisses ein. Sie können auch eine Beschreibung hinzufügen.
note NOTE Es sind nur alphanumerische Zeichen und Unterstriche zulässig. Die maximale Länge beträgt 30 Zeichen.
-
Wählen Sie im Feld Typ die Option Unitär.
-
Wählen Sie im Feld Ereignis-ID-Typ den zu verwendenden Ereignistyp aus: Regelbasiert oder Systemgeneriert. Weitere Informationen zum Ereignis-ID-Typ finden Sie in diesem Abschnitt.
-
Die Anzahl der Journeys, die dieses Ereignis verwenden, wird im Feld Verwendet in angezeigt. Sie können auf Customer Journeys anzeigen klicken, um die Liste der Journeys mit diesem Ereignis anzuzeigen.
-
Definieren Sie das Schema und die Payload-Felder: Hier wählen Sie die Ereignisinformationen aus (normalerweise als Payload bezeichnet), die Journeys voraussichtlich empfangen. Anschließend können Sie diese Informationen in Ihrer Journey verwenden. Weitere Informationen finden Sie in diesem Abschnitt.
note NOTE Wenn Sie den Typ Systemgeneriert auswählen, sind nur Schemata mit dem Feld vom Typ „eventID“ verfügbar. Bei Auswahl des regelbasiert Typs können Sie jedes in Ihrer Sandbox verfügbare Erlebnisereignisschema auswählen. -
Klicken Sie bei regelbasierten Ereignissen in das Feld Ereignis-ID-Bedingung. Mit dem einfachen oder erweiterten Ausdruckseditor definieren Sie eine Bedingung, anhand derer das System die Ereignisse identifiziert, die Ihre Journey auslösen.
In unserem Beispiel haben wir eine Bedingung basierend auf der Stadt des Profils verwendet. Dies bedeutet, dass das System jedes Mal, wenn es ein Ereignis empfängt, das dieser Bedingung entspricht (Feld Stadt und Wert Paris), dieses an Journeys weiterleitet.
note NOTE Im einfachen Ausdruckseditor sind nicht alle Operatoren verfügbar. Sie hängen vom Datentyp ab. Beispielsweise können Sie für ein Feld vom Typ Zeichenfolge „enthält“ oder „ist gleich“ verwenden. Wenn Sie Ihr Schema nach der Erstellung des Ereignisses durch neue Aufzählungswerte ändern, müssen Sie die folgenden Schritte ausführen, um die Änderungen auf das vorhandene Ereignis anzuwenden: Heben Sie die Auswahl des Aufzählungsfelds in den Ereignisfeldern auf, bestätigen Sie die Auswahl und wählen Sie das Aufzählungsfeld erneut aus. Der neue Aufzählungswert wird jetzt angezeigt. -
Fügen Sie einen Identitätstyp hinzu. Es definiert den Schlüsseltyp, den das Ereignis hat. Dieser Schritt ist erforderlich, wenn Sie die im Echtzeit-Kundenprofil-Service gespeicherten Informationen nutzen möchten. Andernfalls ist dies optional. Weiterführende Informationen finden Sie in diesem Abschnitt.
-
Profilkennung definieren: Wählen Sie ein Feld aus Ihren Payload-Feldern aus oder definieren Sie eine Formel, um die mit dem Ereignis verbundene Person zu identifizieren. Dieser Schlüssel wird automatisch eingerichtet (kann aber weiterhin bearbeitet werden), wenn Sie einen Identitätstyp auswählen. Journeys wählt den Schlüssel aus, der dem Identitätstyp entsprechen soll (wenn Sie beispielsweise einen E-Mail-Identitätstyp auswählen, wird der E-Mail-Schlüssel ausgewählt). Weiterführende Informationen finden Sie in diesem Abschnitt.
-
Klicken Sie auf Speichern.
Das Ereignis ist jetzt konfiguriert und kann in einer Journey abgelegt werden. Für den Empfang von Ereignissen sind zusätzliche Konfigurationsschritte erforderlich. Weitere Informationen finden Sie auf dieser Seite.
Definieren der Payload-Felder define-the-payload-fields
Mit der Payload-Definition können Sie die Informationen auswählen, die das System vom Ereignis in Ihrer Journey erwartet, sowie den Schlüssel zum Identifizieren der mit dem Ereignis verbundenen Person. Die Payload basiert auf der Experience Cloud-XDM-Felddefinition. Weitere Informationen zu XDM finden Sie in der Dokumentation zu Adobe Experience Platform.
-
Wählen Sie ein XDM-Schema aus der Liste aus und klicken Sie auf das Feld Felder oder das Symbol Bearbeiten.
Alle im Schema definierten Felder werden angezeigt. Die Liste der Felder variiert von Schema zu Schema. Sie können nach einem bestimmten Feld suchen oder die Filter verwenden, um alle Knoten und Felder oder nur die ausgewählten Felder anzuzeigen. Gemäß der Schemadefinition können einige Felder obligatorisch und vorausgewählt sein. Sie können die Auswahl nicht aufheben. Alle Felder, die für den korrekten Empfang des Ereignisses durch Journeys erforderlich sind, sind standardmäßig ausgewählt.
note NOTE Für systemgenerierte Ereignisse: - Stellen Sie sicher, dass Sie die
orchestration-Feldergruppe zum XDM-Schema hinzugefügt haben. Dadurch wird sichergestellt, dass Ihr Schema alle für die Arbeit mit Journey Optimizer erforderlichen Informationen enthält. - Das Feld eventID wird automatisch in die Liste der ausgewählten Felder eingefügt, damit Journey Optimizer das Ereignis identifizieren kann. Das System, das das Ereignis per Push sendet, sollte keine ID generieren, sondern stattdessen die ID verwenden, die in der Payload-Vorschau verfügbar ist. Weitere Informationen
- Stellen Sie sicher, dass Sie die
-
Wählen Sie die Felder aus, die Sie vom Ereignis erwarten. Dies sind die Felder, die der Business-Anwender in der Journey nutzen wird. Sie müssen auch den Schlüssel enthalten, mit dem die mit dem Ereignis verbundene Person identifiziert werden kann (siehe diesen Abschnitt).
-
Wenn Sie die erforderlichen Felder ausgewählt haben, klicken Sie auf OK oder drücken Sie die Eingabetaste.
Die Anzahl der ausgewählten Felder wird im Feld Felder angezeigt.
Wählen Sie den Identitätstyp aus. select-the-namespace
Mit dem Identitätstyp (früher als „Namespace“ bezeichnet) können Sie den Schlüsseltyp definieren, mit dem die mit dem Ereignis verbundene Person identifiziert wird. Diese Konfiguration ist erforderlich, wenn Sie in Ihren Journey zusätzliche Informationen aus dem Echtzeit-Kundenprofil) möchten. Andernfalls ist dies optional. Der Identitätstyp muss nicht definiert werden, wenn Sie nur Daten aus einem Drittanbietersystem über eine benutzerdefinierte Datenquelle verwenden.
Sie können entweder einen vorhandenen Identitätstyp auswählen oder mit dem Adobe Experience Platform Identity Service einen neuen erstellen. Weitere Informationen finden Sie in der Dokumentation zu Adobe Experience Platform.
Wenn Sie ein Schema mit einer primären Identität auswählen, werden die Felder Profilkennung und Identitätstyp vorausgefüllt. Wenn keine Identität definiert ist, wählen Sie identityMap > id als Primärschlüssel aus. Wählen Sie anschließend einen Identitätstyp aus und der Schlüssel wird (unter dem Feld Identitätstyp) mit identityMap > id vorausgefüllt.
Bei der Auswahl von Feldern werden primäre Identitätsfelder mit Tags versehen.
Wählen Sie einen Identitätstyp aus der Dropdown-Liste aus.
Pro Journey ist nur ein Identitätstyp zulässig. Wenn Sie mehrere Ereignisse in derselben Journey verwenden, müssen diese denselben Identitätstyp verwenden. Weitere Informationen finden Sie auf dieser Seite.
Profilkennung definieren define-the-event-key
Die Profilkennung, auch als Ereignisschlüssel bezeichnet, ist ein Feld oder eine Kombination von Feldern in der Ereignis-Payload. Dadurch kann das System die mit dem Ereignis verbundene Person identifizieren. Dabei kann es sich beispielsweise um die Experience Cloud-ID, eine CRM-ID oder eine E-Mail-Adresse handeln.
Um in der Echtzeit-Kundenprofildatenbank von Adobe gespeicherte Daten zu verwenden, muss die Profilkennung den Informationen entsprechen, die Sie im Echtzeit-Kundenprofil-Service) als Profilidentität haben.
Mit der Profilkennung kann das System die Abstimmung zwischen dem Ereignis und dem Profil des Kontakts durchführen. Wenn Sie ein Schema mit einer primären Identität auswählen, werden die Felder Profilkennung und Identitätstyp vorausgefüllt. Wenn keine Identität definiert ist, ist identityMap > id die primäre Identität. Wählen Sie anschließend einen Identitätstyp aus, und die Profilkennung wird automatisch mit „identityMap id“.
Bei der Auswahl von Feldern werden primäre Identitätsfelder mit Tags versehen.
Wenn Sie eine andere Profilkennung verwenden müssen, z. B. eine CRM-ID oder eine E-Mail-Adresse, müssen Sie sie manuell hinzufügen, wie unten beschrieben:
-
Klicken Sie in das Feld Profilkennung oder auf das Stiftsymbol.
-
Wählen Sie das als Schlüssel ausgewählte Feld in der Liste der Payload-Felder aus.
Wenn das Ereignis eingeht, kann das System mit dem Wert der Profilkennung die mit dem Ereignis verbundene Person identifizieren. Die Profilkennung ist einem Identitätstyp zugeordnet und kann für Abfragen in Adobe Experience Platform verwendet werden. Weitere Informationen finden Sie auf dieser Seite.
Die Profilkennung wird auch verwendet, um zu überprüfen, ob sich eine Person auf einer Journey befindet. Eine Person kann nicht an zwei verschiedenen Stellen in derselben Journey sein. Das System lässt daher nicht zu, dass sich dieselbe Profilkennung, z. B. CRMID=3224, an verschiedenen Stellen auf derselben Journey befindet.
Der erweiterte Ausdruckseditor adv-exp-editor
Sie können beim Definieren der Ereignis-ID-Bedingung oder der Profilkennung auch zum erweiterten Ausdruckseditor wechseln, um komplexere Schlüssel zu erstellen (z. B. eine Verkettung zweier Felder der Ereignisse).
Über die Schaltfläche Erweiterter Modus haben Sie Zugriff auf die erweiterten Ausdrucksfunktionen, wenn Sie zusätzliche Manipulationen durchführen möchten. Mit diesen Funktionen können Sie die Werte bearbeiten, die für bestimmte Abfragen verwendet werden, z. B. Formate ändern, Feldverkettungen durchführen oder nur einen Teil eines Felds berücksichtigen (z. B. die ersten 10 Zeichen). Weitere Informationen finden Sie auf dieser Seite.
Vorschau der Payload preview-the-payload
Mit der Payload-Vorschau können Sie die Payload-Definition validieren.
-
Klicken Sie auf das Symbol Payload zeigen, um eine Vorschau der vom System erwarteten Payload anzuzeigen.
Sie können sehen, dass die ausgewählten Felder angezeigt werden.
-
Überprüfen Sie die Vorschau, um die Payload-Definition zu validieren.
-
Anschließend können Sie die Payload-Vorschau für die Person freigeben, die für das Senden des Ereignisses verantwortlich ist. Diese Payload kann ihr beim Entwurf eines Ereignisses helfen, das an Journey Optimizer gesendet wird. Weitere Informationen finden Sie auf dieser Seite.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to configure a unitary event, which is linked to a specific profile and can be rule-based or system-generated, including its type, schema and payload fields, identity type, profile identifier, and payload preview.
Intents:
- Create a unitary event and choose the Rule Based or System Generated Event ID type
- Define the schema and select the payload fields the journey expects to receive
- Define the Event ID condition for rule-based events using the simple or advanced expression editor
- Add an identity type and define the profile identifier that reconciles the event with a profile
- Use the advanced expression editor to build more complex keys
- Preview the payload to validate the payload definition
Glossary:
- Unitary event: An event linked to a specific profile that can be rule-based or system-generated (product-specific)
- Identity type: The type of key used to identify the person associated to the event, previously known as namespace; only people-based identity types can be selected (product-specific)
- Profile identifier: Also called the event key; the field, or combination of fields, from the event payload that allows the system to identify the person associated to the event, for example the Experience Cloud ID, a CRM ID, or an email address. To use data stored in Real-time Customer Profile, it must be defined as a profile identity there (product-specific)
- eventID: For system-generated events, the field automatically added to the list of selected fields so that Journey Optimizer can identify the event; the system pushing the event should not generate an ID and should use the one available in the payload preview (product-specific)
- Orchestration field group: The field group that must be added to the XDM schema for system-generated events so the schema contains all information required to work with Journey Optimizer (product-specific)
- Advanced expression editor: The editor you can switch to for creating more complex keys, such as a concatenation of two event fields (product-specific)
Guardrails:
- The event name allows only alphanumeric characters and underscores, with a maximum length of 30 characters (hard limit).
- When you select the System Generated type, only schemas that have the eventID type field are available; when you select the Rule Based type, you can select any Experience Event schema available in your sandbox.
- The identity type is required to retrieve additional information from the Real-time Customer Profile Service, and optional otherwise.
- The identity type is not needed if you only use data from a third-party system through a custom data source.
- Only a people-based identity type can be selected; an identity type defined for a lookup table is not available.
- Only one identity type is allowed per journey, so events used in the same journey must use the same identity type.
- If the schema has a primary identity, the Profile identifier and Identity type fields are pre-filled; if no identity is defined, identityMap > id is used as the primary key and you select an identity type.
- The same profile identifier, for example CRMID=3224, cannot be at two different places in the same journey.
- For system-generated events, the payload preview requires saving and re-opening the event to generate an event ID.
Terminology:
- Canonical name: Configure a unitary event
- Synonyms: “Identity type” = “namespace”; “Profile identifier” = “event key”
- Do not confuse: “Rule Based” (uses an Event ID condition, and you can select any Experience Event schema available in your sandbox) ≠ “System Generated” (only schemas that have the eventID type field are available; the eventID field is automatically added to the selected fields)
- Do not confuse: “Event ID condition” (rule used to identify events that trigger the journey) ≠ “Profile identifier” (key used to identify the person associated to the event)
FAQ:
- Q: What are the two Event ID types for a unitary event? — Rule Based, which uses an Event ID condition, and System Generated, for which the eventID field is automatically added to the list of selected fields.
- Q: Is defining an identity type required? — It is required if you want to leverage information stored in the Real-time Customer Profile Service, and optional otherwise. It is not needed if you only use data from a third-party system through a custom data source. Only a people-based identity type can be selected.
- Q: Why does the system not allow the same key at different places in the same journey? — A person cannot be at two different places in the same journey, so the system does not allow the same key to be at different places in the same journey.
- Q: What schemas are available for a System Generated event? — Only schemas that have the eventID type field; for Rule Based events, you can select any Experience Event schema available in your sandbox.
- Q: How do I preview the payload for a system-generated event? — Save the event and re-open it first to generate an event ID, then use the View Payload icon to check the preview.
Personas:
- developer: Can define the schema and payload fields an event expects to receive for use in the journey. Can define the profile identifier, the field or combination of fields that identifies the person associated to the event. The page states that the same key, for example CRMID=3224, cannot be at two different places in the same journey. Where: “Define the profile identifier”.
- admin: Can create a unitary event, name it, and choose the Rule Based or System Generated Event ID type. Can add an identity type, required to leverage information stored in the Real-time Customer Profile Service. The page states that the event name allows only alphanumeric characters and underscores, with a maximum length of 30 characters. Where: “Configure a unitary event”.
Onboarding:
- Level: Intermediate, Experienced
- First minimal step: Select Create Event to create a new event.
- Success check: The event is now configured and ready to be dropped into a journey.
- Previous: Understand what a unitary event is before configuring one: Work with journey events (event/about-events.md)
- Next: After saving the event, complete the additional steps to send events to a journey: Additional steps to send events to a journey (event/additional-steps-to-send-events-to-journey.md); Use the configured key to perform queries on Adobe Experience Platform in journey activities: Get started with journey activities (building-journeys/about-journey-activities.md)