Attribute der Journey-Eigenschaften journey-properties
Im einfachen Ausdruckseditorund im erweiterten Ausdruckseditor können Sie unterhalb der Kategorien Ereignis und Datenquelle auf die Kategorie Journey-Eigenschaften zugreifen. Diese Kategorie enthält technische Felder, die sich auf die Journey eines bestimmten Profils beziehen. Dies sind die Informationen, die das System von Live-Journeys abruft, wie z. B. die Journey-ID oder die spezifischen aufgetretenen Fehler.
Sie enthält beispielsweise Informationen zu:
-
Journey-Version: Journey-UID, Journey-Versions-UID, Instanz-UID usw.
-
Fehler: Datenabruf, Aktionsausführung usw.
-
aktueller Schritt, letzter aktueller Schritt usw.
-
verworfene Profile
Die Liste der Felder ist in diesem Abschnitt verfügbar.
Sie können diese Felder zum Erstellen von Ausdrücken verwenden. Während der Ausführung einer Journey werden die Werte direkt von der Journey abgerufen.
Im Folgenden finden Sie einige Beispiele für Anwendungsfälle:
-
Verworfene Profile protokollieren: Sie können alle Profile, die von einer Nachricht ausgeschlossen sind, mit einer Begrenzungsregel zu Protokollierungszwecken an ein Drittanbietersystem senden. Dazu richten Sie bei Zeitüberschreitung und Fehler einen Pfad ein und fügen eine Bedingung zum Filtern nach einem bestimmten Fehlertyp hinzu, z. B.: „Personen nach Begrenzungsregel verwerfen“. Anschließend können Sie die verworfenen Profile über eine benutzerdefinierte Aktion an ein Drittanbietersystem senden.
-
Warnhinweise bei Fehlern senden: Sie können eine Benachrichtigung an ein Drittanbietersystem senden, sobald ein Fehler in einer Nachricht auftritt. Dazu richten Sie einen Pfad für den Fehlerfall ein, fügen eine Bedingung und eine benutzerdefinierte Aktion hinzu. Sie können beispielsweise eine Benachrichtigung an einen Slack-Kanal mit der Fehlerbeschreibung senden.
-
Fehler in Berichten optimieren: Statt nur einen Pfad für fehlerhafte Nachrichten zu haben, können Sie eine Bedingung pro Fehlertyp definieren. Auf diese Weise können Sie die Berichte optimieren und alle Daten zu den Fehlertypen anzeigen.
Liste der Felder journey-properties-fields
Fehlertyp der aktuellen fehlerhaften Aktivität (Knoten). Mögliche Typen:
- Ereignisse: Ereignisse, Reaktionen, SQ (Beispiel: Zielgruppen-Qualifizierung)
- Flusssteuerung: Ende, Bedingung, Warten
- Aktionen: ACS-Aktionen, Sprung, benutzerdefinierte Aktion
Fehler-Code der aktuellen fehlerhaften Aktivität (Knoten). Mögliche Fehler:
- HTTP-Fehler-Codes
- capped
- timedOut
- Fehler (Beispiel: Standard bei unerwartetem Fehler. Sollte nicht / äußerst selten vorkommen.)
Dieser Abschnitt enthält strukturiertes Wissen zur Unterstützung von Interpretation, Abrufen und Antworten auf Fragen zu diesem Thema.
Zum vollständigen Verständnis sollten diese Informationen mit der Dokumentation auf dieser Seite kombiniert werden. Keine der beiden Quellen ist für Einzelpersonen gedacht. Die Seite beschreibt die Funktion, während dieser Abschnitt zusätzlichen Kontext bietet, der dabei hilft, Begriffe, Absichten, Anwendbarkeit und Begrenzungen zu unterscheiden.
- TL;DR: Auf dieser Seite wird die Kategorie "Journey-Eigenschaften“ im Ausdruckseditor beschrieben - eine Reihe technischer Felder zur Live-Journey-Instanz (IDs, Fehler, aktuelle/vorherige Knoten, verstrichene Zeiten), mit denen Ausdrücke für die Protokollierung, Warnhinweise und fehlerspezifische Berichte erstellt werden können.
intents:
- Zugreifen auf Journey-Eigenschaftsfelder im einfachen oder erweiterten Ausdruckseditor zum Referenzieren von Live-Journey-Metadaten
- Erstellen einer Bedingung, die verworfene Profile nach Fehlertyp filtert, um sie an ein Protokollierungssystem eines Drittanbieters weiterzuleiten
- Senden Sie Fehlermeldungen an einen externen Kanal (z. B. Slack), indem Sie in einer benutzerdefinierten Aktion auf den letzten Fehlercode und Knotennamen verweisen
- Verfeinern Sie die Journey-Fehlerberichterstattung, indem Sie mit
lastNodeTypeInErrorundlastErrorCodeseparate Bedingungspfade pro Fehlertyp erstellen - Referenz-Journey-Versionskennungen, Instanzkennungen und Sandbox-Namen in Ausdrücken für Tracking und Auditing
Glossar:
- Journey-Eigenschaften: Eine Kategorie im Ausdruckseditor, die technische Metadatenfelder für die aktuelle Journey-Ausführungsinstanz enthält (produktspezifisch)
- instanceUID: Die eindeutige Kennung der Journey-Instanz für eine bestimmte Profilausführungsinstanz produktspezifisch)
- lastErrorCode: Der Fehlercode aus der letzten fehlgeschlagenen Aktivität auf der Journey. Mögliche Werte sind HTTP-Codes,
capped,timedOutunderror(produktspezifisch) - lastNodeTypeInError: Der Typ der letzten Aktivität, bei der ein Fehler aufgetreten ist. Dies können Ereignisse, Flusssteuerung oder Aktionen produktspezifisch) sein
- externalKey: Die individuelle Kennung (z. B. Profilkennung), die die Journey-Instanz ausgelöst hat (produktspezifisch)
Leitplanken:
- Journey-Eigenschaften-Feldwerte werden zur Ausführungszeit direkt von der Live-Journey abgerufen - sie stehen nicht für die Validierung vor der Ausführung zur Verfügung
- Das Feld
lastErrorCodeverwendet vordefinierte Werte: HTTP-Fehler-Codes,capped,timedOutunderror - Journey-Eigenschaften sind sowohl im einfachen als auch im erweiterten Ausdruckseditor unter der Kategorie Journey-Eigenschaften verfügbar
Terminologie:
- Kanonischer Name: Journey Properties — Akronym: none — Varianten: Journey technische Felder, Journey Metadatenfelder
- Synonyme: "Journey Properties“ = „Technische Journey-Felder“; „instanceUID“ = "Journey-Instanzkennung“
- Nicht verwechseln: journeyUID (identifiziert die Journey-Definition) ≠ instanceUID (identifiziert die Ausführung der Journey durch ein bestimmtes Profil)
FAQ:
- F: Wo finde ich Journey-Eigenschaftenfelder im Ausdruckseditor? — Sie werden sowohl im einfachen als auch im erweiterten Ausdruckseditor unter der Kategorie Journey-Eigenschaften unterhalb von Ereignisse und Datenquellen angezeigt.
- F: Wie kann ich Profile protokollieren, die durch eine Begrenzungsregel verworfen wurden? - Fügen Sie eine Fehlerpfad-Bedingungsfilterung für
lastErrorCode == "capped"hinzu und übertragen Sie diese Profile über eine benutzerdefinierte Aktion auf ein Drittanbietersystem. - F: Was ist der Unterschied zwischen
journeyUIDundinstanceUID? —journeyUIDidentifiziert die Journey-Definition;instanceUIDidentifiziert eine bestimmte Ausführungsinstanz für ein bestimmtes Profil. - F: Welcher Fehlercode wird bei einem unerwarteten Systemfehler zurückgegeben? — Der
error-Code, der als Standard für unerwartete Fehler verwendet wird und nur selten auftreten sollte. - F: Kann ich Felder für Journey-Eigenschaften verwenden, um Slack-Warnungen bei Aktionsfehlern zu senden? — Ja. Referenzieren Sie
lastNodeNameInErrorundlastErrorCodein einer benutzerdefinierten Aktion, um Fehlerdetails in eine Slack-Benachrichtigung aufzunehmen.