Skip to main content

Verbs

All terms live in the bdm: namespace; the canonical id of initialized is bdm:initialized.

VerbLayerObject typesDescription
initializedlifecycleRuntimeInstanceRuntimeInstance record minted; instrument loaded; engine ready. Nothing shown yet.
startedlifecycleRuntimeInstanceFirst content actually shown to the participant; starts the experiential clock.
pausedlifecycleRuntimeInstanceRuntimeInstance suspended (extended visibility loss, idle threshold, or explicit pause).
resumedlifecycleRuntimeInstanceRuntimeInstance continued after a pause. Carries bdm:pause_duration.
completedlifecycleRuntimeInstanceAll required content done. Distinct from submitted.
submittedlifecycleRuntimeInstanceData left the engine (POST to Orchestrator acknowledged).
abandonedlifecycleRuntimeInstanceRuntimeInstance ended without completion. Carries bdm:abandon_reason.
presentedpresentationScreen, Panel, Stimulus, Option, Feedback, ConsentFormSomething became perceivable (rendered or played). Typically the response-time anchor for Stimulus/Option.
clickedinteractionOption, UIComponentPointer click (mouse, tap, stylus); the lowest-level click event.
drag_and_droppedinteractionOption, UIComponentA drag-and-drop gesture completed. Carries bdm:drag_source and bdm:drop_target.
key_pressedinteractionUIComponent, StimulusA single key event. Carries bdm:key and bdm:key_code.
typedinteractionUIComponentA text input was committed (debounced). Carries bdm:typed_text and bdm:key_sequence.
selectedinteractionOption, UIComponentDiscrete option selected (radio, checkbox, dropdown).
deselectedinteractionOption, UIComponentDiscrete option deselected (e.g. checkbox unchecked).
adjustedinteractionUIComponentA continuous-value control was set (slider, spinner, dial). Carries bdm:current_value.
got_focusinteractionUIComponent, WindowFocus gained by an input control or by the runtime window/tab.
lost_focusinteractionUIComponent, WindowFocus lost. Window-level loss may (by threshold) lead to bdm:paused.
consentedinteractionConsentThe agent committed to consent. Carries bdm:consent_text_hash and bdm:consent_scope.
trial_startedsystemTrialA trial began. Carries bdm:trial_index and (when applicable) bdm:block_index / bdm:block_type.
trial_endedsystemTrialTrial finalised; a Response (trial) row is created. Carries the canonical response_*, response_time, correct/score, and bdm:response_id. Exactly one per trial.
state_changedsystemTimer, Scorer, LocaleSwitchA software-internal state change not tied to a presentation (timer, scorer, locale switch).
recording_startedrecordingRecordingA continuous-data recording opened. Carries bdm:source and bdm:sample_rate.
recording_endedrecordingRecordingA recording closed and was stored. Carries bdm:recording_url, bdm:recording_sha256, bdm:duration.
navigatednavigationScreenParticipant moved between Screens. Carries bdm:from_screen_id and bdm:to_screen_id.