Skip to content

Sequence

FunnelCompletion Tracking

Checks whether a user has completed a specific series of steps in order, and tracks how far along they are. Define a list of events that should happen in sequence and get completion tracking, timing stats, and progress percentage.

When to Use

  • Funnel completion tracking: did users finish onboarding? did they create and then share content?
  • Promo abuse detection: are users completing the sign-up flow suspiciously fast (bots)?
  • User journey analysis: where are users dropping off in a multi-step flow?
  • Identifying power users who complete advanced workflows

Configuration

json
{
  "name": "sequence_content_sharing_1hr",
  "group_by": "handprint_id",
  "operation": "sequence",
  "fields": ["Sign Up", "Generate Content", "Share Content"],
  "window_duration_seconds": 3600,
  "operation_config": {
    "allow_intermediate_events": true
  }
}

Configuration Options

OptionDefaultDescription
allow_intermediate_eventsfalseAllow other events between sequence steps
allow_duplicatestrueAllow duplicate events in sequence

Response

FieldDescription
indexCurrent step index (0-based)
completedNumber of times the full sequence has been completed
start_timeTimestamp of when the current sequence attempt started
percent_completeProgress percentage (0–100)
completion_timesArray of completion durations in seconds for each completed run
completion_time_statsStats across completions: avg, max, min, sum, last
intermediary_eventsCount of non-sequence events that occurred between steps
unique_intermediate_eventsDistinct names of events that occurred between steps
event_idsIDs of the events that matched each sequence step
json
{
  "behaviors": {
    "sequence_content_sharing_1hr": {
      "index": 2,
      "completed": 1,
      "start_time": 1749764339011,
      "percent_complete": 100,
      "completion_times": [59.386],
      "completion_time_stats": {
        "avg": 59.386,
        "max": 59.386,
        "min": 59.386,
        "sum": 59.386,
        "last": 59.386
      },
      "intermediary_events": 1,
      "unique_intermediate_events": ["Page View"],
      "event_ids": [
        "e94ae251-232f-41a8-94f0-fc8eb4510f1c",
        "08d7e2f0-4beb-4506-a3f9-4a05ba3abacf",
        "63fe84d4-8638-4449-9a37-a6e3b9e5243a"
      ],
      "timestamp": "2025-06-12T21:38:35.091Z",
      "remaining_window_seconds": 3516
    }
  }
}