Usage Tracking

Monitor your event usage, understand your billing, and avoid surprises with real-time usage tracking.

Viewing Your Usage

Access usage information from your dashboard:

1. Log in to your Ovyxa account
2. Go to Settings → Billing
3. View Current Usage section

Current Usage Dashboard

Events This Month

See your event usage for the current billing period:

Usage display:

45,234 / 50,000 events (90%)

This shows:

• Events used this month
• Your plan's monthly limit
• Percentage of limit consumed

Visual Progress Bar

Color-coded to indicate status:

• Green (0-79%): Healthy usage
• Yellow (80-99%): Approaching limit
• Red (100%+): Limit exceeded

Breakdown by Site

If you have multiple sites:

mysite.com          32,450 events (72%)
myblog.com          12,784 events (28%)
Total              45,234 events

Click any site to see detailed usage for that specific domain.

Historical Usage

Monthly Chart

View your usage trends over time:

• Interactive chart showing last 12 months
• Hover for exact event counts
• Compare month-over-month growth
• Identify seasonal patterns

Usage Table

Detailed monthly breakdown:

Month	Events	Plan Limit	Percentage	Overage
Oct 2024	42,234	50,000	84%	-
Sep 2024	36,543	50,000	73%	-
Aug 2024	58,890	50,000	118%	$5

Export this data as CSV for further analysis.

Usage Notifications

Email Alerts

Automatic notifications when you reach usage thresholds:

80% threshold:

Subject: You've used 80% of your monthly events

Hi there,

You've used 40,000 of your 50,000 monthly events.
Consider upgrading to avoid service interruptions.

View usage: [Dashboard link]

100% threshold:

Subject: You've reached your event limit

Your site has used 100% of its monthly event limit.
We'll continue tracking, but consider upgrading.

120% threshold (paid plans):

Subject: Overage charges applied

You've exceeded your plan by 20%. Overage charges
of $10 will be added to your next invoice.

In-Dashboard Notifications

Banner appears at top of dashboard:

• Yellow banner at 80%
• Red banner at 100%
• Dismissible but reappears daily
• Direct link to upgrade page

Understanding Event Counts

What Counts as an Event

Pageviews:

• Every page load = 1 event
• SPA route changes = 1 event each
• Page refreshes = 1 event

Custom events:

• Each tracked action = 1 event
• Button clicks, form submissions, etc.

Automatic tracking (if enabled):

• Outbound link click = 1 event
• File download = 1 event

What Doesn't Count

Not counted toward your limit:

• Excluded pages (via settings)
• Excluded IPs
• Bot traffic (filtered automatically)
• Failed requests or errors
• Duplicate events (within 10 seconds)

Event Properties

Custom event properties don't increase count:

// This is 1 event, not 3
window.ovyxa('event', 'Purchase', {
  amount: 49.99,
  plan: 'pro',
  currency: 'USD'
})

Overage Handling

Soft Limits

Ovyxa uses soft limits to prevent tracking interruptions:

Free tier:

• Tracking continues to 150k events
• Email notifications at 80%, 100%, 120%
• Must upgrade to continue beyond 150k
• After 150k, tracking pauses until upgrade or new month

Paid plans:

• No hard cutoff
• Tracking continues regardless of overage
• Overage charges apply monthly
• Reasonable overage expected and allowed

Overage Pricing

Starter and Growth plans:

• $5 per 100,000 additional events
• Charged at end of billing cycle
• Prorated for partial 100k increments

Example:

• Plan: Starter (1M events, $9/mo)
• Used: 1.2M events
• Overage: 200k events
• Overage charge: $10
• Total bill: $19

Enterprise plans:

• Custom overage agreements
• Volume discounts
• Predictable annual pricing

Preventing Overage

To avoid unexpected charges:

1. Monitor usage regularly - Check weekly
2. Set up alerts - Enable all email notifications
3. Upgrade proactively - Don't wait for 100%
4. Use IP exclusions - Filter internal traffic
5. Optimize tracking - Only track what you need

Billing Cycle

When Usage Resets

Your event counter resets on your billing renewal date:

Monthly plans:

• Resets same day each month
• Example: Signed up Jan 15 → resets Feb 15, Mar 15, etc.

Annual plans:

• Monthly event limits still apply
• Resets same day each month within annual period
• Example: 1M events/month, not 12M events/year

Viewing Billing Date

Check your renewal date:

1. Go to Settings → Billing
2. View Next Billing Date
3. Usage resets at 00:00 UTC on that date

Invoices

Accessing Invoices

Download past invoices:

1. Go to Settings → Billing
2. Scroll to Invoices
3. Click Download for any invoice

Invoice Contents

Each invoice includes:

• Plan name and period
• Base subscription cost
• Event usage and overage charges
• Taxes (if applicable)
• Payment method
• Transaction ID

Invoice Format

Invoices are:

• PDF format
• Business-ready (includes VAT if EU)
• Includes your billing details
• Shows itemized charges

Usage Optimization

Reducing Event Count

Strategies to stay within your plan:

Filter internal traffic:

Settings → General → IP Exclusions
Add: 192.168.1.0/24

Exclude admin pages:

Settings → General → Excluded Pages
Add: ^/admin|^/dashboard

Disable unnecessary tracking:

• Turn off outbound link tracking if not needed
• Disable file download tracking if not needed
• Only track important custom events

Optimize SPA tracking:

• Don't track every micro-interaction
• Consolidate similar events
• Use event properties instead of separate events

Right-Sizing Your Plan

Choose the right plan for your needs:

Growing quickly?

• Upgrade before hitting 80%
• Avoid monthly overage charges
• Annual billing saves 17%

Usage declining?

• Downgrade to save money
• Takes effect next billing cycle
• No penalties for downgrading

Frequently Asked Questions

Can I see real-time usage?

Yes, the usage dashboard updates every few minutes showing current month usage.

What if I exceed my limit?

We continue tracking and send notifications. Paid plans incur overage charges. Free tier stops at 150k events.

How accurate is the usage counter?

Very accurate. Updates within 5 minutes of actual usage, synchronized with billing system.

Can I get usage via API?

Yes, use the Stats API to fetch your current usage programmatically.

Do you offer usage alerts via SMS?

Currently email only. SMS alerts available for Enterprise plans.

What timezone is usage tracked in?

UTC for billing consistency. Your dashboard shows data in your configured timezone.

Monitoring Best Practices

Weekly Check-Ins

Review usage weekly to:

• Spot unusual spikes
• Predict end-of-month usage
• Catch tracking issues early
• Plan upgrades if needed

Set Calendar Reminders

Create reminders for:

• Weekly usage check (recommended)
• 5 days before billing cycle ends
• Day after billing cycle resets

Automate Monitoring

For technical users:

# Check usage via API
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.ovyxa.com/v1/billing/usage

# Response:
{
  "current_month": 45234,
  "limit": 100000,
  "percentage": 45.2,
  "billing_cycle_end": "2024-11-30"
}

Set up automated alerts using this endpoint.

Need Help?

Usage or billing questions:

• Email support@ovyxa.com
• Check pricing plans for plan details
• Review upgrade guide
• Contact sales for custom needs

We're here to help you stay within budget while getting the analytics you need.