Analyze Web Traffic
Quick Start
To analyze web traffic:
- Query pageview and session data via the Altertable MCP server
- Compare the current period against a previous period (WoW, MoM, or YoY)
- Segment by traffic source, device, geography, or page
- Surface anomalies, trends, and actionable findings
When to Use This Skill
- User asks about website traffic, pageviews, or sessions
- Investigating traffic spikes, drops, or trends
- Comparing traffic across time periods or segments
- Evaluating traffic source mix or user engagement
Analysis Workflow
Step 1: Determine Scope and Time Frame
Ask the user (or infer from context):
- Period: What date range to analyze (default to last 7 days if unspecified)
- Comparison: What to compare against (previous period of equal length)
- Focus: Overall traffic, a specific source, a specific page, or a segment
Step 2: Query Traffic Data
Use Altertable MCP tools to fetch web analytics data:
get_catalog to confirm the Product Analytics tables and columns available in this environment
query_lakehouse for custom web traffic analysis
render_insight when the user wants a chart preview
Common Product Analytics tables include product_analytics.analytics.web_sessions and product_analytics.analytics.web_pageviews. Query them to compute:
- Volume: pageviews, sessions, unique visitors
- Engagement: bounce rate, pages per session, avg session duration
- Acquisition: traffic by source/medium, referrer breakdown
Always pull both the current period and the comparison period so you can compute deltas.
Step 3: Segment the Data
Break down by at least one dimension to find where changes originate:
- Traffic source: organic, paid, direct, social, referral, email
- Device type: desktop, mobile, tablet
- Geography: country, region
- Page or section: top pages, landing pages, exit pages
When a top-level metric moves, drill into segments to isolate which segment drove the change.
Step 4: Identify Patterns and Anomalies
Look for:
- Trends: sustained directional movement across multiple periods
- Anomalies: single-period spikes or drops that break the pattern
- Shifts in mix: a source growing as a share even if total traffic is flat
Quantify every observation with absolute numbers and percentage change.
Step 5: Summarize and Recommend
Present findings with:
- The metric, its value, and the delta vs. the comparison period
- Which segment is responsible for the change
- A hypothesis for why (site changes, seasonality, campaigns)
- A suggested next step or action when applicable
Time Period Comparison Guide
| Comparison |
When to Use |
| WoW (week-over-week) |
Short-term monitoring, recent changes |
| MoM (month-over-month) |
Growth tracking, campaign evaluation |
| YoY (year-over-year) |
Seasonal businesses, long-term trends |
Always compare equal-length periods. When comparing WoW, align on the same day of week. When comparing MoM, account for differing month lengths.
Segmentation Priorities
When the user does not specify a segment, default to this order:
- Traffic source -- most common driver of traffic changes
- Device type -- surfaces mobile vs. desktop divergence
- Top pages -- pinpoints content driving volume shifts
Only add geography or other dimensions if the first pass does not explain the change.
Common Pitfalls
- Reporting totals without comparison: always include a delta to a prior period so the user can gauge significance
- Ignoring seasonality: a WoW drop on a holiday week is expected, not alarming -- flag it rather than over-interpreting
- Mixing up pageviews and sessions: these measure different things; present both when discussing volume
- Not drilling into segments: a flat total can hide offsetting gains and losses across sources or pages
- Presenting numbers without context: raw counts are meaningless without comparison, percentage change, or benchmarks
- Forgetting to check for tracking issues: sudden drops to zero or impossible spikes often indicate instrumentation problems, not real traffic changes
Reference Files
- Web events reference
- Session analysis
- Trend comparison
1---2name: analyze-web-traffic3description: Analyzes website traffic (pageviews, sessions, referrers, landing pages). Use for site visits, traffic sources, bounce, or visitor behavior.4---56# Analyze Web Traffic78## Quick Start910To analyze web traffic:111. Query pageview and session data via the Altertable MCP server122. Compare the current period against a previous period (WoW, MoM, or YoY)133. Segment by traffic source, device, geography, or page144. Surface anomalies, trends, and actionable findings1516## When to Use This Skill1718- User asks about website traffic, pageviews, or sessions19- Investigating traffic spikes, drops, or trends20- Comparing traffic across time periods or segments21- Evaluating traffic source mix or user engagement2223## Analysis Workflow2425### Step 1: Determine Scope and Time Frame2627Ask the user (or infer from context):28- **Period**: What date range to analyze (default to last 7 days if unspecified)29- **Comparison**: What to compare against (previous period of equal length)30- **Focus**: Overall traffic, a specific source, a specific page, or a segment3132### Step 2: Query Traffic Data3334Use Altertable MCP tools to fetch web analytics data:3536- `get_catalog` to confirm the Product Analytics tables and columns available in this environment37- `query_lakehouse` for custom web traffic analysis38- `render_insight` when the user wants a chart preview3940Common Product Analytics tables include `product_analytics.analytics.web_sessions` and `product_analytics.analytics.web_pageviews`. Query them to compute:41- **Volume**: pageviews, sessions, unique visitors42- **Engagement**: bounce rate, pages per session, avg session duration43- **Acquisition**: traffic by source/medium, referrer breakdown4445Always pull both the current period and the comparison period so you can compute deltas.4647### Step 3: Segment the Data4849Break down by at least one dimension to find where changes originate:50- **Traffic source**: organic, paid, direct, social, referral, email51- **Device type**: desktop, mobile, tablet52- **Geography**: country, region53- **Page or section**: top pages, landing pages, exit pages5455When a top-level metric moves, drill into segments to isolate which segment drove the change.5657### Step 4: Identify Patterns and Anomalies5859Look for:60- **Trends**: sustained directional movement across multiple periods61- **Anomalies**: single-period spikes or drops that break the pattern62- **Shifts in mix**: a source growing as a share even if total traffic is flat6364Quantify every observation with absolute numbers and percentage change.6566### Step 5: Summarize and Recommend6768Present findings with:69- The metric, its value, and the delta vs. the comparison period70- Which segment is responsible for the change71- A hypothesis for why (site changes, seasonality, campaigns)72- A suggested next step or action when applicable7374## Time Period Comparison Guide7576| Comparison | When to Use |77|------------|-------------|78| WoW (week-over-week) | Short-term monitoring, recent changes |79| MoM (month-over-month) | Growth tracking, campaign evaluation |80| YoY (year-over-year) | Seasonal businesses, long-term trends |8182Always compare equal-length periods. When comparing WoW, align on the same day of week. When comparing MoM, account for differing month lengths.8384## Segmentation Priorities8586When the user does not specify a segment, default to this order:871. **Traffic source** -- most common driver of traffic changes882. **Device type** -- surfaces mobile vs. desktop divergence893. **Top pages** -- pinpoints content driving volume shifts9091Only add geography or other dimensions if the first pass does not explain the change.9293## Common Pitfalls9495- **Reporting totals without comparison**: always include a delta to a prior period so the user can gauge significance96- **Ignoring seasonality**: a WoW drop on a holiday week is expected, not alarming -- flag it rather than over-interpreting97- **Mixing up pageviews and sessions**: these measure different things; present both when discussing volume98- **Not drilling into segments**: a flat total can hide offsetting gains and losses across sources or pages99- **Presenting numbers without context**: raw counts are meaningless without comparison, percentage change, or benchmarks100- **Forgetting to check for tracking issues**: sudden drops to zero or impossible spikes often indicate instrumentation problems, not real traffic changes101102## Reference Files103104- [Web events reference](references/web-events.md)105- [Session analysis](references/session-analysis.md)106- [Trend comparison](references/trend-comparison.md)