Represents a single skip event with detailed contextual information

Captures comprehensive metadata about an individual track skip, including timing information, playback progress, skip type classification, and the context in which the skip occurred. This data structure is fundamental to pattern detection algorithms.

Properties:

  • timestamp: ISO datetime string when the skip occurred
  • progress: Percentage (0-1) of track played before skipping
  • playDuration: Optional milliseconds the track played before skip
  • isManualSkip: Whether the skip was user-initiated vs. automatic
  • skipType: Classification of the skip (preview, standard, near_end)
  • context: Details about the playback environment (playlist, album, etc.)

Skip events are analyzed individually and in aggregate to detect patterns across temporal, content, and behavioral dimensions.

interface SkipEvent {
    timestamp: string;
    progress: number;
    playDuration?: number;
    isManualSkip?: boolean;
    skipType?: string;
    context?: { type: string; name?: string; uri?: string };
}

Properties

timestamp: string
progress: number
playDuration?: number
isManualSkip?: boolean
skipType?: string
context?: { type: string; name?: string; uri?: string }