> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage Tracking

> Monitor your event and conversion usage across all workspaces

Usage Tracking shows your current usage for events and conversions, helping you stay within plan limits and avoid unexpected overage charges.

## What It Does

**Track Usage:**

* Events used this billing period
* Conversions sent to ad platforms
* Usage by workspace
* Overage status
* Days until reset

**Shows:**

* Current usage vs plan limits
* Usage percentage
* Projected overages
* Per-workspace breakdown

## Accessing Usage Tracking

**Go to:** Settings → Billing → Usage section

View real-time usage for current billing period.

## Event Usage

**Events Include:**

* Pageviews
* Custom events you track
* Shopify orders
* Stripe payments
* Any event sent to DATALYR

**Not Counted:**

* System events (session\_start, session\_end)
* Duplicate events (deduplicated automatically)
* Failed/rejected events

**Usage Display:**

```
Events: 32,450 / 50,000 (65%)
Status: ✓ Within limit
Remaining: 17,550 events
Resets: January 15, 2025
```

## Conversion Usage

**Conversions Include:**

* Events sent to Meta Ads
* Events sent to Google Ads
* Events sent to TikTok Ads
* Based on Conversion Rules

**Not Counted:**

* Events tracked in DATALYR only
* Events not matched to Conversion Rules
* Failed postbacks (retries don't count)

**Usage Display:**

```
Conversions: 750 / 1,000 (75%)
Status: ⚠ Nearing limit
Remaining: 250 conversions
Resets: January 15, 2025
```

## Per-Workspace Usage

**Breakdown Shows:**

* Each workspace separately
* Events per workspace
* Conversions per workspace
* Total across all workspaces

**Example:**

```
Workspace: Production Site
Events: 28,000
Conversions: 600

Workspace: Staging Site
Events: 4,450
Conversions: 150

Total: 32,450 events, 750 conversions
```

Useful for agencies managing multiple clients or brands with multiple sites.

## Usage Alerts

**Automatic Notifications:**

* **75%:** Warning - approaching limit
* **90%:** Urgent - nearing limit
* **100%:** Overage - limit exceeded

**Alert Email Includes:**

* Current usage
* Limit exceeded
* Projected overage cost
* Recommendation to upgrade

Sent to account owner only.

## Overage Tracking

**Real-Time Overage Display:**

```
Events: 55,000 / 50,000 (110%)
Overage: 5,000 events
Overage charge: $2 ($2 per 50k)
Status: 🔴 Over limit
```

**Projected Overage:**

```
Current: 32,450 / 50,000 (Day 10 of 30)
Projected: ~97,350 at month end
Projected overage: 47,350 events
Estimated charge: $95
Recommendation: Upgrade to Growth plan
```

Helps you decide whether to upgrade or accept overage charges.

## Usage Trends

**Historical View:**

* Last 3 months usage
* Average monthly usage
* Peak usage days
* Growth trend

**Use Cases:**

* Plan capacity planning
* Identify traffic spikes
* Optimize plan selection
* Budget forecasting

## Understanding Usage Spikes

**Common Causes:**

* Marketing campaign launches
* Viral content or press
* Holiday shopping seasons
* Product launches
* Traffic bot attacks

**Temporary Spikes:**

* Accept overage charges for one-time events
* Cheaper than upgrading annually

**Sustained Growth:**

* Upgrade plan for consistent high usage
* More cost-effective long-term

## Managing Usage

**Reduce Event Usage:**

* Filter out bot traffic
* Remove unnecessary custom events
* Reduce pageview tracking on admin pages
* Consolidate duplicate events

**Reduce Conversion Usage:**

* Limit Conversion Rules to essential events
* Don't send every event to every platform
* Remove test conversion rules

**Example Optimization:**

```
Before:
- Send all events to all platforms
- 3 platforms × 10,000 events = 30,000 conversions

After:
- Send only purchase events to all platforms
- 3 platforms × 2,000 purchases = 6,000 conversions
Savings: 24,000 conversions (80% reduction)
```

## Billing Period

**Usage Resets:**

* Resets on billing anniversary each month
* Counter goes back to 0
* Fresh limits for new period

**Example:**

```
Billing date: 15th of each month
January 15: Reset to 0 events
February 15: Reset to 0 events
March 15: Reset to 0 events
```

Days until reset shown in usage display.

## Multiple Workspaces

**Usage Aggregated:**

* All workspaces count toward total
* Plan limits apply account-wide
* Cannot allocate limits per workspace

**Best Practice:**

* Monitor highest-usage workspaces
* Consider separate accounts for large clients (agencies)
* Use workspace breakdown to identify heavy users

## Workspace-Level Monitoring

**Per Workspace:**

```
Settings → [Select Workspace] → Settings → Usage
```

Shows usage for that specific workspace only.

**Useful For:**

* Agency reporting to clients
* Multi-brand usage tracking
* Identifying problem workspaces

## API Usage Limits

**Separate from Event Limits:**

* API requests for data retrieval
* 10,000 requests/day (all plans)
* Resets daily at midnight UTC

**API Usage Display:**

```
API Requests: 2,450 / 10,000 (25%)
Resets: Today at midnight UTC
```

Shown in Usage Tracking section.

## Best Practices

**Monitor Regularly:**

* Check usage weekly
* Set calendar reminder for billing date
* Review overage projections mid-cycle

**Plan Ahead:**

* Upgrade before hitting limits
* Budget for seasonal spikes
* Review usage trends quarterly

**Optimize Tracking:**

* Only track events you need
* Use Conversion Rules strategically
* Filter internal/test traffic

**Set Budget Alerts:**

* Enable usage notifications
* Set custom thresholds (e.g., 50%)
* Add finance team to alert emails

## Next Steps

<CardGroup cols={2}>
  <Card title="Subscription Management" icon="credit-card" href="/account/subscription-management">
    Upgrade or modify plan
  </Card>

  <Card title="Pricing" icon="dollar-sign" href="/account/pricing">
    Compare plans
  </Card>

  <Card title="Dashboard" icon="gauge" href="/features/dashboard">
    View event metrics
  </Card>

  <Card title="Conversion Rules" icon="arrows-turn-to-dots" href="/integrations/conversion-rules">
    Manage conversion rules
  </Card>
</CardGroup>
