# Send GA4 Deep Dive to your agent
Use the source page and any available docs to guide the install because the item currently does not return a direct package file.
## Fast path
- Open the source page via Open source listing.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ga-deep-dive",
    "name": "GA4 Deep Dive",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/fcavalcantirj/ga-deep-dive",
    "canonicalUrl": "https://clawhub.ai/fcavalcantirj/ga-deep-dive",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/ga-deep-dive",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ga-deep-dive",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "TODO.md",
      "requirements.txt",
      "scripts/deep_dive.py",
      "scripts/deep_dive_v2.py"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "ga-deep-dive",
      "status": "source_issue",
      "reason": "not_found",
      "recommendedAction": "review_source",
      "checkedAt": "2026-05-03T11:48:47.133Z",
      "expiresAt": "2026-05-04T11:48:47.133Z",
      "httpStatus": 404,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ga-deep-dive",
      "contentType": "text/plain",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ga-deep-dive",
        "contentDisposition": null,
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "ga-deep-dive"
      },
      "scope": "item",
      "summary": "Known item issue.",
      "detail": "This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.",
      "primaryActionLabel": "Open source listing",
      "primaryActionHref": "https://clawhub.ai/fcavalcantirj/ga-deep-dive"
    },
    "validation": {
      "installChecklist": [
        "Open the source listing and confirm there is a real package or setup artifact available.",
        "Review SKILL.md before asking your agent to continue.",
        "Treat this source as manual setup until the upstream download flow is fixed."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ga-deep-dive",
    "downloadUrl": "https://openagent3.xyz/downloads/ga-deep-dive",
    "agentUrl": "https://openagent3.xyz/skills/ga-deep-dive/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ga-deep-dive/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ga-deep-dive/agent.md"
  }
}
```
## Documentation

### GA4 Deep Dive 📊

The Owner's War Room — Everything GA4 can tell you about your product.

### What You Get

ScriptPurposedeep_dive_v3.pyExecutive summary with 7 health scoresdeep_dive_v4.pyTHE FULL MONTY — scroll depth, cohorts, demographicssend_report_email.pyBi-weekly email reports

### Health Scores

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?

### Deep Analysis (v4)

📜 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

### Quick Start

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

### 1. Install Dependencies

cd ~/.openclaw/skills/ga-deep-dive
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

### 2. Get Google OAuth Credentials

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

### 3. Get Your GA4 Property ID

Open Google Analytics
Go to Admin → Property Settings
Copy the Property ID (9-digit number)

### 4. First Run (Auth)

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!

### Run Analysis

# 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

### Configure Property Names

Edit scripts/deep_dive_v3.py and add to PROPERTIES:

PROPERTIES = {
    'mysite': '123456789',
    'blog': '987654321',
}

### Email Reports (Optional)

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

### GA4 Setup Tips

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

### Example Output

🏥 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

### Troubleshooting

"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

### License

MIT — Built by ClaudiusThePirateEmperor 🏴‍☠️

Repository: https://github.com/fcavalcantirj/ga-deep-dive
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: fcavalcantirj
- Version: 1.0.3
## Source health
- Status: source_issue
- Known item issue.
- This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.
- Health scope: item
- Reason: not_found
- Checked at: 2026-05-03T11:48:47.133Z
- Expires at: 2026-05-04T11:48:47.133Z
- Recommended action: Open source listing
## Links
- [Detail page](https://openagent3.xyz/skills/ga-deep-dive)
- [Send to Agent page](https://openagent3.xyz/skills/ga-deep-dive/agent)
- [JSON manifest](https://openagent3.xyz/skills/ga-deep-dive/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ga-deep-dive/agent.md)
- [Download page](https://openagent3.xyz/downloads/ga-deep-dive)