StageUp
Segments

Create & Edit a Segment

This guide describes the creation & editing workflow based on the live drawer UI.

Opening the Drawer

ActionHow
New SegmentClick [New Segment] top-left
Edit ExistingClick pencil icon in row
CloseX icon (confirmation dialog if unsaved changes)

1. Basic Info Section

FieldRequiredInputDescriptionExample
Segment NameYesSingle-lineUnique, purpose-revealing identifierAge20_30_Female_iOS
DescriptionNoTextareaInternal operational memoRetention Test Cohort A

Validation: Missing name triggers an inline error at save (e.g., “Enter a name”).

2. Condition Builder Structure

Initial state: Group 1 containing one empty condition row.

ElementRole
Group header (e.g. Group 1)Identifies group
Event/Attribute select buttonChoose event or attribute (can type new custom event)
Add Parameter buttonAdd event parameter key/value filters
OR buttonConvert single condition into OR group (add alternate)
AND buttonAdd another single condition within same group
Add Group buttonAdd a new top-level AND group
X iconDelete condition or group (minimum one retained)

2-1. Adding an Event Condition

  1. Click selector → popover opens with tabs
  2. Tabs:
    • Event Log (system events: page_view, purchase, etc.)
    • Custom Events (captured non-system names)
    • User Attributes / Device Info / Date & Time (switch to attribute mode)
  3. Type to filter or create a new custom event name
  4. Select event → row label updates
  5. (Optional) Add parameter filters

2-2. Adding an Attribute Condition

  1. Selector → choose tab (User Attributes / Device Info / Date & Time)
  2. Pick field (e.g., user.country, device.category, date.hour)
  3. Row enters attribute state; [Add Condition] button appears
  4. Click [Add Condition] → operator/value popover
  5. Choose operator (EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN, CONTAINS, IN, NOT_IN)
  6. IN/NOT_IN: multi-values via Enter/comma → tag accumulation
  7. Applied criteria show as removable badges

2-3. Adding Event Parameter Conditions

  1. Click [Add Parameter]
  2. Select or type Key
  3. Select operator (same list)
  4. Enter value(s)
  5. Result appears as key operator value badge (multiple allowed)

2-4. Building an OR Group

ScenarioResult
Click OR on single conditionConverts to OR group + adds blank alternate
Last condition in OR group(+) role adds another alternate
Between conditions“OR” label visually separates items

2-5. Adding Additional Groups

Use [Add Group] to append another top-level AND-connected group.

2-6. Deleting & Constraints

TargetConstraint
Condition deleteAt least one remains in group
Group deleteAt least one group overall
Drawer closeConfirmation if unsaved changes

3. Saving

Top-right primary button states:

ModeLabelLoading
CreateCreate SegmentCreating... spinner
EditSave ChangesUpdating... spinner

Success → drawer closes & list refreshes.

4. Best Practices

  • Avoid overly generic event names (button_click vs purchase_button_click)
  • Use OR only for semantic alternates (page_view OR screen_view)
  • Mix event + attribute to sharpen targeting precision
  • Limit IN lists to top impactful values to avoid dilution

Table of Contents