Salvatore Sinigaglia

Understand your performance data with dashboards, reports, exports, and cross-channel analytics.

Reports & Analytics

/analytics is the performance hub. 2 modes: Single Platform (configurable widget grid, up to 19 widgets) and Cross-Channel (5 narrative blocks, 90-day max, gated by flag).

Analytics overview — Single Platform vs Cross-Channel

Top toolbar mode toggle. Single Platform always available; Cross-Channel gated by ENABLE_CROSS_CHANNEL_ANALYTICS env flag (shown but disabled/greyed when off). Pick mode by question.

Switch between Single Platform and Cross-Channel

Configurable widget grid (up to 19 widgets: KPI cards, charts, tables, commerce). Saved layouts + drag-rearrange active. Per-platform native data.

Single Platform — widget grid explained

5 narrative blocks: KPI strip / channel mix / channel comparison / budget recommendation / top campaigns. 90-day max. Redis 10-min cache.

Cross-Channel overview — 5 narrative blocks

KPI strip metrics: spend / impressions / clicks / CTR / CPC / CPM / conversions / purchases / leads / CPA / ROAS. Verified native or rolled-up.

KPI strip — what each metric means

getChannelMixTrend service. Donut: current per-platform spend share. Stacked area: trend over time. 90-day max. Spot budget concentration.

Channel mix — donut explained

getChannelComparison service. Per-platform metrics side-by-side in a sortable matrix. Spend / ROAS / CPA / CPC / CTR / conversions per row.

Channel comparison matrix

getOptimalMixRecommendation. RULE-BASED (NOT AI). Returns platform, current_budget_pct, recommended_budget_pct, multiplier from historical ROAS+spend.

Budget recommendation — AI suggestions

getTopCampaignsCrossPlatform service. Ranked campaigns across all selected platforms. Sort by spend / ROAS / conversions / CPA. Limit configurable.

Top campaigns cross-platform

ROAS = purchaseValue / spend. Scale when ROAS > target × 1.2 + meaningful spend; pause when ROAS < target × 0.5. Use last_7d minimum.

ROAS — and when to scale or pause

CPA = spend / purchases. CPM = spend / impressions × 1000. CTR = clicks / impressions × 100. Each tells a different story. Use together, not in isolation.

CPA, CPM, CTR — core metrics decoded

GET /api/v1/analytics/comparison. current vs previous date ranges → per-metric delta_pct. Common pairs: last 7d vs prior 7d, MoM, YoY.

Compare periods — performance over time

Sync layers: 15-min platform cron / 10-min Redis cache / 24h demographics cache / 24-72h postback lag for purchases & ROAS.

Data freshness — how often analytics update

Per-day exchange rates with EUR intermediate. target_currency converts all platforms to display currency. Historical rates per transaction date.

Exchange rates per day — multi-currency analytics

POST /api/v1/analytics/export → 202 + job_id. Poll GET /api/v1/analytics/export/:id. CSV + PDF (UPPERCASE). 90-day max. Cross-channel-flag gated. Async via SQS, in-app download.

Export PDF / CSV reports

GET /api/v1/analytics/account-stats. Account HEALTH metrics: managed / active / disabled accounts, ban rate, rejected ads, total ads. Not financial KPIs.

Account summary — health at a glance

Diagnose: data stale, cross-channel UI missing, 90-day rejected, ROAS wrong, currency mismatch, export stuck, demographics outdated, member scoping.

Analytics troubleshooting

Analytics overview (Single + Cross-Channel), KPI strip, channel mix + comparison, budget recommendation, periods, freshness, FX, export.

Cross-channel analytics with Wevion — complete guide

Feedback

Roadmap

Changelog

Meet Wavo — your AI assistant inside Wevion. Ask questions, take actions, get account-aware help.

AI Chat (Wavo)

Wavo is Wevion's in-app AI assistant. /chat. Streams answers. Reads your data. Takes actions with approval. Three modes: Fast / Smart / Expert.

Meet Wavo — your AI assistant in Wevion

Wavo orchestrates: history (max 20) → tools (max 15 rounds, 30 calls/session) → streamed response. CAN: query, action, generate. CAN'T: voice TTS, cross-team data.

How Wavo works — what it can and can't do

Open /chat. Type + Enter. Be specific (campaign / date / platform). Voice via Whisper (25MB, BCP-47 lang). Upload images / PDF / CSV / docx / xlsx (10MB).

