Salvatore Sinigaglia

Welcome to Wevion! Learn how to set up your account, connect your first ad platform, and navigate the platform.

Getting Started

Wevion is the AI media buying platform that manages Meta, Google, TikTok, Taboola, Snapchat, and Outbrain from one workspace.

What is Wevion — the AI media buying platform

Sign up for a 14-day Wevion trial with full access. A card is needed to start, but no charge during the trial. Account ready in 2 minutes.

Create your account and start the free trial

The Wevion onboarding wizard collects 4 quick questions — business type, marketing stack, industry, then finish. Skippable.

The onboarding wizard — set up in 5 minutes

Connect Meta, Google Ads, TikTok, Taboola, Snapchat, or Outbrain to Wevion. 6 platforms, same connection pattern.

Connect your first ad platform

Tour of the Wevion dashboard — KPI strip, spend chart, account summary, top campaigns. Data refreshes every 15 minutes.

Your dashboard — what every section means

Wevion has three navigation surfaces: left sidebar, top header, and the Cmd+K command palette. Here's how each works.

Navigating Wevion — sidebar, header, command palette

Wevion has a 4-level model: Organization > Workspace > Legal Entity > Team. Here's what each holds and when to use them.

Workspace, Team, Account — what's the difference

Invite a teammate from Settings → Team → People. Enter their email and pick a role. They join via an email link valid 7 days.

Invite your first team member

Wevion has 7 roles from viewer to super_admin. Reference table — what each can do, when to pick which.

Roles and permissions in 5 minutes

Wevion imports pixels from connected ad accounts automatically. Verify yours fires events at /pixels before launching.

Set up your first pixel for tracking

Catalogs hold your product feed. Wevion imports them from connected ad accounts. Use them for dynamic ads and retargeting.

Product catalog basics for e-commerce flows

Wavo is the AI assistant inside Wevion. Ask about metrics, get suggestions, take actions. Account-aware, always available.

Meet Wavo — your AI assistant inside Wevion

End-to-end walk-through to launch your first campaign in Wevion. Express mode, pause-then-activate pattern.

Launch your first campaign — end-to-end walk-through

Day 1 after launch: check impressions, CTR, CPM. Skip ROAS and CPA until you have 50+ conversion events.

Understanding your first data — what to look at on day 1

Wevion notification setup overview. Verify current event types and delivery channels against backend defaults and Telegram routes.

Set up notifications and Telegram alerts

A rule combines condition + action. Build at /rules/new. Start with a notify-only rule before activating pause or scale.

Your first automation rule

Creative Hub stores images, videos, and copy. Drag-and-drop to upload. Reuse across campaigns. AI generation available.

Upload your first creative to Creative Hub

Connect 2+ platforms in Wevion to launch from one form, analyze together, manage creatives in one library.

Working across multiple ad platforms

Trial is 14 days, full features, capped seats and spend tracking. A card is needed to start; if you don't pick a plan you move to Free. Stripe billing.

From trial to paid plan — what changes

Quick reference for the terms you'll see in Wevion — product features, ad-tech acronyms, roles. One place, one-line definitions.

Glossary — key terms you'll see in Wevion

Sign up, connect a platform, build your team, launch your first campaign, monitor, get help. The Wevion start-to-launch index.

Getting started 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

Wevion's unified product catalog at /product-catalog merges Shopify, WooCommerce, and manual products into one canonical model with cross-source matching.

Unified product catalog (cross-source CDM)

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 Outbrain Amplify at /connect/outbrain by pasting an API token (no OAuth). Token valid 30 days, marketers import as ad accounts.

Connect Outbrain Amplify

Every TikTok ad needs an identity. Wevion checks TT_USER, lets you create a CUSTOMIZED_USER, and preflights pixel, catalog, app, lead form per objective.

TikTok identity and publish prerequisites

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.