Saved Segments

Segments let you save a combination of filters as a reusable shortcut. Instead of re-applying "Source is Google AND Country is Germany AND Device is Mobile" every time, save it as a segment and apply it with one click.

Segments are available on Starter plans and above.

---

Creating a Segment

1. Apply filters to your dashboard. Use the filter bar to add any combination:

   • Source / Medium / Campaign / Channel
   • Country / Region / City
   • Device / Browser / OS
   • Page / Entry page / Exit page
   • Event name / Event properties
   • Visitor type (new vs returning)

2. Once your filters are active, click the Save as Segment button in the filter bar.

3. Give your segment a name (e.g., "German Mobile Organic") and click Save.

Example segment: "High-Value US Traffic"
  Filters:
    Country = United States
    Channel = Paid Search
    Event = Purchase (with revenue > 0)

---

Using Segments

Apply a segment

Click the Segments dropdown in the filter bar to see your saved segments. Select one to apply all its filters instantly.

When a segment is active, the filter bar shows the segment name with a colored badge. You can add extra filters on top of a segment — the additional filters are combined with AND logic.

Compare segments

Ovyxa supports comparing two time periods or two segments side-by-side:

1. Apply a segment (e.g., "Organic Traffic").
2. Click the Compare toggle in the date picker.
3. Choose Compare to Segment and select a second segment (e.g., "Paid Traffic").

The dashboard shows both segments with percentage differences on every metric — visitors, pageviews, bounce rate, visit duration, and revenue.

Organic Traffic:  1,240 visitors  |  $3,200 revenue  |  RPV $2.58
Paid Traffic:     890 visitors    |  $4,100 revenue   |  RPV $4.61  (+79%)

Segment in API queries

Pass a segment ID to any stats endpoint using the segment query parameter:

curl "https://api.ovyxa.com/api/v1/stats/overview?site_id=example.com&segment=seg_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

You can also pass segment filters inline without saving:

curl "https://api.ovyxa.com/api/v1/stats/sources?site_id=example.com&filters=country%3DUS%3Bchannel%3DOrganic%20Search" \
  -H "Authorization: Bearer YOUR_API_KEY"

---

Managing Segments

Edit a segment

Go to Settings → Segments or click the pencil icon next to a segment name in the dropdown. You can rename it or modify its filters.

Delete a segment

Click the trash icon in the segment list. Deleting a segment does not affect your data — it only removes the saved filter shortcut.

Segment visibility

Segments are per-site and visible to all team members with access to that site. Any editor or owner can create, edit, or delete segments. Viewers can apply segments but cannot modify them.

---

Segment Ideas

Here are common segments that founders find useful:

Segment Name	Filters	Purpose
Paying Customers	Event = Purchase	See behavior of users who converted
Blog Readers	Entry page starts with /blog	Measure content marketing ROI
Mobile Users	Device = Mobile	Check mobile experience quality
Organic from US	Country = US, Channel = Organic Search	Core organic audience
Trial Signups	Event = Signup, Property plan = trial	Track trial funnel
High-Value	Event = Purchase, Revenue > $100	Identify big-ticket patterns

---

Limits

Plan	Max Segments
Free	0
Starter	10
Growth	50
Business	Unlimited

Segments are stored in PostgreSQL and do not count toward your event quota.