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

PropertyReturnsDescription
descriptionStringHuman-readable summary of this trigger's configuration, naming the recognition and topic it matches and whether it applies to organisations or profiles.
fieldsList<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.
funnelTriggerTypeIdStringIdentifier 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.
orgOnlyBooleanWhether 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.
recognitionNameStringName of the recognition award that must be lost for this trigger to match. Never null once the automation has been configured.
recognitionTopicStringName 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.

To get full access to the Kademi Hub existing customers can login here, or new customers can register here.