Reporting#
See how an AI assistant can help with reporting in Brandwave, including example prompts and the details it may ask for.
Using your AI assistant
Get workspace metrics#
Fetch workspace-level metrics including total expenses, impressions, social engagement, delivery coverage, and denominator-aware CPM and Social CPE.
Tool name: get_workspace_metrics. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
How is my workspace performing this month?Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
What you'll get back#
Returns { data, _meta } with the result.
Get workspace metrics history#
Fetch workspace metrics over time with a configurable lookback window.
Tool name: get_workspace_metrics_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me how my workspace metrics have trended over time.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| daysBack | integer | — | Number of days of history to return (1-365). |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get analytics history#
Fetch daily Google Analytics site metrics (sessions, users, page views) and success-metric event counts for a date range, zero-filled for days without data.
Tool name: get_analytics_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this analytics history.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get spend history#
Fetch daily recorded marketing spend and a running cumulative total for a date range. Each spend is attributed to the day its activity ran (publish date for social content, start date for other channels) and days without spend are zero-filled, so budget and spend read alongside traffic and brand signals on one timeline.
Tool name: get_spend_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this spend history.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get performance summary#
Assess whether marketing is working for a date range using the evidence chain: spend (spend, activities, campaigns, delivery coverage), awareness (modeled brand search volume, Share of Search, impressions, Search Console brand impressions), traffic (sessions, users, sessions from linked promo codes and tagged links), and results (success-event counts, customer-reported HDYHAU attribution share, campaign reported outcomes). Spend, traffic, and results figures compare the window with the previous window of the same length; brand search volume is a monthly estimate compared with the month before it, which its own comparison field states. Coverage gaps name the connections or data that would sharpen the picture. Returns figures, not a verdict sentence. Evidence only; no causal attribution.
Tool name: get_performance_summary. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this performance summary.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { data, _meta } with the result.
Get performance moments#
Retrieve the weeks in a date range where marketing evidence moved: spend, brand search impressions, sessions, sessions from linked promo codes and tagged links, success events, or customer-reported HDYHAU marketing mentions that landed well above or below their trailing weekly median. Each moment lists the activities, campaigns, and campaign reported outcomes live that week so a reader can judge what coincided. Quiet windows return the biggest movers below the threshold instead of nothing. Read weeksEvaluated beside weeksInWindow: a week with no data behind it, or whose preceding weeks are all zero, has no baseline to be compared against and is counted in only one of them. Observations only; no causal attribution.
Tool name: get_performance_moments. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this performance moments.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { data, _meta } with the result.
Get performance by channel#
Retrieve evidence by channel for a date range: each channel type with spend (social media, broadcast, out of home, print, events, podcasts, PR articles) walked across the evidence chain with spend and activity count, impressions, sessions from linked promo codes and tagged links, linked success events, and customer-reported HDYHAU mentions, plus a corroboration count of how many of the four steps hold direct evidence. Cells are null when the source that could see them is not connected. Nothing is inferred or attributed.
Tool name: get_performance_channels. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this performance by channel.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { data, _meta } with the result.
Get HDYHAU evidence#
Retrieve a summary of GA4 How Did You Hear About Us (HDYHAU) custom-dimension values for a date range, including raw responses, normalized source categories, response coverage, creator-marketing relevance, data-quality flags, and a daily evidence timeline. This does not assign conversions to creators or campaigns.
Tool name: get_hdyhau_evidence. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this hdyhau evidence.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { data, _meta } with the result.
Upsert HDYHAU mapping#
Create or update a reusable workspace-specific mapping that normalizes one raw GA4 HDYHAU response value for a dimension API name into a source label and category for future reporting. This changes classification only and does not assign attribution.
Tool name: upsert_hdyhau_mapping. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Upsert HDYHAU mapping for my workspace.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| dimensionApiName | string | Required | |
| rawValue | string | Required | |
| normalizedValue | string | Required | |
| category | 'creator' | 'organic_social' | 'broadcast' | 'out_of_home' | 'print' | 'podcast' | 'search' | 'referral' | 'paid' | 'events' | 'other' | 'unknown' | Required | Normalized HDYHAU source category. |
What you'll get back#
Returns { data, _meta } with the result.
Get direct signal evidence#
Retrieve directly observed GA4 promo-code and manually tagged UTM-link evidence for a date range, including sessions, daily users, selected success outcomes, explicit creator/campaign/activity mappings, general referral-channel buckets (e.g. Facebook, Google organic, an AI assistant) with a per-bucket traffic summary, and zero-filled timeline data. This reports observed evidence and does not infer attribution.
Tool name: get_direct_signal_evidence. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this direct signal evidence.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| startDate | string | Required | First day of the range (YYYY-MM-DD, inclusive). |
| endDate | string | Required | Last day of the range (YYYY-MM-DD, inclusive). |
What you'll get back#
Returns { data, _meta } with the result.
Upsert direct signal mapping#
Update one discovered GA4 promo code or manually tagged UTM link by mapping it to exactly one Brandwave creator, campaign, or activity, grouping it under one general referral-channel bucket (e.g. Facebook, Google organic, an AI assistant) when it cannot be tied to a specific entity, or removing its existing mapping. The association is mutually exclusive, applies to all observed sessions, users, and outcomes for that signal, and does not infer causal attribution.
Tool name: upsert_direct_signal_mapping. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Upsert direct signal mapping for my workspace.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| signalId | string (UUID) | Required | Discovered GA4 direct-signal identifier. |
| association | unknown | null | Required | Exactly one association - a Brandwave creator, campaign, or activity, or a general referral-channel bucket - or null to remove the mapping. |
What you'll get back#
Returns { data, _meta } with the result.
Set direct signal ignored#
Ignore one discovered GA4 promo code or manually tagged UTM link as noise, or restore a previously ignored one. Ignored signals are hidden from the default reporting view and excluded from its headline counts, but retain their observed sessions, users, and outcomes and can be restored at any time. This changes triage state only and does not infer attribution.
Tool name: set_direct_signal_ignored. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.
Example prompt#
Set direct signal ignored for my workspace.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| signalId | string (UUID) | Required | Discovered GA4 direct-signal identifier. |
| ignored | boolean | Required | True to ignore the signal as noise, false to restore it for review. |
What you'll get back#
Returns { data, _meta } with the result.
Get campaign metrics#
Fetch metrics for a single campaign including ISO currency, budget, spend, impressions, social engagement, delivery coverage, denominator-aware CPM and Social CPE, freshness, provenance, and data-quality warnings.
Tool name: get_campaign_metrics. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
How is this campaign performing?Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| campaignId | string (UUID) | Required | Campaign identifier to get metrics for. |
What you'll get back#
Returns { data, _meta } with the result.
Get campaign metrics history#
Fetch campaign metrics over time with a configurable lookback window.
Tool name: get_campaign_metrics_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me this campaign’s performance over time.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| campaignId | string (UUID) | Required | Campaign identifier. |
| daysBack | integer | — | Number of days of history to return (1-365). |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get creator metrics#
Fetch metrics for a single creator including activity counts, follower totals, impressions, engagement, spend, CPM, and CPE.
Tool name: get_creator_metrics. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
How is this creator performing?Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| creatorId | string (UUID) | Required | Creator identifier to get metrics for. |
What you'll get back#
Returns { data, _meta } with the result.
Get creator metrics history#
Fetch a creator's follower count, impressions, engagement, spend, CPM, and CPE over time with a configurable lookback window.
Tool name: get_creator_metrics_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me this creator’s performance over time.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| creatorId | string (UUID) | Required | Creator identifier. |
| daysBack | integer | — | Number of days of history to return (1-365). |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get activity metrics#
Fetch metrics for a single activity including impressions, engagement, spend, CPM, and CPE.
Tool name: get_activity_metrics. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
How is this activity performing?Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| activityId | string (UUID) | Required | Activity identifier to get metrics for. |
What you'll get back#
Returns { data, _meta } with the result.
Get activity metrics history#
Fetch an activity's metrics over time with a configurable lookback window.
Tool name: get_activity_metrics_history. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me this activity’s performance over time.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| activityId | string (UUID) | Required | Activity identifier. |
| daysBack | integer | — | Number of days of history to return (1-365). |
What you'll get back#
Returns { items, totalCount, facets, _meta } with paginated results.
Get campaign portfolio#
Retrieve decision-ready portfolio health as the preferred starting point for broad campaign-health questions, including active, scheduled, completed, draft, and attention counts; budget and spend totals; brief completeness; evidence quality; priorities; and recommended next actions.
Tool name: get_campaign_portfolio. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this campaign portfolio.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| daysBack | integer | Required | Trailing window used for campaign changes and portfolio findings (1-365). |
What you'll get back#
Returns { data, _meta } with the result.
Compare campaign performance#
Retrieve the preferred comparison workflow for selected campaigns over a trailing period, including current values, historical changes, denominator-aware efficiency metrics, ISO currency, evidence quality, and plain-language findings.
Tool name: compare_campaign_performance. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Compare campaign performance for my workspace.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| campaignIds | Array<string (UUID)> | Required | Campaign identifiers to compare. |
| daysBack | integer | Required | Trailing comparison window (1-365 days). |
What you'll get back#
Returns { data, _meta } with the result.
Get marketing performance brief#
Create the preferred stakeholder-ready executive or practitioner brief for a trailing period with a headline, highlights, risks, decisions required, recommended actions, campaign evidence, ISO currency, and measurement limitations.
Tool name: get_marketing_performance_brief. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this marketing performance brief.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| daysBack | integer | Required | Trailing reporting window (1-365 days). |
| audience | 'executive' | 'practitioner' | Required | Intended audience and level of operational detail for the brief. |
What you'll get back#
Returns { data, _meta } with the result.
Get marketing recommendations#
Retrieve the preferred next-decision workflow with deterministic evidence-backed recommendations about what to investigate, maintain, or consider, including priority, confidence, rationale, supporting evidence, and campaign links.
Tool name: get_marketing_recommendations. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this marketing recommendations.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
What you'll get back#
Returns { data, _meta } with the result.
Get campaign readiness#
Assess whether a campaign is ready to launch by reviewing its summary, objective, audience, desired outcomes, planned channels, dates, owner, budget, and linked activities.
Tool name: get_campaign_readiness. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this campaign readiness.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| campaignId | string (UUID) | Required | Campaign identifier to assess before launch. |
What you'll get back#
Returns { data, _meta } with the result.
Get campaign closeout#
Generate a campaign closeout or review with recorded performance, ISO currency, evidence quality, limitations, and recommended follow-up actions without claiming causal attribution.
Tool name: get_campaign_closeout. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.
Example prompt#
Show me the details for this campaign closeout.Details to provide#
| Name | Type | Required | Description |
|---|---|---|---|
| workspaceId | string (UUID) | Required | Workspace identifier. |
| campaignId | string (UUID) | Required | Campaign identifier to summarize for closeout or review. |
What you'll get back#
Returns { data, _meta } with the result.