Route a marketing report with ak:analyze

Use ak:analyze as a broad Marketing report router. It accepts one of six analysis types—traffic, campaigns, conversions, funnel, content, or engagement—or the report subcommand with daily, weekly, monthly, or quarterly. It gathers data that is actually available, applies the Marketing analytics framework, and reports findings, gaps, and recommendations.

Choose ak:analyze for routing, not an assumed connector

Use ak:analyze when

• You know the supported analysis type or periodic-report cadence you need.
• Approved project data or authorized provider access is available.
• You want a cross-channel overview before choosing a deeper investigation.

Choose another workflow when

• You need a custom KPI, attribution, cohort, or experiment method. Use ak:analytics directly.
• You need to add tracking, change an account, or operate a campaign. This Skill produces analysis; it does not grant mutation, publishing, or spend authority.
• Your request does not map to a listed type. Define the question and measures first rather than relying on the generic name.

Prepare the reporting contract

Provide the exact type or period, date range, timezone, currency, goals, comparison period, source list, and metric definitions. The workflow can use project data and may fetch GA4 or Search Console evidence when a compatible MCP, credentials, permissions, and current provider behavior exist. Provider names in the Skill are not proof that a connector is configured.

Minimize personal data. Account, property, campaign, page, query, email, CRM, and conversion identifiers can expose people or business-sensitive activity. Use aggregate exports, redact secrets and direct identifiers, and record sampling, consent, retention, and missing-source limits.

Run the Skill

/ak:analyze campaigns "Use only the approved channel exports for 2026-07-01 through 2026-07-31. Compare with goals, identify missing fields, and make no account changes"

/ak:analyze campaigns "Use only the approved channel exports for 2026-07-01 through 2026-07-31. Compare with goals, identify missing fields, and make no account changes"

$ak:analyze campaigns "Use only the approved channel exports for 2026-07-01 through 2026-07-31. Compare with goals, identify missing fields, and make no account changes"

For a periodic report, put report first so the Skill can route the remaining argument:

/ak:analyze report weekly

Understand the stages

1. Parse the analysis type or report period.
2. Inventory available sources and distinguish fetched, supplied, and missing data.
3. Apply type-specific measures: traffic sources and trends; campaign cost, conversion, and ROI; funnel stages and drop-offs; or content and engagement.
4. Compare with approved goals and a genuinely comparable prior period.
5. Separate observations, anomalies, assumptions, and recommendations in the report.

Keep decisions and mutations with you

Verify output and evidence

Standard analysis writes reports/analytics/{date}-{type}.md. The report route writes reports/periodic/{date}-{period}.md. Expect an executive summary, key metrics, relevant channel or funnel detail, goal progress, source and period comparison, findings, limitations, and recommendations. Verify formulas, totals, attribution windows, identifiers, and citations against the originals.

Troubleshoot and know the limits

The Skill does not guarantee source coverage, connector availability, attribution accuracy, statistical significance, revenue, or performance gains. See Marketing Kit and Runtime adapters.