Asking questions — best practices

Wavo sees ONLY your team's data (team_id-scoped). Row-level RBAC per tool. Strategic context cached 5 min. Never fabricates. Output sanitizes secrets.

Wavo and your data — what it sees

3 tool modes: read (instant), write (instant + audit), approval (pending → confirm). HIGH/MEDIUM/LOW risk. ACTION_TTL 30 min. Audit via ai_action_log (GET /api/v1/ai-action-log).

Actions Wavo can take (approvals, drafts, queries)

3-level structure: Project > Session > Message. Project shares instructions + memory facts (max 20). Sessions favoritable + shareable (read default).

Projects and sessions — organizing your chats

5 prompt patterns: performance review / diagnosis / action / comparison / creative. Be specific. Use project instructions for repetitive context.

Prompt tips for media buyers

Wavo: account-aware + action-capable. Help Center: static docs. Use Wavo for your data; Help Center for how-it-works. Wavo can open support tickets.

When to use Wavo vs Help Center

1 credit = $0.001. MARKUP 1.1× on model costs. credit_balance + monthly_cap. Owner/admin set cap via PUT /credits/cap. Stripe top up.

Wavo credits and limits

Team isolation by team_id. RBAC per tool. Output sanitization redacts secrets. Injection defense 50+ regex. Model providers per their terms.

Wavo privacy and data usage

Per-message feedback: thumbs up / down + comment. PATCH /api/v1/chat/messages/:messageId/feedback. Body rating (-1..1) + comment. Helps Wavo improve.

Give feedback — improve Wavo

Diagnose: wrong data, stream interrupted, approval expired, denied permission, out of credits, upload rejected, hallucination, slow, lost memory.

Wavo troubleshooting

Wavo: three modes (Fast/Smart/Expert), action approval (HIGH/MEDIUM/LOW), projects + sessions, credits, privacy, feedback. Wevion's AI assistant hub.

Wavo — your AI assistant in Wevion — complete guide

Your control center for monitoring, filtering, bulk actions, and exporting campaign performance.

Ads Manager & Reports

Ads Manager at /ads-manager — campaign hierarchy view, filters, bulk actions, drill-down. Daily monitoring + management hub for mediabuyers.

Ads Manager overview — your control center

Filter by account, platform, status, date, metric thresholds. Save filter views for reuse. Multi-column sort. Search by name.

Filtering and sorting your data

Per-column metrics: Spend, Impressions, Clicks, CTR, CPC, CPM, Conversions, ROAS, CPA, Frequency. Per-platform variants + attribution caveats.

Campaign metrics explained

Click campaign to expand into ad sets, click ad set to expand into ads. Per-level metrics + actions. Identify which adset or ad is driving issue.

Drill-down from campaign to ad set to ad

Select multiple rows → toolbar actions: pause / resume / archive / edit budget / edit bid / delete. Async via SQS workers. Confirm before destructive.

Bulk actions — pause, resume, edit budget

Right-click row → Duplicate, OR action menu Duplicate. Creates draft mirror, opens in Pro mode for customization. POST /api/v1/campaigns/duplicate.

Duplicate campaigns, ad sets, ads

Select multiple → bulk Duplicate. Creates N drafts. Customize each variant before publish via Bulk Launch grid OR per-draft Pro mode.

Bulk duplication

Naming convention: [Client]_[Type]_[Audience]_[Geo]_[YYYYMM]_[Version]. Speeds filtering, reporting, audit. Codify in templates.

Naming conventions — best practices

Right-click ad set → Add ad → inline creative + copy + CTA + URL. Skip full Campaign Creator. Good for variant or refresh.

Create an ad directly from Ads Manager

Right-click ad set → Edit budget OR double-click cell. Async via SQS edit worker. Effect within 5-10 min. Avoid > 20% daily change (learning reset).

Edit ad set budget

Ad set → action menu → Edit targeting. Modify countries, age, interests, audiences. Caveat: large changes trigger learning reset.

Edit targeting after launch

Ad row → action menu → Edit creative. Replace image/video, change copy, change CTA. Caveat: triggers platform review + learning reset.

Edit creatives

8 statuses: Active, Paused, Archived, Deleted, In Review, Rejected, Limited, Pending Approval. Per-platform variations. Action menu varies.

Understanding campaign statuses

