# Amplitude

Analyze product analytics, user behavior, and engagement patterns

<Image align="left" width="200px" src="https://files.readme.io/6c4c3c5-amplitude-logo.png" />

<br />

Connect Amplitude to Scoop to analyze product analytics data, understand user behavior patterns, and measure feature adoption. Combine event data with other business sources for comprehensive insights.

# AI-Assisted Setup

When connecting Amplitude to Scoop, choose **"Guide me with AI"** for an intelligent, guided setup experience.

## Available Analysis Templates

| Template | Object | Best For | What You'll Analyze |
|----------|--------|----------|---------------------|
| **User Activity Events** (Default) | events | User engagement | Event type, user ID, timestamp, platform, event properties |
| **Platform Breakdown** | events | Device & platform analysis | Event type, user, platform, OS, device type, country |
| **Geographic Trends** | events | Location-based analysis | Event type, user, country, city, platform |

## Example Questions You Can Answer

**User Engagement:**
- "What are the most frequent event types?"
- "How many unique users are active per day?"
- "What's the average number of events per user session?"
- "What's the trend in daily active users over time?"
- "Which events correlate with user retention?"

**Platform Analysis:**
- "What percentage of events come from mobile vs web?"
- "Which platforms have the highest engagement?"
- "How does behavior differ across iOS, Android, and web?"
- "What's the device distribution for key conversion events?"
- "How does session depth vary by platform?"

**Geographic Insights:**
- "Which countries have the most active users?"
- "How does engagement vary by region?"
- "What features are popular in different markets?"
- "What's the user growth rate by country?"
- "How does conversion rate vary by geographic region?"

## Need Something Different?

If the templates above don't match your needs, select **"Something else"** and describe what you want to analyze. For example:

- "I want to analyze specific event properties"
- "I need to focus on a particular user segment"
- "I want to track funnel conversion over time"

Scoop's AI will recommend the right configuration for your specific use case.

# Connecting Amplitude to Scoop

1. Create a new dataset in Scoop
2. Select **Amplitude** from the application list
3. Enter your Amplitude API key and Secret key in the format: `{apiKey}:{secretKey}`
   - Find these in Amplitude under Organization Settings → Project Settings
4. Select your date range for the event export
5. Save and extract data

# What Data You Get

Amplitude event exports include:

| Field | Description |
|-------|-------------|
| Event Type | The name of the event (e.g., "Button Clicked", "Page Viewed") |
| User ID | Unique identifier for the user |
| Device ID | Device-level identifier |
| Event Time | When the event occurred |
| Session ID | Groups events in a session |
| Platform | iOS, Android, Web, etc. |
| OS/Device Type | Operating system and device details |
| Location | Country and city |
| Event Properties | JSON object with event-specific data |
| User Properties | JSON object with user attributes |

# Analysis Examples

## Feature Adoption

Track how users engage with specific features:
- Event counts by feature over time
- User adoption rates
- Feature engagement funnels

## User Behavior Patterns

Understand how users navigate your product:
- Common event sequences
- Time between events
- Session depth analysis

## Platform Comparison

Compare engagement across platforms:
- Event volume by platform
- Feature usage differences
- Platform-specific patterns

# Blending Amplitude with Other Data

Amplitude becomes even more powerful when combined with other sources:

## Amplitude + CRM Data

**Goal**: Connect user behavior to revenue

| Amplitude Data | CRM Data | Combined Insight |
|----------------|----------|------------------|
| Feature usage | Customer tier | Feature adoption by segment |
| Event frequency | Deal value | Engagement vs. revenue correlation |
| Session depth | Churn status | Behavioral leading indicators |

## Amplitude + Marketing Data

**Goal**: Understand acquisition quality

- Which campaigns bring engaged users?
- What's the correlation between feature adoption and CAC?
- How does behavior vary by acquisition source?

# Best Practices

## Date Range Selection

- Export a focused date range to keep data manageable
- Start with 30 days for initial analysis
- Expand range for trend analysis

## Data Hygiene

- Use consistent event naming conventions
- Leverage event properties for deeper analysis
- Combine with CRM data to correlate behavior with revenue

## Analysis Cadence

| Analysis | Recommended Frequency |
|----------|----------------------|
| Engagement metrics | Daily/Weekly |
| Feature adoption | Weekly |
| Cohort analysis | Monthly |
| Platform comparison | Monthly |

# Troubleshooting

## Connection Issues

- Verify API key and secret are correct (format: `apiKey:secretKey`)
- Check that your Amplitude plan includes API access
- Ensure the project ID matches your intended workspace

## Missing Events

- Confirm date range includes expected events
- Check event naming matches what you're searching for
- Verify events are being tracked in Amplitude

## Large Data Volumes

- Amplitude event exports can be large
- Start with shorter date ranges
- Use filters in Scoop to focus analysis

# Related Topics

- [Blending Datasets](../../Preparing%20Datasets/blending-two-datasets) - Combine with CRM/marketing data
- [Creating KPIs](../../Exploring%20and%20Visualizing%20Data/creating-kpis) - Custom engagement metrics
- [Time Series Analysis](../../Exploring%20and%20Visualizing%20Data/time-series-analysis) - Track trends over time