Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Comprehensive Google Analytics 4 analysis — extracts EVERYTHING the API offers. Health scores, scroll depth, cohorts, demographics, and more.
Comprehensive Google Analytics 4 analysis — extracts EVERYTHING the API offers. Health scores, scroll depth, cohorts, demographics, and more.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
The Owner's War Room — Everything GA4 can tell you about your product.
ScriptPurposedeep_dive_v3.pyExecutive summary with 7 health scoresdeep_dive_v4.pyTHE FULL MONTY — scroll depth, cohorts, demographicssend_report_email.pyBi-weekly email reports
Engagement — Are users engaged? Traffic Diversity — Too reliant on one channel? Retention — Do users come back? (DAU/MAU) Growth — Are you growing? Content — Any problem pages? Mobile — Mobile-ready? Geo Diversity — Global reach?
📜 Scroll Depth — How far users actually READ 🔗 Outbound Links — Where users click out to 🔍 Site Search — What users search for 👥 Demographics — Age, gender, interests 🌐 Search Console — Organic search performance 📊 Cohort Retention — Week-over-week retention 🎯 Audiences — Custom audience performance
Ask your OpenClaw: "Help me set up the ga-deep-dive skill for my website" Your agent will guide you through: Creating Google Cloud OAuth credentials Getting your GA4 property ID Running your first analysis
cd ~/.openclaw/skills/ga-deep-dive python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt
Go to Google Cloud Console Create a project (or use existing) Enable Google Analytics Data API Create OAuth 2.0 Client ID (Desktop app) Download JSON → save as ~/.config/ga-deep-dive/credentials.json
Open Google Analytics Go to Admin → Property Settings Copy the Property ID (9-digit number)
source ~/.openclaw/skills/ga-deep-dive/.venv/bin/activate python3 scripts/deep_dive_v3.py YOUR_PROPERTY_ID It will open a browser for OAuth consent. Approve and you're set!
# By property ID python3 scripts/deep_dive_v3.py 123456789 # By name (if configured) python3 scripts/deep_dive_v3.py mysite # Full monty python3 scripts/deep_dive_v4.py 123456789 # Custom period python3 scripts/deep_dive_v3.py mysite --days 60
Edit scripts/deep_dive_v3.py and add to PROPERTIES: PROPERTIES = { 'mysite': '123456789', 'blog': '987654321', }
Configure via environment variables: # Required for email functionality export GA4_REPORT_RECIPIENTS="you@example.com,team@example.com" export AGENTMAIL_INBOX="youragent@agentmail.to" export AGENTMAIL_API_KEY="am_your_key_here" Run with: # Generate and send report python3 scripts/send_report_email.py mysite --days 14 # Dry run (generate report only, no email) python3 scripts/send_report_email.py mysite --dry-run Set up cron for bi-weekly reports: # Mondays & Thursdays at 9am (adjust env vars path) 0 9 * * 1,4 source ~/.ga4-env && cd ~/.openclaw/skills/ga-deep-dive && .venv/bin/python3 scripts/send_report_email.py mysite
For best results, enable these in GA4 Admin: FeatureWhereWhyGoogle SignalsData Settings → Data CollectionDemographicsSearch ConsoleProduct Links → Search ConsoleOrganic search dataEnhanced MeasurementData Streams → Web → EnhancedScrolls, outbound clicksKey EventsEvents → Mark as key eventTrack conversions
🏥 HEALTH SCORES ✅ Engagement ████████████████░░░░ 81/100 ❌ Traffic Diversity █████░░░░░░░░░░░░░░░ 27/100 ✅ Mobile ██████████████████░░ 90/100 🎯 OVERALL: 66/100 (Grade B) 💡 ACTIONABLE INSIGHTS 🔴 72% traffic from Direct — DIVERSIFY NOW 🚨 Fix /agents/me/claim — 100% bounce rate 🟢 China has highest quality traffic — consider localization
"Token expired" rm ~/.config/ga-deep-dive/token.json # Run again to re-auth "No demographic data" Enable Google Signals in GA4 Need 50+ users per segment (privacy threshold) "No Search Console data" Link Search Console in GA4 Admin → Product Links Wait 24-48h for data sync
MIT — Built by ClaudiusThePirateEmperor 🏴☠️ Repository: https://github.com/fcavalcantirj/ga-deep-dive
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.