Konfigurieren eines unitären Ereignisses

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.

Im Folgenden finden Sie die ersten Schritte zum Konfigurieren eines neuen Ereignisses:

  1. Wählen Sie im Menü ADMINISTRATION die Option Konfigurationen. Klicken Sie im Abschnitt Ereignisse auf Verwalten. Die Liste der Ereignisse wird angezeigt.

  2. 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.

  3. Geben Sie den Namen Ihres Ereignisses ein. Sie können auch eine Beschreibung hinzufügen.

    HINWEIS

    Verwenden Sie keine Leerzeichen oder Sonderzeichen. Verwenden Sie nicht mehr als 30 Zeichen.

  4. Wählen Sie im Feld Typ die Option Unitär.

  5. 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.

  6. 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.

  7. Definieren Sie das Schema und die Payload-Felder: Hier wählen Sie die Ereignisinformationen aus (normalerweise als Payload bezeichnet), die von Journeys erwartet werden. Anschließend können Sie diese Informationen in Ihrer Journey verwenden. Weiterführende Informationen finden Sie in diesem Abschnitt.

    HINWEIS

    Wenn Sie den Typ Systemgeneriert auswählen, sind nur Schemas mit dem Feld vom Typ „eventID“ verfügbar. Wenn Sie den regelbasierten Typ auswählen, sind nur Erlebnisereignisschemata verfügbar.

  8. Klicken Sie bei regelbasierten Ereignissen in das Feld Ereignis-ID-Bedingung. Mit dem einfachen 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.

    HINWEIS

    Der erweiterte Ausdruckseditor ist beim Definieren der Ereignis-ID-Bedingung nicht verfügbar. 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.

  9. Fügen Sie einen Namespace hinzu. Dieser Schritt ist optional, wird jedoch empfohlen, da das Hinzufügen eines Namespace es Ihnen ermöglicht, die im Echtzeit-Kundenprofildienst gespeicherten Informationen zu nutzen. Er definiert den Typ des Schlüssels, den das Ereignis hat. Weitere Informationen finden Sie in diesem Abschnitt.

  10. 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 Namespace auswählen. Journeys wählen den Schlüssel aus, der dem Namespace entsprechen soll (wenn Sie beispielsweise einen E-Mail-Namespace auswählen, wird der E-Mail-Schlüssel ausgewählt). Weitere Informationen finden Sie in diesem Abschnitt.

  11. 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

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 Adobe Experience Platform Launch-Dokumentation.

  1. 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.

    HINWEIS

    Stellen Sie bei systemgenerierten Ereignissen sicher, dass Sie die Feldergruppe „Orchestrierung“ zum XDM-Schema hinzugefügt haben. Dadurch wird sichergestellt, dass Ihr Schema alle erforderlichen Informationen für die Zusammenarbeit mit Journey Optimizer enthält.

  2. 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).

    HINWEIS

    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 die ID verwenden, die in der Payload-Vorschau verfügbar ist. Weitere Informationen finden Sie in diesem Abschnitt.

  3. 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 des Namespace

Mit dem Namespace können Sie den Typ des Schlüssels definieren, mit dem die mit dem Ereignis verbundene Person identifiziert wird. Die Konfiguration ist optional. Sie ist erforderlich, wenn Sie in Ihren Journeys zusätzliche Informationen aus dem Echtzeit-Kundenprofil abrufen möchten. Der Namespace muss nicht definiert werden, wenn Sie nur Daten aus einem Drittanbietersystem über eine benutzerdefinierte Datenquelle verwenden.

Sie können entweder einen der vordefinierten Namespace verwenden oder mit dem Identity-Namespace-Dienst einen neuen erstellen. Weitere Informationen finden Sie in der Dokumentation zu Adobe Experience Platform.

Wenn Sie ein Schema mit einer Primäridentität auswählen, werden die Felder Profilkennung und Namespace vorbelegt. Wenn keine Identität definiert ist, wählen Sie identityMap > id als Primärschlüssel aus. Wählen Sie anschließend einen Namespace aus und der Schlüssel wird (unter dem Feld Namespace) mit identityMap > id vorbelegt.