Toggle status: row toggle or action menu. Async via SQS toggle worker. Effect within 1-2 min. Paused > 7 days = Meta learning reset on resume.

Pause and resume a campaign

Archive = hide from default view, preserve data. Delete = soft delete (may permanently remove on platform). Archive reversible; delete harder.

Archive vs delete

/reports → pick level + date + columns → Export CSV. GET /api/v1/reports endpoint. Async for large date ranges (email when ready).

Export reports to CSV

/reports → Export → PDF. POST /api/v1/report-pdf. Formatted report with branding, charts, summary tables. Templates supported.

Export reports to PDF

POST /api/v1/report-schedules. Setup: template + cadence (daily/weekly/monthly) + delivery time + recipients. Cron auto-emails.

Schedule recurring reports

Date picker, timezone (workspace default), currency (workspace default with FX conversion). Late attribution caveat 24-72h.

Date ranges, timezones, currency

Date picker → Compare to → previous period (same days last week / month / year / custom). Metrics show delta. WoW / MoM / YoY analysis.

Compare against previous period

Two sources: Meta-reported (pixel+CAPI) vs Postback (S2S). Often disagree 5-20%. Meta for bidding signals; postback for business reporting.

Postback vs Meta conversions — which to trust

Top 10 Ads Manager issues — stale data, empty filter, bulk stuck, edit not propagating, currency mismatch, mobile actions missing, with fixes.

Ads Manager troubleshooting

Ads Manager overview, drill-down, bulk actions, edits, reports CSV/PDF + scheduled, attribution caveats. Mediabuyer ops index.

Ads Manager & reports — complete guide

Connect Shopify, WooCommerce, Keitaro (Tracker Hub), Postback, Google Drive, Telegram, HubSpot, and API keys.

Commerce & Tracker Integrations

Install the Wevion app on your Shopify store. OAuth grants read_orders + read_all_orders + read_products + read_inventory (+ optional read_reports). Webhooks auto-subscribed.

Connect Shopify

Shopify webhooks deliver orders/products/refunds in real time. 15-min polling backfills missed events. 180-day initial backfill.

Shopify orders sync — what gets imported

Top Shopify issues — OAuth fails, token refresh expired, webhooks missed, scope health, multi-store, refund tracking. Fixes inline.

Shopify troubleshooting

WooCommerce uses REST API with Consumer Key + Secret (Basic Auth). Generate in WordPress, paste in Wevion, sync starts.

Connect WooCommerce

WooCommerce sync: order polling every 15 min, product refresh every 12 h, optional real-time webhooks. CDM normalizes customer fields across themes.

WooCommerce sync explained

Connect multiple WooCommerce stores in one workspace. Each is its own config. Aggregate catalog + reporting across stores.

WooCommerce multi-source catalog

Tracker Hub supports 6 trackers including Keitaro. Connect via API key + Api-Key header. Sync campaigns, conversions, mappings.

Connect Keitaro via Tracker Hub

Keitaro sync pulls campaigns + clicks + conversions every 15 min. Mappings link Keitaro campaigns to Wevion campaigns. Breakdowns by sub/landing/offer/geo.

Keitaro sync flow — what data, how often

Postback (server-to-server) sends conversions from your affiliate network directly to Wevion's Meta-only postback store. Feeds the postback conversion column in reporting.

Postback (S2S) tracking overview

Get your Wevion postback URL, configure it in your tracker with macros, test, verify events arriving. Step-by-step setup.

Set up postback tracking

Postback (server-side) vs Pixel (browser-side). Use both for best attribution with deduplication. Postback critical for iOS / affiliate funnels.

Postback vs pixel — which to use

Wevion owns a per-user Drive folder via a Service Account and grants your Gmail writer access. No personal OAuth; you work directly in the Wevion-owned folder.

Connect Google Drive

Wevion owns your Creative Hub folder via a Service Account and shares it with your Gmail (writer). Manage files in Creative Hub; open them in Drive.

Drive creative folder management

Pair Telegram bot at /connect/telegram with a one-time deep-link token. Real-time alerts for rules, spend, errors. Cross-link to gs-115.

Connect Telegram for notifications

Wevion Telegram bot commands reference: /start, /status, /stats, /help, /unlink. Italian default.

Telegram bot commands reference

HubSpot is not a self-serve integration you connect in Wevion. There is no per-user HubSpot connect flow or OAuth in the product.

