Usage Tracking & Alerts

Monitor your usage to stay within plan limits and avoid service interruptions. Set up alerts to get notified before reaching limits.

Understanding Usage Limits

What Counts as an Event

Events are the core unit of measurement:

Event Type	Description
Page View	Each page load tracked
Custom Event	Goals, clicks, form submissions
Session Start	New visitor session beginning
Error	JavaScript error captured

Plan Limits

Plan	Events/Month	Websites	Team Members
Free	3,000	1	2
Pro	100,000	10	10
Scale	1,000,000	50	50
Enterprise	Unlimited	Unlimited	Unlimited

Viewing Current Usage

Access Usage Dashboard

1. Go to Settings → Billing
2. Click "Usage" tab
3. View current period statistics

Usage Overview

The dashboard shows:

• Events Used: Current count vs. limit
• Usage Percentage: Visual progress bar
• Projected Usage: End-of-month estimate
• Days Remaining: In current billing cycle

Usage Breakdown

Pro Plan

Detailed breakdown by:

Dimension	Available
By Website	Which sites use most events
By Day	Daily usage patterns
By Event Type	Page views vs. custom events
By Traffic Source	Where traffic comes from

Setting Up Usage Alerts

Alert Types

Alert	When Triggered
50% Warning	Half of limit used
75% Warning	Three-quarters used
90% Critical	Nearly at limit
100% Limit	Limit reached

Configuring Alerts

Alert Delivery

Alerts sent via:

• Email (primary)
• In-app notification
• Dashboard banner

What Happens at Limit

Free Plan

When you hit the limit:

• Tracking pauses for the month
• Dashboard shows existing data
• Resets on next billing date
• Upgrade to continue tracking

Paid Plans

When approaching limit:

• Alerts at configured thresholds
• Option to upgrade mid-cycle
• Overage charges may apply
• Never lose existing data

Overage Handling

Pro Plan

Options when exceeding limits:

Option	Description
Hard Stop	Tracking pauses at limit
Soft Limit	Continue with overage charges
Auto-Upgrade	Move to next tier automatically

Configure in Settings → Billing → Overage Settings.

Reducing Usage

Filter Unnecessary Traffic

Reduce events without losing insights:

1. Exclude Bot Traffic

   • Enable bot filtering in Settings
   • Automatically excludes known bots

2. Filter Internal Traffic

   • Exclude your team's IP addresses
   • Go to Domains, select your website, then configure IP Filtering

3. Exclude Staging Sites

   • Don't track development environments
   • Use separate tracking codes

Optimize Tracking

• Track only important pages
• Reduce custom event frequency
• Use sampling for high-traffic sites

Remove Unused Websites

If you're tracking sites you no longer need:

1. Go to Domains
2. Remove or archive unused sites
3. Free up capacity for important sites

Usage History

View Historical Usage

1. Go to Settings → Billing → Usage
2. Click "History" tab
3. View past months' usage

Usage Trends

Pro Plan

Analyze trends to plan capacity:

• Month-over-month growth
• Seasonal patterns
• Traffic spikes

Export Usage Data

1. Go to Usage History
2. Select date range
3. Click "Export CSV"
4. Download for analysis

Usage Projections

End-of-Month Estimate

The dashboard shows:

• Current usage pace
• Projected month-end total
• Likelihood of hitting limit

Planning Ahead

Use projections to:

• Decide if upgrade needed
• Plan marketing campaigns
• Budget for overages

Multi-Website Usage

Per-Website Breakdown

Pro Plan

See usage by website:

1. Go to Settings → Billing → Usage
2. View "By Website" breakdown
3. Identify high-usage sites

Prioritizing Websites

If approaching limits:

• Pause tracking on lower-priority sites
• Focus on most important properties
• Consider archiving inactive sites

Team Usage Visibility

Who Can See Usage

Role	Access
Owner	Full usage data and settings
Admin	View usage, manage alerts
Member	View current usage only
Viewer	No usage access

Sharing Usage Reports

Scale Plan

1. Go to Usage Dashboard
2. Click "Share Report"
3. Generate shareable link
4. Set expiration if needed

API Usage

Pro Plan

Checking Usage via API

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.zenovay.com/api/v1/usage

Response

{
  "current_period": {
    "start": "2025-01-01",
    "end": "2025-01-31",
    "events_used": 45000,
    "events_limit": 100000,
    "percentage": 45
  },
  "projected": {
    "end_of_month": 92000,
    "likelihood_overage": "low"
  }
}

Usage Webhooks

Get real-time usage updates:

1. Configure webhook endpoint
2. Select usage events to receive
3. Receive POST notifications

FAQ

When does usage reset?

On your billing date each month.

Can I buy additional events?

Pro and Scale plans can purchase event packs or upgrade mid-cycle.

Do failed tracking calls count?

No, only successfully recorded events count.

What about test events?

Test events from staging environments count. Use separate tracking codes for testing.

Can I see real-time usage?

Usage updates every few minutes, not real-time.

Troubleshooting

Usage Seems Too High

• Check for bot traffic
• Review IP filtering settings
• Look for duplicate tracking codes
• Verify staging sites excluded

Alerts Not Received

• Check spam folder
• Verify email addresses
• Confirm alerts enabled
• Check notification preferences

Next Steps

• Understand your plan limits
• Upgrade your subscription
• Learn about pay-as-you-go