Google Analytics

Google Analytics Analysis

Analyze website performance using Google Analytics data to provide actionable insights and improvement recommendations.

Quick Start

1. Setup Authentication

This Skill requires Google Analytics API credentials. Set up environment variables:

export GOOGLE_ANALYTICS_PROPERTY_ID="your-property-id"
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"

Or create a .env file in your project root:

GOOGLE_ANALYTICS_PROPERTY_ID=123456789
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json

Never commit credentials to version control. The service account JSON file should be stored securely outside your repository.

2. Install Required Packages

# Option 1: Install from requirements file (recommended)
pip install -r cli-tool/components/skills/analytics/google-analytics/requirements.txt

# Option 2: Install individually
pip install google-analytics-data python-dotenv pandas

3. Analyze Your Project

Once configured, I can:

How to Use

Ask me questions like:

Analysis Workflow

When you ask me to analyze Google Analytics data, I will:

- Traffic trends and patterns

- User behavior insights

- Performance bottlenecks

- Conversion opportunities

- Specific improvement suggestions

- Priority level (high/medium/low)

- Expected impact

- Implementation guidance

Common Metrics

For detailed metric definitions and dimensions, see REFERENCE.md.

Traffic Metrics

Engagement Metrics

Acquisition Metrics

Conversion Metrics

Analysis Examples

For complete analysis patterns and use cases, see EXAMPLES.md.

Scripts

The Skill includes utility scripts for API interaction:

Fetch Current Performance

python scripts/ga_client.py --days 30 --metrics sessions,users,bounceRate

Analyze and Generate Report

python scripts/analyze.py --period last-30-days --compare previous-period

The scripts handle API authentication, data fetching, and basic analysis. I'll interpret the results and provide actionable recommendations.

Troubleshooting

Authentication Error: Verify that:

No Data Returned: Check that:

Import Errors: Install required packages:

pip install google-analytics-data python-dotenv pandas

Security Notes

Data Privacy

This Skill accesses aggregated analytics data only. It does not:

All data is processed locally and used only to generate recommendations during the conversation.