HubSpot in Wevion

There is no user-facing HubSpot leads sync in Wevion. To get ad leads into your CRM, use Postback, commerce, or tracker integrations.

HubSpot leads sync

Top 10 generic sync issues across all integrations — stuck syncs, missing webhooks, attribution lag, currency, duplicates. Fixes inline.

Data and sync troubleshooting

All Wevion integrations: ad platforms, commerce, trackers, files, notifications. Categories, use cases, prerequisites. No user-facing CRM integration.

All integrations — overview and use cases

Commerce (Shopify, WooCommerce) + 6 trackers (Keitaro, Voluum, RedTrack, BeMob, TG Tracker, Binom) + Google Drive + Telegram. Meta-only postback storage.

Commerce & tracker integrations — complete guide

Connect TikTok Ads, Taboola, and Snapchat. Pixel setup, objectives, and platform-specific guidance.

TikTok, Taboola & Snapchat

Snapchat is env-gated in Wevion — contact support if Connect button hidden. When enabled: OAuth at /connect/snapchat.

Connect Snapchat

Snap Pixel is a browser tracking snippet. Auto-imported from connected Snap ad accounts. Install JS on your site to track events.

Snapchat Pixel setup

Taboola uses an OAuth2 client_credentials grant. Paste your Taboola Client ID + Client Secret at /connect/taboola; Wevion validates and stores them encrypted, then syncs campaigns + pixels.

Connect Taboola

Wevion exposes 5 Taboola objectives — Brand Awareness, Website Engagement, Lead Generation, Online Purchases, App Promotion — with campaign-level fixed CPC bidding. Native-ad format on premium publishers.

Taboola objectives and pricing

Top 6 Taboola issues — credentials missing, account ID format, sync delays, pixel install, currency. Fixes inline.

Taboola connection troubleshooting

Connect TikTok For Business at /connect/tiktok. OAuth with advertiser account, asset selection, 15-min sync.

Connect TikTok Ads

TikTok offers browser pixel + Events API (server-side). Wevion supports both. Install both for iOS 14.5+ resilience + dedup.

TikTok Pixel and Events API setup

Top 8 TikTok issues — personal vs Business account, advertiser pending review, token expired, Events API rejected, with fixes.

TikTok connection troubleshooting

TikTok + Taboola + Snapchat integration: OAuth, sync, manage, cross-platform analytics. Snapchat behind feature flag.

TikTok, Taboola & Snapchat Ads — complete guide

Connect Google Ads (direct and MCC), set up conversions, manage tokens, and troubleshoot integration issues.

Google Ads

OAuth flow at /connect/google-ads. Scope: adwords. Import direct accounts or all MCC-managed customers in one flow.

Connect Google Ads

MCC = manager account that owns multiple customers. Direct = single advertiser account. Wevion supports both; MCC scales for agencies.

MCC vs direct Google Ads account

Google Ads tracks conversions via Conversion Actions, set up in Google Ads UI. Wevion imports active actions for campaign optimization.

Set up Google Ads conversions

Wevion exposes 7 Google Ads campaign types: Search, Display, Video, Demand Gen, Shopping, Performance Max, and App. Each optimized for a different goal. Pick based on intent, format, and audience signals.

Shopping, Search, Performance Max — differences

Google refresh tokens don't expire unless revoked. A job runs every 10 min and refreshes short-lived access tokens due within ~15 min. Reconnect restores data on rare failure.

Google Ads token refresh and reconnection

Top 10 Google Ads issues with fixes — OAuth fails, MCC access, conversion 0, Performance Max rejected, currency mismatch.

Google Ads connection troubleshooting

Google Ads integration: OAuth connect, MCC accounts, AdWords API scope, sync, manage, cross-platform analytics, troubleshoot.

Connect & manage Google Ads with Wevion — complete guide

Connect and manage Meta ad accounts, fan pages, pixels, and Meta users. Token health and reconnection.

Meta (Facebook & Instagram)

Connect Meta (Facebook + Instagram) at /connect/meta. OAuth with Business Manager, asset selection, 15-min sync.

Connect your Meta (Facebook & Instagram) account

The Meta permissions Wevion requests, grouped by purpose: managing campaigns, reading performance/insights, and handling account/asset (Pages, Instagram, catalogs, Business Manager). Each scope is documented with what it grants and why.