Automation trigger that fires when a profile or organisation loses a recognition award, such as when a level or badge tier drops. Matches on a RecognitionLostEvent by recognition name and topic, and can be scoped to organisation-level or profile-level events only via the orgOnly flag. Registered as the "recognitionLostTrigger" JSON subtype of FunnelTrigger.
Group: Journeys
Implements: FunnelTrigger, Serializable
Properties
| Property | Returns | Description |
|---|---|---|
| description | String | Human-readable summary of this trigger's configuration, naming the recognition and topic it matches and whether it applies to organisations or profiles. |
| fields | List<Pair<ExtraField,Object>> | Configuration fields shown in the automation editor for this trigger: the recognition name, topic and the organisation-only flag, paired with their currently configured values. |
| funnelTriggerTypeId | String | Identifier of the trigger type this trigger is an instance of, always "recognitionLostTrigger". Used to look up the matching RecognitionLostFunnelTriggerType from the funnel manager's registry. |
| orgOnly | Boolean | Whether this trigger only matches recognition-lost events for organisations rather than profiles. May be null if never configured, in which case orgOnly() treats it as false. |
| recognitionName | String | Name of the recognition award that must be lost for this trigger to match. Never null once the automation has been configured. |
| recognitionTopic | String | Name of the recognition topic the recognition award belongs to. Both the name and the topic must match for this trigger to fire. |
Methods
getFunnelTriggerTypeId()
Returns: String
Identifier of the trigger type this trigger is an instance of, always "recognitionLostTrigger". Used to look up the matching RecognitionLostFunnelTriggerType from the funnel manager's registry.
getFields()
Returns: List<Pair<ExtraField,Object>>
Configuration fields shown in the automation editor for this trigger: the recognition name, topic and the organisation-only flag, paired with their currently configured values.
getDescription()
Returns: String
Human-readable summary of this trigger's configuration, naming the recognition and topic it matches and whether it applies to organisations or profiles.
getRecognitionName()
Returns: String
Name of the recognition award that must be lost for this trigger to match. Never null once the automation has been configured.
getRecognitionTopic()
Returns: String
Name of the recognition topic the recognition award belongs to. Both the name and the topic must match for this trigger to fire.
getOrgOnly()
Returns: Boolean
Whether this trigger only matches recognition-lost events for organisations rather than profiles. May be null if never configured, in which case orgOnly() treats it as false.