{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ga-deep-dive",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ga-deep-dive",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "TODO.md",
      "requirements.txt",
      "scripts/deep_dive.py",
      "scripts/deep_dive_v2.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ga-deep-dive"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/ga-deep-dive",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "GA4 Deep Dive 📊",
        "body": "The Owner's War Room — Everything GA4 can tell you about your product."
      },
      {
        "title": "What You Get",
        "body": "ScriptPurposedeep_dive_v3.pyExecutive summary with 7 health scoresdeep_dive_v4.pyTHE FULL MONTY — scroll depth, cohorts, demographicssend_report_email.pyBi-weekly email reports"
      },
      {
        "title": "Health Scores",
        "body": "Engagement — Are users engaged?\nTraffic Diversity — Too reliant on one channel?\nRetention — Do users come back? (DAU/MAU)\nGrowth — Are you growing?\nContent — Any problem pages?\nMobile — Mobile-ready?\nGeo Diversity — Global reach?"
      },
      {
        "title": "Deep Analysis (v4)",
        "body": "📜 Scroll Depth — How far users actually READ\n🔗 Outbound Links — Where users click out to\n🔍 Site Search — What users search for\n👥 Demographics — Age, gender, interests\n🌐 Search Console — Organic search performance\n📊 Cohort Retention — Week-over-week retention\n🎯 Audiences — Custom audience performance"
      },
      {
        "title": "Quick Start",
        "body": "Ask your OpenClaw:\n\n\"Help me set up the ga-deep-dive skill for my website\"\n\nYour agent will guide you through:\n\nCreating Google Cloud OAuth credentials\nGetting your GA4 property ID\nRunning your first analysis"
      },
      {
        "title": "1. Install Dependencies",
        "body": "cd ~/.openclaw/skills/ga-deep-dive\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r requirements.txt"
      },
      {
        "title": "2. Get Google OAuth Credentials",
        "body": "Go to Google Cloud Console\nCreate a project (or use existing)\nEnable Google Analytics Data API\nCreate OAuth 2.0 Client ID (Desktop app)\nDownload JSON → save as ~/.config/ga-deep-dive/credentials.json"
      },
      {
        "title": "3. Get Your GA4 Property ID",
        "body": "Open Google Analytics\nGo to Admin → Property Settings\nCopy the Property ID (9-digit number)"
      },
      {
        "title": "4. First Run (Auth)",
        "body": "source ~/.openclaw/skills/ga-deep-dive/.venv/bin/activate\npython3 scripts/deep_dive_v3.py YOUR_PROPERTY_ID\n\nIt will open a browser for OAuth consent. Approve and you're set!"
      },
      {
        "title": "Run Analysis",
        "body": "# By property ID\npython3 scripts/deep_dive_v3.py 123456789\n\n# By name (if configured)\npython3 scripts/deep_dive_v3.py mysite\n\n# Full monty\npython3 scripts/deep_dive_v4.py 123456789\n\n# Custom period\npython3 scripts/deep_dive_v3.py mysite --days 60"
      },
      {
        "title": "Configure Property Names",
        "body": "Edit scripts/deep_dive_v3.py and add to PROPERTIES:\n\nPROPERTIES = {\n    'mysite': '123456789',\n    'blog': '987654321',\n}"
      },
      {
        "title": "Email Reports (Optional)",
        "body": "Configure via environment variables:\n\n# Required for email functionality\nexport GA4_REPORT_RECIPIENTS=\"you@example.com,team@example.com\"\nexport AGENTMAIL_INBOX=\"youragent@agentmail.to\"\nexport AGENTMAIL_API_KEY=\"am_your_key_here\"\n\nRun with:\n\n# Generate and send report\npython3 scripts/send_report_email.py mysite --days 14\n\n# Dry run (generate report only, no email)\npython3 scripts/send_report_email.py mysite --dry-run\n\nSet up cron for bi-weekly reports:\n\n# Mondays & Thursdays at 9am (adjust env vars path)\n0 9 * * 1,4 source ~/.ga4-env && cd ~/.openclaw/skills/ga-deep-dive && .venv/bin/python3 scripts/send_report_email.py mysite"
      },
      {
        "title": "GA4 Setup Tips",
        "body": "For best results, enable these in GA4 Admin:\n\nFeatureWhereWhyGoogle SignalsData Settings → Data CollectionDemographicsSearch ConsoleProduct Links → Search ConsoleOrganic search dataEnhanced MeasurementData Streams → Web → EnhancedScrolls, outbound clicksKey EventsEvents → Mark as key eventTrack conversions"
      },
      {
        "title": "Example Output",
        "body": "🏥 HEALTH SCORES\n   ✅ Engagement           ████████████████░░░░ 81/100\n   ❌ Traffic Diversity    █████░░░░░░░░░░░░░░░ 27/100\n   ✅ Mobile               ██████████████████░░ 90/100\n   \n   🎯 OVERALL: 66/100 (Grade B)\n\n💡 ACTIONABLE INSIGHTS\n   🔴 72% traffic from Direct — DIVERSIFY NOW\n   🚨 Fix /agents/me/claim — 100% bounce rate\n   🟢 China has highest quality traffic — consider localization"
      },
      {
        "title": "Troubleshooting",
        "body": "\"Token expired\"\n\nrm ~/.config/ga-deep-dive/token.json\n# Run again to re-auth\n\n\"No demographic data\"\n\nEnable Google Signals in GA4\nNeed 50+ users per segment (privacy threshold)\n\n\"No Search Console data\"\n\nLink Search Console in GA4 Admin → Product Links\nWait 24-48h for data sync"
      },
      {
        "title": "License",
        "body": "MIT — Built by ClaudiusThePirateEmperor 🏴‍☠️\n\nRepository: https://github.com/fcavalcantirj/ga-deep-dive"
      }
    ],
    "body": "GA4 Deep Dive 📊\n\nThe Owner's War Room — Everything GA4 can tell you about your product.\n\nWhat You Get\nScript\tPurpose\ndeep_dive_v3.py\tExecutive summary with 7 health scores\ndeep_dive_v4.py\tTHE FULL MONTY — scroll depth, cohorts, demographics\nsend_report_email.py\tBi-weekly email reports\nHealth Scores\nEngagement — Are users engaged?\nTraffic Diversity — Too reliant on one channel?\nRetention — Do users come back? (DAU/MAU)\nGrowth — Are you growing?\nContent — Any problem pages?\nMobile — Mobile-ready?\nGeo Diversity — Global reach?\nDeep Analysis (v4)\n📜 Scroll Depth — How far users actually READ\n🔗 Outbound Links — Where users click out to\n🔍 Site Search — What users search for\n👥 Demographics — Age, gender, interests\n🌐 Search Console — Organic search performance\n📊 Cohort Retention — Week-over-week retention\n🎯 Audiences — Custom audience performance\nQuick Start\n\nAsk your OpenClaw:\n\n\"Help me set up the ga-deep-dive skill for my website\"\n\nYour agent will guide you through:\n\nCreating Google Cloud OAuth credentials\nGetting your GA4 property ID\nRunning your first analysis\nManual Setup\n1. Install Dependencies\ncd ~/.openclaw/skills/ga-deep-dive\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r requirements.txt\n\n2. Get Google OAuth Credentials\nGo to Google Cloud Console\nCreate a project (or use existing)\nEnable Google Analytics Data API\nCreate OAuth 2.0 Client ID (Desktop app)\nDownload JSON → save as ~/.config/ga-deep-dive/credentials.json\n3. Get Your GA4 Property ID\nOpen Google Analytics\nGo to Admin → Property Settings\nCopy the Property ID (9-digit number)\n4. First Run (Auth)\nsource ~/.openclaw/skills/ga-deep-dive/.venv/bin/activate\npython3 scripts/deep_dive_v3.py YOUR_PROPERTY_ID\n\n\nIt will open a browser for OAuth consent. Approve and you're set!\n\nUsage\nRun Analysis\n# By property ID\npython3 scripts/deep_dive_v3.py 123456789\n\n# By name (if configured)\npython3 scripts/deep_dive_v3.py mysite\n\n# Full monty\npython3 scripts/deep_dive_v4.py 123456789\n\n# Custom period\npython3 scripts/deep_dive_v3.py mysite --days 60\n\nConfigure Property Names\n\nEdit scripts/deep_dive_v3.py and add to PROPERTIES:\n\nPROPERTIES = {\n    'mysite': '123456789',\n    'blog': '987654321',\n}\n\nEmail Reports (Optional)\n\nConfigure via environment variables:\n\n# Required for email functionality\nexport GA4_REPORT_RECIPIENTS=\"you@example.com,team@example.com\"\nexport AGENTMAIL_INBOX=\"youragent@agentmail.to\"\nexport AGENTMAIL_API_KEY=\"am_your_key_here\"\n\n\nRun with:\n\n# Generate and send report\npython3 scripts/send_report_email.py mysite --days 14\n\n# Dry run (generate report only, no email)\npython3 scripts/send_report_email.py mysite --dry-run\n\n\nSet up cron for bi-weekly reports:\n\n# Mondays & Thursdays at 9am (adjust env vars path)\n0 9 * * 1,4 source ~/.ga4-env && cd ~/.openclaw/skills/ga-deep-dive && .venv/bin/python3 scripts/send_report_email.py mysite\n\nGA4 Setup Tips\n\nFor best results, enable these in GA4 Admin:\n\nFeature\tWhere\tWhy\nGoogle Signals\tData Settings → Data Collection\tDemographics\nSearch Console\tProduct Links → Search Console\tOrganic search data\nEnhanced Measurement\tData Streams → Web → Enhanced\tScrolls, outbound clicks\nKey Events\tEvents → Mark as key event\tTrack conversions\nExample Output\n🏥 HEALTH SCORES\n   ✅ Engagement           ████████████████░░░░ 81/100\n   ❌ Traffic Diversity    █████░░░░░░░░░░░░░░░ 27/100\n   ✅ Mobile               ██████████████████░░ 90/100\n   \n   🎯 OVERALL: 66/100 (Grade B)\n\n💡 ACTIONABLE INSIGHTS\n   🔴 72% traffic from Direct — DIVERSIFY NOW\n   🚨 Fix /agents/me/claim — 100% bounce rate\n   🟢 China has highest quality traffic — consider localization\n\nTroubleshooting\n\n\"Token expired\"\n\nrm ~/.config/ga-deep-dive/token.json\n# Run again to re-auth\n\n\n\"No demographic data\"\n\nEnable Google Signals in GA4\nNeed 50+ users per segment (privacy threshold)\n\n\"No Search Console data\"\n\nLink Search Console in GA4 Admin → Product Links\nWait 24-48h for data sync\nLicense\n\nMIT — Built by ClaudiusThePirateEmperor 🏴‍☠️\n\nRepository: https://github.com/fcavalcantirj/ga-deep-dive"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/fcavalcantirj/ga-deep-dive",
    "publisherUrl": "https://clawhub.ai/fcavalcantirj/ga-deep-dive",
    "owner": "fcavalcantirj",
    "version": "1.0.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}