Bei der Auswahl von Feldern werden Primäridentitätsfelder mit Tags versehen.

Wählen Sie einen Namespace aus der Dropdown-Liste aus.

Pro Journey ist nur ein Namespace zulässig. Wenn Sie mehrere Ereignisse in derselben Journey verwenden, müssen diese denselben Namespace verwenden. Weitere Informationen finden Sie auf dieser Seite.

Profilkennung definieren

Der Schlüssel ist das Feld oder die Feldkombination, die Teil der Payload-Ereignisdaten ist und es dem System ermöglicht, die mit dem Ereignis verbundene Person zu identifizieren. Der Schlüssel kann beispielsweise die Experience Cloud-ID, eine CRM-ID oder eine E-Mail-Adresse sein.

Um in der Echtzeit-Kundenprofildatenbank von Adobe gespeicherte Daten zu verwenden, muss der Ereignisschlüssel den Informationen entsprechen, die Sie im Echtzeit-Kundenprofil-Service als Profilidentität definiert 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äridentität auswählen, werden die Felder Profilkennung und Namespace vorbelegt. Wenn keine Identität definiert ist, wählen Sie identityMap > ID als Primärschlüssel aus. Wählen Sie dann einen Namespace aus und der Schlüssel wird automatisch mithilfe von identityMap > ID vorausgefüllt.

Bei der Auswahl von Feldern werden Primäridentitätsfelder mit Tags versehen.

Wenn Sie einen anderen Schlüssel verwenden müssen, z. B. eine CRM-ID oder eine E-Mail-Adresse, müssen Sie ihn manuell hinzufügen, wie hier beschrieben:

  1. Klicken Sie in das Feld Profilkennung oder auf das Stiftsymbol.

  2. Wählen Sie das als Schlüssel ausgewählte Feld in der Liste der Payload-Felder aus. Sie können auch zum erweiterten Ausdruckseditor wechseln, um komplexere Schlüssel zu erstellen (z. B. eine Verkettung zweier Felder der Ereignisse).

Wenn das Ereignis eingeht, kann das System mit dem Wert des Schlüssels die mit dem Ereignis verbundene Person identifizieren. Mit dem Schlüssel, der einem Namespace zugeordnet ist (siehe diesen Abschnitt), können Abfragen in Adobe Experience Platform durchgeführt werden. Weitere Informationen finden Sie auf dieser Seite.
Der Schlüssel wird auch verwendet, um zu überprüfen, ob sich eine Person in einer Journey befindet. Eine Person kann nicht an zwei verschiedenen Stellen in derselben Journey sein. Das System lässt daher nicht zu, dass sich derselbe Schlüssel, z. B. der Schlüssel CRMID=3224, an verschiedenen Stellen in derselben Journey befindet.

Sie haben auch Zugriff auf die erweiterten Ausdrucksfunktionen (erweiterter Modus), wenn Sie zusätzliche Manipulationen durchführen möchten. Mit diesen Funktionen können Sie die Werte bearbeiten, die für bestimmte Abfragen wie das Ändern von Formaten verwendet werden, indem Sie Feldverkettungen durchführen, wobei nur ein Teil eines Felds (z. B. die 10 ersten Zeichen) berücksichtigt wird. Weitere Informationen finden Sie auf dieser Seite.

Vorschau der Payload

Mit der Payload-Vorschau können Sie die Payload-Definition validieren.

HINWEIS

Bei vom System erstellten Ereignissen: Wenn Sie ein Ereignis erstellen, speichern und öffnen Sie es erneut, bevor Sie die Payload-Vorschau anzeigen. Dieser Schritt ist erforderlich, um eine Ereignis-ID in der Payload zu generieren.

  1. 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.

  2. Überprüfen Sie die Vorschau, um die Payload-Definition zu validieren.

  3. 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.

Auf dieser Seite