Skip to main content

Activity Data Format

All activities produce ActivityEvents โ€” timestamped records containing session summaries and per-action detail.

ActivityEvent Structureโ€‹

{
"timestamp": 1634047106612,
"activity": "e2wxcekbb0typzdtz0pb",
"duration": 3735,
"static_data": { ... },
"temporal_slices": [
{ "item": ..., "value": ..., "type": ..., "duration": ..., "level": ... }
]
}
FieldTypeDescription
timestampintegerUnix timestamp in milliseconds when the activity was completed
activitystringThe activity's unique identifier
durationintegerTotal time spent on the activity in milliseconds
static_dataobjectSession-level summary (overall scores, points, metadata)
temporal_slicesarrayPer-action detail (each question answered, each tap made, each level completed)

temporal_slicesโ€‹

Each element represents a single action โ€” a survey question answered, a game level completed, or a tap recorded.

FieldTypeDescription
itemstring or numberQuestion text (surveys), tap/pump number (games), or level identifier
valueanyThe response โ€” selected option (surveys), score (games), correctness flag
typeanyQuestion type (surveys), correctness boolean (games), or null
durationnumberTime spent on this item in milliseconds
levelnumber or nullGame level number, or null for surveys

The meaning of each field varies by activity type. See the individual activity pages in Activity Reference for per-activity schemas.

Data Retrievalโ€‹

Data can be retrieved through:

  • REST API โ€” Query activity events for specific participants, time ranges, and types. See the API documentation.
  • Python SDK โ€” import LAMP for programmatic data access. See Python SDK.
  • Cortex โ€” Process raw events into computed behavioral features automatically. See Cortex.
  • Dashboard โ€” View and export data through the Data Portal or the Portal tab.

Cortex Analysisโ€‹

The Cortex pipeline transforms raw activity events into behavioral insights through three stages:

  1. Raw features โ€” Retrieve activity event data directly (e.g., survey, jewels_a, balloon_risk).
  2. Primary features โ€” Compute per-session metrics (e.g., survey_scores, game_level_scores).
  3. Secondary features โ€” Aggregate scores across time windows (e.g., survey_results, game_results).

See the Cortex documentation for details on running activity analysis. For per-activity schemas, see the Activity Reference.