datafast-analytics

What This Skill Does

The datafast-analytics skill empowers the OpenClaw AI agent to interface directly with the DataFast API, enabling robust, real-time website analytics tracking and management. By acting as a bridge between the agent and your analytics data, this skill facilitates deep insights into visitor behavior, traffic metrics, and conversion funnels. It covers a comprehensive suite of endpoints ranging from high-level overviews to granular, segmented breakdowns of devices, pages, and campaigns. Beyond data retrieval, it supports administrative tasks such as configuring conversion goals and tracking payment activity. The skill requires an API key for secure communication and follows strict protocols to ensure that destructive actions, such as deleting goal or payment data, always require explicit user confirmation, preventing accidental loss of historical records.

Installation

To integrate this skill, use the command: clawhub install openclaw/skills/skills/bennyqp/datafast-analytics. After installation, ensure your API key is stored securely. Create the directory ~/.config/datafast/ and save your DataFast API key (starting with df_) into a file named api_key within that folder. The skill will automatically reference this file to authenticate all HTTP requests to https://datafa.st/api/v1/.

Use Cases

• Executive Reporting: Generate daily or weekly traffic summaries for stakeholders, focusing on visitor counts and bounce rates.
• Campaign Performance: Analyze specific referral sources or campaign tags to determine ROI for digital marketing efforts.
• Technical Audits: Identify performance bottlenecks by inspecting metrics broken down by browser, operating system, or device type.
• Conversion Optimization: Track goal completions and payment events to visualize user journeys and identify where users drop off.
• Real-time Monitoring: Use the realtime endpoints during product launches to monitor traffic surges and immediate user engagement.

Example Prompts

1. "What was the total number of unique visitors and sessions for the last 30 days, broken down by country?"
2. "Show me the current real-time activity on the site, specifically looking for users on mobile devices."
3. "List my top 5 landing pages from last week and include the bounce rate for each."

Tips & Limitations

• Authentication First: Always verify your API key is correctly saved in the ~/.config/datafast directory. If the agent returns an authentication error, check your configuration file first.
• Filter Wisely: Use the filter_* syntax to narrow down results. Over-requesting data without filters can hit response limits.
• Destructive Actions: Treat DELETE operations with extreme caution. The skill is designed to prompt for confirmation, but always provide the specific date range or segment you intend to remove to avoid clearing the wrong datasets.
• API Docs: When crafting complex queries involving unique metrics or custom segments, refer to the provided datafast-api-docs.md to ensure your field parameters match the API schema.