{"id":"0ebd1f94-1c95-468b-99e3-0a3763af6bdd","entityType":"agent","slug":"clawhub-hith3sh-google-analytics-reporting","name":"Google Analytics","canonicalUrl":"https://www.xpersona.co/agent/clawhub-hith3sh-google-analytics-reporting","canonicalPath":"/agent/clawhub-hith3sh-google-analytics-reporting","generatedAt":"2026-10-09T13:47:35.807Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":null},"description":"Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski... Skill: Google Analytics Owner: hith3sh Summary: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski... Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-09T07:09:11.244Z | user Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traf","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 7.2K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:google-analytics-reporting","sourceUrl":"https://clawhub.ai/hith3sh/google-analytics-reporting","homepage":"https://clawhub.ai/hith3sh/skills/google-analytics-reporting","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/hith3sh/google-analytics-reporting","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/hith3sh/skills/google-analytics-reporting","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":77,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":null},"stars":null,"forks":null,"downloads":7189,"packageName":null,"latestVersion":"1.0.5","tractionLabel":"7.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T03:03:23.616Z","lastCrawledAt":"2026-10-09T03:03:23.616Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T03:03:23.616Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.5","createdAt":"2026-06-09T07:09:11.244Z","changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","fileCount":3,"zipByteSize":5976},{"version":"1.0.4","createdAt":"2026-06-09T04:52:56.700Z","changelog":"- Removed the file skill-card.md. - No changes to user-facing features or functionality. - Documentation and existing capabilities remain unchanged.","fileCount":3,"zipByteSize":6083},{"version":"1.0.1","createdAt":"2026-06-08T16:36:43.347Z","changelog":"- Added Google Analytics brand logo to the documentation. - Minor content and formatting improvements to SKILL.md for clarity. - Removed the obsolete skill-card.md file.","fileCount":3,"zipByteSize":6005},{"version":"0.1.2","createdAt":"2026-06-07T14:06:07.530Z","changelog":"Add/fix Setup in 3 Steps GIF table so connection GIFs render correctly.","fileCount":3,"zipByteSize":6005},{"version":"0.1.1","createdAt":"2026-06-07T13:29:53.670Z","changelog":"Full rewrite to new standard: added tool reference tables, 3-step GIF table, architecture diagram, code examples, error handling, and troubleshooting.","fileCount":3,"zipByteSize":6097},{"version":"0.1.0","createdAt":"2026-05-03T13:33:39.479Z","changelog":"Initial release integrating Google Analytics with OpenClaw via ClawLink. - Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data directly from chat. - Includes detailed setup and pairing instructions for ClawLink and Google Analytics connections. - Tools and capabilities are provided dynamically based on user integration status. - Ensures user credentials are handled securely through ClawLink; no raw credentials required in chat. - Outlines best practices and rules for safe use and discovery of Google Analytics tools.","fileCount":3,"zipByteSize":3624}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s173vws87a7ss71xf9rq53k5gd8568kv:google-analytics-reporting","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T13:47:35.805Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-hith3sh-google-analytics-reporting/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":null},"readme":"Skill: Google Analytics\n\nOwner: hith3sh\n\nSummary: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski...\n\nTags: latest:1.0.5\n\nVersion history:\n\nv1.0.5 | 2026-06-09T07:09:11.244Z | user\n\nAdd UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.\n\nv1.0.4 | 2026-06-09T04:52:56.700Z | auto\n\n- Removed the file skill-card.md.\n- No changes to user-facing features or functionality.\n- Documentation and existing capabilities remain unchanged.\n\nv1.0.1 | 2026-06-08T16:36:43.347Z | auto\n\n- Added Google Analytics brand logo to the documentation.\n- Minor content and formatting improvements to SKILL.md for clarity.\n- Removed the obsolete skill-card.md file.\n\nv0.1.2 | 2026-06-07T14:06:07.530Z | user\n\nAdd/fix Setup in 3 Steps GIF table so connection GIFs render correctly.\n\nv0.1.1 | 2026-06-07T13:29:53.670Z | user\n\nFull rewrite to new standard: added tool reference tables, 3-step GIF table, architecture diagram, code examples, error handling, and troubleshooting.\n\nv0.1.0 | 2026-05-03T13:33:39.479Z | auto\n\nInitial release integrating Google Analytics with OpenClaw via ClawLink.\n\n- Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data directly from chat.\n- Includes detailed setup and pairing instructions for ClawLink and Google Analytics connections.\n- Tools and capabilities are provided dynamically based on user integration status.\n- Ensures user credentials are handled securely through ClawLink; no raw credentials required in chat.\n- Outlines best practices and rules for safe use and discovery of Google Analytics tools.\n\nArchive index:\n\nArchive v1.0.5: 3 files, 5976 bytes\n\nFiles: skill-card.md (2507b), SKILL.md (15655b), _meta.json (145b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this skill when users want to list account summaries and properties, run standard or realtime GA4 reports with chosen dimensions and metrics, inspect available fields and compatibility, list audiences, data streams and key events, compare traffic and campaign performance, or create key events after confirmation.\n---\n\n# Google Analytics\n\n![Google Analytics](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/google-analytics.svg)\n\nAccess Google Analytics via the GA4 Data API with OAuth authentication. Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=google-analytics-reporting) for hosted connection flows and credentials so you do not need to configure Google Analytics API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Google Analytics |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Google Analytics |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Google Analytics again.\"\n\n## Quick Start\n\n```bash\n# List accessible accounts and properties\nclawlink_call_tool --tool \"google_analytics_list_account_summaries\" --params '{}'\n\n# Run a basic GA4 report\nclawlink_call_tool --tool \"google_analytics_run_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"deviceCategory\"}], \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalRevenue\"}]}'\n\n# Run a realtime report\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}], \"metrics\": [{\"name\": \"activeUsers\"}]}'\n```\n\n## Authentication\n\nAll Google Analytics tool calls are authenticated automatically by ClawLink using the user's connected Google account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every GA4 API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=google-analytics and connect Google Analytics.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `google-analytics` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration google-analytics\n```\n\n**Response:** Returns the live tool catalog for Google Analytics.\n\n### Reconnect\n\nIf Google Analytics tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=google-analytics\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration google-analytics`\n\n## Security & Permissions\n\n- Access is scoped to GA4 properties accessible to the connected Google account.\n- **All write operations require explicit user confirmation.** Before executing any key event creation or property update, confirm the intended effect with the user.\n- Reports and analytics queries are read-only and do not modify account data.\n\n## Tool Reference\n\n### Account & Property Discovery\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_account_summaries` | List all accessible accounts and properties | Read |\n| `google_analytics_list_accounts_v1_beta` | List all Google Analytics accounts | Read |\n| `google_analytics_list_properties_filtered` | List GA4 properties with filtering | Read |\n| `google_analytics_get_property` | Get GA4 property details | Read |\n| `google_analytics_get_account` | Get account details | Read |\n\n### Reporting\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_run_report` | Run a customized GA4 data report | Read |\n| `google_analytics_run_realtime_report` | Run a realtime report (last 30-60 min) | Read |\n| `google_analytics_run_pivot_report` | Run a pivot table report | Read |\n| `google_analytics_run_funnel_report` | Run a funnel analysis report | Read |\n| `google_analytics_batch_run_reports` | Run multiple reports in one batch | Read |\n| `google_analytics_check_compatibility` | Check dimension/metric compatibility | Read |\n\n### Metadata & Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_get_metadata` | Get available dimensions, metrics, comparisons | Read |\n| `google_analytics_get_property_quotas_snapshot` | Get API quota usage for a property | Read |\n| `google_analytics_get_data_retention_settings` | Get data retention configuration | Read |\n| `google_analytics_get_attribution_settings` | Get attribution model settings | Read |\n| `google_analytics_get_google_signals_settings` | Get Google Signals configuration | Read |\n\n### Audiences & Data Streams\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_audiences` | List configured audiences | Read |\n| `google_analytics_get_audience` | Get audience configuration details | Read |\n| `google_analytics_list_data_streams` | List data streams for a property | Read |\n| `google_analytics_list_key_events` | List key events (conversions) | Read |\n| `google_analytics_get_key_event` | Get key event details | Read |\n\n### Audience Lists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_create_audience_list` | Create an audience list snapshot | Write |\n| `google_analytics_create_recurring_audience_list` | Create a recurring audience list | Write |\n| `google_analytics_list_audience_lists` | List all audience lists | Read |\n| `google_analytics_query_audience_list` | Query audience list results | Read |\n\n### Custom Definitions\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_custom_dimensions` | List custom dimensions | Read |\n| `google_analytics_create_custom_dimension` | Create a custom dimension | Write |\n| `google_analytics_list_custom_metrics` | List custom metrics | Read |\n| `google_analytics_create_custom_metric` | Create a custom metric | Write |\n\n### Property Management\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_update_property` | Update property settings | Write |\n| `google_analytics_create_rollup_property` | Create a roll-up property | Write |\n\n## Code Examples\n\n### Run a basic traffic report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"date\"}, {\"name\": \"country\"}, {\"name\": \"deviceCategory\"}],\n    \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalUsers\"}, {\"name\": \"bounceRate\"}],\n    \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}]\n  }'\n```\n\n### Run a realtime report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"city\"}],\n    \"metrics\": [{\"name\": \"activeUsers\"}]\n  }'\n```\n\n### List key events\n\n```bash\nclawlink_call_tool --tool \"google_analytics_list_key_events\" \\\n  --params '{\n    \"property\": \"properties/123456789\"\n  }'\n```\n\n### Check dimension/metric compatibility\n\n```bash\nclawlink_call_tool --tool \"google_analytics_check_compatibility\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"userAgeBracket\"}, {\"name\": \"sessionCampaignName\"}],\n    \"metrics\": [{\"name\": \"sessions\"}]\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Google Analytics is connected.\n2. Call `clawlink_list_tools --integration google-analytics` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `google-analytics`.\n5. If no Google Analytics tools appear, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → get → run_report → check_compatibility              │\n│                                                             │\n│  Example: List properties → Run report → Show results       │\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → create/update               │\n│                                                             │\n│  Example: Preview key event creation → User confirms        │\n│           → Execute create                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer listing accounts, properties, metadata, compatibility, and read-only reports before writes.\n4. For key event creation, property updates, or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- GA4 property IDs use format `properties/123456789` in API calls.\n- Dimension and metric names in GAQL use camelCase (e.g., `date`, `sessionCampaignName`, `totalUsers`).\n- GA4 Data API has strict dimension/metric compatibility rules. Not all combinations are valid. Use `check_compatibility` to validate before running complex reports.\n- Realtime data covers the last 30-60 minutes and may not be available for all custom dimensions.\n- Key events (conversions) are read-only via API — creation and deletion require the Google Analytics UI.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration google-analytics`. |\n| Missing connection | Google Analytics is not connected. Direct the user to https://claw-link.dev/dashboard?add=google-analytics. |\n| `400 INVALID_ARGUMENT` | Incompatible dimension/metric combination. Use `check_compatibility` to validate. |\n| `403 Forbidden` | Insufficient OAuth scopes or permissions. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `google-analytics`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 Dimensions & Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=google-analytics-reporting)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=google-analytics-reporting)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1780988951244\n}\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, operators, and analytics teams use this skill to connect an agent to Google Analytics through ClawLink, discover GA4 accounts and properties, run standard or realtime reports, inspect metadata, and review traffic, campaign, audience, data stream, and conversion information.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill enables a third-party ClawLink plugin with hosted OAuth credentials and access to Google Analytics properties available to the connected Google account.\n\nMitigation: Install only after reviewing the requested Google OAuth scopes and GA4 property permissions, and revoke the ClawLink Google connection when it is no longer needed.\n\nRisk: Some available analytics tools can create or update Google Analytics resources.\n\nMitigation: Preview write-capable actions and approve them only when the proposed operation exactly matches the user's intent.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/hith3sh/skills/google-analytics-reporting)\n- [Google Analytics Data API documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 dimensions and metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink documentation](https://docs.claw-link.dev/openclaw)\n- [ClawLink verification](https://claw-link.dev/verify)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline bash commands and JSON tool parameters]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes guidance for choosing and confirming Google Analytics tool calls; write-capable actions require explicit user confirmation.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 3 files, 6083 bytes\n\nFiles: skill-card.md (2930b), SKILL.md (15418b), _meta.json (145b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this skill when users want to list account summaries and properties, run standard or realtime GA4 reports with chosen dimensions and metrics, inspect available fields and compatibility, list audiences, data streams and key events, compare traffic and campaign performance, or create key events after confirmation.\n---\n\n# Google Analytics\n\n![Google Analytics](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/google-analytics.svg)\n\nAccess Google Analytics via the GA4 Data API with OAuth authentication. Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Google Analytics API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Google Analytics |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Google Analytics |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Google Analytics again.\"\n\n## Quick Start\n\n```bash\n# List accessible accounts and properties\nclawlink_call_tool --tool \"google_analytics_list_account_summaries\" --params '{}'\n\n# Run a basic GA4 report\nclawlink_call_tool --tool \"google_analytics_run_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"deviceCategory\"}], \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalRevenue\"}]}'\n\n# Run a realtime report\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}], \"metrics\": [{\"name\": \"activeUsers\"}]}'\n```\n\n## Authentication\n\nAll Google Analytics tool calls are authenticated automatically by ClawLink using the user's connected Google account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every GA4 API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=google-analytics and connect Google Analytics.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `google-analytics` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration google-analytics\n```\n\n**Response:** Returns the live tool catalog for Google Analytics.\n\n### Reconnect\n\nIf Google Analytics tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=google-analytics\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration google-analytics`\n\n## Security & Permissions\n\n- Access is scoped to GA4 properties accessible to the connected Google account.\n- **All write operations require explicit user confirmation.** Before executing any key event creation or property update, confirm the intended effect with the user.\n- Reports and analytics queries are read-only and do not modify account data.\n\n## Tool Reference\n\n### Account & Property Discovery\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_account_summaries` | List all accessible accounts and properties | Read |\n| `google_analytics_list_accounts_v1_beta` | List all Google Analytics accounts | Read |\n| `google_analytics_list_properties_filtered` | List GA4 properties with filtering | Read |\n| `google_analytics_get_property` | Get GA4 property details | Read |\n| `google_analytics_get_account` | Get account details | Read |\n\n### Reporting\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_run_report` | Run a customized GA4 data report | Read |\n| `google_analytics_run_realtime_report` | Run a realtime report (last 30-60 min) | Read |\n| `google_analytics_run_pivot_report` | Run a pivot table report | Read |\n| `google_analytics_run_funnel_report` | Run a funnel analysis report | Read |\n| `google_analytics_batch_run_reports` | Run multiple reports in one batch | Read |\n| `google_analytics_check_compatibility` | Check dimension/metric compatibility | Read |\n\n### Metadata & Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_get_metadata` | Get available dimensions, metrics, comparisons | Read |\n| `google_analytics_get_property_quotas_snapshot` | Get API quota usage for a property | Read |\n| `google_analytics_get_data_retention_settings` | Get data retention configuration | Read |\n| `google_analytics_get_attribution_settings` | Get attribution model settings | Read |\n| `google_analytics_get_google_signals_settings` | Get Google Signals configuration | Read |\n\n### Audiences & Data Streams\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_audiences` | List configured audiences | Read |\n| `google_analytics_get_audience` | Get audience configuration details | Read |\n| `google_analytics_list_data_streams` | List data streams for a property | Read |\n| `google_analytics_list_key_events` | List key events (conversions) | Read |\n| `google_analytics_get_key_event` | Get key event details | Read |\n\n### Audience Lists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_create_audience_list` | Create an audience list snapshot | Write |\n| `google_analytics_create_recurring_audience_list` | Create a recurring audience list | Write |\n| `google_analytics_list_audience_lists` | List all audience lists | Read |\n| `google_analytics_query_audience_list` | Query audience list results | Read |\n\n### Custom Definitions\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_custom_dimensions` | List custom dimensions | Read |\n| `google_analytics_create_custom_dimension` | Create a custom dimension | Write |\n| `google_analytics_list_custom_metrics` | List custom metrics | Read |\n| `google_analytics_create_custom_metric` | Create a custom metric | Write |\n\n### Property Management\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_update_property` | Update property settings | Write |\n| `google_analytics_create_rollup_property` | Create a roll-up property | Write |\n\n## Code Examples\n\n### Run a basic traffic report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"date\"}, {\"name\": \"country\"}, {\"name\": \"deviceCategory\"}],\n    \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalUsers\"}, {\"name\": \"bounceRate\"}],\n    \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}]\n  }'\n```\n\n### Run a realtime report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"city\"}],\n    \"metrics\": [{\"name\": \"activeUsers\"}]\n  }'\n```\n\n### List key events\n\n```bash\nclawlink_call_tool --tool \"google_analytics_list_key_events\" \\\n  --params '{\n    \"property\": \"properties/123456789\"\n  }'\n```\n\n### Check dimension/metric compatibility\n\n```bash\nclawlink_call_tool --tool \"google_analytics_check_compatibility\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"userAgeBracket\"}, {\"name\": \"sessionCampaignName\"}],\n    \"metrics\": [{\"name\": \"sessions\"}]\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Google Analytics is connected.\n2. Call `clawlink_list_tools --integration google-analytics` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `google-analytics`.\n5. If no Google Analytics tools appear, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → get → run_report → check_compatibility              │\n│                                                             │\n│  Example: List properties → Run report → Show results       │\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → create/update               │\n│                                                             │\n│  Example: Preview key event creation → User confirms        │\n│           → Execute create                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer listing accounts, properties, metadata, compatibility, and read-only reports before writes.\n4. For key event creation, property updates, or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- GA4 property IDs use format `properties/123456789` in API calls.\n- Dimension and metric names in GAQL use camelCase (e.g., `date`, `sessionCampaignName`, `totalUsers`).\n- GA4 Data API has strict dimension/metric compatibility rules. Not all combinations are valid. Use `check_compatibility` to validate before running complex reports.\n- Realtime data covers the last 30-60 minutes and may not be available for all custom dimensions.\n- Key events (conversions) are read-only via API — creation and deletion require the Google Analytics UI.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration google-analytics`. |\n| Missing connection | Google Analytics is not connected. Direct the user to https://claw-link.dev/dashboard?add=google-analytics. |\n| `400 INVALID_ARGUMENT` | Incompatible dimension/metric combination. Use `check_compatibility` to validate. |\n| `403 Forbidden` | Insufficient OAuth scopes or permissions. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `google-analytics`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 Dimensions & Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink](https://claw-link.dev)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1780980776700\n}\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[hith3sh](https://clawhub.ai/user/hith3sh) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to connect a Google Analytics account through ClawLink, discover accessible GA4 accounts and properties, and run reporting, realtime, metadata, audience, data stream, and conversion analysis workflows. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill requires OAuth access to a Google Analytics account and uses sensitive credentials through ClawLink. <br>\nMitigation: Install only when the user is comfortable connecting the account, verify the Google Analytics integration is active through ClawLink, and avoid asking users to paste credentials into chat. <br>\nRisk: Some Google Analytics admin tools are write-capable, including audience list, custom dimension, custom metric, property update, and roll-up property operations. <br>\nMitigation: Use describe and preview steps for write-capable requests, present the intended effect to the user, and execute only after explicit confirmation. <br>\nRisk: Analytics reports can fail or mislead when dimensions and metrics are incompatible or when realtime data is limited. <br>\nMitigation: Check dimension and metric compatibility before complex reports, report actual API errors, and state realtime coverage limits when presenting results. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/hith3sh/google-analytics-reporting) <br>\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1) <br>\n- [GA4 Dimensions and Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema) <br>\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1) <br>\n- [ClawLink](https://claw-link.dev) <br>\n- [ClawLink OpenClaw Docs](https://docs.claw-link.dev/openclaw) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include GA4 property identifiers, dimensions, metrics, date ranges, and ClawLink tool-call parameters.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.1: 3 files, 6005 bytes\n\nFiles: skill-card.md (2723b), SKILL.md (15418b), _meta.json (145b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this skill when users want to list account summaries and properties, run standard or realtime GA4 reports with chosen dimensions and metrics, inspect available fields and compatibility, list audiences, data streams and key events, compare traffic and campaign performance, or create key events after confirmation.\n---\n\n# Google Analytics\n\n![Google Analytics](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/google-analytics.svg)\n\nAccess Google Analytics via the GA4 Data API with OAuth authentication. Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Google Analytics API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Google Analytics |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Google Analytics |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Google Analytics again.\"\n\n## Quick Start\n\n```bash\n# List accessible accounts and properties\nclawlink_call_tool --tool \"google_analytics_list_account_summaries\" --params '{}'\n\n# Run a basic GA4 report\nclawlink_call_tool --tool \"google_analytics_run_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"deviceCategory\"}], \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalRevenue\"}]}'\n\n# Run a realtime report\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}], \"metrics\": [{\"name\": \"activeUsers\"}]}'\n```\n\n## Authentication\n\nAll Google Analytics tool calls are authenticated automatically by ClawLink using the user's connected Google account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every GA4 API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=google-analytics and connect Google Analytics.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `google-analytics` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration google-analytics\n```\n\n**Response:** Returns the live tool catalog for Google Analytics.\n\n### Reconnect\n\nIf Google Analytics tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=google-analytics\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration google-analytics`\n\n## Security & Permissions\n\n- Access is scoped to GA4 properties accessible to the connected Google account.\n- **All write operations require explicit user confirmation.** Before executing any key event creation or property update, confirm the intended effect with the user.\n- Reports and analytics queries are read-only and do not modify account data.\n\n## Tool Reference\n\n### Account & Property Discovery\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_account_summaries` | List all accessible accounts and properties | Read |\n| `google_analytics_list_accounts_v1_beta` | List all Google Analytics accounts | Read |\n| `google_analytics_list_properties_filtered` | List GA4 properties with filtering | Read |\n| `google_analytics_get_property` | Get GA4 property details | Read |\n| `google_analytics_get_account` | Get account details | Read |\n\n### Reporting\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_run_report` | Run a customized GA4 data report | Read |\n| `google_analytics_run_realtime_report` | Run a realtime report (last 30-60 min) | Read |\n| `google_analytics_run_pivot_report` | Run a pivot table report | Read |\n| `google_analytics_run_funnel_report` | Run a funnel analysis report | Read |\n| `google_analytics_batch_run_reports` | Run multiple reports in one batch | Read |\n| `google_analytics_check_compatibility` | Check dimension/metric compatibility | Read |\n\n### Metadata & Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_get_metadata` | Get available dimensions, metrics, comparisons | Read |\n| `google_analytics_get_property_quotas_snapshot` | Get API quota usage for a property | Read |\n| `google_analytics_get_data_retention_settings` | Get data retention configuration | Read |\n| `google_analytics_get_attribution_settings` | Get attribution model settings | Read |\n| `google_analytics_get_google_signals_settings` | Get Google Signals configuration | Read |\n\n### Audiences & Data Streams\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_audiences` | List configured audiences | Read |\n| `google_analytics_get_audience` | Get audience configuration details | Read |\n| `google_analytics_list_data_streams` | List data streams for a property | Read |\n| `google_analytics_list_key_events` | List key events (conversions) | Read |\n| `google_analytics_get_key_event` | Get key event details | Read |\n\n### Audience Lists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_create_audience_list` | Create an audience list snapshot | Write |\n| `google_analytics_create_recurring_audience_list` | Create a recurring audience list | Write |\n| `google_analytics_list_audience_lists` | List all audience lists | Read |\n| `google_analytics_query_audience_list` | Query audience list results | Read |\n\n### Custom Definitions\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_custom_dimensions` | List custom dimensions | Read |\n| `google_analytics_create_custom_dimension` | Create a custom dimension | Write |\n| `google_analytics_list_custom_metrics` | List custom metrics | Read |\n| `google_analytics_create_custom_metric` | Create a custom metric | Write |\n\n### Property Management\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_update_property` | Update property settings | Write |\n| `google_analytics_create_rollup_property` | Create a roll-up property | Write |\n\n## Code Examples\n\n### Run a basic traffic report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"date\"}, {\"name\": \"country\"}, {\"name\": \"deviceCategory\"}],\n    \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalUsers\"}, {\"name\": \"bounceRate\"}],\n    \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}]\n  }'\n```\n\n### Run a realtime report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"city\"}],\n    \"metrics\": [{\"name\": \"activeUsers\"}]\n  }'\n```\n\n### List key events\n\n```bash\nclawlink_call_tool --tool \"google_analytics_list_key_events\" \\\n  --params '{\n    \"property\": \"properties/123456789\"\n  }'\n```\n\n### Check dimension/metric compatibility\n\n```bash\nclawlink_call_tool --tool \"google_analytics_check_compatibility\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"userAgeBracket\"}, {\"name\": \"sessionCampaignName\"}],\n    \"metrics\": [{\"name\": \"sessions\"}]\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Google Analytics is connected.\n2. Call `clawlink_list_tools --integration google-analytics` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `google-analytics`.\n5. If no Google Analytics tools appear, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → get → run_report → check_compatibility              │\n│                                                             │\n│  Example: List properties → Run report → Show results       │\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → create/update               │\n│                                                             │\n│  Example: Preview key event creation → User confirms        │\n│           → Execute create                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer listing accounts, properties, metadata, compatibility, and read-only reports before writes.\n4. For key event creation, property updates, or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- GA4 property IDs use format `properties/123456789` in API calls.\n- Dimension and metric names in GAQL use camelCase (e.g., `date`, `sessionCampaignName`, `totalUsers`).\n- GA4 Data API has strict dimension/metric compatibility rules. Not all combinations are valid. Use `check_compatibility` to validate before running complex reports.\n- Realtime data covers the last 30-60 minutes and may not be available for all custom dimensions.\n- Key events (conversions) are read-only via API — creation and deletion require the Google Analytics UI.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration google-analytics`. |\n| Missing connection | Google Analytics is not connected. Direct the user to https://claw-link.dev/dashboard?add=google-analytics. |\n| `400 INVALID_ARGUMENT` | Incompatible dimension/metric combination. Use `check_compatibility` to validate. |\n| `403 Forbidden` | Insufficient OAuth scopes or permissions. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `google-analytics`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 Dimensions & Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink](https://claw-link.dev)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1780936603347\n}\n\nFile v1.0.1:skill-card.md\n\n## Description: <br>\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[hith3sh](https://clawhub.ai/user/hith3sh) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users, analysts, marketers, and developers use this skill to connect through ClawLink OAuth, discover accessible GA4 accounts and properties, run standard or realtime reports, inspect metadata, and review traffic, audience, campaign, and conversion data. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill uses ClawLink OAuth to broker Google Analytics access and handle analytics data in transit. <br>\nMitigation: Install only when the user trusts ClawLink with the connected Google Analytics account and the analytics data being requested. <br>\nRisk: Write-capable actions can affect GA4 resources if the live tool catalog exposes them. <br>\nMitigation: Preview and confirm the exact GA4 property and intended change before approving any write action. <br>\nRisk: The security evidence notes documentation drift around key-event creation. <br>\nMitigation: Treat key-event creation guidance as unreliable unless the live ClawLink catalog shows a supported, confirmation-gated tool. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/google-analytics-reporting) <br>\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1) <br>\n- [GA4 Dimensions & Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema) <br>\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1) <br>\n- [ClawLink](https://claw-link.dev) <br>\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance] <br>\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [May include GA4 property identifiers, metric and dimension names, report summaries, setup instructions, and confirmation prompts for write-capable actions.] <br>\n\n## Skill Version(s): <br>\n1.0.1 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.2: 3 files, 6005 bytes\n\nFiles: skill-card.md (2828b), SKILL.md (15289b), _meta.json (145b)\n\nFile v0.1.2:SKILL.md\n\n---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this skill when users want to list account summaries and properties, run standard or realtime GA4 reports with chosen dimensions and metrics, inspect available fields and compatibility, list audiences, data streams and key events, compare traffic and campaign performance, or create key events after confirmation.\n---\n\n# Google Analytics\n\nAccess Google Analytics via the GA4 Data API with OAuth authentication. Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Google Analytics API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Google Analytics |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Google Analytics |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Google Analytics again.\"\n\n## Quick Start\n\n```bash\n# List accessible accounts and properties\nclawlink_call_tool --tool \"google_analytics_list_account_summaries\" --params '{}'\n\n# Run a basic GA4 report\nclawlink_call_tool --tool \"google_analytics_run_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"deviceCategory\"}], \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalRevenue\"}]}'\n\n# Run a realtime report\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}], \"metrics\": [{\"name\": \"activeUsers\"}]}'\n```\n\n## Authentication\n\nAll Google Analytics tool calls are authenticated automatically by ClawLink using the user's connected Google account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every GA4 API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=google-analytics and connect Google Analytics.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `google-analytics` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration google-analytics\n```\n\n**Response:** Returns the live tool catalog for Google Analytics.\n\n### Reconnect\n\nIf Google Analytics tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=google-analytics\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration google-analytics`\n\n## Security & Permissions\n\n- Access is scoped to GA4 properties accessible to the connected Google account.\n- **All write operations require explicit user confirmation.** Before executing any key event creation or property update, confirm the intended effect with the user.\n- Reports and analytics queries are read-only and do not modify account data.\n\n## Tool Reference\n\n### Account & Property Discovery\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_account_summaries` | List all accessible accounts and properties | Read |\n| `google_analytics_list_accounts_v1_beta` | List all Google Analytics accounts | Read |\n| `google_analytics_list_properties_filtered` | List GA4 properties with filtering | Read |\n| `google_analytics_get_property` | Get GA4 property details | Read |\n| `google_analytics_get_account` | Get account details | Read |\n\n### Reporting\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_run_report` | Run a customized GA4 data report | Read |\n| `google_analytics_run_realtime_report` | Run a realtime report (last 30-60 min) | Read |\n| `google_analytics_run_pivot_report` | Run a pivot table report | Read |\n| `google_analytics_run_funnel_report` | Run a funnel analysis report | Read |\n| `google_analytics_batch_run_reports` | Run multiple reports in one batch | Read |\n| `google_analytics_check_compatibility` | Check dimension/metric compatibility | Read |\n\n### Metadata & Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_get_metadata` | Get available dimensions, metrics, comparisons | Read |\n| `google_analytics_get_property_quotas_snapshot` | Get API quota usage for a property | Read |\n| `google_analytics_get_data_retention_settings` | Get data retention configuration | Read |\n| `google_analytics_get_attribution_settings` | Get attribution model settings | Read |\n| `google_analytics_get_google_signals_settings` | Get Google Signals configuration | Read |\n\n### Audiences & Data Streams\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_audiences` | List configured audiences | Read |\n| `google_analytics_get_audience` | Get audience configuration details | Read |\n| `google_analytics_list_data_streams` | List data streams for a property | Read |\n| `google_analytics_list_key_events` | List key events (conversions) | Read |\n| `google_analytics_get_key_event` | Get key event details | Read |\n\n### Audience Lists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_create_audience_list` | Create an audience list snapshot | Write |\n| `google_analytics_create_recurring_audience_list` | Create a recurring audience list | Write |\n| `google_analytics_list_audience_lists` | List all audience lists | Read |\n| `google_analytics_query_audience_list` | Query audience list results | Read |\n\n### Custom Definitions\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_custom_dimensions` | List custom dimensions | Read |\n| `google_analytics_create_custom_dimension` | Create a custom dimension | Write |\n| `google_analytics_list_custom_metrics` | List custom metrics | Read |\n| `google_analytics_create_custom_metric` | Create a custom metric | Write |\n\n### Property Management\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_update_property` | Update property settings | Write |\n| `google_analytics_create_rollup_property` | Create a roll-up property | Write |\n\n## Code Examples\n\n### Run a basic traffic report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"date\"}, {\"name\": \"country\"}, {\"name\": \"deviceCategory\"}],\n    \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalUsers\"}, {\"name\": \"bounceRate\"}],\n    \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}]\n  }'\n```\n\n### Run a realtime report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"city\"}],\n    \"metrics\": [{\"name\": \"activeUsers\"}]\n  }'\n```\n\n### List key events\n\n```bash\nclawlink_call_tool --tool \"google_analytics_list_key_events\" \\\n  --params '{\n    \"property\": \"properties/123456789\"\n  }'\n```\n\n### Check dimension/metric compatibility\n\n```bash\nclawlink_call_tool --tool \"google_analytics_check_compatibility\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"userAgeBracket\"}, {\"name\": \"sessionCampaignName\"}],\n    \"metrics\": [{\"name\": \"sessions\"}]\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Google Analytics is connected.\n2. Call `clawlink_list_tools --integration google-analytics` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `google-analytics`.\n5. If no Google Analytics tools appear, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → get → run_report → check_compatibility              │\n│                                                             │\n│  Example: List properties → Run report → Show results       │\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → create/update               │\n│                                                             │\n│  Example: Preview key event creation → User confirms        │\n│           → Execute create                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer listing accounts, properties, metadata, compatibility, and read-only reports before writes.\n4. For key event creation, property updates, or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- GA4 property IDs use format `properties/123456789` in API calls.\n- Dimension and metric names in GAQL use camelCase (e.g., `date`, `sessionCampaignName`, `totalUsers`).\n- GA4 Data API has strict dimension/metric compatibility rules. Not all combinations are valid. Use `check_compatibility` to validate before running complex reports.\n- Realtime data covers the last 30-60 minutes and may not be available for all custom dimensions.\n- Key events (conversions) are read-only via API — creation and deletion require the Google Analytics UI.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration google-analytics`. |\n| Missing connection | Google Analytics is not connected. Direct the user to https://claw-link.dev/dashboard?add=google-analytics. |\n| `400 INVALID_ARGUMENT` | Incompatible dimension/metric combination. Use `check_compatibility` to validate. |\n| `403 Forbidden` | Insufficient OAuth scopes or permissions. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `google-analytics`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 Dimensions & Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink](https://claw-link.dev)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)\n\nFile v0.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"0.1.2\",\n  \"publishedAt\": 1780841167530\n}\n\nFile v0.1.2:skill-card.md\n\n## Description: <br>\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via Google Analytics APIs. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[hith3sh](https://clawhub.ai/user/hith3sh) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to connect a Google Analytics account, discover available GA4 properties, run standard or realtime reports, inspect dimensions and metrics, and troubleshoot analytics queries. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can expose account-changing Google Analytics tools that are not fully reflected in the top-level description. <br>\nMitigation: Review the live tool catalog before use, grant only the minimum Google Analytics permissions needed, and require explicit confirmation before property updates, roll-up property creation, custom definition creation, or other write actions. <br>\nRisk: The skill contains conflicting guidance about key-event creation. <br>\nMitigation: Treat key-event creation as ambiguous unless the live ClawLink catalog clearly supports the operation and the user confirms the exact change. <br>\nRisk: The skill requires OAuth access to Google Analytics data. <br>\nMitigation: Use a Google account or OAuth grant limited to the properties and permissions needed for the requested reporting task. <br>\n\n\n## Reference(s): <br>\n- [Google Analytics Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1) <br>\n- [GA4 Dimensions and Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema) <br>\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1) <br>\n- [ClawLink](https://claw-link.dev) <br>\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw) <br>\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/google-analytics-reporting) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown with inline shell commands and JSON tool parameters] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Outputs may include OAuth connection instructions, GA4 report guidance, tool-call parameters, troubleshooting steps, and concise analysis of returned analytics data.] <br>\n\n## Skill Version(s): <br>\n0.1.2 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.1: 3 files, 6097 bytes\n\nFiles: skill-card.md (3093b), SKILL.md (15287b), _meta.json (145b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this skill when users want to list account summaries and properties, run standard or realtime GA4 reports with chosen dimensions and metrics, inspect available fields and compatibility, list audiences, data streams and key events, compare traffic and campaign performance, or create key events after confirmation.\n---\n\n# Google Analytics\n\nAccess Google Analytics via the GA4 Data API with OAuth authentication. Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nThis skill uses [ClawLink](https://claw-link.dev) for hosted connection flows and credentials so you do not need to configure Google Analytics API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Google Analytics |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_chain.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Google Analytics |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `/new` as a standalone message to start a fresh chat, then ask for Google Analytics again.\"\n\n## Quick Start\n\n```bash\n# List accessible accounts and properties\nclawlink_call_tool --tool \"google_analytics_list_account_summaries\" --params '{}'\n\n# Run a basic GA4 report\nclawlink_call_tool --tool \"google_analytics_run_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"deviceCategory\"}], \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalRevenue\"}]}'\n\n# Run a realtime report\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}], \"metrics\": [{\"name\": \"activeUsers\"}]}'\n```\n\n## Authentication\n\nAll Google Analytics tool calls are authenticated automatically by ClawLink using the user's connected Google account.\n\n**No API key is required in chat.** ClawLink stores the OAuth token securely and injects it into every GA4 API request on the user's behalf.\n\n### Getting Connected\n\n1. Install the ClawLink plugin (see Install above).\n2. Pair the plugin with `clawlink_begin_pairing` if it is not configured yet.\n3. Open https://claw-link.dev/dashboard?add=google-analytics and connect Google Analytics.\n4. Call `clawlink_list_integrations` to verify the connection is active.\n\n## Connection Management\n\n### List Connections\n\n```bash\nclawlink_list_integrations\n```\n\n**Response:** Returns all connected integrations. Look for `google-analytics` in the list.\n\n### Verify Connection\n\n```bash\nclawlink_list_tools --integration google-analytics\n```\n\n**Response:** Returns the live tool catalog for Google Analytics.\n\n### Reconnect\n\nIf Google Analytics tools are missing or the connection shows an error:\n\n1. Direct the user to https://claw-link.dev/dashboard?add=google-analytics\n2. After they confirm, call `clawlink_list_integrations` to verify\n3. Then call `clawlink_list_tools --integration google-analytics`\n\n## Security & Permissions\n\n- Access is scoped to GA4 properties accessible to the connected Google account.\n- **All write operations require explicit user confirmation.** Before executing any key event creation or property update, confirm the intended effect with the user.\n- Reports and analytics queries are read-only and do not modify account data.\n\n## Tool Reference\n\n### Account & Property Discovery\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_account_summaries` | List all accessible accounts and properties | Read |\n| `google_analytics_list_accounts_v1_beta` | List all Google Analytics accounts | Read |\n| `google_analytics_list_properties_filtered` | List GA4 properties with filtering | Read |\n| `google_analytics_get_property` | Get GA4 property details | Read |\n| `google_analytics_get_account` | Get account details | Read |\n\n### Reporting\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_run_report` | Run a customized GA4 data report | Read |\n| `google_analytics_run_realtime_report` | Run a realtime report (last 30-60 min) | Read |\n| `google_analytics_run_pivot_report` | Run a pivot table report | Read |\n| `google_analytics_run_funnel_report` | Run a funnel analysis report | Read |\n| `google_analytics_batch_run_reports` | Run multiple reports in one batch | Read |\n| `google_analytics_check_compatibility` | Check dimension/metric compatibility | Read |\n\n### Metadata & Configuration\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_get_metadata` | Get available dimensions, metrics, comparisons | Read |\n| `google_analytics_get_property_quotas_snapshot` | Get API quota usage for a property | Read |\n| `google_analytics_get_data_retention_settings` | Get data retention configuration | Read |\n| `google_analytics_get_attribution_settings` | Get attribution model settings | Read |\n| `google_analytics_get_google_signals_settings` | Get Google Signals configuration | Read |\n\n### Audiences & Data Streams\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_audiences` | List configured audiences | Read |\n| `google_analytics_get_audience` | Get audience configuration details | Read |\n| `google_analytics_list_data_streams` | List data streams for a property | Read |\n| `google_analytics_list_key_events` | List key events (conversions) | Read |\n| `google_analytics_get_key_event` | Get key event details | Read |\n\n### Audience Lists\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_create_audience_list` | Create an audience list snapshot | Write |\n| `google_analytics_create_recurring_audience_list` | Create a recurring audience list | Write |\n| `google_analytics_list_audience_lists` | List all audience lists | Read |\n| `google_analytics_query_audience_list` | Query audience list results | Read |\n\n### Custom Definitions\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_list_custom_dimensions` | List custom dimensions | Read |\n| `google_analytics_create_custom_dimension` | Create a custom dimension | Write |\n| `google_analytics_list_custom_metrics` | List custom metrics | Read |\n| `google_analytics_create_custom_metric` | Create a custom metric | Write |\n\n### Property Management\n\n| Tool | Description | Mode |\n|------|-------------|------|\n| `google_analytics_update_property` | Update property settings | Write |\n| `google_analytics_create_rollup_property` | Create a roll-up property | Write |\n\n## Code Examples\n\n### Run a basic traffic report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"date\"}, {\"name\": \"country\"}, {\"name\": \"deviceCategory\"}],\n    \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalUsers\"}, {\"name\": \"bounceRate\"}],\n    \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}]\n  }'\n```\n\n### Run a realtime report\n\n```bash\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"city\"}],\n    \"metrics\": [{\"name\": \"activeUsers\"}]\n  }'\n```\n\n### List key events\n\n```bash\nclawlink_call_tool --tool \"google_analytics_list_key_events\" \\\n  --params '{\n    \"property\": \"properties/123456789\"\n  }'\n```\n\n### Check dimension/metric compatibility\n\n```bash\nclawlink_call_tool --tool \"google_analytics_check_compatibility\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"userAgeBracket\"}, {\"name\": \"sessionCampaignName\"}],\n    \"metrics\": [{\"name\": \"sessions\"}]\n  }'\n```\n\n## Discovery Workflow\n\n1. Call `clawlink_list_integrations` to confirm Google Analytics is connected.\n2. Call `clawlink_list_tools --integration google-analytics` to see the live catalog.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `google-analytics`.\n5. If no Google Analytics tools appear, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n\n## Execution Workflow\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│  READ OPERATIONS (Safe)                                     │\n│  list → get → run_report → check_compatibility              │\n│                                                             │\n│  Example: List properties → Run report → Show results       │\n└─────────────────────────────────────────────────────────────┘\n                              │\n                              ▼\n┌─────────────────────────────────────────────────────────────┐\n│  WRITE OPERATIONS (Require Confirmation)                    │\n│  describe → preview → confirm → create/update               │\n│                                                             │\n│  Example: Preview key event creation → User confirms        │\n│           → Execute create                                   │\n└─────────────────────────────────────────────────────────────┘\n```\n\n1. For unfamiliar tools, ambiguous requests, or any write action, call `clawlink_describe_tool` first.\n2. Use the returned guidance, schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups` to shape the call.\n3. Prefer listing accounts, properties, metadata, compatibility, and read-only reports before writes.\n4. For key event creation, property updates, or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`. Pass confirmation only after the preview matches the user's intent.\n6. If the tool call fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## Notes\n\n- GA4 property IDs use format `properties/123456789` in API calls.\n- Dimension and metric names in GAQL use camelCase (e.g., `date`, `sessionCampaignName`, `totalUsers`).\n- GA4 Data API has strict dimension/metric compatibility rules. Not all combinations are valid. Use `check_compatibility` to validate before running complex reports.\n- Realtime data covers the last 30-60 minutes and may not be available for all custom dimensions.\n- Key events (conversions) are read-only via API — creation and deletion require the Google Analytics UI.\n\n## Error Handling\n\n| Status / Error | Meaning |\n|----------------|---------|\n| Tool not found | The tool name does not exist in the current catalog. Verify with `clawlink_list_tools --integration google-analytics`. |\n| Missing connection | Google Analytics is not connected. Direct the user to https://claw-link.dev/dashboard?add=google-analytics. |\n| `400 INVALID_ARGUMENT` | Incompatible dimension/metric combination. Use `check_compatibility` to validate. |\n| `403 Forbidden` | Insufficient OAuth scopes or permissions. |\n| Write rejected | User did not confirm a write action. Always confirm before executing writes. |\n\n### Troubleshooting: Tools Not Visible\n\n1. Check that the ClawLink plugin is installed:\n   ```bash\n   openclaw plugins list\n   ```\n2. If the plugin is installed but tools are missing, tell the user to send `/new` as a standalone message to reload the catalog.\n3. If a fresh chat does not help, run:\n   ```bash\n   openclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\n   openclaw gateway restart\n   ```\n4. After restart, tell the user to send `/new` again and retry.\n\n### Troubleshooting: Invalid Tool Call\n\n1. Ensure the integration slug is exactly `google-analytics`.\n2. Use `clawlink_describe_tool` to verify parameter names and types before calling.\n3. For write operations, always call `clawlink_preview_tool` first.\n\n## Resources\n\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 Dimensions & Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink](https://claw-link.dev)\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw)\n- [ClawLink Verification](https://claw-link.dev/verify)\n\n---\n\n**Powered by [ClawLink](https://claw-link.dev)** — an integration hub for OpenClaw\n\n![ClawLink Logo](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/logo/link_logo_black_small.png)\n\nFile v0.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1780838993670\n}\n\nFile v0.1.1:skill-card.md\n\n## Description: <br>\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[hith3sh](https://clawhub.ai/user/hith3sh) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nDevelopers, analysts, and operators use this skill to connect an agent to Google Analytics through ClawLink, discover GA4 accounts and properties, and run standard, realtime, pivot, funnel, audience, and metadata queries. It also guides users through preview-and-confirm workflows for supported write-capable configuration actions. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill requires OAuth access to Google Analytics through ClawLink and may expose sensitive business analytics data in agent responses. <br>\nMitigation: Install only when the user accepts the ClawLink connection, verify the connected integration, and treat generated reports as sensitive business data. <br>\nRisk: Reports or configuration actions may target the wrong GA4 account or property if the property identifier is ambiguous. <br>\nMitigation: List and confirm the exact GA4 account and property before running reports or making any write-capable configuration request. <br>\nRisk: Write-capable actions such as property updates or configuration-object creation can change analytics settings. <br>\nMitigation: Use the documented describe and preview workflow, then require explicit user confirmation before executing any write-capable action. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/google-analytics-reporting) <br>\n- [Publisher Profile](https://clawhub.ai/user/hith3sh) <br>\n- [GA4 Data API Documentation](https://developers.google.com/analytics/devguides/reporting/data/v1) <br>\n- [GA4 Dimensions and Metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema) <br>\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1) <br>\n- [ClawLink](https://claw-link.dev) <br>\n- [ClawLink OpenClaw Docs](https://docs.claw-link.dev/openclaw) <br>\n- [ClawLink Verification](https://claw-link.dev/verify) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance, API calls] <br>\n**Output Format:** [Markdown guidance with inline shell commands and JSON tool parameters] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Outputs can include GA4 report summaries, account and property listings, live tool-catalog guidance, and preview steps before write-capable actions.] <br>\n\n## Skill Version(s): <br>\n0.1.1 (source: release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v0.1.0: 3 files, 3624 bytes\n\nFiles: skill-card.md (2220b), SKILL.md (5572b), _meta.json (145b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data — powered by ClawLink.\n---\n\n# Google Analytics via ClawLink\n\nWork with Google Analytics from chat — run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nPowered by [ClawLink](https://claw-link.dev), an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Google Analytics API access yourself.\n\n## Quick start\n\n1. Install the verified ClawLink plugin: `openclaw plugins install clawhub:clawlink-plugin`\n2. Start a fresh OpenClaw chat if the plugin was just installed and ClawLink tools are not visible yet\n3. If ClawLink is not configured, call `clawlink_begin_pairing`\n4. Tell the user to open the returned pairing URL, sign in to ClawLink if needed, and approve the device\n5. After the user confirms approval, call `clawlink_get_pairing_status`\n6. Tell the user to connect Google Analytics at [claw-link.dev/dashboard?add=google-analytics](https://claw-link.dev/dashboard?add=google-analytics)\n7. When the user confirms Google Analytics is connected, call `clawlink_list_integrations` and then `clawlink_list_tools` with the `google-analytics` integration slug\n\n## Setup details\n\n### Installing the plugin\n\nIf the ClawLink plugin is not installed yet, tell the user to run:\n\n```\nopenclaw plugins install clawhub:clawlink-plugin\n```\n\nIf the current chat started before the plugin was installed and ClawLink tools are still unavailable, tell the user to start a fresh chat so OpenClaw reloads the plugin tool catalog.\n\n### Pairing ClawLink\n\nIf ClawLink reports that the plugin is not configured, the plugin has not been paired with the user's ClawLink account yet.\n\n1. Call `clawlink_begin_pairing`.\n2. Tell the user to open the returned pairing URL in their browser.\n3. The user signs in to ClawLink if needed and approves the OpenClaw device.\n4. After the user confirms approval, call `clawlink_get_pairing_status` to finish local setup.\n\nThe resulting device credential is stored locally in OpenClaw's plugin config and is only sent to `claw-link.dev`. The user should not paste raw credentials into chat.\n\n### Connecting Google Analytics\n\nTell the user to open https://claw-link.dev/dashboard?add=google-analytics and connect Google Analytics there. The page opens the add-connection panel filtered to Google Analytics. ClawLink's hosted page runs the Google account connection flow — the user clicks through Google sign-in and consent. When they confirm it is done, call `clawlink_list_integrations` to verify, then call `clawlink_list_tools` with integration `google-analytics`.\n\n## Using Google Analytics tools\n\nClawLink provides tools dynamically based on what the user has connected. You do not need to know tool names or schemas in advance.\n\n### Discovery\n\n1. Call `clawlink_list_integrations` to confirm Google Analytics is connected.\n2. Call `clawlink_list_tools` with integration `google-analytics`.\n3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.\n4. If the user describes a capability but the exact tool is unclear, call `clawlink_search_tools` with a short query and integration `google-analytics`.\n5. If no Google Analytics tools appear, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n\n### Execution\n\n1. Call `clawlink_describe_tool` before using an unfamiliar tool, before any write, or when the request is ambiguous.\n2. Use the returned schema, `whenToUse`, `askBefore`, `safeDefaults`, `examples`, and `followups`.\n3. Prefer listing accounts, properties, metadata, compatibility, and read-only reports before writes.\n4. For key-event creation, property updates, or anything marked as requiring confirmation, call `clawlink_preview_tool` first, then confirm with the user.\n5. Execute with `clawlink_call_tool`.\n6. If it fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.\n\n## What you can do\n\nTypical Google Analytics tasks (actual availability depends on the user's connected account, permissions, scopes, and current ClawLink tool catalog):\n\n- List account summaries and properties\n- Run standard GA4 reports with chosen dimensions and metrics\n- Run real-time, funnel, batch, or pivot reports\n- Inspect available dimensions, metrics, and compatibility constraints\n- List audiences, data streams, and key events\n- Compare traffic, conversions, campaign performance, and engagement trends\n- Create key events or update property settings after confirmation\n\n## Rules\n\n- Always use ClawLink tools for Google Analytics. Do not ask the user for separate Google credentials.\n- Do not claim a capability is missing without checking the live ClawLink catalog in the current turn.\n- Do not invent slash commands or ask the user to paste raw credentials.\n- Ask for confirmation before changing property settings or creating key events.\n- If Google Analytics is not connected, direct the user to https://claw-link.dev/dashboard?add=google-analytics.\n- Never echo or repeat the user's ClawLink credential.\n\n## Resources\n\n- ClawLink: https://claw-link.dev\n- ClawLink Docs: https://docs.claw-link.dev/openclaw\n- ClawLink Verification: https://claw-link.dev/verify\n- ClawLink Source: https://github.com/hith3sh/clawlink\n- Google Analytics Data API: https://developers.google.com/analytics/devguides/reporting/data/v1\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1777815219479\n}\n\nFile v0.1.0:skill-card.md\n\n## Description: <br>\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data through ClawLink. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[hith3sh](https://clawhub.ai/user/hith3sh) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal users and developers use this skill to connect OpenClaw to Google Analytics through ClawLink, discover available GA4 tools, and run reporting or administrative workflows from chat. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: The skill can guide authenticated Google Analytics actions through ClawLink, including property updates or key-event creation. <br>\nMitigation: Review the ClawLink plugin and Google consent screen, preview write actions, and confirm targets before allowing changes. <br>\nRisk: Credential exposure could occur if a user pastes raw credentials into chat. <br>\nMitigation: Use ClawLink pairing and hosted connection flows, and do not ask users to paste raw Google or ClawLink credentials. <br>\n\n\n## Reference(s): <br>\n- [ClawHub Skill Page](https://clawhub.ai/hith3sh/google-analytics-reporting) <br>\n- [ClawLink](https://claw-link.dev) <br>\n- [ClawLink Docs](https://docs.claw-link.dev/openclaw) <br>\n- [ClawLink Source](https://github.com/hith3sh/clawlink) <br>\n- [Google Analytics Data API](https://developers.google.com/analytics/devguides/reporting/data/v1) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown with inline shell commands and tool-use guidance] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Uses the live ClawLink tool catalog as the source of truth for available Google Analytics actions.] <br>\n\n## Skill Version(s): <br>\n0.1.0 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>","readmeExcerpt":"Skill: Google Analytics Owner: hith3sh Summary: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski... Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-09T07:09:11.244Z | user Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traf","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘"},{"language":"bash","snippet":"openclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart"},{"language":"bash","snippet":"# List accessible accounts and properties\nclawlink_call_tool --tool \"google_analytics_list_account_summaries\" --params '{}'\n\n# Run a basic GA4 report\nclawlink_call_tool --tool \"google_analytics_run_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}, {\"name\": \"deviceCategory\"}], \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalRevenue\"}]}'\n\n# Run a realtime report\nclawlink_call_tool --tool \"google_analytics_run_realtime_report\" --params '{\"property\": \"properties/123456789\", \"dimensions\": [{\"name\": \"country\"}], \"metrics\": [{\"name\": \"activeUsers\"}]}'"},{"language":"bash","snippet":"clawlink_list_integrations"},{"language":"bash","snippet":"clawlink_list_tools --integration google-analytics"},{"language":"bash","snippet":"clawlink_call_tool --tool \"google_analytics_run_report\" \\\n  --params '{\n    \"property\": \"properties/123456789\",\n    \"dimensions\": [{\"name\": \"date\"}, {\"name\": \"country\"}, {\"name\": \"deviceCategory\"}],\n    \"metrics\": [{\"name\": \"sessions\"}, {\"name\": \"totalUsers\"}, {\"name\": \"bounceRate\"}],\n    \"dateRanges\": [{\"startDate\": \"30daysAgo\", \"endDate\": \"today\"}]\n  }'"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: google-analytics-reporting\ndescription: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this skill when users want to list account summaries and properties, run standard or realtime GA4 reports with chosen dimensions and metrics, inspect available fields and compatibility, list audiences, data streams and key events, compare traffic and campaign performance, or create key events after confirmation.\n---\n\n# Google Analytics\n\n![Google Analytics](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/google-analytics.svg)\n\nAccess Google Analytics via the GA4 Data API with OAuth authentication. Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data.\n\nThis skill uses [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=google-analytics-reporting) for hosted connection flows and credentials so you do not need to configure Google Analytics API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Google Analytics |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Google Analytics |\n\n## How It Works\n\n```\n┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐\n│   OpenClaw      │────▶│   ClawLink   │────▶│  GA4 Data API    │\n│   (User Chat)   │     │   (OAuth)    │     │   (REST)         │\n└─────────────────┘     └──────────────┘     └──────────────────┘\n         │                       │                       │\n         │  1. Install Plugin    │                       │\n         │  2. Pair Device       │                       │\n         │  3. Connect Google Analytics                   │\n         │                       │  4. Secure Token      │\n         │                       │  5. Proxy Requests    │\n         │                       │                       │\n         ▼                       ▼                       ▼\n   ┌──────────┐           ┌──────────┐           ┌──────────┐\n   │  SKILL   │           │ Dashboard│           │ GA4      │\n   │  File    │           │ Auth     │           │ Reports  │\n   └──────────┘           └──────────┘           └──────────┘\n```\n\n## Install\n\nInstall the verified ClawLink plugin from ClawHub. After the user confirms, complete the full setup so ClawLink tools are visible in the next OpenClaw chat.\n\n```bash\nopenclaw plugins install clawhub:clawlink-plugin\nopenclaw config set tools.alsoAllow '[\"clawlink-plugin\"]' --strict-json\nopenclaw gateway restart\n```\n\nThen tell the user: \"OpenClaw has been restarted. Send `"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn713pxvayh8fjhb503zjb8yxh815j54\",\n  \"slug\": \"google-analytics-reporting\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1780988951244\n}"},{"path":"skill-card.md","content":"## Description:\n\nRun GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[hith3sh](https://clawhub.ai/user/hith3sh)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers, operators, and analytics teams use this skill to connect an agent to Google Analytics through ClawLink, discover GA4 accounts and properties, run standard or realtime reports, inspect metadata, and review traffic, campaign, audience, data stream, and conversion information.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill enables a third-party ClawLink plugin with hosted OAuth credentials and access to Google Analytics properties available to the connected Google account.\n\nMitigation: Install only after reviewing the requested Google OAuth scopes and GA4 property permissions, and revoke the ClawLink Google connection when it is no longer needed.\n\nRisk: Some available analytics tools can create or update Google Analytics resources.\n\nMitigation: Preview write-capable actions and approve them only when the proposed operation exactly matches the user's intent.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/hith3sh/skills/google-analytics-reporting)\n- [Google Analytics Data API documentation](https://developers.google.com/analytics/devguides/reporting/data/v1)\n- [GA4 dimensions and metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)\n- [GA4 Realtime API](https://developers.google.com/analytics/devguides/reporting/realtime/v1)\n- [ClawLink documentation](https://docs.claw-link.dev/openclaw)\n- [ClawLink verification](https://claw-link.dev/verify)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline bash commands and JSON tool parameters]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Includes guidance for choosing and confirming Google Analytics tool calls; write-capable actions require explicit user confirmation.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski... Skill: Google Analytics Owner: hith3sh Summary: Run GA4 reports, inspect properties, list audiences and data streams, and analyze traffic and conversion data via the Google Analytics Data API. Use this ski... Tags: latest:1.0.5 Version history: v1.0.5 | 2026-06-09T07:09:11.244Z | user Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traf","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1064,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T03:03:23.616Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:47:35.807Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}