In short:
ak-analyticsfirst settles the source and time frame, defines each metric, keeps missing cells as unknown rather than 0, then compares equivalent periods. The result is a report with charts, a prioritized recommendations table and next steps with owners. It does not treat revenue credited to a channel as proof that the channel caused it.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you have campaign data, website traffic or A/B test results and need to know what they really say. For GA4, the machine needs the two GA packages and a credential file in .claude/secrets/.
flowchart LR
A["Data: GA4, ad platforms, CRM, email"] --> B["ak-analytics"]
B --> C["Report: defined metrics, charts, recommendations"]
C --> D["You and the team follow the next-steps table"]
B --> E["Inconclusive A/B test: keep running"]Four concepts to know:
| Concept | Question | Example |
|---|---|---|
| Metric definition | Where does this number come from, and what is it divided by? | ROAS = revenue / ad spend, a 7-day post-click attribution window, internal orders excluded, double orders deduplicated |
| Missing means unknown | What goes in a cell with no data? | The email channel has no cost figure, so email ROAS is "unknown", not 0 |
| Equivalent periods | What is a fair comparison? | This week against last week with the same number of days, time zone and currency; not a sale week against a normal week |
| Attribution is not causation | Is the channel credited with revenue really the one that produced it? | Last click gives 100% credit to the final touch, so paid search looks very strong, even though customers may have found you through social media |
The input is the metric or report type you need, typed right after the skill name, for example /ak-analytics ROAS by channel or /ak-analytics monthly report.
Sample prompt for a campaign review:
/ak-analytics Review the Q3 campaign of <product name>.
Data: <ad platform export file> and <CRM order file>.
Date range: 07/01 to 09/30, time zone <time zone>, currency <currency>.
Goals: 4x ROAS, CPL under <amount>.
Need: ROAS, CPL, CVR by channel, compared with Q2.This skill has no flags.
Below is the detailed version: the run flow, 5 situations with prompts, the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-analytics: read marketing data correctly before concluding" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-analytics". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-analytics
